ajimix/asana-api-php-class

A PHP class that acts as wrapper for Asana API. Lets make things easy! :)

Installs: 2 045

Dependents: 0

Stars: 86

Watchers: 22

Forks: 53

Open Issues: 1

Language: PHP

2.14.0 2015-07-21 16:24 UTC

README

A PHP class that acts as wrapper for Asana API.
Lets make things easy! :)

It is licensed under the Apache 2 license and is Copyrighted 2014 Ajimix

Installing

Choose your favorite flavour

  • Download the php class from github.
  • Use Packagist PHP package manager.

Finally require the asana.php file.

Working with the class

First declare the asana class

$asana = new Asana(array(
    'apiKey' => 'YOUR_COOL_API_KEY'
));

Optionally you can pass an accessToken instead of an apiKey if you use OAuth. Read below for more info.

Creating a task
$asana->createTask(array(
   'workspace' => '176825', // Workspace ID
   'name' => 'Hello World!', // Name of task
   'assignee' => 'bigboss@bigcompany.com', // Assign task to...
   'followers' => array('3714136', '5900783') // We add some followers to the task... (this time by ID)
));

Creating a task for another assignee than yourself will mark the task as private by default. This results in the task not being available for modification through the API anymore. Take a look at the API Reference for more fields of the Task you can directly pass to createTask.

Adding task to project
$asana->addProjectToTask('THIS_TASK_ID_PLEASE', 'TO_THIS_COOL_PROJECT_ID');
Commenting on a task
$asana->commentOnTask('MY_BEAUTIFUL_TASK_ID', 'Please please! Don\'t assign me this task!');
Getting projects in all workspaces
$asana->getProjects();
Updating project info
$asana->updateProject('COOL_PROJECT_ID', array(
    'name' => 'This is a new cool project!',
    'notes' => 'At first, it wasn\'t cool, but after this name change, it is!'
));
Do more

There are a lot more methods to do multiple things with asana.

See the examples inside examples folder, read the comments on the class file for class magic and read Asana API documentation if you want to be a master :D

Enjoy ;D

Using Asana OAuth tokens

To use this API you can also create an App on Asana, in order to get an oAuth access token that gives you the same access as with an API key. Include the class:

require_once('asana-oauth.php');

Declare the oAuth class as:

$asanaAuth = new AsanaAuth('YOUR_APP_ID', 'YOUR_APP_SECRET', 'CALLBACK_URL');
$url = $asanaAuth->getAuthorizeUrl();

Where YOUR_APP_ID, YOUR_APP_SECRET and CALLBACK_URL you get from your App's details on Asana. Now, redirect the browser to the result held by $url. The user will be asked to login & accept your app, after which the browser will be returned to the CALLBACK_URL, which should process the result:

$code = $_GET['code'];
$asanaAuth->getAccessToken($code);

And you will receive an object with the access token and a refresh token The token expires after one hour so you can refresh it doing the following:

$asanaAuth->refreshAccessToken('ACCESS_TOKEN');

For a more detailes instructions on how to make oauth work check the example in examples/oauth.php

Author

Twitter: @ajimix

GitHub: github.com/ajimix

Contributors: view contributors

Copyright and license

Copyright 2014 Ajimix

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.