| 1 |
=== MailChimp List Subscribe Form === |
| 2 |
Contributors: mc_jesse, crowdfavorite |
| 3 |
Tags: mailchimp, email, newsletter, signup, marketing, plugin, widget |
| 4 |
Requires at least: 2.8 |
| 5 |
Tested up to: 3.7.1 |
| 6 |
Stable tag: 1.4 |
| 7 |
|
| 8 |
== Description == |
| 9 |
|
| 10 |
The MailChimp plugin allows you to quickly and easily add a signup form for your MailChimp list as a widget on your WordPress 2.8 or higher site. |
| 11 |
|
| 12 |
Not sure what [MailChimp](http://www.mailchimp.com/features/full_list/) is or if it will be helpful? Signup up for a [FREE Trial Account](http://www.mailchimp.com/signup/) and see for yourself! |
| 13 |
|
| 14 |
After Installation, the setup page will guide you through entering your Login information, selecting your List from our Service, selecting options for the Merge Fields and Interest Groups you have setup, and then add the Widget to your site. The time from starting installation to have the form on your site should be less than 5 minutes - absolutely everything can be done via the Wordpress Setting GUI - no file editing at all! |
| 15 |
|
| 16 |
== Installation == |
| 17 |
|
| 18 |
This section describes how to install the plugin and get started using it. |
| 19 |
|
| 20 |
= Version 2.8+ = |
| 21 |
1. Unzip our archive and upload the entire `mailchimp` directory to your `/wp-content/plugins/` directory |
| 22 |
2. Activate the plugin through the 'Plugins' menu in WordPress |
| 23 |
3. Go to Settings and look for "MailChimp Setup" in the menu |
| 24 |
4. Enter your MailChimp API Key and let the plugin verify it. |
| 25 |
5. Select One of your lists to have your visitors subscribe to. |
| 26 |
6. (optionally) Turn on or off the Monkey Rewards option |
| 27 |
7. (optionally) Turn your Merge Vars and Interest Groups `on` and `off` |
| 28 |
8. Finally, go to Appearance->Widgets and drag the `MailChimp Widget` widget into one of your Widget Areas |
| 29 |
9. And you are DONE! |
| 30 |
|
| 31 |
= Advanced = |
| 32 |
If you have a custom coded sidebar or something else special going on where you can't simply enable the widget through the Wordpress GUI, all you need to do is: |
| 33 |
|
| 34 |
If you are using Wordpress v2.8 or higher, you can use the short-code: |
| 35 |
` [mailchimpsf_form] ` |
| 36 |
|
| 37 |
If you are adding it inside a php code block, pop this in: |
| 38 |
|
| 39 |
` mailchimpSF_signup_form(); ` |
| 40 |
|
| 41 |
Or, if you are dropping it in between a bunch of HTML, use this: |
| 42 |
|
| 43 |
`<?php mailchimpSF_signup_form(); ?>` |
| 44 |
|
| 45 |
Where ever you want it to show up. |
| 46 |
|
| 47 |
Note: in some environments you will need to install the Exec_PHP plugin to use that method of display. It can be found here: |
| 48 |
http://wordpress.org/extend/plugins/exec-php/ |
| 49 |
|
| 50 |
== Developer Mode == |
| 51 |
|
| 52 |
You can enable "Devleoper Mode" by adding the following line to your `wp-config.php` file just above the "That's all, stope editing!" line. |
| 53 |
|
| 54 |
define('MAILCHIMP_DEV_MODE', true); |
| 55 |
|
| 56 |
This will enable the MailChimp List Subscribe plugin to operate without the need to connect an external MailChimp Account, and will provide a |
| 57 |
subscription form widget that will not actually submit anywhere. |
| 58 |
|
| 59 |
This will allow you to style and configure the widget in non-production environments that are not publicly accessible. |
| 60 |
|
| 61 |
For more Developer Mode customization options see the following article: |
| 62 |
|
| 63 |
http://connect.mailchimp.com/how-to/how-to-article-configuring-developer-mode-for-the-list-subscribe-wordpress-plugin |
| 64 |
|
| 65 |
== Upgrading == |
| 66 |
|
| 67 |
If you are upgrading to version 1.2.1 and you used the widget in your sidebar previously, all you need to do is drag the `MailChimp Widget` back into the sidebar, visit the MailChimp settings page (which will have maintained your prior settings), click the "Update List" button, and you're done! |
| 68 |
|
| 69 |
== Internationalization (i18n) == |
| 70 |
Currently we have the plugin configured so it can be easily translated and the following languages supported: |
| 71 |
|
| 72 |
* bg_BG - Bulgarian in Bulgaria (thanks to [SiteGround](http://www.siteground.com/wordpress-hosting.htm) for contributing) |
| 73 |
* cs_CZ - Czech in the Czech Republic (thanks to [Peter Kahoun](http://kahi.cz/) for contributing) |
| 74 |
* da_DK - Danish in Denmark (thanks to Jan Lund for contributing) |
| 75 |
* de_DE - German in Germany (thanks to Michael Jaekel for contributing) |
| 76 |
* el_GR - Modern Greek in Greece (thanks to Ιωάννης Δημοφέρλιας (John Dimoferlias) for contributing) |
| 77 |
* en_US - English in the U.S. |
| 78 |
* es_CL - Spanish in Chile (thanks to Tomás Nader for contributing) |
| 79 |
* es_ES - Spanish in Spain (thanks to [Claudia Mansilla](http://cricava.com/) for contributing) |
| 80 |
* et_ET - Estonian in Estonia (thanks to [Helen Urbanik](http://www.motomaania.ee/) for contributing) |
| 81 |
* fr_FR - French in France (thanks to [Maxime Toulliou](http://www.maximetoulliou.com/) for contributing) |
| 82 |
* he_IL - Hebrew in Israel (thanks to [שגיב בית](http://www.sagive.co.il) for contributing) |
| 83 |
* hu_HU - Hungarian in Hungary (thanks to Okostobi for contributing) |
| 84 |
* it_IT - Italian in Italy (thanks to [Stefan Des](http://www.stefandes.com) for contributing) |
| 85 |
* ko_KR - Korean (thanks to 백선기 (SK Baek) for contributing) |
| 86 |
* nb_NO - Norwegian (thanks to [Alexander Roterud aka Defrag](http://www.tigerpews.com) for contributing) |
| 87 |
* nl_BE - Dutch (thanks to [Filip Stas](http://suddenelfilio.net/) for contributing) |
| 88 |
* pt_BR - Portuguese in Brazil (thanks to Maria Manoela Porto for contributing) |
| 89 |
* pt_PT - Portuguese in Portugal (thanks to [Tiago Faria](http://xroot.org) for contributing) |
| 90 |
* ro_RO - Romanian in Romania (thanks to Alexandru Armin Roșu for contributing) |
| 91 |
* ru_RU - Russian in the Russian Federation (thanks to [Илья](http://fatcow.com) for contributing) |
| 92 |
* sv_SE - Swedish in Sweden (thanks to [Sebastian Johnsson](http://www.agiley.se/) for contributing) |
| 93 |
* tr_TR - Turkish in Turkey (thanks to [Hakan E.](http://kazancexpert.com/) for contributing) |
| 94 |
|
| 95 |
If your language is not listed above, feel free to create a translation. Here are the basic steps: |
| 96 |
|
| 97 |
1. Copy "mailchimp_i18n-en_US.po" to "mailchimp_i18n-LANG_COUNTRY.po" - fill in LANG and COUNTRY with whatever you use for WPLANG in wp-config.php |
| 98 |
2. Grab a transalation editor. [POedit](http://www.poedit.net/) works for us |
| 99 |
3. Translate each line - if you need some context, just open up mailchimp.php and search for the line number or text |
| 100 |
4. [Fork](http://help.github.com/fork-a-repo/) the [repository on github](https://github.com/crowdfavorite/wp-mailchimp) |
| 101 |
5. [Clone](http://help.github.com/remotes/#clone) the _develop_ branch |
| 102 |
6. Add the appropriately named files to the /po/ directory and edit the /readme.txt to include how you'd like to be attributed |
| 103 |
7. Make a [pull request](http://help.github.com/send-pull-requests/) |
| 104 |
|
| 105 |
|
| 106 |
== Frequently Asked Questions == |
| 107 |
|
| 108 |
= What in the world is MailChimp? = |
| 109 |
|
| 110 |
Good question! [MailChimp](http://mailchimp.com/features/all/) is full of useful, powerful email marketing features that are easy to use and even a little fun (that's right---we said fun), whether you're an email marketing expert, or a small business just getting started. |
| 111 |
|
| 112 |
To learn more, just check out our site: [MailChimp](http://mailchimp.com/features/all/) |
| 113 |
|
| 114 |
|
| 115 |
= Wait a minute, you want me to pay to try this? = |
| 116 |
|
| 117 |
*Absolutely not!* We welcome you to come signup for a [FREE Trial Account](http://mailchimp.com/signup/) and see if you find it useful. |
| 118 |
|
| 119 |
= I want this in my language, do you have a translation? = |
| 120 |
Maybe! Look in the /po/ directory in our plugin package and see if your language is in there. If it is, great! If it is not, feel from to create one. Here are the basic steps: |
| 121 |
|
| 122 |
1. Copy "mailchimp_i18n-en_US.po" to "mailchimp_i18n-LANG_COUNTRY.po" - fill in LANG and COUNTRY with whatever you use for WPLANG in wp-config.php |
| 123 |
2. Grab a transalation editor. [POedit](http://www.poedit.net/) works for us |
| 124 |
3. Translate each line - if you need some context, just open up mailchimp.php and search for the line number or text |
| 125 |
4. [Fork](http://help.github.com/fork-a-repo/) the [repository on github](https://github.com/crowdfavorite/wp-mailchimp) |
| 126 |
5. [Clone](http://help.github.com/remotes/#clone) the _develop_ branch |
| 127 |
6. Add the appropriately named files to the /po/ directory and edit the /readme.txt to include how you'd like to be attributed |
| 128 |
7. Make a [pull request](http://help.github.com/send-pull-requests/) |
| 129 |
|
| 130 |
|
| 131 |
== Screenshots == |
| 132 |
|
| 133 |
1. Entering your MailChimp login info |
| 134 |
2. Selecting your MailChimp list |
| 135 |
3. Configuring your Signup Form display format (optional) |
| 136 |
4. Configuring extra fields on your Signup Form (optional) |
| 137 |
5. An example Signup Form Widget |
| 138 |
|
| 139 |
== Upgrade Notice == |
| 140 |
|
| 141 |
= 1.4 = |
| 142 |
Added Developer Mode "Kitchen Sink" to aid in styling without having to authenticate a MailChimp account. |
| 143 |
|
| 144 |
= 1.3 = |
| 145 |
Now using OAuth flow within plugin for user authentication |
| 146 |
|
| 147 |
Admin UI refresh |
| 148 |
|
| 149 |
= 1.2.11 = |
| 150 |
Merged pull request from https://github.com/headshift/wp-mailchimp adding additional translation strings. |
| 151 |
|
| 152 |
= 1.2.10 = |
| 153 |
Fixed submission error when apostrophes are present |
| 154 |
|
| 155 |
= 1.2.8= |
| 156 |
Fixes bug where entire phone numbers were only being deposited in the area code portion |
| 157 |
|
| 158 |
= 1.2.6 = |
| 159 |
Fixes major bug with "Settings" link on Plugins screen. |
| 160 |
|
| 161 |
= 1.2.5 = |
| 162 |
Added support for multiple interest groups, field formatting based on type and date picker. |
| 163 |
|
| 164 |
== Changelog == |
| 165 |
|
| 166 |
= 1.4 = |
| 167 |
* Developer Mode "Kitchen Sink" takes over plugin for local development |
| 168 |
* Developer Mode has filters of changable content |
| 169 |
* Fix bug related to required US phone validation |
| 170 |
|
| 171 |
= 1.3 = |
| 172 |
* Now using OAuth flow for user authentication |
| 173 |
* Admin UI refresh |
| 174 |
|
| 175 |
= 1.2.14 = |
| 176 |
* Add link to edit profile within error when duplicate signup occurs |
| 177 |
|
| 178 |
= 1.2.13 = |
| 179 |
* Fixed bug preventing address fields from submitting correctly. |
| 180 |
|
| 181 |
= 1.2.12 = |
| 182 |
* Update spanish language files (es_ES and es_MX) |
| 183 |
|
| 184 |
= 1.2.9 = |
| 185 |
* Fixed bug where multiple checkbox type interest groups were returning an invalid error |
| 186 |
* Fixed bug where assets were not enqueueing properly if the plugin directory was not set to 'mailchimp'. Now supports any directory name. |
| 187 |
|
| 188 |
= 1.2.8 = |
| 189 |
* Fixed bug where entire phone numbers were only being deposited in the area code portion |
| 190 |
|
| 191 |
= 1.2.7 = |
| 192 |
* CSS should now always load correctly on the front end |
| 193 |
* Adding Hebrew and Romanian language support |
| 194 |
* Updating translation contribution instructions |
| 195 |
* Tested version is now 3.3.1 |
| 196 |
|
| 197 |
= 1.2.6 = |
| 198 |
* Fixed bug with "Settings" link appearing on all plugins (props Jason Lane) |
| 199 |
* Resolved issue with unnecessary calls to the MailChimp API during upgrade check |
| 200 |
* Resolved PHP warning when there weren't any interest groups |
| 201 |
|
| 202 |
= 1.2.5 = |
| 203 |
* Field formatting based on type |
| 204 |
* Support for multiple interest groups (a data upgrade procedure must be run by visiting the WordPress dashboard) |
| 205 |
* Added jQuery datepicker option to be used with dates. |
| 206 |
* Added a handful of new translations |
| 207 |
* Fixing various PHP notices and deprecated functions (props Jeffry Ghazally) |
| 208 |
|
| 209 |
= 1.2.4 = |
| 210 |
* Version bump for proper listing on wordpress.org |
| 211 |
|
| 212 |
= 1.2.3 = |
| 213 |
* Change mailchimpSF_where_am_i() to use plugins_url() in place of WP_PLUGIN_URL to take SSL into account when delivering assets (props John LeBlanc) |
| 214 |
* Update MCAPI wrapper to bring back PHP4 support (note: PHP 5.2 to be required starting with WordPress 3.2) |
| 215 |
|
| 216 |
= 1.2.2 = |
| 217 |
* Change MCAPI wrapper to use a more unique class name, v1.3 of the API, and a much lighter client library |
| 218 |
|
| 219 |
= 1.2.1 = |
| 220 |
* Fixed internationalization path bug. |
| 221 |
* Fixed instances where i18n functions weren't necessary in admin. |
| 222 |
* Added more strings to be translated. |
| 223 |
|
| 224 |
= 1.2 = |
| 225 |
* Recommended Upgrade, please see "Upgrading" section of readme. |
| 226 |
* Security and various other improvements |
| 227 |
|
| 228 |
|
