Установка и настройка Newsletter+

Установка Newsletter+ довольно простой процесс. Загрузите файлы, установите права на запись, создайте базу данных, установите несколько параметров. Останется лишь создать аккаунты в Amazon Web Services, UniOne, Mandrill, Mailgun или Sendgrid и настроить их в скрипте. Инструкции описаны в следующих шагах, по которым легко следовать.

Если вам требуется помощь с установкой, мы предоставляем её всего за $40. Просто ответьте на письмо с лицензионным ключом, отправленное вам после приобретения.

Скачать установщик

Шаг 1 Проверьте Минимальные требования

Важно: Мы рекомендуем устанавливать скрипт на VPS сервер с оперативной памятью от 512 мб или выше.

Ищете VPS? Посмотрите на предложение от наших партнеров REG.RU.

Убедитесь, что ваш сервер (хостинг) соответствует минимальным системным требованиям. Иначе у вас могут возникнуть проблемы с установкой и использованием.

  • PHP 5.2 или новее (с расширением MySQL)
  • MySQL 5 или новее (с поддержкой кодировки utf8_general_ci)
  • Последняя версия IonCube PHP Loader на вашем сервере
  • magic_quotes, safe_mode и open_basedir выключены
  • allow_url_fopen включен
  • Поддержка Cronjobs/scheduler (настроить на запуск каждую минуту)
  • gd2, iconv, mbstring, imap, curl, sockets, tidy, mysql расширения для php
  • ModRewrite библиотека и поддержка файлов .htaccess c аттрибутом RewriteRule
  • max_execution_time установлено в 0 и max_input_time установлено в -1 в файле php.ini

Вы можете проверить требования через файл inf.php?action=requirements на Вашем сайте.

Скорость вашего сайта напрямую зависит от скорости вашего сервера.

Важно: Для работы скрипта рассылок лучше всего использовать VPS сервер с оперативной памятью от 512 мб и выше.

Шаг 2 Загрузите файлы

1. Загрузите все файлы на ваш сервер.

2. Убедитесь, что файл .htaccess (в корневой директории) также загружен на ваш сервер (он может быть скрыт, если вы используете Mac).

Важно: Используйте Бинарный режим передачи данных. Это требуется для корректной загрузки закодированных IobCube файлов. Версия с открытым кодом также содержит 1 закрытый файл.

Шаг 3 Установите права записи на все папки и файлы

Для установки и скачивания обновления нужно установить права 777 на папки application, temp, system (и на все входящие в них папки и файлы).

Изображения, вложения, CSV и прочие загрузки требуют установки прав 777 на папку uploads (и на все входящие в неё папки и файлы).

Шаг 4 Установите Newsletter+

1. Откройте ваш установщик Newsletter+. Если вы загрузили Newsletter+ в http://yourdomain/newsletter, посетите эту ссылку для установки.

2. Ваш Лицензионный ключ для установки находится в письме, которое вы получили после покупки.

3. Заполните доступ к FTP серверу (хост, логин и пароль) и нажмите Далее для продолжения. Вы можете пропустить эти настройки, просто не заполняйте их.

4. Укажите доступ к базе данных MySQL (хост, название базы, логин, пароль) и нажмите Далее для продолжения.

5. Установщик скачает все необходимые файлы перед установкой.

6. После скачивания всех файлов установщик приступит к установке.

7. Вас спросят указать Email и Пароль. Это будут данные администратора для входа в Newsletter+.

Шаг 5 Настройте Cron Jobs (Задания по расписанию)

Запускайте следующие задачи каждую минуту:

* * * * * php /path_to_script/cron_index.php cron email_newsletters process >/dev/null 2>&1
* * * * * php /path_to_script/cron_index.php cron email_newsletters bounces >/dev/null 2>&1
* * * * * php /path_to_script/cron_index.php cron email_servers send >/dev/null 2>&1
* * * * * php /path_to_script/cron_index.php cron email_notifications process >/dev/null 2>&1
* * * * * php /path_to_script/cron_index.php cron subscribers import >/dev/null 2>&1
* * * * * php /path_to_script/cron_index.php cron monetization time_limited >/dev/null 2>&1

Запускайте следующую задачу раз в день:

0 0 * * * php /path_to_script/cron_index.php cron install check_license >/dev/null 2>&1

Это лишь пример настроек Cron Jobs. Не копируйте бездумно. path_to_script нужно заменить на полный путь от корня файловой системы до файла cron_index.php.

