iOS Integration

1. Copy Email Collector folder into your project's XCode files view

2. Include Email Collectors header file to your AppDelegate viewController.

#import "MTEmailCollector.h"

3. Include Email Collectors applicationLoaded method to applicationDidFinish function.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    .
    .
    [MTEmailPopup applicationLoaded];
    .
    .
}

4. Init MTEmailCollector class

MTEmailPopup *emailPopup = [[MTEmailPopup alloc] init];
[self.view addSubview:emailPopup];

Dont forget to set DebugMode "NO".

#define DebugMode               NO

iOS Network Configurations

Setup network connection configurations in MTEmailCollector.h header file..

1. Place your AppID that is generated from Email Collector's Server application.

#define AppID                   @"YourAppIDComesHere"

2. Place your host url.

#define HostUrl                 @"YourHostURLComesHere"

Text Editing

You can edit all texts in popup view as you wish.

#define FormTitle               NSLocalizedString(@"Email Signup", nil)
#define FormDescription         NSLocalizedString(@"Joining our mailing list means that we can keep you updated with new releases, new apps and discounts.", nil)
#define FormInformation         NSLocalizedString(@"Enter your email below to subscribe.", nil)
#define SubmitButtonText        NSLocalizedString(@"Submit", nil)
#define NotificationText        NSLocalizedString(@"Thank You for Subscribing", nil) 

Popup View Settings

Set how many times popup will be showed until subscribing.

#define TimesWillBeAsked           3   // Integer

Set how many times customers will use application to be asked to subscribe. Set 1 to show in first use.

#define UsesUntilAsked             5   // Integer

"DaysUntilAsked" defines the days that will pass to be asked to subscribe.

#define DaysUntilAsked             20 // Integer

Here we will provide the steps to install Email Collector Server side component to a dedicated Ubuntu 11.10 installation. The selected domain for this installation is "emails.acmecompany.com". Please replace this with your own domain address.

1. Install apache2, mysql-server and php5 packages

apt-get install apache2 mysql-server php5 php5-mysql unzip

2. Enable apache mod_rewrite

a2enmod rewrite

3. Create Virtual Host file for Email Collector. Place this file under /etc/apache2/sites-available/001-emails

    ServerAdmin support@acmecompany.com
    ServerName  emails.acmecompany.com

    DocumentRoot    /home/acme/EmailCollector

     ErrorLog /var/log/apache2/error.log
     LogLevel warn
     CustomLog /var/log/apache2/access.log combined

    
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        
            Order allow,deny
            Allow from all
        
    

4. Enable 001-emails site

a2ensite 001-emails

5.Add acme user

adduser acme

6. Switch to acme user

sudo su - acme

7. Unzip and copy EmailCollector.Server folder to /home/acme/EmailCollector

unzip email-collector-for-ios-1.0.zip
mv Binpress/EmailCollector.Server /home/acme/EmailCollector

8. Chage owner of the EmailCollector folder. Give permission to web server.

chown -R acme:www-data /home/acme/EmailCollector
chmod -R 775 /home/acme/EmailCollector/tmp

9. Create database and import mysql server data

mysqladmin -u root -p create mt_emails_db;
mysql -u root -p -h localhost mt_emails_db < /home/acme/EmailCollector/mt_emails_db.sql

10. Restart apache2 and Login to Email Collector at http://emails.acmecompany.com

service apache2 restart