“E-mailer v1.12” Documentation by “Paweł Kłopotowski”


“E-mailer”

Created: 2016-03-09
By: Paweł Kłopotowski
Email: webmaster@pklopotowski.pl

Thank you for purchasing my Emailer Program. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!


Table of Contents

  1. About this program
  2. Installation
  3. How it works
  4. How to prepare mailing campaign
  5. E-mailer features
  6. Requirements
  7. SMTP configuration description
  8. Q&A section
  9. Your own component
  10. All possible variables in email layout
  11. Subscription widget with double opt-in option

A) About this program - top

This program is for manage mailing campaigns, newsletters. Easy to use for customers without any complications. Simple menu, many examples of email templates. User friendly view. It also contains predefined sample data for easy understanding how it works and step by step instruction included to the system.


B) Installation - top

Simplified installation process:

  1. Create folder on your hosting server
  2. Just copy files to this folder
  3. Login using default credentials
    • default login name: demo
    • default password: demo
  4. Click button to creste databse structure (automatically process)
  5. Go to system configuration section and change login and password according to your needs

C) How it works - top

It sends emails using PHP mail() function. Whole sending process use ajax, so your browser has to be online during this operation. Progress of sending is showed on the browser screen on the progress belt. Mails are send one by one. Interval of sending emails can be set up in settings section. Check your hosting limits for this issue.


D) How to prepare mailing campaign - top

Whole process is described step by step on the dashboard view.

  1. At first add tags, this will help you find customers and will help you easily prepare an advertising campaign
  2. Next add emails to your database system. You can also upload CSV file with emails to your data base
  3. Add sender, you can decide from whom your customers will receive an email
  4. Add template, you can prepare an unlimited number of templates, with unlimited number of attachments
  5. Add new campaign, prepare unlimited campaigns. You can send campaign at any time, stop and resume also
  6. To select recipients you have to use filter 'search fiels' over recipients table

E) E-mailer features - top

List of features included in this mailing system:


F) Requirements - top


G) SMTP configuration description - top


H) Q&A section - top

  1. Why it is better to have own dedicated server for mailing?

    First of all, no limits. For ordinary hosting, you can send up to 1,000 emails per hour and probably the same amount within one day (depending on the hosting limits range from a few hundred to a few thousand emails a day). On your server, you do not have such restrictions and also have the ability to send emails from your domain. You can also send e-mails as if the server was to be under a different domain (it is in this case set the so-called SPF records and TXT domain - for details ask your hosting provider).

  2. What are tags?

    Make it easy to find mailing addresses and preparing an advertising campaign at a specific recipients.

  3. How to add the name of the recipient to email template?

    Use phrase {RECIPIENT_NAME} in the content template email or in the title of the template mail. The phrase will be replaced by the name of the recipient e-mail, in case that the information has been added to the recipient's email address.

  4. How to add a new translation?

    Copy the file reference english.php, give it a name that describes your language for example mylanguage.php and paste to the same folder. Correct all the texts contained in the new file. Be sure to save the file in UTF-8 w / o BOM. Language file is in the directory 'languages'.

  5. How do I add tags to an email?

    First, you need to add a few tags using add tags menu in the email addressess section. Then when you add/edit each email address can be assigned to any tag. All tags will be added below the form to add/edit recipients.

  6. How to add the ability to unsubscribe out of receiving messages?

    Use phrase {UNSUBSCRIBE} in the link in the email template content. The phrase will be replaced with a link for the particullar recipient. When he/she will click it, system will save in the database information about the discharge of the campaign. Email address will not be removed from the database.
    Usage:
    <a href='{UNSUBSCRIBE}'>unsubscribe from the newsletter</a>.

  7. How to add predefined email templates?

    30 sample templates mailing, click add templates in the usefull extras section

  8. How do I add images to e-mails?

    - As an attachment to an email. In this case, the template IMG tag attribute SCR must be set to contentID, means CID, eg:
    <img src='cid:logo.jpg' >
    - As an absolute link to an image in external resources, such as:
    <img src='http://www.domain.ext/logo.jpg' >.

  9. How does the tracking of emails?

    For each sent email system can add an image tag IMG, which attribute SRC contains tracking code to display a specific message. Tracking will only work when the mail recipient agrees to show images of the received message.

  10. How not to be a spammer?

    - Collect consent to receive messages when creating a mailing list.

    - Use a variety of content for each recipient, use ex. {RECIPIENT_NAME} to differentiate checksums of your mailing.

    - Do not use the keywords like: sex, viagra, porn.

    - Do not use key phrases such as: address from a public database, it is not commercial information in mind, uninterested Sorry, it does not constitute an offer within the meaning if you do not want, click here to unsubscribe, free, special offer, buy it now - if you have to use this such phrases you should consider to put them in the form of graphics.

    - Do not use too many graphics, spam filters examine the ratio of the graphics to text.

    - Mail should not be too heavy.

    - The fewer the better attachments.

    - Do not impersonate another domain.

    - Do not send emails from non-existent email address.

  11. How to increase clicks and reads campaign?

    The biggest influence on the content that you send to your customers and the time and the frequency with which you do it. In most cases, the contact should not be more frequent than two times a month. Respect your customers and they will not throw you to the spam.

  12. How to choose the addresses for mailing?

    Using tags, type them separated by spaces in the search field above the table of addresses.

  13. What are the limitations of this system?

    There is no restrictions, but the bottleneck may be your computer. The program uses AJAX to send e-mails IDs are stored in the browser's memory.

  14. Limit messages on the server hosting?

    Depending on the hosting limits range from a few hundred to a few thousand emails a day, check with your service provider.

  15. Broken connection when sending campaign?

    You can resume the sending of campaigns, emails will be sent to the other recipients. Each sent email sets a unique marker in the database and the campaign itself will not be re-sent to the same recipient.


I) Your own component - top

You can add your own component to this mailing system. There is an example component with some description in the code prepared in folder 'components/example_component'. Make a copy of it and add your custom code.

Base component structure:

Posting data rules:

Receiving data rules:

Prepare menu link to your component:


J) All possible variables in email layout - top

There is a possibility to use some variables in email templates. These variables will be changed for some data from the system during sending process.

For email subject:

For HTML version:

For TXT version:


K) Subscription widget - top

Your potentially customers can subscribe to this mailing system. There is subscription form generator included.

Widget options:


Once again, thank you so much for purchasing this Program. As I said at the beginning, I'd be glad to help you if you have any questions relating to this mailing system. No guarantees, but I'll do my best to assist.

Paweł Kłopotowski

Go To Table of Contents