campaignmonitor/createsend-php

Increase default timeout to 120secs.
Minor updates.

• Add PHP 7.4 Support

• Added support for Journeys API

Updated to use standard agent string prefix format.

Updated to use Campaign Monitor API v3.2
This contains breaking changes, see https://www.campaignmonitor.com/api/ for further details and check the HISTORY.md file

• Changed local API timeout from 10 sec to 20 sec

• Added support for Behavioral Event data

• Prevent definition re-declarations

• Changed the fatal error thrown when unable to communicate with the API into a catchable Exception

• Added PHP7 support

• Fixed the transactional smart email call for get_list() so it now passes the client id

• Added support for Transactional Email

• Updated constant definitions so PHP Notices aren't raised

• Updated the class_exists check to no longer call __autoload

• Updated to v3.1 API
• Added support for new segments structure

  • Segment now includes a new RuleGroups member, instead of a Rules member.

    So for example, when you _previously_ would have created a segment like so:
    
    ```php
    $result = $wrap->create('Segments List ID', array(
    	'Title' => 'Segment Title',
    	'Rules' => array(
    		array(
    			'Subject' => 'EmailAddress',
    			'Clauses' => array(
    				'CONTAINS example.com'
    			)
    		) ,
    		array(
    			'Subject' => '[customfield]',
    			'Clauses' => array(
    				'PROVIDED',
    				'EQUALS 1'
    			)
    		)
    	)
    ));
    ```
    
    You would _now_ do this:
    
    ```php
    $result = $wrap->create('Segments List ID', array(
    	'Title' => 'Segment Title',
    	'RuleGroups' => array(
    		array(
    			'Rules' => array(
    				array(
    					'RuleType' => 'EmailAddress',
    					'Clause' => 'CONTAINS example.com'
    				)
    			)
    		) ,
    		array(
    			'Rules' => array(
    				array(
    					'RuleType' => '[customfield]',
    					'Clause' => 'PROVIDED'
    				) ,
    				array(
    					'RuleType' => '[customfield]',
    					'Clause' => 'EQUALS 1'
    				)
    			)
    		)
    	)
    ));
    

  • The Add Rule call is now Add Rule Group, taking a ruleGroup argument instead of a rule argument.

    function CS_REST_Segments->add_rulegroup($rulegroup)
    

    So for example, when you previously would have added a rule like so:

    $wrap = new CS_REST_Segments('Segment ID', $auth);
    $result = $wrap->add_rule(array(
        'Subject' => 'EmailAddress',
        'Clauses' => array('CONTAINS example.com')
    ));
    

    You would now do this:

    $wrap = new CS_REST_Segments('Segment ID', $auth);
    $result = $wrap->add_rulegroup(array(
        'Rules' => array(
            array(
                'RuleType' => 'EmailAddress',
                'Clause' => 'CONTAINS example.com'
            )
        )
    ));
    

• Removed the get_apikey method to promote usage of oAuth authentication

• Fixed a notice that was raised when unscheduling a campaign.

• Only set the CURLOPT_CAINFO option if not already set globally via the ini system.

• Made it harder to accidentally email your subscribers when using the example code

• Added support for single sign on which allows initiation of external login sessions to Campaign Monitor.

• Added support for authenticating using OAuth. See the README for full usage instructions.

  • This introduces some changes to how you authenticate using this library. You now authenticate by passing an $auth array as the first argument when creating instances of any classes which inherit from the CS_REST_Wrapper_Base class.

    So in existing code, when you previously would have authenticated using an API key as follows:

    $wrap = new CS_REST_General('Your API Key');
    $result = $wrap->get_clients();
    

    If you want to authenticate using an API key, you should now do this:

    $wrap = new CS_REST_General(array('api_key' => 'Your API Key'));
    $result = $wrap->get_clients();
    

• Removed simpletest source files, and added simpletest as a dev dependency.
• Fixed autoloading with composer, so that only necessary classes are loaded.

• Use CURLOPT_TIMEOUT and CURLOPT_CONNECTTIMEOUT constants instead of CURLOPT_TIMEOUT_MS and CURLOPT_CONNECTTIMEOUT_MS.
• Added autoloading support when using Composer (PHP dependency management).

• Added support for including from name, from email, and reply to email in drafts, scheduled, and sent campaigns.
• Added support for campaign text version urls.
• Added support for transferring credits to/from a client.
• Added support for getting account billing details as well as client credits.
• Made all date fields optional when getting paged results.

• Added CS_REST_Campaigns.get_email_client_usage().
• Added support for ReadsEmailWith field on subscriber objects.
• Added support for retrieving unconfirmed subscribers for a list.
• Added support for suppressing email addresses.
• Added support for retrieving spam complaints for a campaign, as well as adding SpamComplaints field to campaign summary output.
• Added VisibleInPreferenceCenter field to custom field output.
• Added support for setting preference center visibility when creating custom fields.
• Added the ability to update a custom field name and preference visibility.
• Added documentation explaining that TextUrl is now optional when creating a campaign.

• Fixed timeout issue by setting CS_REST_SOCKET_TIMEOUT to 10 seconds.

• Fixed #13. Load services_json.php only if Services_JSON class doesn't already exist.
• Fixed issue with curl calls hangs hanging on proxy failure.