docmail-laravel

Installation

The Docmail Service Provider can be installed via Composer by requiring the Softlabs/docmail package and setting the minimum-stability to dev in your project's composer.json.

{
    "require": {
        "laravel/framework": "4.0.*",
        "Softlabs/docmail": "1.*"
    },
    "minimum-stability": "dev"
}

Also you need to add the repository to composer.json:

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/Softlabs/docmail-laravel"
    }
]

This package contains two classes:

• Docmail
• DocmaiAPI

DocmailAPI class

This class allows making Docmail API calls. Every public function in DocmailAPI class is mapped to a single Docmail API call.

$templateGUID = DocmailAPI::AddTemplateFile($options);

This code send a AddTemplateFile call to the API with parameters $option and results the template GUID.

Docmail class

Docmail class contains complex methods, not only single API calls. For example the following method Docmail::sendToSingelAddress creates a new mailing, adds an address and uploads a template file:

public function sendToSingelAddress($options = []) {

    $this->mailingGUID = DocmailAPI::CreateMailing();
    $options["MailingGUID"] = $this->mailingGUID;

    $result = DocmailAPI::AddAddress($options);

    $this->templateGUID = DocmailAPI::AddTemplateFile($options);

}

In your code you can combine the two classes, like:

        $dm = new SoftlabsDocmail();
        $dm->sendToSingelAddress([
            "Address1" => "address line 1",
            "FilePath" => "../sample.pdf",
        ]);
        $satus = DocmailAPI::GetStatus($dm->getMailingGUID());

API parameter defaults

API call parameters can get its values from various sources (in ascending priority order):

• method parameters

    DocmailAPI::GetStatus($dm->getMailingGUID())
  

• docmail config file (/app/config/Softlabs/docmail.php)

    return [
  
        'username'       => 'myusername',
        'password'       => 'mypassword',
        'wsdl'           => 'https://www.cfhdocmail.com/TestAPI2/DMWS.asmx?WSDL',
  
        'productType'    => "A4Letter",
        'printColor'     => false,
        'printDuplex'    => false,
        'deliveryType'   => "Standard",
        'despatchASAP'   => true,
  
        'MinimumBalance' => 200,
        'AlertEmail'     => "[email protected]"
  
    ];
  

• defalut values set in DocmailAPI class

    private static $defaults = [
        "Username" => null,
        "Password" => null,
        "wsdl" => null,
        "timeout" => 240,
        "DocumentType" => "A4Letter"
    ];
  

Exaple code how to send a mailing

    $data = [
        "lastName"     => "lastname2",
        "address1"     => "address line 1",
        "postCode"     => "PostCode",
        "filePath"     => "../sample.pdf",
        "templateName" => "Sample Template 01",
        "submit"       => true,
    ];

    $options = [
        "printColour"  => true,
        "firstClass"   => true,
    ];

    $result = SoftlabsDocmail::sendToSingelAddress($data, $options);