TaxonomyPermissions.php

Same filename and directory in other branches
  1. 9 core/modules/taxonomy/src/TaxonomyPermissions.php
  2. 8.9.x core/modules/taxonomy/src/TaxonomyPermissions.php
  3. 10 core/modules/taxonomy/src/TaxonomyPermissions.php

Namespace

Drupal\taxonomy

File

core/modules/taxonomy/src/TaxonomyPermissions.php

View source
<?php

namespace Drupal\taxonomy;

use Drupal\Core\DependencyInjection\ContainerInjectionInterface;
use Drupal\Core\Entity\BundlePermissionHandlerTrait;
use Drupal\Core\Entity\EntityTypeManagerInterface;
use Drupal\Core\StringTranslation\StringTranslationTrait;
use Drupal\taxonomy\Entity\Vocabulary;
use Symfony\Component\DependencyInjection\ContainerInterface;

/**
 * Provides dynamic permissions of the taxonomy module.
 *
 * @see taxonomy.permissions.yml
 */
class TaxonomyPermissions implements ContainerInjectionInterface {
    use BundlePermissionHandlerTrait;
    use StringTranslationTrait;
    
    /**
     * The entity type manager.
     *
     * @var \Drupal\Core\Entity\EntityTypeManagerInterface
     */
    protected $entityTypeManager;
    
    /**
     * Constructs a TaxonomyPermissions instance.
     *
     * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
     *   The entity type manager.
     */
    public function __construct(EntityTypeManagerInterface $entity_type_manager) {
        $this->entityTypeManager = $entity_type_manager;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container) {
        return new static($container->get('entity_type.manager'));
    }
    
    /**
     * Get taxonomy permissions.
     *
     * @return array
     *   Permissions array.
     */
    public function permissions() {
        return $this->generatePermissions(Vocabulary::loadMultiple(), [
            $this,
            'buildPermissions',
        ]);
    }
    
    /**
     * Builds a standard list of taxonomy term permissions for a given vocabulary.
     *
     * @param \Drupal\taxonomy\VocabularyInterface $vocabulary
     *   The vocabulary.
     *
     * @return array
     *   An array of permission names and descriptions.
     */
    protected function buildPermissions(VocabularyInterface $vocabulary) {
        $id = $vocabulary->id();
        $args = [
            '%vocabulary' => $vocabulary->label(),
        ];
        return [
            "create terms in {$id}" => [
                'title' => $this->t('%vocabulary: Create terms', $args),
            ],
            "delete terms in {$id}" => [
                'title' => $this->t('%vocabulary: Delete terms', $args),
            ],
            "edit terms in {$id}" => [
                'title' => $this->t('%vocabulary: Edit terms', $args),
            ],
            "view term revisions in {$id}" => [
                'title' => $this->t('%vocabulary: View term revisions', $args),
            ],
            "revert term revisions in {$id}" => [
                'title' => $this->t('%vocabulary: Revert term revisions', $args),
                'description' => $this->t('To revert a revision you also need permission to edit the taxonomy term.'),
            ],
            "delete term revisions in {$id}" => [
                'title' => $this->t('%vocabulary: Delete term revisions', $args),
                'description' => $this->t('To delete a revision you also need permission to delete the taxonomy term.'),
            ],
        ];
    }

}

Classes

Title Deprecated Summary
TaxonomyPermissions Provides dynamic permissions of the taxonomy module.

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