/** * Create a SharePoint Recycle Bin Item Collection * * @param SPSite $site SharePoint Site * @param array $extra Extra properties to map * @throws \Impensavel\Spoil\Exception\SPRuntimeException * @return SPRecycleBinItemCollection */ public static function create(SPSite $site, array $extra = []) { $json = $site->request("_api/web/RecycleBin", ['headers' => ['Authorization' => 'Bearer ' . $site->getSPAccessToken(), 'Accept' => 'application/json']]); $collection = new static(); foreach ($json['value'] as $item) { $collection[$item['Id']] = new SPRecycleBinItem($site, $item, $extra); } return $collection; }
/** * Get SubFolders of a SharePoint Folder * * @param SPSite $site SharePoint Site * @param string $relativeUrl SharePoint Folder relative URL * @param array $settings Instantiation settings * @throws SPRuntimeException * @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; }
/** * Create a SharePoint List * * @param SPSite $site SharePoint Site * @param array $properties SharePoint List properties (Title, Description, ...) * @param array $settings Instantiation settings * @throws SPRuntimeException * @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' => $site->getSPContextInfo()->getFormDigest(), 'Content-type' => 'application/json', 'Content-length' => strlen($body)], 'query' => ['$expand' => 'RootFolder'], 'body' => $body], 'POST'); return new static($site, $json, $settings); }
/** * {@inheritdoc} */ public function getSPAccessToken() { return $this->site->getSPAccessToken(); }
/** * Get a SharePoint File by Relative URL * * @param SPSite $site SharePoint Site * @param string $relativeUrl SharePoint Folder relative URL * @param array $extra Extra payload values to map * @throws SPRuntimeException * @return SPFile */ public static function getByRelativeUrl(SPSite $site, $relativeUrl, array $extra = []) { $json = $site->request("_api/web/GetFileByServerRelativeUrl('" . $relativeUrl . "')", ['headers' => ['Authorization' => 'Bearer ' . $site->getSPAccessToken(), 'Accept' => 'application/json'], 'query' => ['$expand' => 'ListItemAllFields,Author']]); $folder = SPFolder::getByRelativeUrl($site, dirname($relativeUrl)); return new static($folder, $json, $extra); }
/** * Get a SharePoint User by Account * * @param SPSite $site SharePoint Site object * @param string $account SharePoint User account * @param array $extra Extra payload values to map * @throws SPRuntimeException * @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); }