You are here: Home > Newsletter



Terms of use:
Newsletter may only be used to send messages to subscribers who voluntary have agreed to receive messages from your website by subscribing. All other use is to be regarded as spamming and is prohibited.


  • Unlimited number of e-mails (thought your provider may have some restrictions).
  • Mails are send in user defined periods of time to avoid server timeouts.
  • Resume sending of mails after timeout or crash.
  • Multiple Newsletter Lists.
  • Subscription page with subsdcription form to one or more user selectable Newsletters Lists
  • Newsletter templates
  • User activation of subscription (optional)
  • admin defined template for subscription and unsubscription confirmation mails
  • Support for both SMTP and php mailing function through PHPMailer
  • Support for both HTML and text based mail clients through PHPMailer
  • Attachments (optional)
  • Preview of ready to send mail and possibility to send evaluation mail to admin
  • Mailing log
  • admin defined newsletter templates
  • Additional user defined fields.
  • This plugin does not require use of cookies.

Newsletter can send unlimitted number of newsleters and, depending of newsleter size, is capable to send up to 800-1000 letters per minute. Please be aware of that many providers have restriction on amount of bulk mails so to be on the safe side check out with your provider.

Table of Content

  1. License and purchase 
  2. Installation
  3. Configuration
  4. How it works
  5. Compatibility
  6. History
  7. Known problems
  8. Future development
  9. Acknowledgement
  10. Disclaimer

1. License and purchase


Remove Link License:




2. Installation  

Newsletter requires a preinstalled pluginloader.
Download and uncompress newsletter.zip 
Upload the entire newsletter folder to your "plugins" directory.  

Then follow these 2 steps:  

  1. Create a new subscription page and insert:

    #CMSimple $output.=newsletter('My Newsletter 11');#

    some place on your page (use single quotes only).This page will be used to subscribe to your newsletter. You can call it "Subscribe single Newsletter" or anything else. 
  2. Create a second page with the title My Newsletter 11 (same title as you specified on the page to administration of subscribers ). This is the page where you create your newsletters content.  

To create multiple newsletters repeat step 1 and 2. Remember to name pages something else (for instance "My Newsletter 2").  

To create a subscription page with subscription to multiple Newsletters insert a comma separated list of newsltters:

