Newsletter Configuration – Unidy Documentation

The Newsletter module ships two surfaces: a signup form for anonymous visitors, and a preference center for signed-in users to manage their subscriptions. This article covers the configuration under Unidy → Newsletter.

1. Cards

A card represents one newsletter product visible to the visitor. Under Cards you define:

Internal name — a machine-readable identifier (e.g. club_news). Used in URLs and analytics; not shown to the visitor.

Display name — the human-readable label (e.g. Club News).

Description — a short subtitle explaining what the newsletter is about.

Badge (optional) — a small accent label rendered on the card (e.g. Weekly, VIP).

Has sub-preferences — toggle if this newsletter supports finer-grained topic selection.

Cards are rendered as toggle-switch rows in the signup form and as manage-subscription rows in the preference center.

2. Sub-preferences

When a card has sub-preferences enabled, you can add checkboxes underneath it for topic-level opt-in. Under Sub-preferences:

Belongs to card — pick the parent card.

Backend identifier — a machine name (e.g. player_news_pref).

Label — the human-readable checkbox label.

Default (pre-selected when the visitor subscribes) — check to make this an opt-out preference. Uncheck for classic opt-in behavior.

⚠️

Be aware of the regulatory implications of opt-in versus opt-out defaults. Under GDPR, marketing subscriptions require explicit opt-in.

3. Placement

Under Placement you decide where the signup form appears:

Shortcode snippet: [unidy_newsletter] — paste into any page or post.

Limit to card (optional): restrict a specific shortcode to one card only, useful when a landing page focuses on a single newsletter.

Style override: default (all admin-configured cards) or compact (single card, minimal chrome).

Intro block: hides the intro text at the top of the shortcode.

Auto-inject on homepage: appends the signup form automatically at the end of your homepage. Useful when you don't want to touch the page content directly.

4. Signed-in behaviour

When a signed-in visitor lands on a page containing [unidy_newsletter], one of four things can happen (configured under Signed-in behaviour):

Show preference center inline (recommended) — the signup form transforms into the manage-subscription view on the same page.

Show success message + link — a short confirmation with a link to a dedicated preference-center page.

Show identified email + link — compact display showing which email is registered, plus a link.

Hide entirely — the shortcode renders nothing.

5. Text customization

Under Text customisation you can override the microcopy for the success flash message, the double-opt-in banner, the resend-DOI button, and the fallback text shown to visitors who haven't confirmed their email yet.

6. Consent checkboxes

Above the Abonnieren button on the signup form, you can add one or more legally-required consent checkboxes. Under Consent checkboxes:

Key — a machine identifier (e.g. datenschutz).

Text — the checkbox label. Supports HTML anchors, so you can embed links to your privacy policy: Ich stimme <a href="/datenschutz">der Datenschutzerklärung</a> zu.

All consent checkboxes are required — the Abonnieren button stays disabled until every one is checked.

7. Preference Center

The preference center is a standalone view for signed-in visitors to manage their subscriptions. Configuration:

Render mode: inline, modal, or panel.

Trigger URL patterns: which links (e.g. /newsletter/, /mein-newsletter) open the panel or modal.

Header text: what appears at the top of the preference center.

Container selector: where the click interception is scoped.

The preference center is rendered via [unidy_newsletter_preferences] — see the Shortcode Reference.