yiimaker/yii2-email-templates Extension for creating of email templates and manage using your site dashboard

24204902

Email templates module

  1. Installation
  2. Usage
  3. Tests
  4. Contributing
  5. License

Extension for creating email templates and managing by using your site dashboard. You can create email templates with CRUD module in your backend or Gii generator.

Documentation is at docs/guide/README.md.

Build Status Scrutinizer Code Quality Total Downloads Latest Stable Version Latest Unstable Version

Installation

The preferred way to install this extension is through composer.

Either run

$ composer require yiimaker/yii2-email-templates

or add

"yiimaker/yii2-email-templates": "~4.0"

to the require section of your composer.json.

Usage

  1. Create template with placeholders using your site dashboard or Gii generator

    ##### Key

    register-notification - this is unique key of this template for using in your code

    ##### Subject

    Notification from {site-name}

    In this example email subject has one placeholder {site-name}

    ##### Body

    Hello, {username}! Welcome to {site-name} :)

    Email body has two placeholders: {username} and {site-name}.

    > All keys should be wrapped by {}.

  2. Now you can get this template in your code

    `php $template = Yii::$app->get('templateManager')->getTemplate('register-notification'); `

    This method returns a template model object.

  3. Then you should parse this template

    `php $template->parseSubject([

    'site-name' => Yii::$app->name,
    

    ]);

    $template->parseBody([

    'username' => Yii::$app->getIdentity()->username,
    'site-name' => Yii::$app->name,
    

    ]); `

    or use another method

    `php $template->parse([

    'subject' => [
        'site-name' => Yii::$app->name,
    ],
    'body' => [
        'username' => Yii::$app->getIdentity()->username,
        'site-name' => Yii::$app->name,
    ],
    

    ]); `

    this methods replace placeholders in template with real data.

  4. Now you can use data of this template in your logic

    `php Yii::$app->get('mailer')->compose()

     ->setSubject($template->subject)
     ->setHtmlBody($template->body)
     // ...
    

    `

Tests

You can run tests with composer command

$ composer test

or using following command

$ codecept build && codecept run

Contributing

For information about contributing please read CONTRIBUTING.md.

License

License

This project is released under the terms of the BSD-3-Clause license.

Copyright (c) 2017-2018, Yii Maker

0 0
1 follower
1 309 downloads
Yii Version: 2.0
License: BSD-3-Clause
Category: Mail
Developed by: greeflas
Created on: Apr 28, 2018
Last updated: (not set)
Packagist Profile
Github Repository

Related Extensions