/**
* Get a SharePoint User by Account
*
* @access public
* @param SPSite $site SharePoint Site object
* @param string $account SharePoint User account
* @param array $extra Extra properties to map
* @throws SPException
* @return SPUser
*/
public static function getByAccount(SPSite $site, $account, array $extra = [])
{
$json = $site->request('_api/SP.UserProfiles.PeopleManager/GetPropertiesFor(accountName=@v)', ['headers' => ['Authorization' => 'Bearer ' . $site->getSPAccessToken(), 'Accept' => 'application/json'], 'query' => ['@v' => "'" . $account . "'"]], 'POST');
return new static($site, $json, $extra);
}
/**
* Create a SharePoint List
*
* @static
* @access public
* @param SPSite $site SharePoint Site
* @param array $properties SharePoint List properties (Title, Description, ...)
* @param array $settings Instantiation settings
* @throws SPException
* @return SPList
*/
public static function create(SPSite $site, array $properties, array $settings = [])
{
$properties = array_replace_recursive(['BaseTemplate' => static::TPL_DOCUMENTLIBRARY], $properties, ['odata.type' => 'SP.List']);
$body = json_encode($properties);
$json = $site->request('_api/web/Lists', ['headers' => ['Authorization' => 'Bearer ' . $site->getSPAccessToken(), 'Accept' => 'application/json', 'X-RequestDigest' => (string) $site->getSPFormDigest(), 'Content-type' => 'application/json', 'Content-length' => strlen($body)], 'query' => ['$expand' => 'RootFolder'], 'body' => $body], 'POST');
return new static($site, $json, $settings);
}
/**
* Get SubFolders of a SharePoint Folder
*
* @static
* @access public
* @param SPSite $site SharePoint Site
* @param string $relativeUrl SharePoint Folder relative URL
* @param array $settings Instantiation settings
* @throws SPException
* @return array
*/
public static function getSubFolders(SPSite $site, $relativeUrl, array $settings = [])
{
$json = $site->request("_api/web/GetFolderByServerRelativeUrl('" . $relativeUrl . "')/Folders", ['headers' => ['Authorization' => 'Bearer ' . $site->getSPAccessToken(), 'Accept' => 'application/json'], 'query' => ['$expand' => 'ListItemAllFields/ParentList,Properties']]);
$folders = [];
foreach ($json['value'] as $subFolder) {
// skip System Folders
if (!static::isSystemFolder($subFolder['Name'])) {
$folders[$subFolder['UniqueId']] = new static($site, $subFolder, $settings);
}
}
return $folders;
}
/**
* Permanently delete a SharePoint RecycleBin Item
*
* @throws \Impensavel\Spoil\Exception\SPRuntimeException
* @return bool
*/
public function delete()
{
$this->site->request("_api/web/RecycleBin('" . $this->guid . "')/deleteObject()", ['headers' => ['Authorization' => 'Bearer ' . $this->site->getSPAccessToken(), 'Accept' => 'application/json']], 'POST');
return true;
}
