Quickstart (for Drupal 7 version)
- Install and enable the module (and its dependencies).
- Adjust Simplenews configuration settings at /admin/config/services/simplenews. There you can also set newsletter "categories", each of which is a mailing list.
- Create/edit a content type that you want to be for newsletters. The crucial setting is in the "Publishing options" tab, labeled "Use as simplenews newsletter".
- Subscribe members via /admin/people/simplenews. Alternately, people can subscribe themselves via subscription blocks (which you expose at /admin/structure/block).
- Create a node of the enabled content type. After saving, you'll see a "Newsletter" tab, through which you can send the node as a newsletter.
- Taxonomy module.
- Large mailing lists require cron (poormans cron can be used but not recommended)
- HTML-format newsletters and/or newsletters with attachments require mime mail module.
- Create a new directory "simplenews" in the sites/all/modules directory and place the entire contents of this simplenews folder in it.
- Enable the module on the Modules admin page: Administer > Site building > Modules
- Grant the access at the Access control page: Administer > User management > Access control. (Or Administration > People > Permissions if using Drupal 7)
Configure Simplenews on the Simplenews admin pages:
- Drupal 5:
Administer > Content management > Newsletters
choose tab Settings
- Drupal 6:
Administer > Site configuration > Simplenews
Select a content type to use as newsletter, select a vocabulary which tags will be newsletter series.
- Drupal 7:
Administration > Configuration > Web Services > Newsletters
choose tab Settings
To enable users to (un)subscribe to a newsletter use the "subscribe to newsletters" permission. This will enable the subscription form in the Simplenews block and give access to the subscription page at /newsletter/subscriptions.
With the Simplenews block users can subscribe to a newsletter. For each newsletter one block is available.
Enable the Simplenews block on the Administer blocks page: Administer > Site building > Blocks (or Administer > Structure > Blocks for Drupal 7), and visit the block configuration page to configure the block settings. Permission "subscribe to newsletters" is required to access the subscription form in the simplenews block or to view the link to the subscription form.
Simplenews block theming
More control over the content of simplenews blocks can be achieved using the block theming. Theme your simplenews block by copying simplenews-block.tpl.php into your theme directory and edit the content. The file is self documented listing all available variables.
The newsletter block can be themed generally and per newsletter:
* simplenews-block.tpl.php (for all newsletters)
* simplenews-block--[tid].tpl.php (for newsletter series tid)
Simplenews supports multilingual newsletters for node translation, multilingual taxonomy and url path prefixes. When translated newsletter issues are available subscribers receive the newsletter in their preferred language (according to account setting). Translation module is required for newsletter translation.
Multilingual taxonomy of 'Localized terms' and 'per language terms' is supported. 'per language vocabulary' is not supported. I18n-taxonomy module is required.
Use 'Localized terms' for a multilingual newsletter. Taxonomy terms are translated and translated newsletters are each taged with the same (translated) term. Subscribers receive the newsletter in the preferred language set in their account settings or in the site default language. Use 'per language terms' for mailing lists each with a different language. Newsletters of different language each have their own tag and own list of subscribers.
Path prefixes are added to footer message according to the subscribers preferred language.
The preferred language of anonymous users is set based on the interface language of the page they visit for subscription. Anonymous users can not change their preferred language. Users with an account on the site will be subscribed with the preferred language as set in their account settings.
Useful tip for a standalone newsletter subscription page
Here's how to create a standalone page that JUST lets a user subscribe to a newsletter:
- Create a new Page called "Subscribe to Newsletter" or whatever you want.
- Add to the body of the page whatever text you would like
- Go to the block administration page.
- Enable the "subscribe" block from Simplenews, and put it in the content region of the page.
- Configure the block. Down at the bottom of the configuration page, select the setting that says "Display ONLY on the folowing pages." Put the path to the page you created there.
Useful end user links related to newsletters
There are a couple of direct links that any visitor can use to access newsletters: "www.example.com" should be replaced with your Drupal installation's URL.
Subscribing to newsletters, and managing your subscriptions:
To view sent issues of the "my-news" newsletter:
This URLs assume you have Clean URL's enabled. If not, you need to put "?q=" after "example.com/" if they are not.