Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests Fix line length violations Aug 20, 2018
.gitignore Added basic tests for API Oct 24, 2017
.travis.yml Remove php 5.4 Nov 17, 2017
LICENSE.txt Add license for composer Feb 28, 2017
Makefile Format files and add standard validation May 16, 2018
README.md Added status badge Nov 17, 2017
composer.json Bump version Aug 20, 2018
composer.lock
cronofy.php Fix line length violations Aug 20, 2018
phpunit.xml Bootstrap cronofy.php Nov 17, 2017
ruleset.xml Fix line length violations Aug 20, 2018

README.md

Cronofy

Cronofy - one API for all the calendars (Google, iCloud, Exchange, Office 365, Outlook.com) Build Status

Sample Application

To see this API wrapper in action see our sample app here

Usage

In order to use the Cronofy API you will need to create a developer account.

From there you can use your Calendar Sandbox to access your own calendars, or you can create an OAuth application to obtain an OAuth client_id and client_secret to be able to use the full API.

Authorization

API documentation

Generate a link for a user to grant access to their calendars:

$redirect_uri = "http://yoursite.dev/oauth2/callback";

$cronofy = new Cronofy(array("client_id" => "clientId"));
$params = array(
  'redirect_uri' => $redirect_uri,
  'scope' => array('read_account','list_calendars','read_events','create_event','delete_event')
);
$auth = $cronofy->getAuthorizationURL($params);

The redirect URI is a page on your website that will handle the OAuth 2.0 callback and receive a code parameter. You can then use that code to retrieve an OAuth token granting access to the user's Cronofy account:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret"
));

$params = array(
  'redirect_uri' => $redirect_uri,
  'code' => $code
);

$token=$cronofy->request_token($params);

You should save the response's AccessToken and RefreshToken for later use.

Note that the exact same redirect URI must be passed to both methods for access to be granted.

List calendars

API documentation

Get a list of all the user's calendars:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken"
));

$calendar = $cronofy->list_calendars();

Read events

API documentation

Get a list of all the user's events:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken"
));

$params = array(
  'tzid' => 'Etc/UTC'
);

$events = $cronofy->read_events($params);

foreach($events->each() as $event){
  // process event
}

Create or update events

API documentation

To create/update an event in the user's calendar:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken"
));

$params = array(
  'calendar_id' => 'calendarID',
  'event_id' => 'event_test_12345679',
  'summary' => 'test event 2',
  'description' => 'some event data here',
  'start' => '2015-12-07T09:00:00Z',
  'end' => '2015-12-08T10:00:00Z'
);
$new_event = $cronofy->upsert_event($params);

Delete events

API documentation

To delete an event from user's calendar:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken"
));

$params = array(
  'calendar_id' => 'calendarID',
  'event_id' => 'EventID'
);

$delete = $cronofy->delete_event($params);

Delete external events

To delete an external event from a user's calendar:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken"
));

$params = array(
  'calendar_id' => 'calendarID',
  'event_uid' => 'EventUID'
);

$delete = $cronofy->delete_external_event($params);

Elevated permissions

To elevate a client's permissions for a user's calendar(s):

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken"
));

$params = array(
  'permissions' => array(
    array(
      'calendar_id' => 'calendarID_1',
      'permission_level' => 'unrestricted'
    ),
    array(
      'calendar_id' => 'calendarID_2',
      'permission_level' => 'unrestricted'
    )
  ),
  'redirect_uri' => 'http://yoursite.dev/elevate/callback'
);

$response = $cronofy->elevated_permissions($params);

Authorize with a Service Account

To authorize a user's account using a service account:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken"
));

$params = array(
  'email' => $email,
  'callback_url' => $callback_url,
  'scope' => array('read_account','list_calendars','read_events','create_event','delete_event')
);

$response = $cronofy->authorize_with_service_account($params);

Note: You will need to use a Service Account access token to perform this action.

Create a Calendar

To create a calendar for a user's account profile:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken"
));

$params = array(
  'profile_id' => $account_profile_id,
  'name' => $new_calendar_name
);

$response = $cronofy->create_calendar($params);

Using an Alternative Data Center

To use an alternative data center:

$cronofy = new Cronofy(array(
  "client_id" => "clientId",
  "client_secret" => "ClientSecret",
  "access_token" => "AccessToken",
  "refresh_token" => "RefreshToken",
  "data_center" => "DataCenter"
));

Running unit tests

curl -sS https://getcomposer.org/installer | php
php composer.phar install
vendor/bin/phpunit

Links