{"id":19270830,"url":"https://github.com/activecampaign/craft-customerio","last_synced_at":"2026-06-13T06:32:12.621Z","repository":{"id":66239045,"uuid":"454782698","full_name":"ActiveCampaign/craft-customerio","owner":"ActiveCampaign","description":"Craft CMS plugin for pushing newsletter subscribers to Customer.io","archived":false,"fork":false,"pushed_at":"2022-06-16T22:06:47.000Z","size":48,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-01-05T13:11:11.711Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ActiveCampaign.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-02T13:20:50.000Z","updated_at":"2023-11-23T04:41:32.000Z","dependencies_parsed_at":"2023-02-20T16:46:07.313Z","dependency_job_id":null,"html_url":"https://github.com/ActiveCampaign/craft-customerio","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveCampaign%2Fcraft-customerio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveCampaign%2Fcraft-customerio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveCampaign%2Fcraft-customerio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActiveCampaign%2Fcraft-customerio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ActiveCampaign","download_url":"https://codeload.github.com/ActiveCampaign/craft-customerio/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240371759,"owners_count":19790888,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T20:27:37.928Z","updated_at":"2026-06-13T06:32:07.588Z","avatar_url":"https://github.com/ActiveCampaign.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Customer.io plugin for Craft CMS 3.x\n\nSend newsletter subscribers to Customer.io\n\n![Customer.io logo](resources/img/plugin-logo.svg)\n\n## Requirements\n\nThis plugin requires Craft CMS 3.0.0-beta.23 or later.\n\n## Installation\n\nTo install the plugin, follow these instructions.\n\n1.  Open your terminal and go to your Craft project:\n\n        cd /path/to/project\n\n2.  Then tell Composer to load the plugin:\n\n        composer require wildbit/customer.io\n\n3.  In the Control Panel, go to Settings → Plugins and click the “Install” button for Customer.io.\n\n## Customer.io Overview\n\nThis plugin powers the newsletter sign up form on the site, sending details to Customer.io. It utilizes a double opt-in flow for signups.\n\nSubscribers will be added/updated in Customer.io with a `\u003cprefix\u003e\u003clist\u003e_confirmed` property set to `false`. Ensure that a workflow is set up in Customer.io that sends an email to these subscribers with a confirmation link that will update this propery to `true`. See [Customer.io’s double opt-in documentation](https://customer.io/docs/double-opt-in/) for more info.\n\nWhen someone subscribes to a list we also create a `email_subscription` event in Customer.io with the `lists` that were subscribed to and the `page` where the subscription occurred.\n\n## Configuring Customer.io\n\n1. Go to **Settings** → **Customer.io**.\n2. Add the **Site ID** and **API Key** for the relevant Customer.io workspace.\n3. Specify a prefix for the attribute that will be added to the user's profile in Customer.io. (e.g. `wb_` or `pm_`)\n4. Add the URL of the newsletter success page. This will be shown to users that sign up for the newsletter with JavaScript disabled. (e.g. `https://newsletters.wildbit.com/wildbit/confirm.html`)\n\n## Using Customer.io\n\nThe plugin does not contain a template for the subscription form as this will vary depending on the site design. However, it does include a JavaScript file with the logic for submitting the form (`srs/assetbundles/customerio/dist/js/Customerio.js`).\n\n1. Include the Customer.io asset bundle on pages with a subscription form `{% do view.registerAssetBundle(\"wildbit\\\\customerio\\\\assetbundles\\\\customerio\\\\CustomerioAsset\") %}`\n2. Ensure that the form action is set to `/actions/customerio/subscribers/new-subscriber`.\n3. Add the `js-customerio-form` class to the `form` element.\n4. Ensure the form has `name`, `email`, and `lists[]` fields. The `lists[]` field(s) determines the attribute that will be added to the user's profile in Customer.io. For example: specifying `newsletter` will create a `wb_newsletter_subscription` attribute. You can subscribe a user to more than one list by adding multiple inputs with the `lists[]` name. (For example: if you want to include checkboxes with multiple list options.)\n5. Ensure the form fields and submit button are contained within an element with the `js-customerio-fields` class.\n6. Successful subscription requests will result in the form fields being hidden and a success message added inside a `form_success` element. There are no default styles for this element.\n7. Errors will be displayed in a `form_errors` element below the `js-customerio-fields` element. There are no default styles for this element.\n\n---\n\nBrought to you by [ActiveCampaign](https://activecampaign.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factivecampaign%2Fcraft-customerio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Factivecampaign%2Fcraft-customerio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factivecampaign%2Fcraft-customerio/lists"}