123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808 |
- <?php
- /**
- * @copyright Copyright (c) 2016, ownCloud, Inc.
- *
- * @author Bernhard Reiter <ockham@raz.or.at>
- * @author derkostka <sebastian.kostka@gmail.com>
- * @author Joas Schilling <coding@schilljs.com>
- * @author Jörn Friedrich Dreyer <jfd@butonic.de>
- * @author Morris Jobke <hey@morrisjobke.de>
- * @author Robin Appelman <robin@icewind.nl>
- * @author Robin McCorkell <robin@mccorkell.me.uk>
- * @author Thomas Müller <thomas.mueller@tmit.eu>
- * @author Thomas Tanghus <thomas@tanghus.net>
- * @author Vincent Petry <pvince81@owncloud.com>
- *
- * @license AGPL-3.0
- *
- * This code is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License, version 3,
- * as published by the Free Software Foundation.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU Affero General Public License for more details.
- *
- * You should have received a copy of the GNU Affero General Public License, version 3,
- * along with this program. If not, see <http://www.gnu.org/licenses/>
- *
- */
-
- /**
- * Class for easily tagging objects by their id
- *
- * A tag can be e.g. 'Family', 'Work', 'Chore', 'Special Occation' or
- * anything else that is either parsed from a vobject or that the user chooses
- * to add.
- * Tag names are not case-sensitive, but will be saved with the case they
- * are entered in. If a user already has a tag 'family' for a type, and
- * tries to add a tag named 'Family' it will be silently ignored.
- */
-
- namespace OC;
-
- use OC\Tagging\Tag;
- use OC\Tagging\TagMapper;
- use OCP\DB\QueryBuilder\IQueryBuilder;
-
- class Tags implements \OCP\ITags {
-
- /**
- * Tags
- *
- * @var array
- */
- private $tags = array();
-
- /**
- * Used for storing objectid/categoryname pairs while rescanning.
- *
- * @var array
- */
- private static $relations = array();
-
- /**
- * Type
- *
- * @var string
- */
- private $type;
-
- /**
- * User
- *
- * @var string
- */
- private $user;
-
- /**
- * Are we including tags for shared items?
- *
- * @var bool
- */
- private $includeShared = false;
-
- /**
- * The current user, plus any owners of the items shared with the current
- * user, if $this->includeShared === true.
- *
- * @var array
- */
- private $owners = array();
-
- /**
- * The Mapper we're using to communicate our Tag objects to the database.
- *
- * @var TagMapper
- */
- private $mapper;
-
- /**
- * The sharing backend for objects of $this->type. Required if
- * $this->includeShared === true to determine ownership of items.
- *
- * @var \OCP\Share_Backend
- */
- private $backend;
-
- const TAG_TABLE = '*PREFIX*vcategory';
- const RELATION_TABLE = '*PREFIX*vcategory_to_object';
-
- const TAG_FAVORITE = '_$!<Favorite>!$_';
-
- /**
- * Constructor.
- *
- * @param TagMapper $mapper Instance of the TagMapper abstraction layer.
- * @param string $user The user whose data the object will operate on.
- * @param string $type The type of items for which tags will be loaded.
- * @param array $defaultTags Tags that should be created at construction.
- * @param boolean $includeShared Whether to include tags for items shared with this user by others.
- */
- public function __construct(TagMapper $mapper, $user, $type, $defaultTags = array(), $includeShared = false) {
- $this->mapper = $mapper;
- $this->user = $user;
- $this->type = $type;
- $this->includeShared = $includeShared;
- $this->owners = array($this->user);
- if ($this->includeShared) {
- $this->owners = array_merge($this->owners, \OC\Share\Share::getSharedItemsOwners($this->user, $this->type, true));
- $this->backend = \OC\Share\Share::getBackend($this->type);
- }
- $this->tags = $this->mapper->loadTags($this->owners, $this->type);
-
- if(count($defaultTags) > 0 && count($this->tags) === 0) {
- $this->addMultiple($defaultTags, true);
- }
- }
-
- /**
- * Check if any tags are saved for this type and user.
- *
- * @return boolean.
- */
- public function isEmpty() {
- return count($this->tags) === 0;
- }
-
- /**
- * Returns an array mapping a given tag's properties to its values:
- * ['id' => 0, 'name' = 'Tag', 'owner' = 'User', 'type' => 'tagtype']
- *
- * @param string $id The ID of the tag that is going to be mapped
- * @return array|false
- */
- public function getTag($id) {
- $key = $this->getTagById($id);
- if ($key !== false) {
- return $this->tagMap($this->tags[$key]);
- }
- return false;
- }
-
- /**
- * Get the tags for a specific user.
- *
- * This returns an array with maps containing each tag's properties:
- * [
- * ['id' => 0, 'name' = 'First tag', 'owner' = 'User', 'type' => 'tagtype'],
- * ['id' => 1, 'name' = 'Shared tag', 'owner' = 'Other user', 'type' => 'tagtype'],
- * ]
- *
- * @return array
- */
- public function getTags() {
- if(!count($this->tags)) {
- return array();
- }
-
- usort($this->tags, function($a, $b) {
- return strnatcasecmp($a->getName(), $b->getName());
- });
- $tagMap = array();
-
- foreach($this->tags as $tag) {
- if($tag->getName() !== self::TAG_FAVORITE) {
- $tagMap[] = $this->tagMap($tag);
- }
- }
- return $tagMap;
-
- }
-
- /**
- * Return only the tags owned by the given user, omitting any tags shared
- * by other users.
- *
- * @param string $user The user whose tags are to be checked.
- * @return array An array of Tag objects.
- */
- public function getTagsForUser($user) {
- return array_filter($this->tags,
- function($tag) use($user) {
- return $tag->getOwner() === $user;
- }
- );
- }
-
- /**
- * Get the list of tags for the given ids.
- *
- * @param array $objIds array of object ids
- * @return array|boolean of tags id as key to array of tag names
- * or false if an error occurred
- */
- public function getTagsForObjects(array $objIds) {
- $entries = array();
-
- try {
- $conn = \OC::$server->getDatabaseConnection();
- $chunks = array_chunk($objIds, 900, false);
- foreach ($chunks as $chunk) {
- $result = $conn->executeQuery(
- 'SELECT `category`, `categoryid`, `objid` ' .
- 'FROM `' . self::RELATION_TABLE . '` r, `' . self::TAG_TABLE . '` ' .
- 'WHERE `categoryid` = `id` AND `uid` = ? AND r.`type` = ? AND `objid` IN (?)',
- array($this->user, $this->type, $chunk),
- array(null, null, IQueryBuilder::PARAM_INT_ARRAY)
- );
- while ($row = $result->fetch()) {
- $objId = (int)$row['objid'];
- if (!isset($entries[$objId])) {
- $entries[$objId] = array();
- }
- $entries[$objId][] = $row['category'];
- }
- if (\OCP\DB::isError($result)) {
- \OCP\Util::writeLog('core', __METHOD__. 'DB error: ' . \OCP\DB::getErrorMessage(), \OCP\Util::ERROR);
- return false;
- }
- }
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- return false;
- }
-
- return $entries;
- }
-
- /**
- * Get the a list if items tagged with $tag.
- *
- * Throws an exception if the tag could not be found.
- *
- * @param string $tag Tag id or name.
- * @return array|false An array of object ids or false on error.
- * @throws \Exception
- */
- public function getIdsForTag($tag) {
- $result = null;
- $tagId = false;
- if(is_numeric($tag)) {
- $tagId = $tag;
- } elseif(is_string($tag)) {
- $tag = trim($tag);
- if($tag === '') {
- \OCP\Util::writeLog('core', __METHOD__.', Cannot use empty tag names', \OCP\Util::DEBUG);
- return false;
- }
- $tagId = $this->getTagId($tag);
- }
-
- if($tagId === false) {
- $l10n = \OC::$server->getL10N('core');
- throw new \Exception(
- $l10n->t('Could not find category "%s"', $tag)
- );
- }
-
- $ids = array();
- $sql = 'SELECT `objid` FROM `' . self::RELATION_TABLE
- . '` WHERE `categoryid` = ?';
-
- try {
- $stmt = \OCP\DB::prepare($sql);
- $result = $stmt->execute(array($tagId));
- if (\OCP\DB::isError($result)) {
- \OCP\Util::writeLog('core', __METHOD__. 'DB error: ' . \OCP\DB::getErrorMessage(), \OCP\Util::ERROR);
- return false;
- }
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- return false;
- }
-
- if(!is_null($result)) {
- while( $row = $result->fetchRow()) {
- $id = (int)$row['objid'];
-
- if ($this->includeShared) {
- // We have to check if we are really allowed to access the
- // items that are tagged with $tag. To that end, we ask the
- // corresponding sharing backend if the item identified by $id
- // is owned by any of $this->owners.
- foreach ($this->owners as $owner) {
- if ($this->backend->isValidSource($id, $owner)) {
- $ids[] = $id;
- break;
- }
- }
- } else {
- $ids[] = $id;
- }
- }
- }
-
- return $ids;
- }
-
- /**
- * Checks whether a tag is saved for the given user,
- * disregarding the ones shared with him or her.
- *
- * @param string $name The tag name to check for.
- * @param string $user The user whose tags are to be checked.
- * @return bool
- */
- public function userHasTag($name, $user) {
- $key = $this->array_searchi($name, $this->getTagsForUser($user));
- return ($key !== false) ? $this->tags[$key]->getId() : false;
- }
-
- /**
- * Checks whether a tag is saved for or shared with the current user.
- *
- * @param string $name The tag name to check for.
- * @return bool
- */
- public function hasTag($name) {
- return $this->getTagId($name) !== false;
- }
-
- /**
- * Add a new tag.
- *
- * @param string $name A string with a name of the tag
- * @return false|int the id of the added tag or false on error.
- */
- public function add($name) {
- $name = trim($name);
-
- if($name === '') {
- \OCP\Util::writeLog('core', __METHOD__.', Cannot add an empty tag', \OCP\Util::DEBUG);
- return false;
- }
- if($this->userHasTag($name, $this->user)) {
- \OCP\Util::writeLog('core', __METHOD__.', name: ' . $name. ' exists already', \OCP\Util::DEBUG);
- return false;
- }
- try {
- $tag = new Tag($this->user, $this->type, $name);
- $tag = $this->mapper->insert($tag);
- $this->tags[] = $tag;
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- return false;
- }
- \OCP\Util::writeLog('core', __METHOD__.', id: ' . $tag->getId(), \OCP\Util::DEBUG);
- return $tag->getId();
- }
-
- /**
- * Rename tag.
- *
- * @param string|integer $from The name or ID of the existing tag
- * @param string $to The new name of the tag.
- * @return bool
- */
- public function rename($from, $to) {
- $from = trim($from);
- $to = trim($to);
-
- if($to === '' || $from === '') {
- \OCP\Util::writeLog('core', __METHOD__.', Cannot use empty tag names', \OCP\Util::DEBUG);
- return false;
- }
-
- if (is_numeric($from)) {
- $key = $this->getTagById($from);
- } else {
- $key = $this->getTagByName($from);
- }
- if($key === false) {
- \OCP\Util::writeLog('core', __METHOD__.', tag: ' . $from. ' does not exist', \OCP\Util::DEBUG);
- return false;
- }
- $tag = $this->tags[$key];
-
- if($this->userHasTag($to, $tag->getOwner())) {
- \OCP\Util::writeLog('core', __METHOD__.', A tag named ' . $to. ' already exists for user ' . $tag->getOwner() . '.', \OCP\Util::DEBUG);
- return false;
- }
-
- try {
- $tag->setName($to);
- $this->tags[$key] = $this->mapper->update($tag);
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- return false;
- }
- return true;
- }
-
- /**
- * Add a list of new tags.
- *
- * @param string[] $names A string with a name or an array of strings containing
- * the name(s) of the tag(s) to add.
- * @param bool $sync When true, save the tags
- * @param int|null $id int Optional object id to add to this|these tag(s)
- * @return bool Returns false on error.
- */
- public function addMultiple($names, $sync=false, $id = null) {
- if(!is_array($names)) {
- $names = array($names);
- }
- $names = array_map('trim', $names);
- array_filter($names);
-
- $newones = array();
- foreach($names as $name) {
- if(!$this->hasTag($name) && $name !== '') {
- $newones[] = new Tag($this->user, $this->type, $name);
- }
- if(!is_null($id) ) {
- // Insert $objectid, $categoryid pairs if not exist.
- self::$relations[] = array('objid' => $id, 'tag' => $name);
- }
- }
- $this->tags = array_merge($this->tags, $newones);
- if($sync === true) {
- $this->save();
- }
-
- return true;
- }
-
- /**
- * Save the list of tags and their object relations
- */
- protected function save() {
- if(is_array($this->tags)) {
- foreach($this->tags as $tag) {
- try {
- if (!$this->mapper->tagExists($tag)) {
- $this->mapper->insert($tag);
- }
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- }
- }
-
- // reload tags to get the proper ids.
- $this->tags = $this->mapper->loadTags($this->owners, $this->type);
- \OCP\Util::writeLog('core', __METHOD__.', tags: ' . print_r($this->tags, true),
- \OCP\Util::DEBUG);
- // Loop through temporarily cached objectid/tagname pairs
- // and save relations.
- $tags = $this->tags;
- // For some reason this is needed or array_search(i) will return 0..?
- ksort($tags);
- foreach(self::$relations as $relation) {
- $tagId = $this->getTagId($relation['tag']);
- \OCP\Util::writeLog('core', __METHOD__ . 'catid, ' . $relation['tag'] . ' ' . $tagId, \OCP\Util::DEBUG);
- if($tagId) {
- try {
- \OCP\DB::insertIfNotExist(self::RELATION_TABLE,
- array(
- 'objid' => $relation['objid'],
- 'categoryid' => $tagId,
- 'type' => $this->type,
- ));
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- }
- }
- }
- self::$relations = array(); // reset
- } else {
- \OCP\Util::writeLog('core', __METHOD__.', $this->tags is not an array! '
- . print_r($this->tags, true), \OCP\Util::ERROR);
- }
- }
-
- /**
- * Delete tags and tag/object relations for a user.
- *
- * For hooking up on post_deleteUser
- *
- * @param array $arguments
- */
- public static function post_deleteUser($arguments) {
- // Find all objectid/tagId pairs.
- $result = null;
- try {
- $stmt = \OCP\DB::prepare('SELECT `id` FROM `' . self::TAG_TABLE . '` '
- . 'WHERE `uid` = ?');
- $result = $stmt->execute(array($arguments['uid']));
- if (\OCP\DB::isError($result)) {
- \OCP\Util::writeLog('core', __METHOD__. 'DB error: ' . \OCP\DB::getErrorMessage(), \OCP\Util::ERROR);
- }
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- }
-
- if(!is_null($result)) {
- try {
- $stmt = \OCP\DB::prepare('DELETE FROM `' . self::RELATION_TABLE . '` '
- . 'WHERE `categoryid` = ?');
- while( $row = $result->fetchRow()) {
- try {
- $stmt->execute(array($row['id']));
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- }
- }
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- }
- }
- try {
- $stmt = \OCP\DB::prepare('DELETE FROM `' . self::TAG_TABLE . '` '
- . 'WHERE `uid` = ?');
- $result = $stmt->execute(array($arguments['uid']));
- if (\OCP\DB::isError($result)) {
- \OCP\Util::writeLog('core', __METHOD__. ', DB error: ' . \OCP\DB::getErrorMessage(), \OCP\Util::ERROR);
- }
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__ . ', exception: '
- . $e->getMessage(), \OCP\Util::ERROR);
- }
- }
-
- /**
- * Delete tag/object relations from the db
- *
- * @param array $ids The ids of the objects
- * @return boolean Returns false on error.
- */
- public function purgeObjects(array $ids) {
- if(count($ids) === 0) {
- // job done ;)
- return true;
- }
- $updates = $ids;
- try {
- $query = 'DELETE FROM `' . self::RELATION_TABLE . '` ';
- $query .= 'WHERE `objid` IN (' . str_repeat('?,', count($ids)-1) . '?) ';
- $query .= 'AND `type`= ?';
- $updates[] = $this->type;
- $stmt = \OCP\DB::prepare($query);
- $result = $stmt->execute($updates);
- if (\OCP\DB::isError($result)) {
- \OCP\Util::writeLog('core', __METHOD__. 'DB error: ' . \OCP\DB::getErrorMessage(), \OCP\Util::ERROR);
- return false;
- }
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: ' . $e->getMessage(),
- \OCP\Util::ERROR);
- return false;
- }
- return true;
- }
-
- /**
- * Get favorites for an object type
- *
- * @return array|false An array of object ids.
- */
- public function getFavorites() {
- try {
- return $this->getIdsForTag(self::TAG_FAVORITE);
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: ' . $e->getMessage(),
- \OCP\Util::DEBUG);
- return array();
- }
- }
-
- /**
- * Add an object to favorites
- *
- * @param int $objid The id of the object
- * @return boolean
- */
- public function addToFavorites($objid) {
- if(!$this->userHasTag(self::TAG_FAVORITE, $this->user)) {
- $this->add(self::TAG_FAVORITE);
- }
- return $this->tagAs($objid, self::TAG_FAVORITE);
- }
-
- /**
- * Remove an object from favorites
- *
- * @param int $objid The id of the object
- * @return boolean
- */
- public function removeFromFavorites($objid) {
- return $this->unTag($objid, self::TAG_FAVORITE);
- }
-
- /**
- * Creates a tag/object relation.
- *
- * @param int $objid The id of the object
- * @param string $tag The id or name of the tag
- * @return boolean Returns false on error.
- */
- public function tagAs($objid, $tag) {
- if(is_string($tag) && !is_numeric($tag)) {
- $tag = trim($tag);
- if($tag === '') {
- \OCP\Util::writeLog('core', __METHOD__.', Cannot add an empty tag', \OCP\Util::DEBUG);
- return false;
- }
- if(!$this->hasTag($tag)) {
- $this->add($tag);
- }
- $tagId = $this->getTagId($tag);
- } else {
- $tagId = $tag;
- }
- try {
- \OCP\DB::insertIfNotExist(self::RELATION_TABLE,
- array(
- 'objid' => $objid,
- 'categoryid' => $tagId,
- 'type' => $this->type,
- ));
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- return false;
- }
- return true;
- }
-
- /**
- * Delete single tag/object relation from the db
- *
- * @param int $objid The id of the object
- * @param string $tag The id or name of the tag
- * @return boolean
- */
- public function unTag($objid, $tag) {
- if(is_string($tag) && !is_numeric($tag)) {
- $tag = trim($tag);
- if($tag === '') {
- \OCP\Util::writeLog('core', __METHOD__.', Tag name is empty', \OCP\Util::DEBUG);
- return false;
- }
- $tagId = $this->getTagId($tag);
- } else {
- $tagId = $tag;
- }
-
- try {
- $sql = 'DELETE FROM `' . self::RELATION_TABLE . '` '
- . 'WHERE `objid` = ? AND `categoryid` = ? AND `type` = ?';
- $stmt = \OCP\DB::prepare($sql);
- $stmt->execute(array($objid, $tagId, $this->type));
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- return false;
- }
- return true;
- }
-
- /**
- * Delete tags from the database.
- *
- * @param string[]|integer[] $names An array of tags (names or IDs) to delete
- * @return bool Returns false on error
- */
- public function delete($names) {
- if(!is_array($names)) {
- $names = array($names);
- }
-
- $names = array_map('trim', $names);
- array_filter($names);
-
- \OCP\Util::writeLog('core', __METHOD__ . ', before: '
- . print_r($this->tags, true), \OCP\Util::DEBUG);
- foreach($names as $name) {
- $id = null;
-
- if (is_numeric($name)) {
- $key = $this->getTagById($name);
- } else {
- $key = $this->getTagByName($name);
- }
- if ($key !== false) {
- $tag = $this->tags[$key];
- $id = $tag->getId();
- unset($this->tags[$key]);
- $this->mapper->delete($tag);
- } else {
- \OCP\Util::writeLog('core', __METHOD__ . 'Cannot delete tag ' . $name
- . ': not found.', \OCP\Util::ERROR);
- }
- if(!is_null($id) && $id !== false) {
- try {
- $sql = 'DELETE FROM `' . self::RELATION_TABLE . '` '
- . 'WHERE `categoryid` = ?';
- $stmt = \OCP\DB::prepare($sql);
- $result = $stmt->execute(array($id));
- if (\OCP\DB::isError($result)) {
- \OCP\Util::writeLog('core',
- __METHOD__. 'DB error: ' . \OCP\DB::getErrorMessage(),
- \OCP\Util::ERROR);
- return false;
- }
- } catch(\Exception $e) {
- \OCP\Util::writeLog('core', __METHOD__.', exception: '.$e->getMessage(),
- \OCP\Util::ERROR);
- return false;
- }
- }
- }
- return true;
- }
-
- // case-insensitive array_search
- protected function array_searchi($needle, $haystack, $mem='getName') {
- if(!is_array($haystack)) {
- return false;
- }
- return array_search(strtolower($needle), array_map(
- function($tag) use($mem) {
- return strtolower(call_user_func(array($tag, $mem)));
- }, $haystack)
- );
- }
-
- /**
- * Get a tag's ID.
- *
- * @param string $name The tag name to look for.
- * @return string|bool The tag's id or false if no matching tag is found.
- */
- private function getTagId($name) {
- $key = $this->array_searchi($name, $this->tags);
- if ($key !== false) {
- return $this->tags[$key]->getId();
- }
- return false;
- }
-
- /**
- * Get a tag by its name.
- *
- * @param string $name The tag name.
- * @return integer|bool The tag object's offset within the $this->tags
- * array or false if it doesn't exist.
- */
- private function getTagByName($name) {
- return $this->array_searchi($name, $this->tags, 'getName');
- }
-
- /**
- * Get a tag by its ID.
- *
- * @param string $id The tag ID to look for.
- * @return integer|bool The tag object's offset within the $this->tags
- * array or false if it doesn't exist.
- */
- private function getTagById($id) {
- return $this->array_searchi($id, $this->tags, 'getId');
- }
-
- /**
- * Returns an array mapping a given tag's properties to its values:
- * ['id' => 0, 'name' = 'Tag', 'owner' = 'User', 'type' => 'tagtype']
- *
- * @param Tag $tag The tag that is going to be mapped
- * @return array
- */
- private function tagMap(Tag $tag) {
- return array(
- 'id' => $tag->getId(),
- 'name' => $tag->getName(),
- 'owner' => $tag->getOwner(),
- 'type' => $tag->getType()
- );
- }
- }
|