Модуль Simplenews позволяет создавать, публиковать и отправлять рассылки подписанным на них пользователям. HTML-письма могут отправляться при использовании модуля Mime Mail или HTML Mail.
Отметьте: отправка рассылки при запуске cron (cron.php) требует, чтобы базовый URL (файл settings.php, переменная $base_url) был настроен корректно. В противном случае, ссылки внутри рассылки работать не будут.
Некоторые страницы, на которых модуль размещает свои формы:
Кроме того, список рассылок, на которые пользователем оформлена подписка, показывается на странице профиля. Также здесь показывается ссылка для перехода к управлению подпиской на рассылки.
Темизировать рассылку можно воспользовавшись специальными шаблонами. Скопируйте .tpl.php-файлы из папки theme (находится в папке модуля) в папку своей темы. Темизацию можно выполнить как в целом, так и для каждой рассылки:
Темизация нижней колонки рассылки:
Файлы шаблонов содержат справку и все доступные переменные. В зависимости от того, как будут отправляться письма (например, при каком событии срабатывает cron), может использоваться либо стандартная, либо настроенная управляющим тема. Чтобы предотвратить это, Simplenews поддерживает настройку темы письма из модуля Mailsystem. Установите его, выберите тему письма и шаблон рассылки из этой темы будет использоваться независимо от того, какие темы ещё включены.
Для темизации блока оформления подписки/отписки, используйте файл simplenews-block.tpl.php. Для этого, скопируйте его из папки модуля в папку своей темы и отредактируйте содержание. Файл содержит справку с перечислением всех доступных переменных:
<?php
/**
* @file
* Default theme implementation to display the simplenews block.
*
* Скопируйте этот файл в папку своей темы, чтобы темизировать блок рассылки самостоятельно.
* Переименуйте файл в simplenews-block--<идентификатор-рассылки>.tpl.php, чтобы переопределить его для определённой рассылки через её идентификатор.
*
* Доступные переменные:
* - $subscribed: текущий пользователь подписан на рассылку
* - $user: текущий пользователь залогинен
* - $newsletter_id: идентификатор рассылки
* - $message: объявление (Стандартно: «Будьте в курсе наших последних новостей!»)
* - $form: форма подписки на рассылку *1
* - $subscription_link: ссылка на форму подписки на странице 'newsletter/subscriptions' *1
* - $newsletter_link: ссылка на список выпусков этой рассылки
* - $issue_list: list of newsletter ids *2
* - $rssfeed: RSS-лента рассылки (series) *2
* Note 1: требуется наличие права «подписка на рассылку»
*
* Модуль Simplenews управляет показом содержания блока.
* Следующие переменные доступны для этой цели:
* - $use_form : TRUE = показывать форму; FALSE = показывать ссылку на example.com/newsletter/subscriptions
* - $use_issue_link : TRUE = показывать ссылку на список выпусков рассылки
* - $use_issue_list : TRUE = показывать список выпусков рассылки
* - $use_rss : TRUE = показывать RSS-ленту
*
* @see template_preprocess_simplenews_block()
*/
?>
<?php if ($message): ?>
<p><?php print $message; ?></p>
<?php endif; ?>
<?php if ($use_form): ?>
<?php print render($form); ?>
<?php elseif ($subscription_link): ?>
<p><?php print $subscription_link; ?></p>
<?php endif; ?>
<?php if ($use_issue_link && $newsletter_link): ?>
<div class="issues-link"><?php print $newsletter_link; ?></div>
<?php endif; ?>
<?php if ($use_issue_list && $issue_list): ?>
<div class="issues-list"><?php print $issue_list; ?></div>
<?php endif; ?>
<?php if ($use_rss): ?>
<?php print $rssfeed; ?>
<?php endif; ?>
Блок рассылки может быть темезирован как для всех рассылок – simplenews-block.tpl.php, так и для каждой рассылки в отдельности – simplenews-block.tpl--[tid].php
simplenews-multi-block.tpl.php:
<?php
// $Id: simplenews-multi-block.tpl.php,v 1.6 2009/01/02 12:01:17 sutharsan Exp $
/**
* @file
* Default theme implementation to display the simplenews block.
*
* Copy this file in your theme directory to create a custom themed block.
*
* Available variables:
* - $subscribed: the current user is subscribed to the newsletter
* - $user: the current user is authenticated
* - $message: announcement message (Default: 'Stay informed on our latest news!')
* - $form: newsletter subscription form
*
* @see template_preprocess_simplenews_multi_block()
*/
?>
<?php if ($message): ?>
<p><?php print $message; ?></p>
<?php endif; ?>
<?php print render($form); ?>
simplenews-newsletter-body.tpl.php:
<?php
/**
* @file
* Default theme implementation to format the simplenews newsletter body.
*
* Copy this file in your theme directory to create a custom themed body.
* Rename it to override it. Available templates:
* simplenews-newsletter-body--[tid].tpl.php
* simplenews-newsletter-body--[view mode].tpl.php
* simplenews-newsletter-body--[tid]--[view mode].tpl.php
* See README.txt for more details.
*
* Available variables:
* - $build: Array as expected by render()
* - $build['#node']: The $node object
* - $title: Node title
* - $language: Language code
* - $view_mode: Active view mode
* - $simplenews_theme: Contains the path to the configured mail theme.
* - $simplenews_subscriber: The subscriber for which the newsletter is built.
* Note that depending on the used caching strategy, the generated body might
* be used for multiple subscribers. If you created personalized newsletters
* and can't use tokens for that, make sure to disable caching or write a
* custom caching strategy implemention.
*
* @see template_preprocess_simplenews_newsletter_body()
*/
?>
<h2><?php print $title; ?></h2>
<?php print render($build); ?>
simplenews-newsletter-footer.tpl.php:
<?php
/**
* @file
* Default theme implementation to format the simplenews newsletter footer.
*
* Copy this file in your theme directory to create a custom themed footer.
* Rename it to simplenews-newsletter-footer--[newsletter-id].tpl.php to override it for a
* newsletter using the newsletter id.
*
* @todo Update the available variables.
* Available variables:
* - $build: Array as expected by render()
* - $build['#node']: The $node object
* - $language: language code
* - $key: email key [node|test]
* - $format: newsletter format [plain|html]
* - $unsubscribe_text: unsubscribe text
* - $test_message: test message warning message
* - $simplenews_theme: path to the configured simplenews theme
*
* Available tokens:
* - [simplenews-subscriber:unsubscribe-url]: unsubscribe url to be used as link
*
* Other available tokens can be found on the node edit form when token.module
* is installed.
*
* @see template_preprocess_simplenews_newsletter_footer()
*/
?>
<?php if (!$opt_out_hidden): ?>
<?php if ($format == 'html'): ?>
<p class="newsletter-footer"><a href="[simplenews-subscriber:unsubscribe-url]"><?php print $unsubscribe_text ?></a></p>
<?php else: ?>
-- <?php print $unsubscribe_text ?>: [simplenews-subscriber:unsubscribe-url]
<?php endif ?>
<?php endif; ?>
<?php if ($key == 'test'): ?>
- - - <?php print $test_message ?> - - -
<?php endif ?>
Cron требуется для отправки большому количеству получателей. Если у вас среднее или большое количество подписчиков (например, больше 500 человек), всегда используйте cron для отправки рассылки.
Чтобы использовать cron:
Чтобы не использовать cron:
Эти параметры находятся на странице: Конфигурация → Веб-сервисы → Рассылки → Параметры → Отправка писем.
Возможность подтверждения подписки/отписки на рассылку:
Отметьте: в некоторых странах запрещено использование вариантов «Скрыто» и «Одиночный».
Стандартно, ссылка отписки приведет пользователя на страницу подтверждения. После подтверждения пользователь будет перенаправлен на первую страницу и ему будет показано соответствующее сообщение. На странице управления подпиской можно определить альтернативную страницу назначения: Структура → Конфигурация → Веб-сервисы → Рассылки → Настройка → Подписка.
Чтобы пропустить страницу подтверждения, можно добавить параметр в URL подписки. Пример: [simplenews-subscribe-url]/ok. Когда определена альтернативная страница назначения, дополнительные параметры будут добавлены в URL назначения. Пример: [simplenews-subscriber:subscribe-url]/ok. Назначение: node/123 → node/123/ok.
2008.06.26 | Jeff Eaton. Модуль Simpleviews |
Комментарии
а скриншоты где?))
Да вообще бы хорошо информацию по модулю, как и с чем ставится, как рассылки отправляются, как делать формы подписки к ним и отписки