UserData.php

Same filename in this branch
  1. 10 core/modules/user/src/Plugin/migrate/destination/UserData.php
  2. 10 core/modules/user/src/UserData.php
Same filename and directory in other branches
  1. 9 core/modules/user/src/Plugin/views/field/UserData.php
  2. 9 core/modules/user/src/Plugin/migrate/destination/UserData.php
  3. 9 core/modules/user/src/UserData.php
  4. 8.9.x core/modules/user/src/Plugin/views/field/UserData.php
  5. 8.9.x core/modules/user/src/Plugin/migrate/destination/UserData.php
  6. 8.9.x core/modules/user/src/UserData.php
  7. 11.x core/modules/user/src/Plugin/views/field/UserData.php
  8. 11.x core/modules/user/src/Plugin/migrate/destination/UserData.php
  9. 11.x core/modules/user/src/UserData.php

Namespace

Drupal\user\Plugin\views\field

File

core/modules/user/src/Plugin/views/field/UserData.php

View source
<?php

namespace Drupal\user\Plugin\views\field;

use Drupal\Core\Extension\ModuleExtensionList;
use Drupal\Core\Extension\ModuleHandlerInterface;
use Drupal\Core\Form\FormStateInterface;
use Drupal\views\Plugin\views\field\FieldPluginBase;
use Drupal\views\ResultRow;
use Drupal\user\UserDataInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;

/**
 * Provides access to the user data service.
 *
 * @ingroup views_field_handlers
 *
 * @see \Drupal\user\UserDataInterface
 *
 * @ViewsField("user_data")
 */
class UserData extends FieldPluginBase {
    
    /**
     * Provides the user data service object.
     *
     * @var \Drupal\user\UserDataInterface
     */
    protected $userData;
    
    /**
     * The module handler.
     *
     * @var \Drupal\Core\Extension\ModuleHandlerInterface
     */
    protected $moduleHandler;
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
        return new static($configuration, $plugin_id, $plugin_definition, $container->get('user.data'), $container->get('module_handler'), $container->get('extension.list.module'));
    }
    
    /**
     * Constructs a UserData object.
     */
    public function __construct(array $configuration, $plugin_id, $plugin_definition, UserDataInterface $user_data, ModuleHandlerInterface $module_handler, ?ModuleExtensionList $moduleExtensionList = NULL) {
        parent::__construct($configuration, $plugin_id, $plugin_definition);
        $this->userData = $user_data;
        $this->moduleHandler = $module_handler;
        if ($this->moduleExtensionList === NULL) {
            @trigger_error('Calling ' . __METHOD__ . '() without the $moduleExtensionList argument is deprecated in drupal:10.3.0 and will be required in drupal:12.0.0. See https://www.drupal.org/node/3310017', E_USER_DEPRECATED);
            $this->moduleExtensionList = \Drupal::service('extension.list.module');
        }
    }
    
    /**
     * {@inheritdoc}
     */
    protected function defineOptions() {
        $options = parent::defineOptions();
        $options['data_module'] = [
            'default' => '',
        ];
        $options['data_name'] = [
            'default' => '',
        ];
        return $options;
    }
    
    /**
     * {@inheritdoc}
     */
    public function buildOptionsForm(&$form, FormStateInterface $form_state) {
        parent::buildOptionsForm($form, $form_state);
        $modules = $this->moduleHandler
            ->getModuleList();
        $names = [];
        foreach (array_keys($modules) as $name) {
            $names[$name] = $this->moduleExtensionList
                ->getName($name);
        }
        $form['data_module'] = [
            '#title' => $this->t('Module name'),
            '#type' => 'select',
            '#description' => $this->t('The module which sets this user data.'),
            '#default_value' => $this->options['data_module'],
            '#options' => $names,
        ];
        $form['data_name'] = [
            '#title' => $this->t('Name'),
            '#type' => 'textfield',
            '#description' => $this->t('The name of the data key.'),
            '#default_value' => $this->options['data_name'],
        ];
    }
    
    /**
     * {@inheritdoc}
     */
    public function render(ResultRow $values) {
        $uid = $this->getValue($values);
        $data = $this->userData
            ->get($this->options['data_module'], $uid, $this->options['data_name']);
        // Don't sanitize if no value was found.
        if (isset($data)) {
            return $this->sanitizeValue($data);
        }
    }

}

Classes

Title Deprecated Summary
UserData Provides access to the user data service.

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