You are here

README.txt in Mailchimp E-Commerce 7

Same filename and directory in other branches
  1. 8 README.txt
# Mailchimp eCommerce

## Description

The Mailchimp eCommerce module connects Drupal-based shopping carts to
Mailchimp's eCommerce API.

For more information about Mailchimp eCommerce integration, please see:

https://mailchimp.com/resources/mailchimp-e-commerce/

## Dependencies

  * Mailchimp: https://www.drupal.org/project/mailchimp
  * Mailchimp Audiences

## Optional Dependencies

  This module supports two eCommerce platforms. Only one should be enabled
  at any time.

  * Commerce: https://www.drupal.org/project/commerce
  * Ubercart: https://www.drupal.org/project/ubercart

## Installation

  * Ensure you have the Mailchimp module configured with your API key.

## Installation Notes

  ### For Drupal Commerce

    * Enable the Mailchimp eCommerce Commerce module.

  ### For Ubercart

    * Enable the Mailchimp eCommerce Ubercart module.

## Configuration

  * Connect your Drupal Commerce or Ubercart store to MailChimp at this path:
      /admin/config/services/mailchimp/ecommerce

  * Enter a name for your store and select a MailChimp audience.
    Stores are mapped one-to-one with audiences.

## For Existing Stores

  If you already have an active Drupal Commerce or Ubercart store, you must
  sync your existing products to MailChimp. You may optionally sync existing
  orders.

  You will find options to sync both products and orders at this path:
    /admin/config/services/mailchimp/ecommerce

  If syncing existing orders, you will need to sync existing products first.

## Testing

  ### Mailchimp API Playground

    Mailchimp provides a way to interact with their API via your web browser.

    See: https://us1.api.mailchimp.com/playground/

    You are able to execute API commands that will show your eCommerce stores,
    products, orders, and customers here.

  ### Drush Commands

    This module provides these drush commands:

      * drush mcstores
        Retrieve a list of stores attached to your API key.

      * drush mcorders [store ID]
        Retrieve a list of orders for a given store ID.
        Store IDs are available via the mcstores drush command.

## Related Modules

  ### Mailchimp - http://drupal.org/project/mailchimp

    * This module provides integration with Mailchimp, a popular email delivery
      service. The module makes it easy for website users or visitors to control
      which of your email audiences they want to be on (or off), lets you generate
      and send Mailchimp email campaigns from your site, and lets you and your
      users view a history of emails they have been sent from Mailchimp.
      More generally, it aspires to makes your email delivery world efficient
      and to make your user's email receipt and control simple and precise.

  ### Mandrill - http://drupal.org/project/mandrill

    * Mandrill is Mailchimp's transactional email service. The module provides
      the ability to send all site emails through Mandrill with reporting
      available from within Drupal. Please refer to the project page for more
      details.

File

README.txt
View source
  1. # Mailchimp eCommerce
  2. ## Description
  3. The Mailchimp eCommerce module connects Drupal-based shopping carts to
  4. Mailchimp's eCommerce API.
  5. For more information about Mailchimp eCommerce integration, please see:
  6. https://mailchimp.com/resources/mailchimp-e-commerce/
  7. ## Dependencies
  8. * Mailchimp: https://www.drupal.org/project/mailchimp
  9. * Mailchimp Audiences
  10. ## Optional Dependencies
  11. This module supports two eCommerce platforms. Only one should be enabled
  12. at any time.
  13. * Commerce: https://www.drupal.org/project/commerce
  14. * Ubercart: https://www.drupal.org/project/ubercart
  15. ## Installation
  16. * Ensure you have the Mailchimp module configured with your API key.
  17. ## Installation Notes
  18. ### For Drupal Commerce
  19. * Enable the Mailchimp eCommerce Commerce module.
  20. ### For Ubercart
  21. * Enable the Mailchimp eCommerce Ubercart module.
  22. ## Configuration
  23. * Connect your Drupal Commerce or Ubercart store to MailChimp at this path:
  24. /admin/config/services/mailchimp/ecommerce
  25. * Enter a name for your store and select a MailChimp audience.
  26. Stores are mapped one-to-one with audiences.
  27. ## For Existing Stores
  28. If you already have an active Drupal Commerce or Ubercart store, you must
  29. sync your existing products to MailChimp. You may optionally sync existing
  30. orders.
  31. You will find options to sync both products and orders at this path:
  32. /admin/config/services/mailchimp/ecommerce
  33. If syncing existing orders, you will need to sync existing products first.
  34. ## Testing
  35. ### Mailchimp API Playground
  36. Mailchimp provides a way to interact with their API via your web browser.
  37. See: https://us1.api.mailchimp.com/playground/
  38. You are able to execute API commands that will show your eCommerce stores,
  39. products, orders, and customers here.
  40. ### Drush Commands
  41. This module provides these drush commands:
  42. * drush mcstores
  43. Retrieve a list of stores attached to your API key.
  44. * drush mcorders [store ID]
  45. Retrieve a list of orders for a given store ID.
  46. Store IDs are available via the mcstores drush command.
  47. ## Related Modules
  48. ### Mailchimp - http://drupal.org/project/mailchimp
  49. * This module provides integration with Mailchimp, a popular email delivery
  50. service. The module makes it easy for website users or visitors to control
  51. which of your email audiences they want to be on (or off), lets you generate
  52. and send Mailchimp email campaigns from your site, and lets you and your
  53. users view a history of emails they have been sent from Mailchimp.
  54. More generally, it aspires to makes your email delivery world efficient
  55. and to make your user's email receipt and control simple and precise.
  56. ### Mandrill - http://drupal.org/project/mandrill
  57. * Mandrill is Mailchimp's transactional email service. The module provides
  58. the ability to send all site emails through Mandrill with reporting
  59. available from within Drupal. Please refer to the project page for more
  60. details.