==============================================================================
"MailChimp Integration Pro" Instructions

Author: Clear Thinking, LLC
E-mail: johnathan@getclearthinking.com
Website: http://www.getclearthinking.com
==============================================================================

1. Backup your OpenCart installation, just to be safe.



2. Make sure a recent version of vQmod is installed (preferably 2.5.1 or
later). You can check your vQmod version in the /vqmod/vqmod.php file. If you
do not have vQmod installed, you can download it for free from www.vqmod.com



3. Using an FTP application, upload the extension files to your server. To do
this, unzip the .zip bundle, and then upload the contents of the "upload"
folder to the root of your OpenCart installation. (Note: make sure you're
uploading the CONTENTS, and not the "upload" folder itself.) For further
information on how to upload files via FTP, view this video tutorial:

https://www.youtube.com/watch?v=BQrgJeOAIQ8

If you prefer the extension be installed for you as a paid service, contact
Clear Thinking at the above e-mail address for details.



4. If updating from a previous version, make sure to click "Save" in the
admin panel to apply any new settings. You can ignore the rest of the
following instructions.



5. If installing for the first time, navigate to:
Extensions > Modules > MailChimp Integration Pro > click Install



6. All documentation for the extension is built into the admin panel itself, in
the form of help text and tooltips. Please make sure you read all of that
information carefully for each admin panel setting. If you have further
questions about any specific setting, or any problems using the extension,
please contact Clear Thinking at the above e-mail address.



7. If you want to add a checkbox to the guest checkout as well, you can use
the following edit. The info will then be passed on to MailChimp appropriately
during guest checkout. If you have "Auto-Create Customers" enabled, a new
customer will also be automatically created in OpenCart when MailChimp
sends the webhook back to OpenCart after the sign up is processed.

------------------------------------------------------------------------------
IN:
/catalog/view/theme/default/template/checkout/guest.tpl

BEFORE:
<div class="buttons">

ADD:
<label><input type="checkbox" name="newsletter" value="1" /> Subscribe to our newsletter</label>
------------------------------------------------------------------------------



8. If you want to add a checkbox to the default theme's contact form as well,
you can use the following edit. For custom themes, ask your theme designer for
the appropriate edit.

------------------------------------------------------------------------------
IN:
/catalog/view/theme/default/template/information/contact.tpl

AFTER:
<div class="buttons">

ADD:
<label><input type="checkbox" name="newsletter" value="1" /> Subscribe to our newsletter</label>
------------------------------------------------------------------------------



9. To hook other e-mail modules or extensions into the MailChimp Integration,
you can paste the following code in wherever the e-mail address is used on the
server. If you don't know where that is, you should ask the developer of the
extension you are trying to hook it into.

The $email variable should contain the e-mail address you want to subscribe to
your MailChimp list.

------------------------------------------------------------------------------
if (version_compare(VERSION, '2.1', '<')) $this->load->library('mailchimp_integration');
$mailchimp_integration = new MailChimp_Integration($this->registry);
$mailchimp_integration->send(array('email' => $email, 'newsletter' => 1));
------------------------------------------------------------------------------



10. If you've enabled the "Send Cart Data" setting and are using a custom
checkout, you'll need to place this code somewhere in your checkout extension
code, to send abandoned carts to MailChimp. You should ask the developer
of your checkout extension if you do not know where to place it:

------------------------------------------------------------------------------
$customer_id = ($this->customer->isLogged()) ? (int)$this->customer->getId() : $this->session->data['guest']['email'];
if (version_compare(VERSION, '2.1', '<')) $this->load->library('mailchimp_integration');
$mailchimp_integration = new MailChimp_Integration($this->registry);
$mailchimp_integration->sendCart($this->cart, $customer_id);
------------------------------------------------------------------------------
