# Installation
Clone the repository into `~/public_html/modules/Ezine`:

```bash
git clone https://BITBUCKET_USERNAME@bitbucket.org/mtcmedia/core-modules-ezine.git ~/FORK_NAME/modules/Ezine && rm -rf ~/FORK_NAME/modules/Ezine/.git
```

Remember to then run composer update.

# Usage
Edit the email.ezine.php to edit the ezine template.

# Database installation/update
Open the site, the Ezine will install automatically if needed.

# CSV Import
Example of emails CSV import file is provided under `Ezine/example/example.csv`

To add new email simply skip entering id

To edit existing email provide id of email in CSV

One CSV file can be used for updating and adding new emails

First row of CSV is header

# CSV import row structure
[id][email][firstname][surname]

# Transferring Ezine to live
An installation call is made on the emails manage page so the settings will be added once you have visited this page.

http://www.MYSITE.co.uk/modules/Ezine/admin/email_manage.php

You can also visit the includes/install.php file directly and the install will trigger from there.

# Bouncebacks
A bounceback handler also needs to be set up for each Ezine install. Please see the wiki for documentation:

http://wiki.mtcmedia.co.uk/index.php?title=Email_Marketing_-_Bounceback_Handler

# Unsubscribe

The Ezine produced will always carry a link so that users can opt out.  You must include some way to allow users to opt out of recieving further emails.  You can add this functionality by installing the [Unsubscribe plugin](https://bitbucket.org/mtcmedia/core-plugins-unsubscribe).
