Newsletter Jackknife
Newsletter Jackknife adds two things to AcyMailing on Joomla 6. Archive-on-send turns every campaign sent to a mailing list into a clean Joomla article, built from the copy readers actually received. The Planned article block lets you line up newsletter content by date: each issue picks the article(s) dated for it.
New to Newsletter Jackknife? This page is the reference manual. For an overview, with the download, see its page on cybersalt.com.
Release history. This page documents the current release (1.0.0). For what changed in each version, see the changelog.
Requirements. Joomla 6, PHP 8.3 or newer and AcyMailing 11. Available from cybersalt.com.
Installing
- Buy a membership on cybersalt.com (one purchase covers as many of your sites as you like), log in and download the ZIP from My Sites.
- In the administrator, go to System → Install → Extensions and upload it. The package installs a system plugin (switched on for you) and the Components → Newsletter Jackknife screens.
- Link the site for updates (below).
- Add a mapping for each newsletter you want archived (see Archive-on-send).
Link your account (updates)
Go to Components → Newsletter Jackknife → Link your account and enter the email address of your cybersalt.com account. While your membership is current, new versions show up under System → Update → Extensions, and remote managers such as mySites.guru can install them too. Everything else works the same whether or not a site is linked; only updates need a current membership.
Archive-on-send
A mapping connects one AcyMailing list to one Joomla category. From then on, every campaign sent to that list becomes an article in that category. Add one under Components → Newsletter Jackknife → Mappings → New.
What gets archived
- Standard campaigns sent to a mapped list, sent on or after the mapping's Archive sends from date (it defaults to the moment you save the mapping). Older campaigns are what Backfill is for.
- The article is built from AcyMailing's as-sent copy, so Planned article blocks and other dynamic content show what readers got. A campaign without dynamic blocks can also be archived from its stored body.
- Each issue is archived once. Running it again (Re-archive, or after changing the rules) updates the same article: same id, same address, same hits.
When it runs
Right after AcyMailing sends each batch, including batches sent by AcyMailing's cron, and at most every 5 minutes on ordinary page requests as a fallback. Archive now on the Dashboard runs it straight away and reports how many issues were archived, how many are still waiting for AcyMailing to send, and how many failed. A campaign is only archived once something has actually gone out: AcyMailing marks a campaign "sent" as soon as it's queued.
AcyMailing deletes its as-sent copies after 90 days by default (Configuration → Data management). Archive-on-send picks issues up within minutes, so that only matters for Backfill.
What is removed from the archive copy
- Subscribe, unsubscribe and profile links. These carry the subscriber's details and your site's AcyMailing security key, so the whole paragraph they sit in goes.
- Subscriber tags such as
{subscriber:name}, the hidden preheader text, open-tracking pixels and UTM parameters. - Click-tracking redirects, which are turned back into the real links.
- AcyMailing's social icons and "powered by" badge.
- Layout tables, which are unwrapped. Images keep their float, margins and centring; headings and paragraphs keep their alignment.
Mapping settings
| Setting | What it does |
|---|---|
| AcyMailing list, Joomla category | Which list's campaigns go where. |
| Access level, Author, Default publish state | Applied to every archived article. An empty author uses the campaign's creator. |
| Article title | Placeholders: {subject}, {issue} (the number after "Issue" or "#" in the subject), {date} (send date, e.g. November 15, 2026) and {date:FORMAT} with any PHP date format. Empty = the subject. |
| Article alias | Same placeholders, e.g. issue-{issue}. Empty = made from the title. A number is added if the alias is already taken in the category. |
| Article date | The day it was sent, 00:01 site time, or the exact send time. Used for the created and start-publishing dates. |
| Archive sends from | Only campaigns sent from this date on are archived automatically. |
| Cleanup rules | Extra cleanup for your own template (below). |
| Body wrap mode | Content only (recommended) strips the email layout so the article fits your site's template; Full HTML keeps the email markup. |
| Title prefix strip | Optional regular expression removed from the subject before it becomes the title. |
| Meta description / keywords templates, Tags | Same placeholders as the title. |
| Priority, Enabled | When a campaign goes to several mapped lists, the lowest priority wins. Disable a mapping to pause it. |
Cleanup rules
Plain text, one rule per line, no regular expressions. Lines starting with # are comments.
| Rule | What it does |
|---|---|
remove-paragraph: text | Removes every paragraph containing the text. |
remove-paragraph-text: Issue #{number} | Removes a paragraph whose whole text is exactly this. {number} matches any number. |
remove-image: part-of-image-address | Removes matching images. |
image-to-hr: part-of-image-address | Turns divider images into a horizontal line. |
replace-paragraph: text => <p>new HTML</p> | Replaces a paragraph containing the text. |
replace: old text => new text | Plain replacement, run after the other rules. |
# Example: a newsletter template
remove-paragraph: Was this forwarded to you by a friend
remove-paragraph-text: Issue #{number}
remove-image: thank-you-for-being-a-subscriber
image-to-hr: newsletter_graphics/article-divider
Log, Errors, Backfill and Retrofit
- Archive Log: every archived issue with its article, source, size before and after cleanup, and status (Success, Error, No source, Skipped). Re-archive rebuilds an issue with the current rules. A failed issue is retried after an hour; one with no as-sent copy after 24 hours is logged as No source.
- Errors: details of anything that failed, with a stack trace for support.
- Backfill: archives campaigns sent before a mapping existed, in batches with a progress bar. Pick a date to skip older ones, or do a dry run first. Campaigns older than AcyMailing's as-sent copies that were built with dynamic blocks can't be backfilled faithfully and are logged as No source.
- Retrofit: if you already archived issues by hand, Retrofit matches those articles to their campaigns (by issue number) and logs them as archived, so Backfill doesn't make second copies.
Planned article block
In the AcyMailing editor, add the Planned article (Newsletter Jackknife) block, pick one or more categories, and the block inserts the published article(s) in those categories whose Newsletter send date field matches the issue being sent. Line content up weeks ahead by setting that date on each article; a section with nothing planned disappears from the email. Article order and publishing dates are ignored on purpose, so reworking an old article doesn't move it.
The install creates the Newsletter send date article field (a date, not shown on the site). Block options: heading and heading style, a divider image, which date field to use, and how many articles (default 1).
Which issue a campaign is for: a scheduled campaign uses its send date. A campaign that isn't scheduled yet (say, while you preview it) uses the next issue day from the plugin settings, and after the cut-off hour on an issue day, the next one.
| Plugin setting | Default | What it does |
|---|---|---|
| Issue days | Sunday, Thursday | The days your newsletter goes out. |
| Cut-off hour | 12 | From this hour (site time) an issue day counts as sent, so an evening preview shows the next issue. |
| Send date field | Newsletter send date | The article date field blocks use unless they pick another. |
Coming from Newsletter Vault
Newsletter Jackknife replaces Newsletter Vault. Installing it on a site with Vault copies Vault's mappings and archive log across once and switches Vault's plugin off, so nothing is archived twice. Vault stays installed until you remove it.
Troubleshooting
| Symptom | Cause and fix |
|---|---|
| Nothing archived after a send | Check the mapping is enabled, the campaign went to that list, and it was sent after Archive sends from. Then press Archive now: it tells you if the issue is still waiting for AcyMailing. On a site with Joomla's cache on, clearing the cache once after installing makes sure the first run isn't delayed. |
| Template text left in the article | Add a cleanup rule for it on the mapping, then press Re-archive on the log row. |
| An older issue shows No source | AcyMailing no longer has its as-sent copy and its stored body uses dynamic blocks. Archive it by hand, then use Retrofit. |
| No updates offered | Open Link your account and check the email and membership status. |
Getting help
Use the support form on cybersalt.com.