#CMSimple $output.=newsletter('My Newsletter 11, My Newsletter 12, And so on');#
or in CMsimple_XH just { {{newsletter('My Newsletter 11, My Newsletter 12, And so on');}}} (with no spaces between {{)

and create corresponding Newsletter content pages as described above.



3. Configuration 

  • adminmail: the mail address where you want to send test mail. If left empty the CMSimple mailform email is used.
  • from: is the senders' mail. If left empty the CMSimple mailform email is used.
  • form name: is the senders' name. If left empty the CMSimple site title from your language file is used (CMSimple_XH only).
  • mail confirm subscription: values mail, user or no (yes can be used instead of mail). 
    mail or yes: the mail is send to new subscriber. The template of this mails is defined in a "Confirmation" template in Plugin Main Settings.
    user: To activate the subscription the subscriber must reply the mail containing a link to confirmation page on your website. The content of the mail is defined in Plugin language fields "subscribe confirm subject" and "subscribe confirm". All subscription data is encrypted
  • mail confirm unsubscription: (yes or no). If yes the mail is send to the subscriber otherwise no. The template of this mail is defined in a "Confirmation" template in Plugin Main Settings and the content is defined in Plugin language fields "unsubscribe success subject" and "unsubscribe success".
  • max execution time: is the server time in seconds before timeout. You can find it by executing phpinfo.php on your server. Look for max_execution_time. If you experience timeouts when sending newsletters reduce this value to something lower.
  • separator: You can have several newsletters on the same page. Only the one over the separator will be send. Default is "< hr  / >".
  • smtp: insert your internet providers smtp server name. If left blank newsletter will send mails through php mail command. The best sending method is smtp.
  • encrypt key: 8 to 32 arbitrary characters without spaces. Used to encrypt subscription information in activation mail.

Configuration in language files: 

  • charset: Encoding of your choice.If left empty then CMSimple encoding is used.
  • alt body and alt footer: contains mail content of text based mails received by no HTML mail clients. A link to the newsletter page is added at the end of content of alt body.
  • alt unsubscribe: contains a text followed by link to unsubscribe page (text based mails only).
  • footer_unsubscribe contains a text that will be converted to a link to the unsubscribe page and replace the placeholder {UNSUBSCRIBE} in a newsletter template.
  • unreadable: contains text that will be converted to a link to the newsletter content page and replace the placeholder {NOT_READABLE} in a newsletter template. To deactivate leave it empty and/or remove {NOT_READABLE} from the template.
  • subscriber group contains labels to e-mail input field and to user defined unlimited number of extra text fields. To define extra text fields enter a list of labels to "subscriber fields label" separated by the "subscribe fields delimiter" (default is semicolon). The e-mail field is always mandatory. Extra text fields are only mandatory when "subscriber field mandatory" contains some error message. "Subscriber email empty" and "subscriber fields empty" contains an error message if some fields are left empty before form submission.
  • Newsletter creates a mandatory email field. To get other information from subscriber you must create additional fields by filling the field "Fields label" in section Subscribers with a list of field labels separated by a delimiter defined in "Fields delimitter" in the same section, f.ex. "Your Title; Your Name".

Configuration of stylesheets for subscription form .

You may change the values of css classes newsletter_label and newsletter_inputfiel to feet the with of your template.

Newsletter Templates:

Newsletter contains a HTML template that is copied to each created newsletter. Multilanguage sites are supported too. Templates contains 3 predefined placeholders: {NOT_READABLE}, {CONTENT} and {UNUBSCRIBE}. To show Text fields defined in group subscriber in language file insert placeholders named {TEXTFIELD_1}, {TEXTFIELD_2} and so on.

Farther there is defined a template for the confirmation sent to the user after subscription and unsusbscription. This template contains only one placeholder that will be replaced with corresponding text based on confirmation setup in configutation file.

All templates are editable from admin section of Newsletter plugin.

4. How it works

It depends of your provider and the restrictions on your mail server if you can send bulk mail at all.

Below is a look of Newsletters sending page.


  • Select Mailing List (only visible if there are several mailing list)
  • Change Subject if necessary
  • Choose attachment from list if any (atachment list is listing all files in download folder) 
  • Change admin email address if necessary
  • Push "Publish"

If "Send test mail" is checked then you send only one newsletter to yourself. Check the content, inks and images and if your newsletter is as expected then uncheck the check box and push "Publish" again.

Sending of newsletters begins. You will first se a screen with sending instruction. After a few seconds the screen is refreshed and the mails are sent. If you are sending many or big newsletters  then the sending stops after the time specified in "max execution time" the screen is refreshed with status information and posting continues after some time (be patient). After all newsletters are sent you will see the page with the list of all sent newsletters(you can find the same information in a log).

Handling timeouts (white screen).

Sending a bulk mail can result in server timeout. It is usually due to that not all emails may be sent before the server times out. Especially if you send a large amounts of data in your newsletters  or if use a slow sever you will experience HTTP error 500.  

Usually you will be able to continue to send newsletters simply by pressing F5 to refresh the browser. If it does not help stop sending and go back to your  "Publish" screen. If you are still in the same browser the "Restore" field will contain number for the last sent newsletter. Change value of "max execution time" in your configuration to something lower and push the "Publish" button again. Newsletter resumes sending the subsequent newsletters. If "Restore" field is empty then you will find the number of the last posted newsletter in the log file. Enter this value in "Restore" filed and continue as described above.

When restoring the sending the counter shows the total number of sent emails.

Multilanguage sites

Create different subscription and newsletter pages for each second language site and then newsletter will create corresponding mailing lists.  You may not use the same newsletters names in different langauge files as they will use the same mailings list..

"Subscribe Newsletter" + "Newsletter" on your main cmsimple page
"Subscribe Newsletter EN" + "Newsletter EN" on your 2lang page in English
"Subscribe Newsletter FR" + "Newsletter FR" on your 2lang page in French

Updating subscribers list trough other plugins

Newsletter contains external function that can be accessed by other plugins. For instance signe for a membership and a newsletter in the same form. To do that call the function extern_AddSubscriberToList(" Newsletter_name", $email); included in index.php of Newsletter plugin.

Form Mailer plugin includes function user_function() from where you can call to Newsletter. 

5. Compatibility

The Newsletter plugin is tested with CMSimple_XH version 1.7 and php version 7.

It was tested with more than 1000 real mail addresses and mails up to 2MB large.

The Newsletter was successfully checked as HTML 4.01 Transitional and  HTML 1.0 Transitional.  

6. History 

  • version 2.4.2 
    updated to CMSimple XH version 1.7
  • version 2.4.1
    minor bug fixes
  • version 2.4.0
    php 7 ready
  • version 2.3.2
    compatibility with CMSimple_XH version 1.6.
    Added recognition of relative urls. It is not necessary to change editor setup to absolute urls.
    changed log. Each shipment of newsletter is loged in a separate file. Old logs are copied to files with a time stamps. Until 5 copies are stored. The actual log file can be accessed trough plugin admin. Copies are only accessible through ftp.
  • version 2.3.1
    A minor bug fix in file admin.php.
    German translation by b&s creations 
  • version 2.3.0 
    Added optional selection of newsletter subscriptions from the list of newsletters defined by administrator 
    Added support for {{ {PLUGIN:....}}} plugins call
    Optimization of success/error notifications. 
    PHPmailer updated to version 5.2.1 
  • version 2.2.1
    IE bug fix in admin php.
  • version 2.2.0
    Added template for subscription and unsubscription confirmation mail.
    released under Remove Link licens.
  • version 2.1.3 
    all calls to eregi replaced by stristr again
  • version 2.1.2 
    bug fix in syncronization of subscriber list and newsletter sending. All removed eregi from before version 2.1.1 are unfortunetly back again.
  • version 2.1.1 
    minor bug fix
    function eregi removed for comaptibility with php 5.3 and higher.
  • version 2.1.0 
    added templates and extra input fields.
    Fixed bug in unsubscribe function.
    Added link to newletter pageif the newsletter is not readable
    Optimized to use with pd_scripting.
    Changed: if charset is empty then cmsimple default codepage is used.
    Changed: Newsletter attahcments are stored in CMSimple downloads directory. 
  • version 2.0 
    resolved compatilbility issues with hi_pd_scripting plugin
  • version 1.9  
    Subscribers email adress is passed to subscription page through the unsubscribe link in the newsletters.
  • version 1.8 
    added urlencoding of subscription string when "mail confirm subscription" is set to "user". 
  • version 1.7 
    minor bug fix. Some html line breaks moved to language files.
    Dutch transaltion by svasti
  • version 1.6 
    added user confirmation of subscription (optional).
  • version 1.5 
    bug fix (utf-8 correction of confirmation mail and encoding of unsubscribe link by svasti.)
    German translation by svasti.
  • version 1.4 
    bug fix.
  • version 1.3 
    Unused CMSimple tags h4 and above can be used in newsletter content.
    added definition of charset in plugin config.
    added class newsleter_legend in plugin stylesheets.
  • version 1.2 
    bug fixes: absolute path to unsubscribe link and minor fixes in text version of the Newsletter.
  • version 1.1
    bug in absolute path corrected and path is urlencoded.
    added sk translation by Tata.
  • version 1.0 

7. Known problems

Some mail servers destroys confirmation link when "mail confirm subscription" is configured as user. See cmsimpleforum.

8. Future development

  • Rewrited mail confirmation to solve problems on servers that destroy links.
  • east european languages gender dependence.

9. Acknowledgement

The inspiration to this plugin comes from geniz.
Mailing facility is based on PHPMailer.
Slovak translation by Tata.
French translation by MicroVintage.
German translation by b&s creations 
Dutch translation by bastingse and svasti

10. Disclaimer

This CMSimple plugin is distributed in the hope that it will be useful - without any warranty; without even the implied warranty of fitnes for a particualr purpose.

© simpleSolutions, 2010-2018.

This page is powered by
CMSimple plugin: Tooltip and Modalbox © simpleSolutions



All plugins on this site are validated according to CMSimple_XH standard 





Newsbox Rotator demo


Hold the cursor over Newsbox Rotator area to pause rotation.Move the mouse outside area to continue rotation.

In CMSimple XH not published news are not visible in News Rotator. 



Newsbox Rotator demo

Newsbox Rotator Test 1

Newsbox_1 test test test


test1 test2 test3 test4 test5 test6 test7 test8 test9 

Newsbox Rotator demo

CMSimple plugin: Newsbox Rotator
© simpleSolutions
dow Meeting weekly event

Last update:

Powered by CMSimple | Template by simpleSolutions

(X)html | css | Login