function OverviewTerms::buildForm

Same name in other branches
  1. 9 core/modules/taxonomy/src/Form/OverviewTerms.php \Drupal\taxonomy\Form\OverviewTerms::buildForm()
  2. 8.9.x core/modules/taxonomy/src/Form/OverviewTerms.php \Drupal\taxonomy\Form\OverviewTerms::buildForm()
  3. 11.x core/modules/taxonomy/src/Form/OverviewTerms.php \Drupal\taxonomy\Form\OverviewTerms::buildForm()

Form constructor.

Display a tree of all the terms in a vocabulary, with options to edit each one. The form is made drag and drop by the theme function.

Parameters

array $form: An associative array containing the structure of the form.

\Drupal\Core\Form\FormStateInterface $form_state: The current state of the form.

\Drupal\taxonomy\VocabularyInterface $taxonomy_vocabulary: The vocabulary to display the overview form for.

Return value

array The form structure.

Overrides FormInterface::buildForm

1 call to OverviewTerms::buildForm()
Overview::buildForm in core/modules/forum/src/Form/Overview.php
Form constructor.
1 method overrides OverviewTerms::buildForm()
Overview::buildForm in core/modules/forum/src/Form/Overview.php
Form constructor.

File

core/modules/taxonomy/src/Form/OverviewTerms.php, line 133

Class

OverviewTerms
Provides terms overview form for a taxonomy vocabulary.

Namespace

Drupal\taxonomy\Form

Code

