Swish Active Campaign

=== Swish Active Campaign === Contributors: denischweya Tags: activecampaign, popup, lead magnet, woocommerce, email marketing, newsletter Requires at least: 6.0 Tested up to: 6.6 Requires PHP: 7.4 Stable tag: 0.3.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

ActiveCampaign integration: lead-magnet popups (CPT + custom blocks) and a "Save Trip" floating button for WooCommerce products.

== Description ==

Swish Active Campaign is a custom WordPress plugin that gives a site two ActiveCampaign-powered features:

• Lead-magnet popups — manage popups as a Custom Post Type, edited with the block editor. Two custom blocks ship: a Swish Popup container with InnerBlocks (image, columns, heading, paragraph, plus the form), and a Swish AC Form child block. Each popup has its own targeting (URL patterns, post types, the homepage, exclude lists), trigger (time delay, scroll %, exit intent, click selector), frequency cap (cookie-based) and ActiveCampaign mapping (list dropdown + tag picker, both sourced live from the API).

• Save Trip button — a floating bookmark button on WooCommerce product pages. Clicking opens a popup that subscribes the visitor in ActiveCampaign and adds two tags: a base tag (e.g. "Saved Trip") and a dynamic per-product tag (e.g. trip:hawaii-2026). The button's screen position and show-trigger (immediate, after time delay, or after scroll %) are configurable.