Бывает, что Cron jobs не знают адреса вашего сайта. Чтобы исправить это откройте файл /application/config/config.php и укажите адрес сайта в переменной base_url, если скрипт не сделал этого при установке.

Шаг 6 Зарегистрируйтесь в Amazon (AWS) и получите Ключи Доступа

Для того, чтобы использовать Amazon SES, Вам нужно сначала зарегистрироваться в Amazon Web Services (AWS).

1. Посетите Amazon Web Services (AWS) и зарегистрируйте ваш AWS аккаунт.

2. После регистрации Вам нужно будет получить Ключи Доступа(Access Credentials) в вашем AWS аккаунте. Этот набор "ключей" позволяет скрипту отправлять письма через Ваш Amazon SES аккаунт. Начните с создания IAM (Identity and Access Management) пользователя в вашей IAM консоли.

3. Нажмите на кнопку Create New Users:

4. Введите "nps" в первое поле, после чего нажмите на кнопку Create.

5. Скопируйте ваши Access Key ID и Secret Access Key. В дальнейшем это нужно будет использовать при создании Email сервера.

6. Важно: Не пропускайте следующие шаги.

7. Теперь вам нужно предоставить права новому пользователю. В вашей IAM консоли нажмите на "nps".

8. На следующей странице нажмите на кнопку Attach Policy.

9. Найдите AmazonSESFullAccess, после чего выделите чекбоксом элемент AmazonSESFullAccess. Нажмите на кнопку Attach Policy внизу экрана.

Шаг 7 Настройте Amazon Simple Email Service (SES)

Важно: Прежде, чем продолжить, что в выпадающем меню в верхнем правом углу SES консоли отображается нужный вам регион.

Для того, чтобы начать отправлять письма, Вам нужно добавить Email адреса отправителей или домены и увеличить ваши Лимиты на отправку (SES Sending Limits).

1. Добавьте Email адрес отправителя в Вашей Amazon SES консоли > Verified Senders > Email Addresses. Допустим вы собираетесь использовать yourname@domain.com для отправки писем, добавьте и подтвердите право владения адресом yourname@domain.com в Вашей SES консоли. Нажмите на кнопку Verify a New Email Address и следуйте инструкциям.

