УрокСоздание своих токенов на примере регистрации пользователей

В этой статье я совмещу две очень полезные вещи: во-первых, расскажу про программное создание токенов, а во-вторых, покажу как в Drupal 7 отправлять пользователю письмо о регистрации, в котором будет находиться автоматически сгенерированный пароль для него.

Сегодня мне была поставлена такая задача по регистрации: Форма регистрации должна содержать только емейл пользователя. После ввода емейла пользователь автоматически авторизируется на сайте, а пароль и логин высылаются на указанную почту. Парадоксально, но в седьмом Друпале этого сделать стандартными средствами сделать невозможно. Из всех возможных стандартных средств, наиболее близкая к поставленной задаче оказалась такая: Пользователь вводит логин, емейл и пароль, после чего происходит автоматическая авторизация. На емейл приходит только логин пользователя - в токенах пароля нет и не предусмотрено. Поэтому отталкиваться я решил именно от него. Итак, переходим к реализации.

Шаг первый. Настройка пользователей.

Первым делом заходим на страницу настройки пользователей /admin/config/people/accounts и выставляем там такие настройки:

После таких настроек регистрация выглядит самым громоздким образом (зато автоматически авторизует пользователя):

Шаг второй. Убираем лишние поля из формы регистрации.

Скачиваем и ставим модуль Email Registration, который позволяет убрать логин из формы регистрации. Теперь она выглядит немного поменьше:

Осталось убрать поля с паролем. Для этого я создал небольшой модуль, который назвал Registration Password Token (системное имя - rpt). Имплементируем hook_form_FORM_ID_alter():

/**
 * Implements hook_form_FORM_ID_alter().
 */
function rpt_form_user_register_form_alter(&$form, &$form_state) {
 
  // Если выставлены настройки из первого скриншота, то скрываем пароль.
  $user_registration = variable_get('user_register', USER_REGISTER_VISITORS_ADMINISTRATIVE_APPROVAL);
  $verification_required = variable_get('user_email_verification', TRUE);
  $user_registration_allowed = in_array($user_registration, array(USER_REGISTER_VISITORS, USER_REGISTER_VISITORS_ADMINISTRATIVE_APPROVAL));
  if ($user_registration_allowed && !$verification_required) {
    // Меняем полю с паролем тип на value и генерируем автоматический пароль.
    $form['account']['pass']['#type']  = 'value';
    $form['account']['pass']['#value'] = user_password();
  }
}

Теперь регистрация выглядит намного проще:

Шаг третий. Создание токена.

Теперь, введя емейл, пользователь зарегистрируется и авторизируется. Однако свой пароль он не знает, а далеко не каждый пользователь догадается зайти в личный кабинет и поменять его. Поэтому очень неплохо было бы выслать пароль пользователю на емейл. Для этого надо создать токен с паролем, которого по умолчанию в Друпале нет. Создаём токен с паролем:

/**
 * Implements hook_token_info().
 */
function rpt_token_info() {
 
  // Создаём новый токен с паролем и добавляем его в группу пользователей.
  $info['tokens']['user']['password'] = array(
    'name' => t('User password'),
    'description' => t('Provides user password. May be used only during registration.'),
  );
 
  return $info;
}

Наполняем токен данными, которые будут доступны только в процессе регистрации:

/**
 * Implements hook_tokens().
 */
function rpt_tokens($type, $tokens, array $data = array(), array $options = array()) {
  $replacements = array();
  if (isset($data['user']) && isset($data['user']->password)) {
    $replacements['[user:password]'] = $data['user']->password;
  }
  return $replacements;
}

Теперь при регистрации будет доступен новый токен [user:password], который можно использовать в тексте письма:

Если включить модуль Token, то созданный токен будет отображаться в общем списке:

Ну вот, собственно, и всё.

Шаг четвёртый. Написал модуль - поделись с другими.

Модуль можно забрать прямо с d.org: Registration Token Password. Кстати, там есть настройка дополнительная: генерировать пароль автоматически (скрывая в форме регистрации поля для ввода пароля), или же оставлять всё как есть. Но в любом случае пароль может быть выслан на емейл при добавлении соответствующего токена.