All submissions go server-side through the WordPress REST API to ActiveCampaign v3, so the API key never reaches the browser. List names and tag names are cached for 5 minutes via transients.

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/ (or install the zip via Plugins → Add New → Upload).
2. Activate the plugin through the Plugins menu.
3. Go to Settings → Swish AC and fill in:
   • ActiveCampaign API URL (e.g. https://youraccount.api-us1.com)
   • ActiveCampaign API Key
   • Default list
4. Click Test Connection. This must return "Connected as …" before anything else will work.
5. (Optional, for Save Trip) set a list override, base tag, per-product tag pattern, popup copy, button position, and show-trigger.
6. (For popups) create posts under Swish Popups → Add New. Each popup's targeting/trigger/AC settings live in the block's right-hand sidebar.

== Frequently Asked Questions ==

= How do I preview a popup repeatedly without dismissing it? =

Append ?swish_preview=1 to the page URL — this bypasses the localStorage frequency cap so you can re-test as many times as needed. Append ?swish_debug=1 to also stream matching/trigger info to the browser console.

= How do I actually clear the dismissal cookies? =

?swish_preview=1 only bypasses the cap for the current page load; the cookie is still set. To wipe the cookies entirely, append ?swish_reset=1 to any URL — the loader clears every swish_popup_* entry in localStorage and logs the count to the browser console. Reload without the param afterward to test triggers normally. (You can also delete the keys manually in DevTools → Application → Local Storage.)

= Why isn't my popup showing? =

In order, check:

1. Is the popup post Published (not draft)?
2. Does the targeting actually match the URL? URL patterns are case-insensitive and use * as a wildcard. The leading slash matters: /trips/* matches /trips/foo, but trips/* does not.
3. Is the "Show to" filter excluding you (logged-in vs logged-out)?
4. Is a localStorage frequency-cap entry still set from a prior dismissal? Open DevTools → Application → Local Storage and delete any swish_popup_* keys.

When WP_DEBUG is enabled, the server logs to debug.log which popups matched and which were skipped (with reasons).

= Why does the form submission fail with "ActiveCampaign returned HTTP 4xx"? =

The error message includes the AC endpoint that failed — e.g. ... on /api/3/contactLists means the list ID being used doesn't exist in your AC account. Open Settings → Swish AC and re-select the list from the dropdown.

= Can I customize the popup design? =

Yes. The Swish Popup block exposes:

• Width slider (320–900 px)
• Padding via per-side BoxControl (px/%/em/rem)
• Image with three layouts: image on top, two-column (image left), or image as background with opacity
• Focal point picker + image height (for cropped layouts)
• Accent color + success message
• Core color and other block-supports

The Swish AC Form child block exposes:

• Optional name field (with required toggle)
• Field-labels toggle (placeholders always render either way)
• Submit button label, alignment (Left / Center / Right / Full width)
• Submit button background, text color, border, border radius

= Where do I find which AC list is being used? =

In the popup block's ActiveCampaign panel — the List dropdown is sourced live from your AC account (each option shows Name (#id)). The same dropdown appears in the plugin Settings for the default list and the Save Trip override.

= How do I save the product title to a custom field (e.g. "Tours") on the contact? =

You need to create the custom field in ActiveCampaign first — the plugin does not create it for you. The setup is:

1. In ActiveCampaign, go to Contacts → Fields → Add a field.
2. Give it a title (e.g. Tours), set the type to Text input (or Text area if you expect many trips), and save.
3. Back in WordPress, go to Settings → Swish AC → Save Trip → "Save product title to field" and pick the field you just created from the dropdown. (If you don't see it immediately, save settings to invalidate the 5-minute cache and reload.)
4. Save the settings.

On every Save Trip submit, the plugin will read the contact's current value for that field, append the product title if it's not already there, and write it back as a comma-separated string. A contact who saves "Hawaii Camp" and then "Costa Rica Retreat" ends up with Tours = "Hawaii Camp, Costa Rica Retreat".

Leave the setting on — None — to skip the field write entirely.

= Is the AC API key exposed to the browser? =

No. Form submissions hit POST /wp-json/swish-ac/v1/submit, which proxies to the AC v3 API server-side with the stored credentials.

== Changelog ==

= 0.3.0 - 2026-05-29 =

• Per-product popup override. WooCommerce products now have a new "Swish Popup" tab in the Product data box where you can pick a specific popup to show on that product page. When set, that popup is shown instead of whatever popups would normally match — useful for "this trip has a tailored offer" cases. The chosen popup's own auth filter, trigger, and frequency cap still apply.

= 0.2.0 - 2026-05-29 =

• Save Trip can now write the product title to an ActiveCampaign custom field (e.g. "Tours") on the contact, appended comma-separated and deduped so a contact's full saved-trip list is preserved. New "Save product title to field" dropdown in Settings, sourced live from your AC custom fields.
• Fix: Homepage targeting now works on sites with a static front page. The detection used to return the page's post type (e.g. page) when is_singular() matched first; it now also reports home when is_front_page() is true. A static front page matches both home and page, so either targeting choice fires.
• Fix: Scroll-depth trigger checks immediately on load — popups (and the Save Trip button) fire if the user already scrolled past the threshold, or if the page is too short to scroll at all. Previously they would only fire on subsequent scroll events.

= 0.1.0 - 2026-05-28 = Initial release.

Plugin core

• Plugin scaffold, settings page, AC v3 REST client.
• "Test Connection" button hits /users/me to verify credentials.
• Single POST /wp-json/swish-ac/v1/submit endpoint handles both popup and Save Trip submissions.
• AC list and tag dropdowns sourced from the AC API via /wp-json/swish-ac/v1/ac-lists and /wp-json/swish-ac/v1/ac-tags, 5-minute transient caching with a manual refresh.

Lead-magnet popups

• swish_popup CPT, Gutenberg enforced via use_block_editor_for_post_type filter (priority 101 to override Classic Editor).
• swish/popup container block with InnerBlocks; allowed children: core/columns, core/column, core/heading, core/paragraph, core/image, swish/ac-form.
• swish/ac-form child block: optional name field, email field, submit button.
• Per-popup targeting (All / URL patterns / Post types / Exclude URLs / Homepage) with auth filter.
• Per-popup triggers: time delay, scroll %, exit intent, click selector.
• Frequency cap via localStorage (N-days-after-dismissal, hide-forever-after-submission).
• Image layouts: stack (image on top), two-column (image left), background-with-opacity.
• Focal point picker, image height slider, popup width slider.
• Per-side padding via core BoxControl.
• AC form: button alignment (left/center/right/full), label toggle with always-on placeholders, button background/text color, border width/color, border radius.
• Circular close button using the popup's accent color.

Save Trip (WooCommerce)

• Floating bookmark button on is_product() pages.
• Configurable screen position (6 corner/edge presets) and show-trigger (immediate / time delay / scroll %).
• Pre-fills email for logged-in users; tags contact with base tag + trip:{slug} dynamic tag.
• Optional "Save product title to field" setting: writes the product title to an ActiveCampaign custom field (e.g. "Tours") on the contact, appended comma-separated and deduped so a contact's full saved-trip list is preserved.
• Circular close button.

UX & DX

• Submit spinners on both popup and Save Trip forms.
• ?swish_preview=1 bypasses the frequency cap for repeat testing.
• ?swish_debug=1 streams diagnostic info to the browser console.
• When WP_DEBUG is on, the server logs which popups matched the request and full AC error response bodies.
• AC error messages include the failing API path (e.g. ... on /api/3/contactLists) for fast diagnosis.
• Block deprecations registered on both swish/popup and swish/ac-form for forward compatibility.
• Focus trap + ESC close + opener-focus-restore on both modals.

== Upgrade Notice ==

= 0.1.0 = First release.