====== asana Plugin ======

---- plugin ----
description: Asana's task integration from syntax and API call
author     : Elonet
email      : contact@elonet.fr
type       : syntax, remote
lastupdate : 2014-05-01
compatible : Binky
depends    : 
conflicts  : 
similar    : 
tags       : teamwork, task, issue

downloadurl: https://github.com/pedroELT/elonet/archive/master.zip
bugtracker : https://github.com/pedroELT/asana/issues
sourcerepo : https://github.com/pedroELT/elonet
donationurl: 

screenshot_img : 
----
===== Examples/Usage =====

This plugin integrates [[https://asana.com/|Asana]]'s tasks (a teamwork communication manager), more specifically project name, task name, assignee, due date, tags and comments into an array.
It also permits to filter with workspace name, projects names, assignees names and tags names.

===== Installation =====


:!: **External requirements:** This plugin requires an Asana'a account and the libcurl php library.

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Syntax =====


Display all tasks :

  [asana : ]

Some more complex syntaxes :

 Filter with a workspace ( if not define into configuration plugin panel ) :
  [asana :workspace=workspaceName, ]
  
 Filter with projects names :
  [asana :projects=projectName,otherProjectName, ]
  
 Filter with assignees names or tags names :
  [asana :assignees=assigneeName, tags=tagName, ]
  
 Filter with a string contained into task name or description :
  [asana :strings=string1,string2, ]
  
 Fullest possible syntax :
  [asana :[workspace=workspaceName,] [projects=projectName,[projectName,]*] [assignees=assigneeName,[assigneeName,]*] [tags=tagName,[tagName,]*] [strings=string,[string,]*] ]


===== Configuration and Settings =====

The plugin is configured with a mandatory Asana's API key. 
And an optionnal workspace name


=== ToDo/Wish List ===

The plugin is an read only integration.
So, next part is a writable integration.