tigrov/yii2-email-reply

Email Reply for Yii2 - passes reply messages to predefined objects.

Installs: 8

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

Type:yii2-extension

1.0.4 2019-07-16 09:11 UTC

This package is auto-updated.

Last update: 2024-03-19 23:52:07 UTC


README

It provides help to configure Yii2 to work with Tigrov/email-reply.

Tigrov/email-reply library passes reply messages from email to predefined objects. It uses IMAP to connect email servers.

Latest Stable Version Build Status

Limitation

The library uses ddeboer/imap and it requires:

  • PHP >= 7.1
  • extensions iconv, IMAP, mbstring

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist tigrov/yii2-email-reply

or add

"tigrov/yii2-email-reply": "~1.0"

to the require section of your composer.json file.

Usage

Firstly read Tigrov/email-reply/README.

Then you can take steps:

  1. Create an ActiveRecord model class with ModelInterface interface and implement emailReply method (see examples/Model.php).

    class Model extends yii\db\ActiveRecord implements tigrov\emailReply\ModelInterface
    {
        use tigrov\yii2\emailReply\ActiveRecordThread;
    
        public function emailReply($message)
        {
            /** @var string $fromEmail email address of the sender */
            $fromEmail = $message->getFrom()->getAddress();
            
            /** @var string $fromName name of the sender */
            $fromName = $message->getFrom()->getName();
            
            /** @var string $content content from the replied message */
            $content = $message->getBodyHtml() ?: $message->getBodyText() ?: $message->getDecodedContent();
            
            // Parse the content to get only answer
            $content = EmailReplyParser::parseReply($content);
            
            // To do something with $content
            // e.g. add comment from $fromEmail to the object 
        }
    }
  2. Add EmailReply to Yii2 config file.

    return [
        ...
        'emailReply' => [
            'class' => 'tigrov\emailReply\EmailReply',
            'classesMap' => [
                // key will be used as prefix for email address
                'm' => \Model::class,
            ],
        ],
        ...
    ];
  3. Send an email message with the special reply email address.

    $replyEmail = \Yii::$app->emailReply->getReplyEmail($model);
    
    // Send an email to somebody using the reply email address
    $message = \Yii::$app->mailer->compose($view)
        ->setReplyTo([$replyEmail => \Yii::$app->name])
        ->setFrom([$replyEmail => \Yii::$app->name]);
     
    // Set message subject, body, recipients and etc
    ...
    
    $message->send();
  4. Create the console controller.

    class EmailReplyController extends tigrov\yii2\emailReply\EmailReplyController
    {
    }
  5. Read your mailboxes using console command yii email-reply. For example as a cron job:

    15 * * * * yii email-reply

  6. Each message will be passed to Model::emailReply($message) where you can precess them.

See examples directory for examples.

Suggests

You can use willdurand/email-reply-parser to parse only reply text from email messages.

$reply = EmailReplyParser::parseReply($content);

License

MIT