Подсказка: Если вы планируете отправлять письма со множества адресов, находящихся в одном домене без подтверждения каждого адреса, то вы можете просто подтвердить право владения доменом (смотрите #2 ниже).

2. Чтобы подтвердить право владения доменом, перейдите в Amazon SES консоль > Verified Senders > Domains. Нажмите на кнопку Verify a New Domain и следуйте инструкциям. Подтвердив домен, Вы сможете отправлять с любого адреса, находящегося в этом домене.

Важно: Не подтверждайте ваш домен через 'www' перед названием домена. Т.е. если Ваш домен mydomain.com, подтвердите mydomain.com, но не www.mydomain.com, иначе ваши письма будут выглядеть как name@www.mydomain.com (что редко используется).

3. Теперь Вам нужно запросить у Amazon Увеличение лимитов (SES Sending Limits), чтобы иметь возможность отправлять отправлять письма. Пока вы не Увеличите ваши лимиты Amazon SES API не позволит Вам отправлять письма.

Настройте обработку Bounces (отказов)

Amazon SNS требует отслеживать Bounces (Отказы) и Complaints (Спам-жалобы). Если отправка на email невозможна, то email будет помечен как Ошибка в Newsletter+, чтобы Вы были в курсе проблемных адресов и не отправляли на них снова. Чтобы сделать это возможным, Вам нужно сделать следующее:

1. Перейдите в Консоль SNS, нажмите Topics в левом меню, далее нажмите кнопку Create new topic.

Назовите его как bounces и оставьте Display name пустым, далее нажмите на кпноку Create topic.

2. После создания Топика bounces, нажмите на чекбокс 'bounces' и нажмите на кнопку Actions, после чего выберите в выпадающем списке Subscribe to topic.

3. Теперь Вам нужно заполниить поле Endpoint. Просто введите в поле Endpoint Email для Bounces (отказов) noreply@site.com. Другими словами, Вы должны создать отдельный Email для Boucnes и Complaints. Не забудьте подтвердить этот адрес в Консоли SES.

Нажмите на кнопку Create subscription.

4. Перейдите в Вашу Консоль Amazon SES > Verified Senders > Email Addresses и нажмите на email, который вы прежде подтвердили. Если Вы подтверждали домен, то перейдите в Консоль Amazon SES > Verified Senders > Domains и нажмите на домен, который Вы прежде подтвердили.

5. В разделе 'Notifications' нажмите Edit Configuration.

6. В разделе 'SNS Topic Configuration', нажмите на выпадающий список Bounces и выберите bounces (который Вы создали ранее в Консоли SNS).

7. Повторите пункты с #5 по #7 для каждого email и/или домена предварительно добавленных в Консоли SES.

8. Готово! Все email bounces будут пересылаться на Email для Bounces.

Настройте обработку Жалоб

Если получатель помечает Ваше письмо как Спам, это также может быть обработано в Newsletter+, чтобы Вы больше не отправляли этому получателю писем.
Следующие шаги идентичны настройкам Bounces (отказов), но для Жалоб:

1. Нажмите на Create new topic в Вашей Консоли SNS.

Назовите это complaints и оставьте пустым поле Display name, далее нажмите на кнопку Create topic.

2. После создания Топика complaints, нажмите на чекбокс 'complaints' нажмите на кнопку Actions, далее нажмите Subscribe to topic.

3. Теперь Вам нужно заполнить поле Endpoint. Просто введите в Endpoint Email для Bounces noreply@site.com. Другими словами, Вам нужно создать отдельный Email для Boucnes и Complaints. Не забудьте добавить этот Email в список подтвержденных адресов в Консоли SES.

Нажмите на кнопку Create subscription.

4. Перейдите в Вашу Консоль Amazon SES > Verified Senders > Email Addresses и нажмите на email, который Вы прежде подтвердили. Если Вы подтверждали домен, то перейдите в Консоль Amazon SES > Verified Senders > Domains и нажмите на домен, который Вы прежде подтвердили.

5. В разделе 'Notifications', нажмите на Edit Configuration.

6. В разделе 'SNS Topic Configuration', нажмите на выпадающее меню Complaints, и выберите complaints (который Вы ранее создали в Консоли SNS).

7. Пвторите шаги с #5 по #7 для для каждого email и/или домена прежде подтвержденных в Консоли SES.

8. Теперь у Вас настроена передача Bounces и Жалоб в Email для Bounces.

Шаг 8 Зарегистрируйтесь в Mandrill и получите Ваш API ключ

Для того, чтобы использовать Mandrill, Вам нужно зарегистрировать аккаунт в Mandrill.

1. Посетите Mandrill и зарегистрируйте аккаунт.

2. После регистрации Вы можете запросить 'API ключ' в Вашем аккаунте. Перейдите в Settings и нажмите на кнопку Add API Key.

3. Увеличьте Ваши лимиты на отправку. Перейдите в Account и нажмите на кнопку Upgrade account.

Настройте Bounce уведомления (Отказы и Жалобы)

1. Перейдите в Вашу Консоль Mandrill, нажмите на Settings в левом меню, далее перейдите в раздел Sending defaults.

2. Найдите поле 'Forward Bounce Notifications To This Address' и введите в него Email для Bounces. Нажмите на кнопку 'Save'.

Шаг 9 Зарегистрируйтесь в Sendrid Email Service

Для того, чтобы использовать Sendrid, Вам нужно зарегистрировать аккаунт в Sendrid.

1. Посетите Sendrid и зарегистрируйтесь. Вы можете выбрать Бесплатный пакет.

2. После регистрации вы сможете использовать ваш логин и пароль в Newsletter+ Software при создании Email сервера.

3. Заполните личную информацию. Ваши данные будут проверены. Вы не сможете отправлять письма, пока данные не будут проверены.

Настройте Bounce уведомления (Отказы и Жалобы)

1. Перейдите в Вашу Консоль Sendgrid, нажмите на Settings в левом меню, далее выберите подменю Mail settings.

2. Найдите настройки 'Forward Bounce' и 'Forward Spam' и введите в них Email для Bounces. Активируйте эти настройки.

Шаг 10 Зарегистрируйтесь в Mailgun

Для того, чтобы использовать Mailgun, вам нужно зарегистрировать аккаунт в Mailgun.

1. Посетите Mailgun и зарегистрируйте аккаунт.

2. После регистрации вам нужно подтвердить право владения Доменом. Нажмите на кнопку Add Your Domain.

3. Mailgun покажет Вам DNS записи, которые необходимо настроить. После того, как вы внесете все необходимые изменения в DNS может потребоваться 24-48 часов, чтобы эти изменения вступили в силу. Mailgun уведомит вас по email, когда Домен будет подтверждён.

Шаг 11 Зарегистрируйтесь в UniOne

Для того, чтобы использовать UniOne, вам нужно зарегистрировать аккаунт в UniOne.

1. Посетите UniOne и зарегистрируйте аккаунт.

2. После регистрации вам нужно подтвердить право владения сайтом. Перейдите по ссылке и следуйте инструкциям.

3. Прежде чем начать отправлять письма, Вам также нужно подтвердить все Email или домены отправителя. Для этого перейдите по ссылке и следуйте инструкциям.

Шаг 12 Настройте обработку Bounces и Жалоб

Email Сервисы требуют отслеживать bounces и жалобы. Если email проблемный, то email будет помечен как Ошибка в Newsletter+ Software и не нужно отправлять на этот Email писем. Можно включить в настройках добавление проблемных адресов в Черный список или удаление их из базы. Для обработки Bounces нужно внести в скрипт ряд настроек:

1. Перейдите в режим Администратора, нажмите на Система в левом меню, нажмите на кнопку SMTP и API.

2. Вам нужно указать Email и имя Отправителя по умолчанию. Эта информация будет использована в Email уведомлениях с вашего сайта.

3. Ниже вы можете настроить обработку Boucnes. Вам нужно ввести доступ по протоколу IMAP к отдельному ящику для ошибок, в котором Newsletter+ Software будет находить проблемные письма. Скрипт будет добавлять этот ящик в каждое письмо в поля Return-Path и X-Complaints-To. Это информация для почтовых служб, что все жалобы нужно направлять именно в этот ящик.

Шаг 13 Настройте отправку писем в Newsletter+

Email Сервисы предоставляют API ключи или иные доступы для отправки писем. Вы получили их в шагах 6-11. Для добавления Email сервисов в Newsletter+ Software Вам нужно:

1. Перейдите на ваш сайт в режим Администратора, нажмите на пункт Система в левом меню, нажмите на кнопку SMTP и API. Перейдите на вкладку Email серверы.

Важно: Вам нужно добавить по одному Email серверу для каждого Email сервиса. Каждый Email сервер - это один поток отправки писем. Newsletter+ Software использует многопоточность. Если Вам нужно отправлять быстрее, то добавьте несколько Email серверов для каждого Email сервиса, просто используйте одни и те же API ключи или иные доступы.

2. Вам нужно добавить первый Email сервер. Нажмите на кнопку Добавить.

3. Выберите Email сервис в поле Способ отправки, например Amazon SES, UniOne, Mandrill, Sendgrid или Mailgun. Заполните API ключи или иные доступы. Если в выпадающем писке нет нужного Сервиса, то добавьте его нажав на ссылку Добавить новый API аккаунт.

4. Заполните оставшиеся поля. Вы можете указать любое название сервера, например Amazon 1, Amazon 2, Madrill 10, и т.д. Это нужно Вам, чтобы отличать их. Вы можете указать Кодировку писем, Лимиты на отправку. Обязательно укажите серверу для чего его нужно использовать: Email рассылки и/или Email уведомления.

Важно: Вам нужно активировать Использование сервера для Email рассылок и/или Email уведомлений. Если вы выключите опцию "Использовать для Email рассылок", то сервер не будет использован для отправки Email рассылок.

Запомните: Если Вам нужно отправлять быстрее, то добавьте больше Email серверов для каждого Email сервиса, просто используйте те же API ключи или иные доступы.

Наслаждайтесь Newsletter+! Что дальше?

Поздравляем! Вы закончили все необходимые настройки.

Войдите в вашу установку Newsletter+ Software и начните с создания Вашего первого Пользователя. Почему пользователя? Например, у Вас есть своя компания под названием Widgets Inc. И у вас есть определенные продукты только от этой компании. Вы можете рекламировать различные продукты или компании под разными пользователями. У каждого пользователя есть свои рассылки, подписчики, статистика, Email серверы и т.д. Опционально вы можете использовать скрипт как Сервис Рассылок, настроив платные услуги.

Важно: Для каждого нового отправителя в Amazon SES или UniOne нужно подтверждать Email (шаг 7). Amazon SES автоматически отправляет подтверждение на новый Email при отправке через Amazon SES, но его нужно подтвердить, иначе письма не будут отправлены. UniOne не отправляет писем автоматически и нужно подтверждать каждый Email в ручную по инструкции из Шага 11.

Веселитесь!


Устранение неисправностей и Техническая поддержка

Пожалуйста, посетите страницу Устранения Неполадок, если вам нужна помощь.

Newsletter+ API

Посмотрите документацию API для Newsletter+.

Перевод Newsletter+

Посмотрите документацию по переводу Newsletter+ на Ваш язык.