Version
7.0.1
About PHP Newsletter
PHP Newsletter is an email marketing tool for organizing E-mail newsletters from your website, any information.
script is easy to use, easy to install, versatile in configuration and requires minimal requirements from hosting. PHP Newsletter is written in the PHP programming language,
has a simple and intuitive interface, and also has many useful functions and features,
such as creating a list of newsletters with sorting by categories, a visual editor for email templates, sending emails with attachments, sending via SMTP server,
import/export of the database of email addresses, managing subscribers, starting a newsletter on schedule (cron), statistics on newsletters and much more that an email marketer needs.
Requirement
- PHP 8.2 and above;
- MySQL database version 5.6 and above;
- Apache 2+ mod_rewrite, nginx;
- mail();
- MB String PHP extension;
- Zip PHP extension;
- cURL PHP extension;
- Iconv PHP extension;
- GD2 PHP extension.
Opportunities
- sending emails via smtp server, mail(), and sendmail;
- subscription to a newsletter with the option to unsubscribe;
- visual editor (WYSIWYG) for email templates;
- personalization of emails;
- running a scheduled mailing list (cron);
- selection of mailing format (plain and html);
- support for most known encodings;
- adding standard headers to the newsletter that are used in bulk or automated newsletters: Precedence(bulk, junk or list) and list-unsubscribe;
- adding a DKIM signature to the email header;
- sending a mailing list with attachments;
- creating an unlimited mailing list;
- sorting mailings by category;
- managing the subscriber base (changing, deleting, moving, and activating).
- subscription form;
- importing email addresses from a text file and MS Excel;
- export of email addresses to a text file and MS Excel;
- statistics on the number of sent, unsent, and read emails* with the ability to export to MS Excel;
- link traffic statistics;
- user-friendly web-based admin interface;
- convenient and simple installation wizard.
New features in version 7.0.x
- Added macros;
- Improved performance.
Installation
- Extract the distribution to any directory on your website, for example, ‘/phpnewsletter’;
- Set the access permissions (CHMOD) to 775 for the following files and folders:
- .env files
- Folders
- bootstrap/cache
- public
- storage
- Run the installation wizard in your browser: http://yourwebsite/phpnewsletter/install/. and follow the installation wizard’s instructions
Customization
Configuring email distribution via the smtp server
In order to send a newsletter via an SMTP server, follow the steps below.
Log in to the admin panel, go to the “Settings” section, and select “SMTP server” as the “Sending method” in the “Newsletter settings” section.
Then, go to the SMTP section and add the SMTP server.
Configuring sending emails via Mail.ru
E-mail: vasyapupkin@mail.ru
Login of the mailbox / password: the name of the mailbox in full (vasyapupkin@mail.ru), your password for the mailbox
smtp server: smtp.mail.ru (smtp.list.ru / smtp.bk.ru / smtp.inbox.ru)
Port of the smtp server: 465
Connect via a secure connection (SSL): yes
Authentication method: LOGIN
Sending method: SMTP server
Setting up sending emails via Gmail
E-mail: vasyapupkin@gmail.com
Login of the mailbox / password: the name of the mailbox in full (vasyapupkin@gmail.com), your password for the mailbox
smtp server: smtp.gmail.com
ѕort of the smtp server: 465
ѕo connect via secure connection (SSL): yes
Authentication method: LOGIN
Method of sending: SMTP server
Configuring sending emails via Yandex mail
E-mail: vasyapupkin@yandex.ru
Login of the mailbox / password: the name of the mailbox in full (vasyapupkin@yandex.ru), your password to the mailbox
smtp server: smtp.yandex.ru
Port of the smtp server: 465
Connect via a secure connection (SSL): yes
Authentication method: LOGIN
Sending method: SMTP server
Setting up sending emails via rambler.ru
E-mail: vasyapupkin@rambler.ru
Login of the mailbox / password: the name of the mailbox in full (vasyapupkin@rambler.ru), your password to the mailbox
smtp server: smtp.rambler.ru
Port of the smtp server: 465
Connect via a secure connection (SSL): yes
Authentication method: LOGIN
Method of sending: SMTP server
Configuring sending emails via hotmail
E-mail: vasyapupkin@hotmail.com
Login of the mailbox / password: the name of the mailbox in full (vasyapupkin@hotmail.com), your password to the mailbox
smtp server: smtp.live.com
Port of the smtp server: 465
Connect via secure connection (SSL): yes
Authentication method: LOGIN
Method of sending: SMTP server
Setting up sending emails via Yahoo mail
E-mail: vasyapupkin@yahoo.com
Mailbox login / password: full mailbox name (vasyapupkin@yahoo.com), your mailbox password
smtp server: smtp.mail.yahoo.com
smtp server port: 465
Connect via secure connection (SSL): Yes
Authentication method: LOGIN
Sending method: SMTP server
Setting up a scheduled mailing list
In the cron settings, enter the following commands:
- * * * * /usr/bin/php -q /var/www/phpnewsletter/artisan schedule:run >/dev/null 2>&1
The first command is responsible for sending the newsletter to subscribers, and the second command is responsible for resending the newsletter to subscribers who did not receive the newsletter due to mail server errors or who were unable to send the newsletter for various reasons.
In the example, a php script is executed every minute, where /usr/bin/php is the path to the php interpreter. This parameter is mandatory. It may differ from the example on your server. In order to find out the path, you need to run the command which php or ask your hosting provider.
/var/www/phpnewsletter/artisan is the absolute path to the file on your web server, so specify your own.
Once you have configured the cron job, go to the admin panel in the “Newsletter Scheduling” section and add a newsletter schedule by selecting a template, specifying the start and end times, and selecting a subscriber category.
