annotate core/modules/taxonomy/taxonomy.module @ 14:1fec387a4317

Update Drupal core to 8.5.2 via Composer
author Chris Cannam
date Mon, 23 Apr 2018 09:46:53 +0100
parents 4c8ae668cc8c
children c2387f117808
rev   line source
Chris@0 1 <?php
Chris@0 2
Chris@0 3 /**
Chris@0 4 * @file
Chris@0 5 * Enables the organization of content into categories.
Chris@0 6 */
Chris@0 7
Chris@0 8 use Drupal\Component\Utility\Tags;
Chris@0 9 use Drupal\Component\Utility\Unicode;
Chris@0 10 use Drupal\Core\Entity\EntityInterface;
Chris@0 11 use Drupal\Core\Entity\Sql\SqlContentEntityStorage;
Chris@0 12 use Drupal\Core\Render\Element;
Chris@0 13 use Drupal\Core\Routing\RouteMatchInterface;
Chris@0 14 use Drupal\Core\Url;
Chris@0 15 use Drupal\taxonomy\Entity\Term;
Chris@0 16 use Drupal\taxonomy\Entity\Vocabulary;
Chris@0 17 use Drupal\taxonomy\TermInterface;
Chris@0 18 use Drupal\taxonomy\VocabularyInterface;
Chris@0 19
Chris@0 20 /**
Chris@0 21 * Denotes that no term in the vocabulary has a parent.
Chris@0 22 *
Chris@0 23 * @deprecated in Drupal 8.2.x and will be removed before 9.0.0. Use
Chris@0 24 * \Drupal\taxonomy\VocabularyInterface::HIERARCHY_DISABLED instead.
Chris@0 25 *
Chris@0 26 * @see https://www.drupal.org/node/2807795
Chris@0 27 */
Chris@0 28 const TAXONOMY_HIERARCHY_DISABLED = 0;
Chris@0 29
Chris@0 30 /**
Chris@0 31 * Denotes that one or more terms in the vocabulary has a single parent.
Chris@0 32 *
Chris@0 33 * @deprecated in Drupal 8.2.x and will be removed before 9.0.0. Use
Chris@0 34 * \Drupal\taxonomy\VocabularyInterface::HIERARCHY_SINGLE instead.
Chris@0 35 *
Chris@0 36 * @see https://www.drupal.org/node/2807795
Chris@0 37 */
Chris@0 38 const TAXONOMY_HIERARCHY_SINGLE = 1;
Chris@0 39
Chris@0 40 /**
Chris@0 41 * Denotes that one or more terms in the vocabulary have multiple parents.
Chris@0 42 *
Chris@0 43 * @deprecated in Drupal 8.2.x and will be removed before 9.0.0. Use
Chris@0 44 * \Drupal\taxonomy\VocabularyInterface::HIERARCHY_MULTIPLE instead.
Chris@0 45 *
Chris@0 46 * @see https://www.drupal.org/node/2807795
Chris@0 47 */
Chris@0 48 const TAXONOMY_HIERARCHY_MULTIPLE = 2;
Chris@0 49
Chris@0 50 /**
Chris@0 51 * Implements hook_help().
Chris@0 52 */
Chris@0 53 function taxonomy_help($route_name, RouteMatchInterface $route_match) {
Chris@0 54 switch ($route_name) {
Chris@0 55 case 'help.page.taxonomy':
Chris@0 56 $field_ui_url = \Drupal::moduleHandler()->moduleExists('field_ui') ? \Drupal::url('help.page', ['name' => 'field_ui']) : '#';
Chris@0 57 $output = '';
Chris@0 58 $output .= '<h3>' . t('About') . '</h3>';
Chris@0 59 $output .= '<p>' . t('The Taxonomy module allows users who have permission to create and edit content to categorize (tag) content of that type. Users who have the <em>Administer vocabularies and terms</em> <a href=":permissions" title="Taxonomy module permissions">permission</a> can add <em>vocabularies</em> that contain a set of related <em>terms</em>. The terms in a vocabulary can either be pre-set by an administrator or built gradually as content is added and edited. Terms may be organized hierarchically if desired.', [':permissions' => \Drupal::url('user.admin_permissions', [], ['fragment' => 'module-taxonomy'])]) . '</p>';
Chris@0 60 $output .= '<p>' . t('For more information, see the <a href=":taxonomy">online documentation for the Taxonomy module</a>.', [':taxonomy' => 'https://www.drupal.org/documentation/modules/taxonomy/']) . '</p>';
Chris@0 61 $output .= '<h3>' . t('Uses') . '</h3>';
Chris@0 62 $output .= '<dl>';
Chris@0 63 $output .= '<dt>' . t('Managing vocabularies') . '</dt>';
Chris@0 64 $output .= '<dd>' . t('Users who have the <em>Administer vocabularies and terms</em> permission can add and edit vocabularies from the <a href=":taxonomy_admin">Taxonomy administration page</a>. Vocabularies can be deleted from their <em>Edit vocabulary</em> page. Users with the <em>Taxonomy term: Administer fields</em> permission may add additional fields for terms in that vocabulary using the <a href=":field_ui">Field UI module</a>.', [':taxonomy_admin' => \Drupal::url('entity.taxonomy_vocabulary.collection'), ':field_ui' => $field_ui_url]) . '</dd>';
Chris@0 65 $output .= '<dt>' . t('Managing terms') . '</dt>';
Chris@0 66 $output .= '<dd>' . t('Users who have the <em>Administer vocabularies and terms</em> permission or the <em>Edit terms</em> permission for a particular vocabulary can add, edit, and organize the terms in a vocabulary from a vocabulary\'s term listing page, which can be accessed by going to the <a href=":taxonomy_admin">Taxonomy administration page</a> and clicking <em>List terms</em> in the <em>Operations</em> column. Users must have the <em>Administer vocabularies and terms</em> permission or the <em>Delete terms</em> permission for a particular vocabulary to delete terms.', [':taxonomy_admin' => \Drupal::url('entity.taxonomy_vocabulary.collection')]) . ' </dd>';
Chris@0 67 $output .= '<dt>' . t('Classifying entity content') . '</dt>';
Chris@0 68 $output .= '<dd>' . t('A user with the <em>Administer fields</em> permission for a certain entity type may add <em>Taxonomy term</em> reference fields to the entity type, which will allow entities to be classified using taxonomy terms. See the <a href=":entity_reference">Entity Reference help</a> for more information about reference fields. See the <a href=":field">Field module help</a> and the <a href=":field_ui">Field UI help</a> pages for general information on fields and how to create and manage them.', [':field_ui' => $field_ui_url, ':field' => \Drupal::url('help.page', ['name' => 'field']), ':entity_reference' => \Drupal::url('help.page', ['name' => 'entity_reference'])]) . '</dd>';
Chris@0 69 $output .= '<dt>' . t('Adding new terms during content creation') . '</dt>';
Chris@0 70 $output .= '<dd>' . t("Allowing users to add new terms gradually builds a vocabulary as content is added and edited. Users can add new terms if either of the two <em>Autocomplete</em> widgets is chosen for the Taxonomy term reference field in the <em>Manage form display</em> page for the field. You will also need to enable the <em>Create referenced entities if they don't already exist</em> option, and restrict the field to one vocabulary.") . '</dd>';
Chris@0 71 $output .= '<dt>' . t('Configuring displays and form displays') . '</dt>';
Chris@0 72 $output .= '<dd>' . t('See the <a href=":entity_reference">Entity Reference help</a> page for the field widgets and formatters that can be configured for any reference field on the <em>Manage display</em> and <em>Manage form display</em> pages. Taxonomy additionally provides an <em>RSS category</em> formatter that displays nothing when the entity item is displayed as HTML, but displays an RSS category instead of a list when the entity item is displayed in an RSS feed.', [':entity_reference' => \Drupal::url('help.page', ['name' => 'entity_reference'])]) . '</li>';
Chris@0 73 $output .= '</ul>';
Chris@0 74 $output .= '</dd>';
Chris@0 75 $output .= '</dl>';
Chris@0 76 return $output;
Chris@0 77
Chris@0 78 case 'entity.taxonomy_vocabulary.collection':
Chris@0 79 $output = '<p>' . t('Taxonomy is for categorizing content. Terms are grouped into vocabularies. For example, a vocabulary called "Fruit" would contain the terms "Apple" and "Banana".') . '</p>';
Chris@0 80 return $output;
Chris@0 81
Chris@0 82 case 'entity.taxonomy_vocabulary.overview_form':
Chris@0 83 $vocabulary = $route_match->getParameter('taxonomy_vocabulary');
Chris@14 84 if (\Drupal::currentUser()->hasPermission('administer taxonomy') || \Drupal::currentUser()->hasPermission('edit terms in ' . $vocabulary->id())) {
Chris@14 85 switch ($vocabulary->getHierarchy()) {
Chris@14 86 case VocabularyInterface::HIERARCHY_DISABLED:
Chris@14 87 return '<p>' . t('You can reorganize the terms in %capital_name using their drag-and-drop handles, and group terms under a parent term by sliding them under and to the right of the parent.', ['%capital_name' => Unicode::ucfirst($vocabulary->label()), '%name' => $vocabulary->label()]) . '</p>';
Chris@14 88 case VocabularyInterface::HIERARCHY_SINGLE:
Chris@14 89 return '<p>' . t('%capital_name contains terms grouped under parent terms. You can reorganize the terms in %capital_name using their drag-and-drop handles.', ['%capital_name' => Unicode::ucfirst($vocabulary->label()), '%name' => $vocabulary->label()]) . '</p>';
Chris@14 90 case VocabularyInterface::HIERARCHY_MULTIPLE:
Chris@14 91 return '<p>' . t('%capital_name contains terms with multiple parents. Drag and drop of terms with multiple parents is not supported, but you can re-enable drag-and-drop support by editing each term to include only a single parent.', ['%capital_name' => Unicode::ucfirst($vocabulary->label())]) . '</p>';
Chris@14 92 }
Chris@14 93 }
Chris@14 94 else {
Chris@14 95 switch ($vocabulary->getHierarchy()) {
Chris@14 96 case VocabularyInterface::HIERARCHY_DISABLED:
Chris@14 97 return '<p>' . t('%capital_name contains the following terms.', ['%capital_name' => Unicode::ucfirst($vocabulary->label())]) . '</p>';
Chris@14 98 case VocabularyInterface::HIERARCHY_SINGLE:
Chris@14 99 return '<p>' . t('%capital_name contains terms grouped under parent terms', ['%capital_name' => Unicode::ucfirst($vocabulary->label())]) . '</p>';
Chris@14 100 case VocabularyInterface::HIERARCHY_MULTIPLE:
Chris@14 101 return '<p>' . t('%capital_name contains terms with multiple parents.', ['%capital_name' => Unicode::ucfirst($vocabulary->label())]) . '</p>';
Chris@14 102 }
Chris@0 103 }
Chris@0 104 }
Chris@0 105 }
Chris@0 106
Chris@0 107 /**
Chris@0 108 * Entity URI callback.
Chris@0 109 */
Chris@0 110 function taxonomy_term_uri($term) {
Chris@0 111 return new Url('entity.taxonomy_term.canonical', [
Chris@0 112 'taxonomy_term' => $term->id(),
Chris@0 113 ]);
Chris@0 114 }
Chris@0 115
Chris@0 116 /**
Chris@0 117 * Implements hook_page_attachments_alter().
Chris@0 118 */
Chris@0 119 function taxonomy_page_attachments_alter(array &$page) {
Chris@0 120 $route_match = \Drupal::routeMatch();
Chris@0 121 if ($route_match->getRouteName() == 'entity.taxonomy_term.canonical' && ($term = $route_match->getParameter('taxonomy_term')) && $term instanceof TermInterface) {
Chris@0 122 foreach ($term->uriRelationships() as $rel) {
Chris@0 123 // Set the URI relationships, like canonical.
Chris@0 124 $page['#attached']['html_head_link'][] = [
Chris@0 125 [
Chris@0 126 'rel' => $rel,
Chris@0 127 'href' => $term->url($rel),
Chris@0 128 ],
Chris@0 129 TRUE,
Chris@0 130 ];
Chris@0 131
Chris@0 132 // Set the term path as the canonical URL to prevent duplicate content.
Chris@0 133 if ($rel == 'canonical') {
Chris@0 134 // Set the non-aliased canonical path as a default shortlink.
Chris@0 135 $page['#attached']['html_head_link'][] = [
Chris@0 136 [
Chris@0 137 'rel' => 'shortlink',
Chris@0 138 'href' => $term->url($rel, ['alias' => TRUE]),
Chris@0 139 ],
Chris@0 140 TRUE,
Chris@0 141 ];
Chris@0 142 }
Chris@0 143 }
Chris@0 144 }
Chris@0 145 }
Chris@0 146
Chris@0 147 /**
Chris@0 148 * Implements hook_theme().
Chris@0 149 */
Chris@0 150 function taxonomy_theme() {
Chris@0 151 return [
Chris@0 152 'taxonomy_term' => [
Chris@0 153 'render element' => 'elements',
Chris@0 154 ],
Chris@0 155 ];
Chris@0 156 }
Chris@0 157
Chris@0 158 /**
Chris@0 159 * Checks and updates the hierarchy flag of a vocabulary.
Chris@0 160 *
Chris@0 161 * Checks the current parents of all terms in a vocabulary and updates the
Chris@0 162 * vocabulary's hierarchy setting to the lowest possible level. If no term
Chris@0 163 * has parent terms then the vocabulary will be given a hierarchy of
Chris@0 164 * VocabularyInterface::HIERARCHY_DISABLED. If any term has a single parent then
Chris@0 165 * the vocabulary will be given a hierarchy of
Chris@0 166 * VocabularyInterface::HIERARCHY_SINGLE. If any term has multiple parents then
Chris@0 167 * the vocabulary will be given a hierarchy of
Chris@0 168 * VocabularyInterface::HIERARCHY_MULTIPLE.
Chris@0 169 *
Chris@0 170 * @param \Drupal\taxonomy\VocabularyInterface $vocabulary
Chris@0 171 * A taxonomy vocabulary entity.
Chris@0 172 * @param $changed_term
Chris@0 173 * An array of the term structure that was updated.
Chris@0 174 *
Chris@0 175 * @return
Chris@0 176 * An integer that represents the level of the vocabulary's hierarchy.
Chris@0 177 */
Chris@0 178 function taxonomy_check_vocabulary_hierarchy(VocabularyInterface $vocabulary, $changed_term) {
Chris@0 179 $tree = \Drupal::entityManager()->getStorage('taxonomy_term')->loadTree($vocabulary->id());
Chris@0 180 $hierarchy = VocabularyInterface::HIERARCHY_DISABLED;
Chris@0 181 foreach ($tree as $term) {
Chris@0 182 // Update the changed term with the new parent value before comparison.
Chris@0 183 if ($term->tid == $changed_term['tid']) {
Chris@0 184 $term = (object) $changed_term;
Chris@0 185 $term->parents = $term->parent;
Chris@0 186 }
Chris@0 187 // Check this term's parent count.
Chris@0 188 if (count($term->parents) > 1) {
Chris@0 189 $hierarchy = VocabularyInterface::HIERARCHY_MULTIPLE;
Chris@0 190 break;
Chris@0 191 }
Chris@0 192 elseif (count($term->parents) == 1 && !isset($term->parents[0])) {
Chris@0 193 $hierarchy = VocabularyInterface::HIERARCHY_SINGLE;
Chris@0 194 }
Chris@0 195 }
Chris@0 196 if ($hierarchy != $vocabulary->getHierarchy()) {
Chris@0 197 $vocabulary->setHierarchy($hierarchy);
Chris@0 198 $vocabulary->save();
Chris@0 199 }
Chris@0 200
Chris@0 201 return $hierarchy;
Chris@0 202 }
Chris@0 203
Chris@0 204 /**
Chris@0 205 * Generates an array which displays a term detail page.
Chris@0 206 *
Chris@0 207 * @param \Drupal\taxonomy\Entity\Term $term
Chris@0 208 * A taxonomy term object.
Chris@0 209 * @param string $view_mode
Chris@0 210 * View mode; e.g., 'full', 'teaser', etc.
Chris@0 211 * @param string $langcode
Chris@0 212 * (optional) A language code to use for rendering. Defaults to the global
Chris@0 213 * content language of the current request.
Chris@0 214 *
Chris@0 215 * @return array
Chris@0 216 * A $page element suitable for use by drupal_render().
Chris@0 217 */
Chris@0 218 function taxonomy_term_view(Term $term, $view_mode = 'full', $langcode = NULL) {
Chris@0 219 return entity_view($term, $view_mode, $langcode);
Chris@0 220 }
Chris@0 221
Chris@0 222 /**
Chris@0 223 * Constructs a drupal_render() style array from an array of loaded terms.
Chris@0 224 *
Chris@0 225 * @param array $terms
Chris@0 226 * An array of taxonomy terms as returned by Term::loadMultiple().
Chris@0 227 * @param string $view_mode
Chris@0 228 * View mode; e.g., 'full', 'teaser', etc.
Chris@0 229 * @param string $langcode
Chris@0 230 * (optional) A language code to use for rendering. Defaults to the global
Chris@0 231 * content language of the current request.
Chris@0 232 *
Chris@0 233 * @return array
Chris@0 234 * An array in the format expected by drupal_render().
Chris@0 235 */
Chris@0 236 function taxonomy_term_view_multiple(array $terms, $view_mode = 'full', $langcode = NULL) {
Chris@0 237 return entity_view_multiple($terms, $view_mode, $langcode);
Chris@0 238 }
Chris@0 239
Chris@0 240 /**
Chris@0 241 * Implements hook_theme_suggestions_HOOK().
Chris@0 242 */
Chris@0 243 function taxonomy_theme_suggestions_taxonomy_term(array $variables) {
Chris@0 244 $suggestions = [];
Chris@0 245
Chris@0 246 /** @var \Drupal\taxonomy\TermInterface $term */
Chris@0 247 $term = $variables['elements']['#taxonomy_term'];
Chris@0 248
Chris@0 249 $suggestions[] = 'taxonomy_term__' . $term->bundle();
Chris@0 250 $suggestions[] = 'taxonomy_term__' . $term->id();
Chris@0 251
Chris@0 252 return $suggestions;
Chris@0 253 }
Chris@0 254
Chris@0 255 /**
Chris@0 256 * Prepares variables for taxonomy term templates.
Chris@0 257 *
Chris@0 258 * Default template: taxonomy-term.html.twig.
Chris@0 259 *
Chris@0 260 * @param array $variables
Chris@0 261 * An associative array containing:
Chris@0 262 * - elements: An associative array containing the taxonomy term and any
Chris@0 263 * fields attached to the term. Properties used:
Chris@0 264 * - #taxonomy_term: A \Drupal\taxonomy\TermInterface object.
Chris@0 265 * - #view_mode: The current view mode for this taxonomy term, e.g.
Chris@0 266 * 'full' or 'teaser'.
Chris@0 267 * - attributes: HTML attributes for the containing element.
Chris@0 268 */
Chris@0 269 function template_preprocess_taxonomy_term(&$variables) {
Chris@0 270 $variables['view_mode'] = $variables['elements']['#view_mode'];
Chris@0 271 $variables['term'] = $variables['elements']['#taxonomy_term'];
Chris@0 272 /** @var \Drupal\taxonomy\TermInterface $term */
Chris@0 273 $term = $variables['term'];
Chris@0 274
Chris@0 275 $variables['url'] = $term->url();
Chris@0 276 // We use name here because that is what appears in the UI.
Chris@0 277 $variables['name'] = $variables['elements']['name'];
Chris@0 278 unset($variables['elements']['name']);
Chris@0 279 $variables['page'] = $variables['view_mode'] == 'full' && taxonomy_term_is_page($term);
Chris@0 280
Chris@0 281 // Helpful $content variable for templates.
Chris@0 282 $variables['content'] = [];
Chris@0 283 foreach (Element::children($variables['elements']) as $key) {
Chris@0 284 $variables['content'][$key] = $variables['elements'][$key];
Chris@0 285 }
Chris@0 286 }
Chris@0 287
Chris@0 288 /**
Chris@0 289 * Returns whether the current page is the page of the passed-in term.
Chris@0 290 *
Chris@0 291 * @param \Drupal\taxonomy\Entity\Term $term
Chris@0 292 * A taxonomy term entity.
Chris@0 293 */
Chris@0 294 function taxonomy_term_is_page(Term $term) {
Chris@0 295 if (\Drupal::routeMatch()->getRouteName() == 'entity.taxonomy_term.canonical' && $page_term_id = \Drupal::routeMatch()->getRawParameter('taxonomy_term')) {
Chris@0 296 return $page_term_id == $term->id();
Chris@0 297 }
Chris@0 298 return FALSE;
Chris@0 299 }
Chris@0 300
Chris@0 301 /**
Chris@0 302 * Clear all static cache variables for terms.
Chris@0 303 */
Chris@0 304 function taxonomy_terms_static_reset() {
Chris@0 305 \Drupal::entityManager()->getStorage('taxonomy_term')->resetCache();
Chris@0 306 }
Chris@0 307
Chris@0 308 /**
Chris@0 309 * Clear all static cache variables for vocabularies.
Chris@0 310 *
Chris@0 311 * @param $ids
Chris@0 312 * An array of ids to reset in the entity cache.
Chris@0 313 */
Chris@0 314 function taxonomy_vocabulary_static_reset(array $ids = NULL) {
Chris@0 315 \Drupal::entityManager()->getStorage('taxonomy_vocabulary')->resetCache($ids);
Chris@0 316 }
Chris@0 317
Chris@0 318 /**
Chris@0 319 * Get names for all taxonomy vocabularies.
Chris@0 320 *
Chris@0 321 * @return array
Chris@0 322 * A list of existing vocabulary IDs.
Chris@0 323 */
Chris@0 324 function taxonomy_vocabulary_get_names() {
Chris@0 325 $names = &drupal_static(__FUNCTION__);
Chris@0 326
Chris@0 327 if (!isset($names)) {
Chris@0 328 $names = [];
Chris@0 329 $config_names = \Drupal::configFactory()->listAll('taxonomy.vocabulary.');
Chris@0 330 foreach ($config_names as $config_name) {
Chris@0 331 $id = substr($config_name, strlen('taxonomy.vocabulary.'));
Chris@0 332 $names[$id] = $id;
Chris@0 333 }
Chris@0 334 }
Chris@0 335
Chris@0 336 return $names;
Chris@0 337 }
Chris@0 338
Chris@0 339 /**
Chris@0 340 * Try to map a string to an existing term, as for glossary use.
Chris@0 341 *
Chris@0 342 * Provides a case-insensitive and trimmed mapping, to maximize the
Chris@0 343 * likelihood of a successful match.
Chris@0 344 *
Chris@0 345 * @param $name
Chris@0 346 * Name of the term to search for.
Chris@0 347 * @param $vocabulary
Chris@0 348 * (optional) Vocabulary machine name to limit the search. Defaults to NULL.
Chris@0 349 *
Chris@0 350 * @return
Chris@0 351 * An array of matching term objects.
Chris@0 352 */
Chris@0 353 function taxonomy_term_load_multiple_by_name($name, $vocabulary = NULL) {
Chris@0 354 $values = ['name' => trim($name)];
Chris@0 355 if (isset($vocabulary)) {
Chris@0 356 $vocabularies = taxonomy_vocabulary_get_names();
Chris@0 357 if (isset($vocabularies[$vocabulary])) {
Chris@0 358 $values['vid'] = $vocabulary;
Chris@0 359 }
Chris@0 360 else {
Chris@0 361 // Return an empty array when filtering by a non-existing vocabulary.
Chris@0 362 return [];
Chris@0 363 }
Chris@0 364 }
Chris@0 365 return entity_load_multiple_by_properties('taxonomy_term', $values);
Chris@0 366 }
Chris@0 367
Chris@0 368 /**
Chris@0 369 * Load multiple taxonomy terms based on certain conditions.
Chris@0 370 *
Chris@0 371 * This function should be used whenever you need to load more than one term
Chris@0 372 * from the database. Terms are loaded into memory and will not require
Chris@0 373 * database access if loaded again during the same page request.
Chris@0 374 *
Chris@0 375 * @see entity_load_multiple()
Chris@0 376 * @see \Drupal\Core\Entity\Query\EntityQueryInterface
Chris@0 377 *
Chris@0 378 * @deprecated in Drupal 8.x, will be removed before Drupal 9.0.
Chris@0 379 * Use \Drupal\taxonomy\Entity\Term::loadMultiple().
Chris@0 380 *
Chris@0 381 * @param array $tids
Chris@0 382 * (optional) An array of entity IDs. If omitted, all entities are loaded.
Chris@0 383 *
Chris@0 384 * @return array
Chris@0 385 * An array of taxonomy term entities, indexed by tid. When no results are
Chris@0 386 * found, an empty array is returned.
Chris@0 387 */
Chris@0 388 function taxonomy_term_load_multiple(array $tids = NULL) {
Chris@0 389 return Term::loadMultiple($tids);
Chris@0 390 }
Chris@0 391
Chris@0 392 /**
Chris@0 393 * Loads multiple taxonomy vocabularies based on certain conditions.
Chris@0 394 *
Chris@0 395 * This function should be used whenever you need to load more than one
Chris@0 396 * vocabulary from the database. Terms are loaded into memory and will not
Chris@0 397 * require database access if loaded again during the same page request.
Chris@0 398 *
Chris@0 399 * @see entity_load_multiple()
Chris@0 400 *
Chris@0 401 * @deprecated in Drupal 8.x, will be removed before Drupal 9.0.
Chris@0 402 * Use \Drupal\taxonomy\Entity\Vocabulary::loadMultiple().
Chris@0 403 *
Chris@0 404 * @param array $vids
Chris@0 405 * (optional) An array of entity IDs. If omitted, all entities are loaded.
Chris@0 406 *
Chris@0 407 * @return array
Chris@0 408 * An array of vocabulary objects, indexed by vid.
Chris@0 409 */
Chris@0 410 function taxonomy_vocabulary_load_multiple(array $vids = NULL) {
Chris@0 411 return Vocabulary::loadMultiple($vids);
Chris@0 412 }
Chris@0 413
Chris@0 414 /**
Chris@0 415 * Return the taxonomy vocabulary entity matching a vocabulary ID.
Chris@0 416 *
Chris@0 417 * @deprecated in Drupal 8.x, will be removed before Drupal 9.0.
Chris@0 418 * Use \Drupal\taxonomy\Entity\Vocabulary::load().
Chris@0 419 *
Chris@0 420 * @param int $vid
Chris@0 421 * The vocabulary's ID.
Chris@0 422 *
Chris@0 423 * @return \Drupal\taxonomy\Entity\Vocabulary|null
Chris@0 424 * The taxonomy vocabulary entity, if exists, NULL otherwise. Results are
Chris@0 425 * statically cached.
Chris@0 426 */
Chris@0 427 function taxonomy_vocabulary_load($vid) {
Chris@0 428 return Vocabulary::load($vid);
Chris@0 429 }
Chris@0 430
Chris@0 431 /**
Chris@0 432 * Return the taxonomy term entity matching a term ID.
Chris@0 433 *
Chris@0 434 * @deprecated in Drupal 8.x, will be removed before Drupal 9.0.
Chris@0 435 * Use \Drupal\taxonomy\Entity\Term::load().
Chris@0 436 *
Chris@0 437 * @param $tid
Chris@0 438 * A term's ID
Chris@0 439 *
Chris@0 440 * @return \Drupal\taxonomy\Entity\Term|null
Chris@0 441 * A taxonomy term entity, or NULL if the term was not found. Results are
Chris@0 442 * statically cached.
Chris@0 443 */
Chris@0 444 function taxonomy_term_load($tid) {
Chris@0 445 if (!is_numeric($tid)) {
Chris@0 446 return NULL;
Chris@0 447 }
Chris@0 448 return Term::load($tid);
Chris@0 449 }
Chris@0 450
Chris@0 451 /**
Chris@0 452 * Implodes a list of tags of a certain vocabulary into a string.
Chris@0 453 *
Chris@0 454 * @see \Drupal\Component\Utility\Tags::explode()
Chris@0 455 */
Chris@0 456 function taxonomy_implode_tags($tags, $vid = NULL) {
Chris@0 457 $typed_tags = [];
Chris@0 458 foreach ($tags as $tag) {
Chris@0 459 // Extract terms belonging to the vocabulary in question.
Chris@0 460 if (!isset($vid) || $tag->bundle() == $vid) {
Chris@0 461 // Make sure we have a completed loaded taxonomy term.
Chris@0 462 if ($tag instanceof EntityInterface && $label = $tag->label()) {
Chris@0 463 // Commas and quotes in tag names are special cases, so encode 'em.
Chris@0 464 $typed_tags[] = Tags::encode($label);
Chris@0 465 }
Chris@0 466 }
Chris@0 467 }
Chris@0 468 return implode(', ', $typed_tags);
Chris@0 469 }
Chris@0 470
Chris@0 471 /**
Chris@0 472 * Title callback for term pages.
Chris@0 473 *
Chris@0 474 * @param \Drupal\taxonomy\Entity\Term $term
Chris@0 475 * A taxonomy term entity.
Chris@0 476 *
Chris@0 477 * @return
Chris@0 478 * The term name to be used as the page title.
Chris@0 479 */
Chris@0 480 function taxonomy_term_title(Term $term) {
Chris@0 481 return $term->getName();
Chris@0 482 }
Chris@0 483
Chris@0 484 /**
Chris@0 485 * @defgroup taxonomy_index Taxonomy indexing
Chris@0 486 * @{
Chris@0 487 * Functions to maintain taxonomy indexing.
Chris@0 488 *
Chris@0 489 * Taxonomy uses default field storage to store canonical relationships
Chris@0 490 * between terms and fieldable entities. However its most common use case
Chris@0 491 * requires listing all content associated with a term or group of terms
Chris@0 492 * sorted by creation date. To avoid slow queries due to joining across
Chris@0 493 * multiple node and field tables with various conditions and order by criteria,
Chris@0 494 * we maintain a denormalized table with all relationships between terms,
Chris@0 495 * published nodes and common sort criteria such as status, sticky and created.
Chris@0 496 * When using other field storage engines or alternative methods of
Chris@0 497 * denormalizing this data you should set the
Chris@0 498 * taxonomy.settings:maintain_index_table to '0' to avoid unnecessary writes in
Chris@0 499 * SQL.
Chris@0 500 */
Chris@0 501
Chris@0 502 /**
Chris@0 503 * Implements hook_ENTITY_TYPE_insert() for node entities.
Chris@0 504 */
Chris@0 505 function taxonomy_node_insert(EntityInterface $node) {
Chris@0 506 // Add taxonomy index entries for the node.
Chris@0 507 taxonomy_build_node_index($node);
Chris@0 508 }
Chris@0 509
Chris@0 510 /**
Chris@0 511 * Builds and inserts taxonomy index entries for a given node.
Chris@0 512 *
Chris@0 513 * The index lists all terms that are related to a given node entity, and is
Chris@0 514 * therefore maintained at the entity level.
Chris@0 515 *
Chris@0 516 * @param \Drupal\node\Entity\Node $node
Chris@0 517 * The node entity.
Chris@0 518 */
Chris@0 519 function taxonomy_build_node_index($node) {
Chris@0 520 // We maintain a denormalized table of term/node relationships, containing
Chris@0 521 // only data for current, published nodes.
Chris@0 522 if (!\Drupal::config('taxonomy.settings')->get('maintain_index_table') || !(\Drupal::entityManager()->getStorage('node') instanceof SqlContentEntityStorage)) {
Chris@0 523 return;
Chris@0 524 }
Chris@0 525
Chris@0 526 $status = $node->isPublished();
Chris@0 527 $sticky = (int) $node->isSticky();
Chris@0 528 // We only maintain the taxonomy index for published nodes.
Chris@0 529 if ($status && $node->isDefaultRevision()) {
Chris@0 530 // Collect a unique list of all the term IDs from all node fields.
Chris@0 531 $tid_all = [];
Chris@0 532 $entity_reference_class = 'Drupal\Core\Field\Plugin\Field\FieldType\EntityReferenceItem';
Chris@0 533 foreach ($node->getFieldDefinitions() as $field) {
Chris@0 534 $field_name = $field->getName();
Chris@0 535 $class = $field->getItemDefinition()->getClass();
Chris@0 536 $is_entity_reference_class = ($class === $entity_reference_class) || is_subclass_of($class, $entity_reference_class);
Chris@0 537 if ($is_entity_reference_class && $field->getSetting('target_type') == 'taxonomy_term') {
Chris@0 538 foreach ($node->getTranslationLanguages() as $language) {
Chris@0 539 foreach ($node->getTranslation($language->getId())->$field_name as $item) {
Chris@0 540 if (!$item->isEmpty()) {
Chris@0 541 $tid_all[$item->target_id] = $item->target_id;
Chris@0 542 }
Chris@0 543 }
Chris@0 544 }
Chris@0 545 }
Chris@0 546 }
Chris@0 547 // Insert index entries for all the node's terms.
Chris@0 548 if (!empty($tid_all)) {
Chris@0 549 foreach ($tid_all as $tid) {
Chris@0 550 db_merge('taxonomy_index')
Chris@0 551 ->key(['nid' => $node->id(), 'tid' => $tid, 'status' => $node->isPublished()])
Chris@0 552 ->fields(['sticky' => $sticky, 'created' => $node->getCreatedTime()])
Chris@0 553 ->execute();
Chris@0 554 }
Chris@0 555 }
Chris@0 556 }
Chris@0 557 }
Chris@0 558
Chris@0 559 /**
Chris@0 560 * Implements hook_ENTITY_TYPE_update() for node entities.
Chris@0 561 */
Chris@0 562 function taxonomy_node_update(EntityInterface $node) {
Chris@0 563 // If we're not dealing with the default revision of the node, do not make any
Chris@0 564 // change to the taxonomy index.
Chris@0 565 if (!$node->isDefaultRevision()) {
Chris@0 566 return;
Chris@0 567 }
Chris@0 568 taxonomy_delete_node_index($node);
Chris@0 569 taxonomy_build_node_index($node);
Chris@0 570 }
Chris@0 571
Chris@0 572 /**
Chris@0 573 * Implements hook_ENTITY_TYPE_predelete() for node entities.
Chris@0 574 */
Chris@0 575 function taxonomy_node_predelete(EntityInterface $node) {
Chris@0 576 // Clean up the {taxonomy_index} table when nodes are deleted.
Chris@0 577 taxonomy_delete_node_index($node);
Chris@0 578 }
Chris@0 579
Chris@0 580 /**
Chris@0 581 * Deletes taxonomy index entries for a given node.
Chris@0 582 *
Chris@0 583 * @param \Drupal\Core\Entity\EntityInterface $node
Chris@0 584 * The node entity.
Chris@0 585 */
Chris@0 586 function taxonomy_delete_node_index(EntityInterface $node) {
Chris@0 587 if (\Drupal::config('taxonomy.settings')->get('maintain_index_table')) {
Chris@0 588 db_delete('taxonomy_index')->condition('nid', $node->id())->execute();
Chris@0 589 }
Chris@0 590 }
Chris@0 591
Chris@0 592 /**
Chris@0 593 * Implements hook_ENTITY_TYPE_delete() for taxonomy_term entities.
Chris@0 594 */
Chris@0 595 function taxonomy_taxonomy_term_delete(Term $term) {
Chris@0 596 if (\Drupal::config('taxonomy.settings')->get('maintain_index_table')) {
Chris@0 597 // Clean up the {taxonomy_index} table when terms are deleted.
Chris@0 598 db_delete('taxonomy_index')->condition('tid', $term->id())->execute();
Chris@0 599 }
Chris@0 600 }
Chris@0 601
Chris@0 602 /**
Chris@0 603 * @} End of "defgroup taxonomy_index".
Chris@0 604 */