Basecamp Classic API Wrapper for php 5.3+

This is a php library to access the classic Basecamp API. Collection classes provide methods to query the api and wrap each result item in an entity object. Entity objects come with methods such as update() and delete() to persist themselfes via the api. Functionality is provided to attach and detach observers to collections and entities – this is useful for logging or to print current activity to the terminal.

Supported Features

Person: startMe(), startById(), startAllByProjectId(), startAll() etc
Project: startById(), startAll(), copy(), replicate() etc
Milestone: startAllByProjectId(), create(), update(), delete(), complete(), uncomplete() etc
Todolist: startById(), startAllByProjectId(), startAllByResponsibiltyParty(), create(), update(), delete() etc
Todoitems: startAllByTodoListId(), startById(), create(), update(), delete(), complete(), uncomplete() etc
Comments: startAllByResourceId(), startById()
Timetracking: startAllByProjectId(), startById()

Requirements

php 5.3+ (uses namespaces)

Getting Started

Please find plenty of working examples in the basecamp/example/basecamp directory. Here’s the basics:

First Steps

git clone git://github.com/sirprize/basecamp.git sirprize-basecamp
cd sirprize-basecamp
git submodule init
git submodule update
create a dummy project in your basecamp account
adjust sirprize-basecamp/example/basecamp/_config.php with your own settings
make files executable in sirprize-basecamp/example/basecamp/(milestone|person|project|todoitem|todolist)/*
make writeable sirprize-basecamp/example/_logs
run examples

Setup

$config = array(
	'baseUri' => 'https://xxx.basecamphq.com',
	'username' => 'xxx',
	'password' => 'xxx'
);

$service = new \Sirprize\Basecamp\Service($config);

Fetch all projects

$projects = $service->getProjectsInstance()->startAll();

foreach($projects as $project)
{
	print $project->getName()."\n";
}

Copy a project

/*
 *
 * populate the target-project with the milestones,
 * todo-lists and todo-items from the source-project
 *
 */

$sourceProjectId = new \Sirprize\Basecamp\Id('xxx');
$targetProjectId = new \Sirprize\Basecamp\Id('yyy');

$projects = $service->getProjectsInstance();
$sourceProject = $projects->startById($sourceProjectId);
$sourceProject->copy($targetProjectId);

Replicate a project (push deadlines to a new date)

/*
 *
 * populate the target-project with the milestones,
 * todo-lists and todo-items from the source-project.
 * the last milestone deadline is pushed to 2010-12-30 and
 * all other deadlines will be calculated relative to it
 *
 */

$sourceProjectId = new \Sirprize\Basecamp\Id('xxx');
$targetProjectId = new \Sirprize\Basecamp\Id('yyy');

$projects = $service->getProjectsInstance();
$sourceProject = $projects->startById($sourceProjectId);
$referenceDate = new \Sirprize\Basecamp\Date('2010-12-30');
$referenceMilestone = \Sirprize\Basecamp\Schema\Export::REFERENCE_EXTREMITY_LAST;
$sourceProject->replicate($targetProjectId, $referenceDate, $referenceMilestone);

Create a new milestone

$milestones = $service->getMilestonesInstance();
$milestone = $milestones->getMilestoneInstance();
$deadline = new \Sirprize\Basecamp\Date('2010-03-01');
$projectId = new \Sirprize\Basecamp\Id('xxx');
$userId = new \Sirprize\Basecamp\Id('xxx');

$milestone
	->setProjectId($projectId)
	->setResponsiblePartyId($userId)
	->setDeadline($deadline)
	->setTitle('Milestoners Everywhere')
	->setWantsNotification(true)
	->create()
;

Todo

Account
Companies
Categories
Messages
Comments: create(), update(), delete()
Time tracking: startAllByTodoItemId(), create(), update(), delete()

shashank9487/basecamp