官术网_书友最值得收藏!

Using tokens

To quickly demonstrate how we can use tokens, let's include in our hello_world_log mails some information about the current user at the time the email is being sent out. This will naturally coincide with the user that is signed in at the time the error is being logged.

For this, we will need to alter our hook_mail() implementation. In there, we will ask the current_user service for the AccountProxy of the current user, add another string to our mail body and, of course, replace a token:

/**
* Implements hook_mail().
*/
function hello_world_mail($key, &$message, $params) {
switch ($key) {
case 'hello_world_log':
$message['from'] = \Drupal::config('system.site')->get('mail');
$message['subject'] = t('There is an error on your website');
$message['body'][] = $params['message'];
$user_message = 'The user that was logged in: [current-user:name].';
$message['body'][] = \Drupal::token()->replace($user_message, ['current-user' => \Drupal::currentUser()]);

break;
}
}

As you can see, we are adding a new "paragraph" to our email. This is a simple string that informs us about the user that was logged in. However, in doing so, we use the token service (statically) to replace that piece of string with the token value. The replace() method of the service takes a string and optionally an array of data objects keyed by the type (group) of the tokens they should be used for.

The choice of token and type in this case is important. The User module defines the user and current-user types. The difference between the two, if you check inside user_tokens(), is that the latter simply delegates to the former after it loads a full user entity. We could, alternatively, have done that ourselves and then passed the user type, but why should we? If somebody has done that for us already, we should not have to do it again. And what we pass to the current-user token type as a data object to be used in the replacement process is the AccountProxy (current user session).

So, that's it. Now, the email message will get an extra line that contains the dynamically generated username of the currently logged-in user at the time the error happened. Under the hood, the token service scans the string, extracts the token, and calls all hook_tokens() implementations. The User module is the one that can return the replacement for this token based on the User object it receives.

主站蜘蛛池模板: 渑池县| 时尚| 库伦旗| 明水县| 环江| 富顺县| 大悟县| 武邑县| 广安市| 乐亭县| 商丘市| 中西区| 闽侯县| 梁山县| 合水县| 漳浦县| 邵阳县| 河北区| 依兰县| 黄梅县| 西乡县| 逊克县| 新宁县| 武冈市| 昭苏县| 北票市| 武陟县| 宜州市| 五常市| 侯马市| 宁晋县| 新巴尔虎右旗| 时尚| 灌云县| 南安市| 陵水| 盐源县| 阳春市| 黄冈市| 邢台市| 商南县|