class UserDevelGenerate

Same name in other branches
  1. 5.x devel_generate/src/Plugin/DevelGenerate/UserDevelGenerate.php \Drupal\devel_generate\Plugin\DevelGenerate\UserDevelGenerate

Provides a UserDevelGenerate plugin.

Plugin annotation


@DevelGenerate(
  id = "user",
  label = @Translation("users"),
  description = @Translation("Generate a given number of users. Optionally delete current users."),
  url = "user",
  permission = "administer devel_generate",
  settings = {
    "num" = 50,
    "kill" = FALSE,
    "pass" = ""
  }
)

Hierarchy

Expanded class hierarchy of UserDevelGenerate

File

devel_generate/src/Plugin/DevelGenerate/UserDevelGenerate.php, line 31

Namespace

Drupal\devel_generate\Plugin\DevelGenerate
View source
class UserDevelGenerate extends DevelGenerateBase implements ContainerFactoryPluginInterface {
    
    /**
     * The user storage.
     *
     * @var \Drupal\Core\Entity\EntityStorageInterface
     */
    protected $userStorage;
    
    /**
     * The date formatter service.
     *
     * @var \Drupal\Core\Datetime\DateFormatterInterface
     */
    protected $dateFormatter;
    
    /**
     * Provides system time.
     *
     * @var \Drupal\Core\Datetime\TimeInterface
     */
    protected $time;
    
    /**
     * Constructs a new UserDevelGenerate object.
     *
     * @param array $configuration
     *   A configuration array containing information about the plugin instance.
     * @param string $plugin_id
     *   The plugin_id for the plugin instance.
     * @param mixed $plugin_definition
     *   The plugin implementation definition.
     * @param \Drupal\Core\Entity\EntityStorageInterface $entity_storage
     *   The user storage.
     * @param \Drupal\Core\Datetime\DateFormatterInterface $date_formatter
     *   The date formatter service.
     * @param \Drupal\Core\Datetime\TimeInterface $time
     *   Provides system time.
     */
    public function __construct(array $configuration, $plugin_id, $plugin_definition, EntityStorageInterface $entity_storage, DateFormatterInterface $date_formatter, TimeInterface $time) {
        parent::__construct($configuration, $plugin_id, $plugin_definition);
        $this->userStorage = $entity_storage;
        $this->dateFormatter = $date_formatter;
        $this->time = $time;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
        return new static($configuration, $plugin_id, $plugin_definition, $container->get('entity_type.manager')
            ->getStorage('user'), $container->get('date.formatter'), $container->get('datetime.time'));
    }
    
    /**
     * {@inheritdoc}
     */
    public function settingsForm(array $form, FormStateInterface $form_state) {
        $form['num'] = [
            '#type' => 'number',
            '#title' => $this->t('How many users would you like to generate?'),
            '#default_value' => $this->getSetting('num'),
            '#required' => TRUE,
            '#min' => 0,
        ];
        $form['kill'] = [
            '#type' => 'checkbox',
            '#title' => $this->t('Delete all users (except user id 1) before generating new users.'),
            '#default_value' => $this->getSetting('kill'),
        ];
        $options = user_role_names(TRUE);
        unset($options[AccountInterface::AUTHENTICATED_ROLE]);
        $form['roles'] = [
            '#type' => 'checkboxes',
            '#title' => $this->t('Which roles should the users receive?'),
            '#description' => $this->t('Users always receive the <em>authenticated user</em> role.'),
            '#options' => $options,
        ];
        $form['pass'] = [
            '#type' => 'textfield',
            '#title' => $this->t('Password to be set'),
            '#default_value' => $this->getSetting('pass'),
            '#size' => 32,
            '#description' => $this->t('Leave this field empty if you do not need to set a password'),
        ];
        $options = [
            1 => $this->t('Now'),
        ];
        foreach ([
            3600,
            86400,
            604800,
            2592000,
            31536000,
        ] as $interval) {
            $options[$interval] = $this->dateFormatter
                ->formatInterval($interval, 1) . ' ' . $this->t('ago');
        }
        $form['time_range'] = [
            '#type' => 'select',
            '#title' => $this->t('How old should user accounts be?'),
            '#description' => $this->t('User ages will be distributed randomly from the current time, back to the selected time.'),
            '#options' => $options,
            '#default_value' => 604800,
        ];
        return $form;
    }
    
