Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

cjw_newsletter documentation

cjw_newsletter is the newsletter system of Exponential: newsletter editions are content, visitors subscribe to lists with a double opt-in, editions go out from the cron in the background, and bounces, the blacklist and…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/ext/cjw_newsletter/README.md

On this page

cjw_newsletter documentation

cjw_newsletter is the newsletter system of Exponential: newsletter editions are content, visitors subscribe to lists with a double opt-in, editions go out from the cron in the background, and bounces, the blacklist and the e-mail preferences of Exponential keep the lists clean.

This folder holds the guides of the extension. The 4.0 manual (cjw_newsletter_documentation.pdf, .odt) still describes the content classes, the lists, the editions and the sending; the guides below describe what 4.2.0 adds. INSTALL and FAQ in the extension's root folder cover the installation.

Start here

PageForWhat it covers
Upgrade from 4.1 to 4.2administratorsThe database update for MySQL, PostgreSQL and SQLite, the one-time commands, the defaults, the settings to switch on, the cron parts, the requirements
CHANGELOGeveryoneWhat changed in every release

The guides of 4.2.0

GuideAreaWhat it covers
DeliverabilitysendingHard bounces and complaints on the suppression list, retries of soft bounces, rate limits, batches and pauses, test groups, subscribe and unsubscribe by e-mail, the suppression import
EditorialeditorsRecurring sends (weekdays, weekly, monthly; a copy of a template or the latest edition), article pools and the article picker, the approval of editions through the collaboration inbox
Renderingeditors, designersPlaceholders, the newsletter condition (a part only some subscribers get), interests and the block "articles for your interests", one edition in several languages, the skins company, news and shop, plain text views, the preview as a subscriber
Statisticseditors, data protectionOpens and clicks (per person only with consent, anonymous totals otherwise), the report of a send, the dashboard trend, the article box, A/B subject tests, the CSV export, retention and erasure
SMSadministratorsNewsletters by SMS: the transports (file, generic HTTP/JSON, a Twilio-style preset), the mobile number confirmed with a code, STOP, the rate limit
Import, export and migrationadministratorsThe CSV import with a column mapping, a preview, a dry run and a consent source; the subscriber export; the migration from the old eznewsletter extension
The schema of 4.2.0developersEvery table and column 4.2.0 adds, with its meaning
The administration in admin4administrators, designersThe admin4 copies of every administration page (4.2.22), the components, the Bootstrap icons per function and state, the stylesheet and its token rules, the test that keeps it complete

Where the features show

PageWhat 4.2.0 adds there
Newsletter dashboard (newsletter/index)A block per area: deliverability (rate limits, batches, bounces, suppressions, test groups, mail-in addresses), editorial (recurring sends, approvals waiting, pools), rendering (skins, languages), statistics (totals, trend, A/B tests), SMS (queue, consents, STOP replies), import and migration runs
E-mail preference page (mailpreferences/settings, public and admin)In the row of the newsletter category: the language of the newsletters, the interests per list, the mail-in addresses. The categories "Newsletter statistics" (the consent to counting per person) and "Newsletters by SMS" (with the mobile number and the code)
Notification settings (notification/settings, public and admin)The newsletter card: the subscribed lists, the language, the interests, the SMS state, a link to the e-mail preferences
The list objectAllowed skins, languages and the main language, the interest source, approval, the article pool, the tracking mode, SMS
The send page of an editionThe skin of the send, the tracking of the send, the A/B subject test, the rate-limit transport, the approval state, the article picker, the preview as a subscriber, the SMS send

Requirements

  • Exponential 6.0.15 or later, with the e-mail preferences (expMailGate, the consent log, the suppression list, the bounce reader with [BounceSettings] MessageListeners[], the category handlers with erased() and the category part hook partTemplate() / partVariables() / storePart()). On an older kernel the newsletter still sends; the features that need the e-mail preferences stay off.
  • PHP 8.0 to 8.5.
  • MySQL / MariaDB, PostgreSQL or SQLite (Oracle through the kernel's driver, untested for 4.2.0).

License

GNU General Public License v2.0 (or any later version), see LICENSE.

Something wrong on this page? Report an error

Documentation license

This page is part of the documentation of the extension cjw_newsletter and is distributed under the license of that extension.