Pull Request for Issue # .

Summary of Changes

Allow to read existing template data in the MailTemplate.

Currently it is complicated to determine the exact content is associated with MailTemplate.
Example during User registration it is impossible to load parameter from User Profile plugin in onMailBeforeRendering event to add them in to email. Because it is impossible to determine for which User it is.
The same can be for any other content associated with MailTemplate.

With new getTemplateData() it should be easy now.

Testing Instructions

Code review from Maintainers .

OR

1. Enable Plugin User - Profile.
   Create a new User, set the profile value for Country field.

2. Edit Email Template for "Users: Username Reminder", and change:

Your username: {USERNAME}

to:

Your username: {USERNAME}
Your country: {PROFILE.COUNTRY}

3. Edit User Profile plugin file.

Add 'onMailBeforeRendering' => 'onMailBeforeRendering', after:

And at the end of the file (before last }) add:

    public function onMailBeforeRendering(\Joomla\CMS\Event\Mail\BeforeRenderingMailTemplateEvent $event)
    {
        if ('com_users.reminder' === $event->getTemplateId()) {
            $emailTmpl = $event->getTemplate();
            $data      = $emailTmpl->getTemplateData();
            $userId    = ArrayHelper::getValue($data, 'id', 0, 'int');

            if ($userId) {
                $key   = 'profile.country';
                $db    = $this->getDatabase();
                $query = $db->createQuery()->select($db->quoteName('profile_value'))
                    ->from($db->quoteName('#__user_profiles'))
                    ->where($db->quoteName('user_id') . ' = :userid')
                    ->where($db->quoteName('profile_key') . ' = :key')
                    ->bind(':userid', $userId, ParameterType::INTEGER)
                    ->bind(':key', $key, ParameterType::STRING);
                $db->setQuery($query);

                $data[$key] = $db->loadResult() ?: '';

                $emailTmpl->addTemplateData($data);
            }
        }
    }

4. Visit the site login form, click "Forgot your username?", and enter email of just created user and submit the form.
5. Check email box, the email should contain country entered in Step 1.

Link to documentations

Please select:

• Documentation link for docs.joomla.org:
• No documentation changes for docs.joomla.org needed
• Pull Request link for manual.joomla.org: TBD
• No documentation changes for manual.joomla.org needed