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

Newsletters with CJW Newsletter: course overview

The course for people who write, send and run newsletters with the cjw_newsletter extension - 6 modules and 20 lessons, 16 hours of lessons, on a training installation that writes every mail to a file and uses only test…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/trainers/newsletter/README.md

On this page

Newsletters with CJW Newsletter: course overview

This course teaches the newsletter system of Exponential, the extension cjw_newsletter, from the first look at the dashboard to a skin of your own. Learners build a list, gather made-up subscribers through the real double opt-in, write and test editions, send them, run the queue by hand, and plan the switch to real mail for their own site.

One rule holds from the first lesson to the last: nothing is ever sent to a real person. The training installation writes every mail to a file, and every subscriber, sender and test address ends in @example.invalid.

Who it is for

  • Editors who will write and send newsletters (modules 1 to 4 and lesson 6.1).
  • Administrators who set up and run the newsletter: cron, bounces, transports, deliverability (all modules; module 5 is theirs).
  • Designers and developers who give the newsletter its look (module 6, after a look at modules 2 and 4).

Outcome

After the course, learners can create newsletter systems and lists with a sound configuration, write editions with articles, run the subscribe form and double opt-in, manage, import and export subscribers with recorded consent, unsubscribe and blacklist addresses, preview and test editions, send them and follow the queue, abort a send, read the archive and statistics, handle bounces, plan the switch from files to real sending, use rate limits and test groups, and write a skin.

Format and length

Lessons20 lessons in 6 modules
Lesson time16 hours (presenting and exercises)
With breaksabout 17 hours, as in the modules' timing plans
FormatClassroom with a projector, or online with screen sharing; every learner at their own computer
Group sizeUp to about 10 learners per trainer; the sending exercises need the trainer to watch the outbox
LevelBeginner to advanced (the later modules for administrators and designers)

Prerequisites

  • Learners: basic editing of content as taught in Editors 101 (creating, editing and publishing an item). Administrators: a shell on a training installation. Designers: the template language.
  • Trainer: has run the whole course on their own training installation once, including every sending exercise, and knows the train-the-trainer material (Train the trainer: course overview).

Lab setup

  • A training installation, for example installed with php bin/php/console exp:install --apply (7. The console install), with cjw_newsletter active, its tables created, the newsletter tree with its section, and the subscribe form reachable on the public siteaccess. How to build and reset a lab: Module 2: Building the lab of Train the trainer.
  • Every mail written to files: site.ini [MailSettings] Transport=file, and in cjw_newsletter.ini [NewsletterMailSettings] the methods TransportMethodCronjob, TransportMethodPreview and TransportMethodDirectly all file, checked in the settings viewer. The shipped TransportMethodPreview is sendmail; lesson 1.2 changes it.
  • Only made-up people: subscribers, senders, test receivers and test groups at example.invalid. Never a copy of a real subscriber list.
  • One admin training account per learner; shell access as the web server user for administrators and designers.
  • No cron for the newsletter parts on a shared installation during the course: the trainer starts the queue.

Modules

ModuleLessonsDurationTopics
Module 1: Getting started32 hThe parts, a training installation that cannot send, the dashboard
Module 2: Systems, lists and editions43 h 30 minNewsletter root and systems, list configuration, editions and articles, recurring sends, pools, approval
Module 3: Subscribers43 h 15 minSubscribe form and double opt-in, users and subscriptions, CSV import and export, consent, unsubscribing, blacklist
Module 4: Sending43 h 15 minPreviews and test sends, sending, cronjobs and console, aborting, archive, statistics
Module 5: Bounces and transports32 h 15 minMail accounts and bounces, going live, rate limits, test groups, suppression
Module 6: Templates and skins21 h 45 minSkins, HTML and text parts, placeholders, writing a skin

Reading path

For a trainer preparing the course, in this order:

  1. cjw_newsletter: newsletters in the admin: the parts, the rehearsal without mail, the settings and what changed in the Exponential 6 releases.
  2. Newsletters with cjw_newsletter, Newsletter lists and subscriptions and Sending newsletters safely: the three short pages the course follows.
  3. 10.4 Mail and 10.5 Notifications and newsletters: the transports and the cron parts.
  4. Specification: the cjw_newsletter extension: every view, command, cronjob part and dashboard problem.
  5. E-mail preferences: setting them up and running them and Cronjobs.
  6. The extension's own guides for 4.2 (deliverability, editorial, rendering, statistics, import and export), linked from the feature page.
  7. Then the modules in order: each module's overview first (its preparation list and timing plan), then its lessons. Rehearse every exercise on your training installation, and look at the outbox after each one.

Suggested schedules

Lesson times add up to 16 hours; the schedules add breaks.

Two and a half days, the whole course

DayMorningAfternoon
1Module 1, lessons 2.1 and 2.2Lessons 2.3 and 2.4, lessons 3.1 and 3.2
2Lessons 3.3 and 3.4, lessons 4.1 and 4.2Lessons 4.3 and 4.4, lesson 5.1
3Lessons 5.2 and 5.3, Module 6

One and a half days for editors

Module 1 (lesson 1.2 as a demonstration by the trainer), Module 2, Module 3 without lesson 3.3, lessons 4.1, 4.2 and 4.4, and lesson 6.1: about 11 hours 15 minutes of lessons. Administrators join for lessons 3.3 and 4.3 and Module 5 on a later half day.

Half day for administrators who already know the editing side

Lessons 1.2, 4.3, 5.1, 5.2 and 5.3: 4 hours of lessons.

Assessing learners

  • Each lesson's quiz and expected result check understanding during the course.
  • A good final practical check: each learner runs the whole cycle alone on a fresh training list (list, two subscribers through the double opt-in, an edition, a test, a send, an abort), and shows the outbox.
  • The assessments course (Assessments and practical exercises, in this section of the help) has a written test and a practical task for this course. All assessments are the trainer's own material, not an official certification (Certifications says what the partner program publishes).

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x