public function buildForm(array $form, FormStateInterface $form_state, ?VocabularyInterface $taxonomy_vocabulary = NULL) {
    $form_state->set([
        'taxonomy',
        'vocabulary',
    ], $taxonomy_vocabulary);
    $vocabulary_hierarchy = $this->storageController
        ->getVocabularyHierarchyType($taxonomy_vocabulary->id());
    $parent_fields = FALSE;
    $page = $this->pagerManager
        ->findPage();
    // Number of terms per page.
    $page_increment = $this->config('taxonomy.settings')
        ->get('terms_per_page_admin');
    // Elements shown on this page.
    $page_entries = 0;
    // Elements at the root level before this page.
    $before_entries = 0;
    // Elements at the root level after this page.
    $after_entries = 0;
    // Elements at the root level on this page.
    $root_entries = 0;
    // Terms from previous and next pages are shown if the term tree would have
    // been cut in the middle. Keep track of how many extra terms we show on
    // each page of terms.
    $back_step = NULL;
    $forward_step = 0;
    // An array of the terms to be displayed on this page.
    $current_page = [];
    $delta = 0;
    $term_deltas = [];
    // Terms are not loaded to avoid excessive memory consumption for large
    // vocabularies. Needed terms are loaded explicitly afterward.
    $tree = $this->storageController
        ->loadTree($taxonomy_vocabulary->id(), 0, NULL, FALSE);
    $tree_index = 0;
    $complete_tree = NULL;
    do {
        // In case this tree is completely empty.
        if (empty($tree[$tree_index])) {
            break;
        }
        $delta++;
        // Count entries before the current page.
        if ($page && $page * $page_increment > $before_entries && !isset($back_step)) {
            $before_entries++;
            continue;
        }
        elseif ($page_entries > $page_increment && isset($complete_tree)) {
            $after_entries++;
            continue;
        }
        // Do not let a term start the page that is not at the root.
        $raw_term = $tree[$tree_index];
        if (isset($raw_term->depth) && $raw_term->depth > 0 && !isset($back_step)) {
            $back_step = 0;
            while ($parent_term = $tree[--$tree_index]) {
                $before_entries--;
                $back_step++;
                if ($parent_term->depth == 0) {
                    $tree_index--;
                    // Jump back to the start of the root level parent.
                    continue 2;
                }
            }
        }
        $back_step = $back_step ?? 0;
        // Continue rendering the tree until we reach the a new root item.
        if ($page_entries >= $page_increment + $back_step + 1 && $raw_term->depth == 0 && $root_entries > 1) {
            $complete_tree = TRUE;
            // This new item at the root level is the first item on the next page.
            $after_entries++;
            continue;
        }
        if ($page_entries >= $page_increment + $back_step) {
            $forward_step++;
        }
        // Finally, if we've gotten down this far, we're rendering a term on this
        // page.
        $page_entries++;
        $term_deltas[$raw_term->tid] = isset($term_deltas[$raw_term->tid]) ? $term_deltas[$raw_term->tid] + 1 : 0;
        $key = 'tid:' . $raw_term->tid . ':' . $term_deltas[$raw_term->tid];
        // Keep track of the first term displayed on this page.
        if ($page_entries == 1) {
            $form['#first_tid'] = $raw_term->tid;
        }
        // Keep a variable to make sure at least 2 root elements are displayed.
        if ($raw_term->parents[0] == 0) {
            $root_entries++;
        }
        $current_page[$key] = $raw_term;
    } while (isset($tree[++$tree_index]));
    // Load all the terms we're going to display and set the weight and parents
    // from the tree.
    $terms = $this->storageController
        ->loadMultiple(array_keys($term_deltas));
    $current_page = array_map(function ($raw_term) use ($terms) {
        $term = $terms[$raw_term->tid];
        $term->depth = $raw_term->depth;
        $term->parents = $raw_term->parents;
        return $term;
    }, $current_page);
    // Because we didn't use a pager query, set the necessary pager variables.
    $total_entries = $before_entries + $page_entries + $after_entries;
    $this->pagerManager
        ->createPager($total_entries, $page_increment);
    // If this form was already submitted once, it's probably hit a validation
    // error. Ensure the form is rebuilt in the same order as the user
    // submitted.
    $user_input = $form_state->getUserInput();
    if (!empty($user_input['terms'])) {
        // Get the POST order.
        $order = array_flip(array_keys($user_input['terms']));
        // Update our form with the new order.
        $current_page = array_merge($order, $current_page);
        foreach ($current_page as $key => $term) {
            // Verify this is a term for the current page and set at the current
            // depth.
            if (is_array($user_input['terms'][$key]) && is_numeric($user_input['terms'][$key]['term']['tid'])) {
                $current_page[$key]->depth = $user_input['terms'][$key]['term']['depth'];
            }
            else {
                unset($current_page[$key]);
            }
        }
    }
    $args = [
        '%capital_name' => Unicode::ucfirst($taxonomy_vocabulary->label()),
        '%name' => $taxonomy_vocabulary->label(),
    ];
    if ($this->currentUser()
        ->hasPermission('administer taxonomy') || $this->currentUser()
        ->hasPermission('edit terms in ' . $taxonomy_vocabulary->id())) {
        $help_message = match ($vocabulary_hierarchy) {    VocabularyInterface::HIERARCHY_DISABLED => $this->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.', $args),
            VocabularyInterface::HIERARCHY_SINGLE => $this->t('%capital_name contains terms grouped under parent terms. You can reorganize the terms in %capital_name using their drag-and-drop handles.', $args),
            VocabularyInterface::HIERARCHY_MULTIPLE => $this->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.', $args),
        
        };
    }
    else {
        $help_message = match ($vocabulary_hierarchy) {    VocabularyInterface::HIERARCHY_DISABLED => $this->t('%capital_name contains the following terms.', $args),
            VocabularyInterface::HIERARCHY_SINGLE => $this->t('%capital_name contains terms grouped under parent terms', $args),
            VocabularyInterface::HIERARCHY_MULTIPLE => $this->t('%capital_name contains terms with multiple parents.', $args),
        
        };
    }
    // Get the IDs of the terms edited on the current page which have pending
    // revisions.
    $edited_term_ids = array_map(function ($item) {
        return $item->id();
    }, $current_page);
    $pending_term_ids = array_intersect($this->storageController
        ->getTermIdsWithPendingRevisions(), $edited_term_ids);
    if ($pending_term_ids) {
        $help_message = $this->formatPlural(count($pending_term_ids), '%capital_name contains 1 term with pending revisions. Drag and drop of terms with pending revisions is not supported, but you can re-enable drag-and-drop support by getting each term to a published state.', '%capital_name contains @count terms with pending revisions. Drag and drop of terms with pending revisions is not supported, but you can re-enable drag-and-drop support by getting each term to a published state.', $args);
    }
    // Only allow access to change parents and reorder the tree if there are no
    // pending revisions and there are no terms with multiple parents.
    $update_tree_access = $taxonomy_vocabulary->access('reset all weights', NULL, TRUE);
    $form['help'] = [
        '#type' => 'container',
        'message' => [
            '#markup' => $help_message,
        ],
    ];
    $operations_access = !empty($pending_term_ids) || $vocabulary_hierarchy === VocabularyInterface::HIERARCHY_MULTIPLE;
    if ($operations_access) {
        $form['help']['#attributes']['class'] = [
            'messages',
            'messages--warning',
        ];
    }
    $errors = $form_state->getErrors();
    $row_position = 0;
    // Build the actual form.
    $access_control_handler = $this->entityTypeManager
        ->getAccessControlHandler('taxonomy_term');
    $create_access = $access_control_handler->createAccess($taxonomy_vocabulary->id(), NULL, [], TRUE);
    if ($create_access->isAllowed()) {
        $empty = $this->t('No terms available. <a href=":link">Add term</a>.', [
            ':link' => Url::fromRoute('entity.taxonomy_term.add_form', [
                'taxonomy_vocabulary' => $taxonomy_vocabulary->id(),
            ])
                ->toString(),
        ]);
    }
    else {
        $empty = $this->t('No terms available.');
    }
    $form['terms'] = [
        '#type' => 'table',
        '#empty' => $empty,
        '#header' => [
            'term' => $this->t('Name'),
            'status' => $this->t('Status'),
            'operations' => $this->t('Operations'),
            'weight' => !$operations_access ? $this->t('Weight') : NULL,
        ],
        '#attributes' => [
            'id' => 'taxonomy',
        ],
    ];
    $this->renderer
        ->addCacheableDependency($form['terms'], $create_access);
    foreach ($current_page as $key => $term) {
        $form['terms'][$key] = [
            'term' => [],
            'status' => [],
            'operations' => [],
            'weight' => $update_tree_access->isAllowed() ? [] : NULL,
        ];
        
        /** @var \Drupal\Core\Entity\EntityInterface $term */
        $term = $this->entityRepository
            ->getTranslationFromContext($term);
        $form['terms'][$key]['#term'] = $term;
        $indentation = [];
        if (isset($term->depth) && $term->depth > 0) {
            $indentation = [
                '#theme' => 'indentation',
                '#size' => $term->depth,
            ];
        }
        $form['terms'][$key]['term'] = [
            '#prefix' => !empty($indentation) ? $this->renderer
                ->render($indentation) : '',
            '#type' => 'link',
            '#title' => $term->getName(),
            '#url' => $term->toUrl(),
        ];
        $form['terms'][$key]['status'] = [
            '#type' => 'item',
            '#markup' => $term->isPublished() ? t('Published') : t('Unpublished'),
        ];
        // Add a special class for terms with pending revision so we can highlight
        // them in the form.
        $form['terms'][$key]['#attributes']['class'] = [];
        if (in_array($term->id(), $pending_term_ids)) {
            $form['terms'][$key]['#attributes']['class'][] = 'color-warning';
            $form['terms'][$key]['#attributes']['class'][] = 'taxonomy-term--pending-revision';
        }
        if ($update_tree_access->isAllowed() && count($tree) > 1) {
            $parent_fields = TRUE;
            $form['terms'][$key]['term']['tid'] = [
                '#type' => 'hidden',
                '#value' => $term->id(),
                '#attributes' => [
                    'class' => [
                        'term-id',
                    ],
                ],
            ];
            $form['terms'][$key]['term']['parent'] = [
                '#type' => 'hidden',
                // Yes, default_value on a hidden. It needs to be changeable by the
                // javascript.
'#default_value' => $term->parents[0],
                '#attributes' => [
                    'class' => [
                        'term-parent',
                    ],
                ],
            ];
            $form['terms'][$key]['term']['depth'] = [
                '#type' => 'hidden',
                // Same as above, the depth is modified by javascript, so it's a
                // default_value.
'#default_value' => $term->depth,
                '#attributes' => [
                    'class' => [
                        'term-depth',
                    ],
                ],
            ];
        }
        if ($update_tree_access->isAllowed()) {
            $form['terms'][$key]['weight'] = [
                '#type' => 'weight',
                '#delta' => $delta,
                '#title' => $this->t('Weight for added term'),
                '#title_display' => 'invisible',
                '#default_value' => $term->getWeight(),
                '#attributes' => [
                    'class' => [
                        'term-weight',
                    ],
                ],
            ];
        }
        if ($operations = $this->termListBuilder
            ->getOperations($term)) {
            $form['terms'][$key]['operations'] = [
                '#type' => 'operations',
                '#links' => $operations,
            ];
        }
        if ($parent_fields) {
            $form['terms'][$key]['#attributes']['class'][] = 'draggable';
        }
        // Add classes that mark which terms belong to previous and next pages.
        if ($row_position < $back_step || $row_position >= $page_entries - $forward_step) {
            $form['terms'][$key]['#attributes']['class'][] = 'taxonomy-term-preview';
        }
        if ($row_position !== 0 && $row_position !== count($tree) - 1) {
            if ($row_position == $back_step - 1 || $row_position == $page_entries - $forward_step - 1) {
                $form['terms'][$key]['#attributes']['class'][] = 'taxonomy-term-divider-top';
            }
            elseif ($row_position == $back_step || $row_position == $page_entries - $forward_step) {
                $form['terms'][$key]['#attributes']['class'][] = 'taxonomy-term-divider-bottom';
            }
        }
        // Add an error class if this row contains a form error.
        foreach ($errors as $error_key => $error) {
            if (str_starts_with($error_key, $key)) {
                $form['terms'][$key]['#attributes']['class'][] = 'error';
            }
        }
        $row_position++;
    }
    $this->renderer
        ->addCacheableDependency($form['terms'], $update_tree_access);
    if ($update_tree_access->isAllowed()) {
        if ($parent_fields) {
            $form['terms']['#tabledrag'][] = [
                'action' => 'match',
                'relationship' => 'parent',
                'group' => 'term-parent',
                'subgroup' => 'term-parent',
                'source' => 'term-id',
                'hidden' => FALSE,
            ];
            $form['terms']['#tabledrag'][] = [
                'action' => 'depth',
                'relationship' => 'group',
                'group' => 'term-depth',
                'hidden' => FALSE,
            ];
            $form['terms']['#attached']['library'][] = 'taxonomy/drupal.taxonomy';
            $form['terms']['#attached']['drupalSettings']['taxonomy'] = [
                'backStep' => $back_step,
                'forwardStep' => $forward_step,
            ];
        }
        $form['terms']['#tabledrag'][] = [
            'action' => 'order',
            'relationship' => 'sibling',
            'group' => 'term-weight',
        ];
    }
    if ($update_tree_access->isAllowed() && count($tree) > 1) {
        $form['actions'] = [
            '#type' => 'actions',
            '#tree' => FALSE,
        ];
        $form['actions']['submit'] = [
            '#type' => 'submit',
            '#value' => $this->t('Save'),
            '#button_type' => 'primary',
        ];
        $form['actions']['reset_alphabetical'] = [
            '#type' => 'submit',
            '#submit' => [
                '::submitReset',
            ],
            '#value' => $this->t('Reset to alphabetical'),
        ];
    }
    $form['pager_pager'] = [
        '#type' => 'pager',
    ];
    return $form;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.