{"id":18859233,"url":"https://github.com/1up-lab/contao-mailchimp","last_synced_at":"2025-04-14T12:13:51.000Z","repository":{"id":1768762,"uuid":"44529145","full_name":"1up-lab/contao-mailchimp","owner":"1up-lab","description":"Contao bundle for MailChimp subscribe/unsubscribe forms (using MailChimp API V3.0)","archived":false,"fork":false,"pushed_at":"2024-09-19T07:43:18.000Z","size":131,"stargazers_count":7,"open_issues_count":4,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-14T12:13:44.974Z","etag":null,"topics":["contao","contao-mailchimp","contao-module","mailchimp"],"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/1up-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2015-10-19T11:08:44.000Z","updated_at":"2024-09-19T07:42:38.000Z","dependencies_parsed_at":"2024-07-11T17:52:27.988Z","dependency_job_id":null,"html_url":"https://github.com/1up-lab/contao-mailchimp","commit_stats":{"total_commits":87,"total_committers":8,"mean_commits":10.875,"dds":"0.32183908045977017","last_synced_commit":"3a4cb7dfce06fbe7719d29ddb2c4d6055895e693"},"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1up-lab%2Fcontao-mailchimp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1up-lab%2Fcontao-mailchimp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1up-lab%2Fcontao-mailchimp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1up-lab%2Fcontao-mailchimp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1up-lab","download_url":"https://codeload.github.com/1up-lab/contao-mailchimp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248877960,"owners_count":21176244,"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":["contao","contao-mailchimp","contao-module","mailchimp"],"created_at":"2024-11-08T04:16:58.471Z","updated_at":"2025-04-14T12:13:50.979Z","avatar_url":"https://github.com/1up-lab.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Contao Mailchimp Bundle\n==========================\n\nThis Contao bundle provides subscribe and unsubscribe forms for easy integration in Contao.\n\n[![Author](http://img.shields.io/badge/author-@1upgmbh-blue.svg?style=flat-square)](https://twitter.com/1upgmbh)\n[![Software License](http://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE)\n[![Total Downloads](http://img.shields.io/packagist/dt/oneup/contao-mailchimp.svg?style=flat-square)](https://packagist.org/packages/oneup/contao-mailchimp)\n\n--\n\nThe fields that will be shown are managed through MailChimp's [`List fields and *|MERGE|* tags`](http://kb.mailchimp.com/lists/managing-subscribers/set-default-merge-values-for-a-list). You may also change the order of this fields: In MailChimp, go to Signup forms \u003e General forms \u003e Signup Form and rearrange the fields via drag'n'drop. You then have to import the new field order into Contao, by simply re-saving the MailChimp list in the back end. \n\n## How-to\n\nInstall using the command line `composer require oneup/contao-mailchimp` or by using the [Contao Manager](https://contao.org/de/download.html).\n\n### Requires of oneup/contao-mailchimp (Composer resolves this automatically)\n\n- [codefog/contao-haste](https://github.com/codefog/contao-haste)\n- [contao/core-bundle](https://github.com/contao/core-bundle)\n- [oneup/mailchimp-api-v3](https://github.com/1up-lab/mailchimp-api-v3)\n- [patchwork/utf8](https://github.com/tchwork/utf8)\n\nAfter installing the Contao MailChimp bundle you have to build a connection to MailChimp.\n\nLogin into the Contao Backend and go to Content \u003e MailChimp:\n\n- Create a new List\n- Enter a name for your list\n- Enter your [MailChimp API Key](https://mailchimp.com/help/about-api-keys/#find+or+generate+your+api+key)\n- Enter your subscriber [List ID](https://mailchimp.com/help/find-your-list-id/)\n\nCreate four pages under Layout \u003e Site Structure:\n\n- Subscribe to the newsletter\n- Subscribe confirmation\n- Unsubscribe from the newsletter\n- Unsubscribe confirmation\n\nGo to Layout \u003e Themes \u003e Modules:\n\n- Add a module of the type **Subscribe form**\n- Choose your MailChimp List\n- Choose the redirection page after subscription (Page: Subscribe to the newsletter)\n- Choose whether you will use double opt-in for subscription\n- Choose whether you will use the HTML5-Placeholder in the form fields or not\n- Choose whether you will have the Contao captcha field \n- Add a module of the type **Unsubscribe form**\n- Choose your MailChimp List\n- Choose the redirection page after unsubscription (Unsubscribe from the newsletter)\n- Choose whether you will use the HTML5-Placeholder in the form fields or not\n- Choose whether you will have the Contao captcha field\n\nGo to Content \u003e Articles:\n\n- Insert the module of the type **Subscribe form** on the page Subscribe to the newsletter\n- Insert the module of the type **Unsubscribe form** on the page Unsubscribe from the newsletter\n\n### Form Generator\n\nYou can also use forms of the form generator to subscribe to Mailchimp lists.\n\n- Go to the settings of the form.\n- In the _Mailchimp_ section **Enable Mailchimp**.\n- Select a _Mailchimp list_ to subscribe to.\n- Optionally select interest groups that new subscriptions should be assigned to by default.\n- Optionally enter the name of a field which controls whether the subscription should take place or not (e.g. the field name of a newsletter checkbox).\n- Optionally enable Mailchimp's double opt-in feature.\n- Define the merge tags to map the form's input to the mailchimp list's fields. _Note:_ you always need an `EMAIL` merge tag.\n- Define optional added member tags.\n\n### Known limitations\n- If the captcha option is activated and the same module is multiple times visible on the website, it won't work properly. E.g. if you have a subscription form in the footer and the same module somewhere in the content - it won't work. You'll have to have a different module for the footer then.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1up-lab%2Fcontao-mailchimp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1up-lab%2Fcontao-mailchimp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1up-lab%2Fcontao-mailchimp/lists"}