    /**
     * {@inheritdoc}
     */
    protected function generateElements(array $values) {
        $num = $values['num'];
        $kill = $values['kill'];
        $pass = $values['pass'];
        $age = $values['time_range'];
        $roles = array_filter($values['roles']);
        if ($kill) {
            $uids = $this->userStorage
                ->getQuery()
                ->condition('uid', 1, '>')
                ->execute();
            $users = $this->userStorage
                ->loadMultiple($uids);
            $this->userStorage
                ->delete($users);
            $this->setMessage($this->formatPlural(count($uids), '1 user deleted', '@count users deleted.'));
        }
        if ($num > 0) {
            $names = [];
            while (count($names) < $num) {
                $name = $this->getRandom()
                    ->word(mt_rand(6, 12));
                $names[$name] = '';
            }
            if (empty($roles)) {
                $roles = [
                    AccountInterface::AUTHENTICATED_ROLE,
                ];
            }
            foreach ($names as $name => $value) {
                $account = $this->userStorage
                    ->create([
                    'uid' => NULL,
                    'name' => $name,
                    'pass' => $pass,
                    'mail' => $name . '@example.com',
                    'status' => 1,
                    'created' => $this->time
                        ->getRequestTime() - mt_rand(0, $age),
                    'roles' => array_values($roles),
                    // A flag to let hook_user_* know that this is a generated user.
'devel_generate' => TRUE,
                ]);
                // Populate all fields with sample values.
                $this->populateFields($account);
                $account->save();
            }
        }
        $this->setMessage($this->t('@num_users created.', [
            '@num_users' => $this->formatPlural($num, '1 user', '@count users'),
        ]));
    }
    
    /**
     * {@inheritdoc}
     */
    public function validateDrushParams(array $args, array $options = []) {
        $values = [
            'num' => array_shift($args),
            'time_range' => 0,
            'roles' => StringUtils::csvToArray($options['roles']),
            'kill' => $options['kill'],
            'pass' => $options['pass'],
        ];
        return $values;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
DevelGenerateBase::$entityTypeManager protected property The entity type manager service.
DevelGenerateBase::$random protected property The random data generator.
DevelGenerateBase::$settings protected property The plugin settings.
DevelGenerateBase::generate public function Execute the instructions in common for all DevelGenerate plugin. Overrides DevelGenerateBaseInterface::generate
DevelGenerateBase::getDefaultSettings public function Returns the default settings for the plugin. Overrides DevelGenerateBaseInterface::getDefaultSettings
DevelGenerateBase::getEntityTypeManager protected function Gets the entity type manager service.
DevelGenerateBase::getLangcode protected function Return a language code. 1
DevelGenerateBase::getLanguageForm protected function Creates the language and translation section of the form.
DevelGenerateBase::getRandom protected function Returns the random data generator.
DevelGenerateBase::getSetting public function Returns the array of settings, including defaults for missing settings. Overrides DevelGenerateBaseInterface::getSetting
DevelGenerateBase::getSettings public function Returns the current settings for the plugin. Overrides DevelGenerateBaseInterface::getSettings
DevelGenerateBase::handleDrushParams public function
DevelGenerateBase::isNumber public static function Check if a given param is a number.
DevelGenerateBase::populateFields public static function Populate the fields on a given entity with sample values.
DevelGenerateBase::randomSentenceOfLength protected function Generates a random sentence of specific length.
DevelGenerateBase::setMessage protected function Set a message for either drush or the web interface.
DevelGenerateBase::settingsFormValidate public function Form validation handler. Overrides DevelGenerateBaseInterface::settingsFormValidate 2
PluginInspectionInterface::getPluginDefinition public function Gets the definition of the plugin implementation. 6
PluginInspectionInterface::getPluginId public function Gets the plugin_id of the plugin instance. 2
UserDevelGenerate::$dateFormatter protected property The date formatter service.
UserDevelGenerate::$time protected property Provides system time.
UserDevelGenerate::$userStorage protected property The user storage.
UserDevelGenerate::create public static function Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface::create
UserDevelGenerate::generateElements protected function Business logic relating with each DevelGenerate plugin. Overrides DevelGenerateBase::generateElements
UserDevelGenerate::settingsForm public function Returns the form for the plugin. Overrides DevelGenerateBase::settingsForm
UserDevelGenerate::validateDrushParams public function Responsible for validating Drush params. Overrides DevelGenerateBaseInterface::validateDrushParams
UserDevelGenerate::__construct public function Constructs a new UserDevelGenerate object.