* This file is licensed under the Affero General Public License version 3 or * later. * See the COPYING-README file. */ namespace OCA\Contacts; class Share_Backend_Addressbook implements \OCP\Share_Backend_Collection { const FORMAT_ADDRESSBOOKS = 1; /** * @brief Get the source of the item to be stored in the database * @param string Item * @param string Owner of the item * @return mixed|array|false Source * * Return an array if the item is file dependent, the array needs two keys: 'item' and 'file' * Return false if the item does not exist for the user * * The formatItems() function will translate the source returned back into the item */ public function isValidSource($itemSource, $uidOwner) { $addressbook = Addressbook::find( $itemSource ); if( $addressbook === false || $addressbook['userid'] != $uidOwner) { return false; } return true; } /** * @brief Get a unique name of the item for the specified user * @param string Item * @param string|false User the item is being shared with * @param array|null List of similar item names already existing as shared items * @return string Target name * * This function needs to verify that the user does not already have an item with this name. * If it does generate a new name e.g. name_# */ public function generateTarget($itemSource, $shareWith, $exclude = null) { $addressbook = Addressbook::find( $itemSource ); $user_addressbooks = array(); foreach(Addressbook::all($shareWith) as $user_addressbook) { $user_addressbooks[] = $user_addressbook['displayname']; } $name = $addressbook['displayname']; $suffix = ''; while (in_array($name.$suffix, $user_addressbooks)) { $suffix++; } return $name.$suffix; } /** * @brief Converts the shared item sources back into the item in the specified format * @param array Shared items * @param int Format * @return ? * * The items array is a 3-dimensional array with the item_source as the first key and the share id as the second key to an array with the share info. * The key/value pairs included in the share info depend on the function originally called: * If called by getItem(s)Shared: id, item_type, item, item_source, share_type, share_with, permissions, stime, file_source * If called by getItem(s)SharedWith: id, item_type, item, item_source, item_target, share_type, share_with, permissions, stime, file_source, file_target * This function allows the backend to control the output of shared items with custom formats. * It is only called through calls to the public getItem(s)Shared(With) functions. */ public function formatItems($items, $format, $parameters = null) { $addressbooks = array(); if ($format == self::FORMAT_ADDRESSBOOKS) { foreach ($items as $item) { $addressbook = Addressbook::find($item['item_source']); if ($addressbook) { $addressbook['displayname'] = $item['item_target']; $addressbook['permissions'] = $item['permissions']; $addressbooks[] = $addressbook; } } } return $addressbooks; } public function getChildren($itemSource) { $query = \OCP\DB::prepare('SELECT `id`, `fullname` FROM `*PREFIX*contacts_cards` WHERE `addressbookid` = ?'); $result = $query->execute(array($itemSource)); $children = array(); while ($contact = $result->fetchRow()) { $children[] = array('source' => $contact['id'], 'target' => $contact['fullname']); } return $children; } }