xref: /plugin/recommend/helper/mail.php (revision c6f9d3d590f898165ce791277f4554ff3ef97548)

<?php

use dokuwiki\Extension\Plugin;
use dokuwiki\Extension\AuthPlugin;

/**
 * Mail helper
 */
class helper_plugin_recommend_mail extends Plugin
{
    /**
     * @param string $recipient
     * @param string $sender
     * @param array $replacements
     *
     * @return void
     */
    public function sendMail($recipient, $sender, $replacements = [])
    {
        global $INPUT;

        $mailtext = file_get_contents($this->localFN('template'));

        /* Limit to two empty lines. */
        $mailtext = preg_replace('/\n{4,}/', "\n\n\n", $mailtext);

        $mailer = new Mailer();
        $mailer->bcc($recipient);
        $mailer->from($sender);

        $subject = $INPUT->str('subject');
        $mailer->subject($subject);
        $mailer->setBody($mailtext, $replacements);
        $mailer->send();
    }

    /**
     * Processes recipients from input and returns an array of emails
     * with user groups resolved to individual users
     *
     * @param string $recipients
     * @return array
     * @throws Exception
     */
    public function resolveRecipients($recipients)
    {
        $resolved = [];

        $recipients = explode(',', $recipients);

        foreach ($recipients as $recipient) {
            $recipient = trim($recipient);

            if ($recipient[0] === '@') {
                $this->resolveGroup($resolved, $recipient);
            } elseif (!str_contains($recipient, '@')) {
                $this->resolveUser($resolved, $recipient);
            } else {
                if (!$this->emailIsValid($recipient)) {
                    throw new \Exception($this->getLang('err_recipient'));
                }
                $resolved[] = $recipient;
            }
        }
        return $resolved;
    }

    /**
     * @param array $resolved
     * @param string $recipient
     * @return void
     * @throws Exception
     */
    protected function resolveGroup(&$resolved, $recipient)
    {
        /** @var AuthPlugin $auth */
        global $auth;
        if (!$auth->canDo('getUsers')) {
            throw new \Exception('Auth cannot fetch users by group.');
        }

        $users = $auth->retrieveUsers(0, 0, ['grps' => substr($recipient, 1)]);
        foreach ($users as $user) {
            $resolved[] = $user['mail'];
        }
    }

    /**
     * @param array $resolved
     * @param string $recipient
     * @return void
     */
    protected function resolveUser(&$resolved, $recipient)
    {
        /** @var AuthPlugin $auth */
        global $auth;
        $user = $auth->getUserData($recipient);
        if ($user) $resolved[] = $user['mail'];
    }

    /**
     * Checks validity of given mail. With config 'wikionly' set to true
     * also checks if user with this email is known.
     *
     * @param $mail
     * @return bool
     * @throws Exception
     */
    protected function emailIsValid($mail)
    {
        if (!$this->getConf('wikionly')) return mail_isvalid($mail);

        /** @var AuthPlugin $auth */
        global $auth;
        if (!$auth->canDo('getUsers')) {
            throw new \Exception('Auth cannot fetch users by email.');
        }

        $user = $auth->retrieveUsers(0, 1, ['mail' => $mail]);
        return (bool)$user;
    }
}