Фремворк Limb

Отредактируйте страницу и нажмите «Сохранить». Прочтите справочную страницу для ознакомления с синтаксисом вики. Пожалуйста, редактируйте только в том случае, если планируете улучшить содержимое. Если вы просто хотите потестировать что-либо, воспользуйтесь специальной страницей: PlayGround.

====== Пакет MAIL ======
Пакет mail предназначен для отправки почты, как с помощью известной библиотеки PHPMailer, так и стандартными средствами ОС. Помимо этого, опционально, пакет предоставляет средства для использования шаблонов [[limb3:ru:packages:macro|MACRO]] в качестве шаблонов писем, а так же средства отладки.

===== Пример отправки письма =====
<code php>

$mailer = new lmbMailer();

$recipients = array(
    array("name" => "Sam", "address" => "sam@somehost.com"),
    "todd@somehost.com"
  );
  $sender = 'bob@somehost.com';
  $subject = 'new movie';
  $text = 'Hello';
  $html = '<h1>Hello</h1>';

$mailer->addAttachment('/www/attachments/movie.flv', $name = "Super movie");
  $mailer->embedImage('/www/images/thumb.png', $cid = mt_rand(), $name=" Thumb for super movie");

//отправка текстового письма
  $mailer->sendPlainMail($recipients, $sender, $subject, $text);

//отправка html письма
  $mailer->sendHtmlMail($recipients, $sender, $subject, $html, $text, $charset = 'cp-1251');
</code> 
===== Конфигурация lmbMailer =====

Находится в settings/mail.conf.php

:!: В старых версиях пакета для конфигурирования lmbMailer использовались константы, заданные с помощью директив define(), а так же функциями lmb_env_set() и lmb_env_setor(). Этот способ хотя и поддерживается, но __настоятельно не рекомендуется__.

Также при создании объекта lmbMailer можно передать массив c опциями в конструктор. Названия параметров этого массива совпадают с названиями опций конфига. Значения, переданные в конструктор, перекрывают значения взятые из ''mail.conf.php''.

<code php>
$custom_config = array(
  'smtp_user' => 'user',
  'smtp_password' => 'password');

$mailer = new lmbMailer($custom_config);
</code>

===== Разница между отправкой с помощью mail() и smtp =====
===== lmbMailService и мейлеры =====
====Пример работы с lmbMailService ====
Например мы хотим отправить пользователю сообщение, что он удачно купил трактор в нашем магазине. Создаем шаблон письма. 
<code>
Поздравляем с покупкой трактора {#tractor.title}

Поздравляем!
Вы, или ваш тайный доброжелатель, только что купили новенький {#tractor.title} на нашем замечательном сайте vtraktore.ru.
По смешной цене "{$#tractor.price}" рублей. 
Посмотреть на это чудо инженерного гения можно на странице {$#tractor.profile_url}.

<h2>Поздравляем!</h2>
<p>Вы, или ваш тайный доброжелатель, только что купили новенький {#tractor.title} на нашем замечательном сайте vtraktore.ru.</p>
<p>По смешной цене "{$#tractor.price}" рублей.</p>
Посмотреть на это чудо инженерного гения можно на странице <a href="{$#tractor.profile_url}">{$#tractor.profile_url}</a>.
</code>
Шаблон состоит из трех частей: темы письма, txt-части и html-части (не обязательной). Части разделяются символом \n\n. Назовем шаблон **tractor_sold.phtml** и поместим его в директорию **_mail**, в директории шаблонов (что-то типа template/_mail/tracor_sold.phtml).

Приступим непосредственно к отправке:
<code php>
    $tractor = new stdClass();
    $tractor->title = 'Советский турбовинтовой мирный трактор, среднего радиуса действия';
    $tractor->price = 4999999;
    $tractor->profile_url = 'http://lurkmore.ru/Мирный_советский_трактор';

$service = new lmbMailService('tractor_sold');
    $service->set('tractor', $tractor);
    $service->sendMailTo('petya-the-pig@gmail.com');
</code>

==== Классы-мейлеры ====
Мейлеры это объекты, которые отвечают за непосредственно отправку письма ( интерфейс %%lmbBaseMailerInterface%%). В данный момент поддерживаются следующие мейлеры:
  - **lmbMailer** - "честный" мейлер: отправляет письмо в соответствии с настройками mail-конфига
  - **lmbFileMailer** - создает файлы, с содержимым писем, во временной папке limb (по умолчанию это <PROJECT_DIR>/var )
  - **lmbMemoryMailer** - не отсылает писем, а хранит их внутри себя. Удобен для тестов. Для доступа к "отправленным" письмам имеются методы getMailContents() и clearMailContents()
  - **lmbFirePHPMailer** - отправляет письма в консоль firefox-расширения [[http://getfirebug.com/|FireBug]], используя библиотеку [[http://www.firephp.org/|FirePHP]]
  - **lmbResponseMailer** - записывает текст письма в объект-ответ ([[limb3:ru:packages:net:lmb_http_response|lmbHttpResponse]])
==== Конфигурация ====
=== Выбор мэйлера для lmbMailService ===
:!: В данный момент выбор мейлера происходит в самом lmbMailService. В будущем инстанцирование и настройка мэйлера будет вынесена в [[limb3:ru:packages:toolkit:lmb_toolkit|toolkit]].

Пожалуйста, введите код подтверждения, чтобы доказать, что вы не робот:

   __ __   __ __   ____   ____   __ 
  / //_/  / //_/  / __/  / __/  / / 
 / ,<    / ,<    / _/   / _/   / /__
/_/|_|  /_/|_|  /___/  /___/  /____/

Пожалуйста, оставьте это поле пустым:

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International

Фремворк Limb

Инструменты пользователя

Инструменты сайта

Инструменты страницы