Mailerlite Newsletter

No Token in HTML or JS
Your MailerLite API token is stored in module parameters and used only in the Ajax handler — it is not output to templates or script options.

CSRF-Protected Ajax
Submissions go through Joomla’s com_ajax with CSRF validation, matching Joomla’s security model for authenticated-style requests.

Published Module Check
The server verifies the module instance exists and is published before accepting a subscription, reducing misuse of orphaned endpoints.

Group IDs
Send new subscribers to the MailerLite group you choose using the numeric audience group ID from your dashboard.

Multiple Groups
Enter several group IDs separated by comma or space to add each subscriber to more than one list or segment in one submit.

Guided Configuration
Built-in Setup instructions in the module admin point you to MailerLite’s API token and group settings with direct documentation context.

Token Normalization
Strips accidental Bearer prefixes, BOMs, and stray whitespace so pasted tokens from the dashboard work reliably.

Truncation Detection
Warns when a JWT-style token looks incomplete (wrong segment count) before MailerLite returns a vague “Unauthenticated” error.

Clear API Feedback
Parses MailerLite JSON error bodies when possible and maps common HTTP cases (auth, 404, network) to actionable messages for site owners and visitors.

Heading & Intro
Set the section title and supporting paragraph to match your brand voice and compliance wording.

Labels & Button
Customize name and email placeholders and the subscribe button label without touching code.

Success & Error Text
Define the messages visitors see after submit or when something fails — ideal for double opt-in reminders or localized tone.

Horizontal Row
Name, email, and button align in a row on wide screens — great for footers and full-width bands.

Vertical Stack
Single-column fields for sidebars, narrow columns, or mobile-first sections.

Responsive Grid
CSS automatically reflows: three columns become two, then one, with the button spanning appropriately at each breakpoint.

CSS Custom Properties
Colours and sizes are driven by variables injected on the section — fast theme tweaks without editing CSS files.

Typography & Spacing
Adjust heading and body sizes with any valid CSS (including clamp()), plus section padding and inner max width for perfect alignment with your layout.

Inputs & Button
Control backgrounds, borders, radii, hover colour, and success/error message colours so the block feels native to your template.

Inline SVG Icons
Add a small icon before the button label — arrow, envelope, or paper plane — or keep a text-only button.

Crisp at Any DPI
Vector icons scale cleanly and inherit button colour for a professional subscribe control.

Client-Side Checks
Validates name and email before network calls, with focus moved to the first invalid field.

Server-Side Rules
PHP validates input again and returns structured JSON errors for consistent handling.

No Full Reload
Uses fetch for Ajax submit, disables the button during the request, shows inline success or error messages, and resets the form after success.

Screen Reader Labels
Visually hidden labels pair with placeholders so fields are announced correctly.

Live Region
Status messages use an aria-live region so assistive tech announces success and errors after submit.

Autocomplete
Name and email fields use appropriate autocomplete values for faster, safer browser fill-in.

Language Files
Validation strings and system messages use MOD_MAILERLITE_NEWSLETTER_* keys — copy and translate for each site language.

Per-Language Instances
Duplicate the module per content language with translated headings and intros for true multilingual campaigns.

Joomla 4, 5 & 6
Modern module structure with namespaced helper, cache-busted assets, and an update server for straightforward maintenance.