README

CloudmailIn for cloudControl

This mini app on cloudControl shows the usage of the CloudMailIn addon.

The CloudMailIn addon provides incoming email for your app.

The mini app's goal is - in this case - to store the incoming messages to a 
database.
For your special needs overwrite the handleMail function in "incomingMail.php". 

To run the app you need a cloudControl MySQLs addon and naturally a cloudControl 
CloudMailIn addon.

To run this app you have to

    * Configure the endpoint of incoming emails to CloudMailIn.com.
        * Login on CloudMailIn.com with your CloudMailIn credentials (type in 
          commandline $ cctrlapp APP_NAME/DEP_NAME addon)
        * On CloudMailIn's dashboard at "Email Forwards(SMTP)", choose the 
          proper CloudMailIn email address and click on "manage".
          Click on "Edit Target" and fill the target field with 
          "http://APP_NAME.cloudcontrolled.com/incomingMail.php"

    * Configure your database. Connect to your database with your mysqls 
      credentials (type in commandline $ cctrlapp APP_NAME/DEP_NAME addon) 
        * Create a table in your database:

        CREATE TABLE `mail` (
                `id` int(11) NOT NULL AUTO_INCREMENT,
                `date` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
                `from` varchar(255) DEFAULT '',
                `to` varchar(255) DEFAULT '',
                `subject` varchar(255) DEFAULT '',
                `plain` varchar(2048) DEFAULT '',
                `html` varchar(4096) DEFAULT '',
                `x_remote_ip` varchar(128) DEFAULT '',
                PRIMARY KEY (`id`)
        ) ENGINE=InnoDB DEFAULT CHARSET=latin1

    * Now you can send an e-mail to the CloudMailIn email address from your 
      default e-mail client. CloudMailIn forwards the e-mail to your webapp. 
      The incomingMail.php script stores the mail to the MySQLs database.

    * You can read the mail with a request to 
      "http://APP_NAME.cloudcontrolled.com/readMail.php"