johnrich85/teamwork

PHP wrapper for the Teamwork project management API

v2.0.0 2024-02-28 10:01 UTC

This package is auto-updated.

Last update: 2024-03-28 11:03:52 UTC


README

teamwork-graphic

Scrutinizer Code Quality Code Coverage Build Status Release License

This is a simple PHP Client that can connect to the Teamwork API. This package was developed to be used with Laravel 5 but can also be used stand alone as well. I hope this helps you automate and extend Teamwork to integrate even more into your business! Have fun and good luck. 🤘

Installation

You can simply add it like this

composer require "johnrich85/teamwork"

Laravel Setup

This wrapper comes with support for Laravel 5. This includes a service provider as well as a facade for easy access. Once this package is pulled into your project just add this to your config/app.php file.

'providers' => [
    ...
    'Johnrich85\Teamwork\TeamworkServiceProvider',
],

and then add the facade to your aliases array

'aliases' => [
    ...
    'Teamwork' => 'Johnrich85\Teamwork\Facades\Teamwork',
],

Configuration

If you are using Laravel then add a teamwork array to your config/services.php file

...
'teamwork' => [
    'key'  => 'YourSecretKey',
    'url'  => 'YourTeamworkUrl'
],

Use

If you are using the Facade with Laravel youc an easily access Teamwork like this

Teamwork::people()->all();

If you want to use dependency injection to make your application easy to test the Service Provider binds Johnrich85\Teamwork\Factory. Here is an example of how to use it with dependency injection

Route::get('/test', function(Johnrich85\Teamwork\Factory $teamwork) {
   $activity = $teamwork->activity()->latest();
});

Configuration Without Laravel

If you are not using Laravel you can instantiate the class like this

require "vendor/autoload.php";

use GuzzleHttp\Client as Guzzle;
use Johnrich85\Teamwork\Client;
use Johnrich85\Teamwork\Factory as Teamwork;

$client     = new Client(new Guzzle, 'YourSecretKey', 'YourTeamworkUrl');
$teamwork   = new Teamwork($client);

You are ready to go now!

Examples

Not all of the Teamwork API is supported yet but there is still a lot you can do! Below are some examples of how you can access Projects, Companies, and more. To work with a specific Object pass in the ID to perform actions on it. Data can be passed through for creating and editing.

To see more examples visit the docs

// create a project
$teamwork->project()->create([
    "name" => "My New Amazing Project",
    "description" => "This is a project that I will dedicate my whole life to",
    "companyId" => "999"
]);

// get the latest activity on a project
$teamwork->project($projectID)->activity();

Roadmap

1.1 Release

  • Add Support For Comments
  • Add Support For Permissions
  • Add Support For Time Endpoint

1.2 Release

  • Add Support For Categories
  • Add Support For People Status
  • Add Support For Files
  • Add Support For Notebooks