gregoriohc/laravel-trello

A Laravel wrapper and facade package for the Trello API

0.3 2017-03-15 11:09 UTC

Requires

• php: >=5.4.0
• cdaguerre/php-trello-api: @dev
• illuminate/config: ~5
• illuminate/support: ~5

Requires (Dev)

• phpunit/phpunit: ~4.0

MIT

• Gregorio Hernández Caso

• package
• api
• trello
• laravel
• facade

README

A simple Laravel 5 package that wraps Trello API.

Requirements

• PHP 5.4 or greater

Installation

You can install the package using the Composer package manager running this command in your project root:

composer require gregoriohc/laravel-trello

Laravel

The package includes a service providers and a facade for easy integration and a nice syntax for Laravel.

Firstly, add the Gregoriohc\LaravelTrello\TrelloServiceProvider provider to the providers array in config/app.php

'providers' => [
  ...
  Gregoriohc\LaravelTrello\TrelloServiceProvider::class,
],

and then add the facade to your aliases array

'aliases' => [
  ...
  'Trello' => Gregoriohc\LaravelTrello\Facades\Wrapper::class,
],

Configuration

Publish the configuration file with:

php artisan vendor:publish --provider="Gregoriohc\LaravelTrello\TrelloServiceProvider"

Head into the file and configure the keys and defaults you'd like the package to use.

Usage

Creating a basic card

$card = Trello::manager()->getCard();
$card
    ->setBoardId(Trello::getDefaultBoardId())
    ->setListId(Trello::getDefaultListId())
    ->setName('Example card')
    ->setDescription('Description of the card')
    ->save();

Creating a more complex card

// Create the card
$card = Trello::manager()->getCard();
$card
    ->setBoardId(Trello::getDefaultBoardId())
    ->setListId(Trello::getDefaultListId())
    ->setName('Example card')
    ->setDescription('Description of the card')
    ->save();

// Add a checklist with one item
$checklist = Trello::manager()->getChecklist();
$checklist
    ->setCard($card)
    ->setName('Example list')
    ->save();
Trello::checklist()->items()->create($checklist->getId(), 'Example checklist item');

// Attach an image using a url
Trello::card()->attachments()->create($card->getId(), ['url' => 'http://lorempixel.com/400/200/']);

More examples

For more examples of usage, please see the original PHP Trello API package documentation: https://github.com/cdaguerre/php-trello-api

Contributing

If you're having problems, spot a bug, or have a feature suggestion, please log and issue on Github. If you'd like to have a crack yourself, fork the package and make a pull request.