josrom / laravel-trello-wrapper
Trello API wrapper for Laravel 13
Requires
- php: ^8.3
- guzzlehttp/guzzle: ^7.0.1
- guzzlehttp/psr7: ^2.1.0
- illuminate/contracts: ^13.0
- illuminate/support: ^13.0
- josrom/php-trello-api: ^3.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.64
- josrom/phpunit-unicode-printer: ^9.0
- phpunit/phpunit: ^9.6
README
A simple Laravel 13 package that wraps Trello API.
Requirements
- PHP 8.3 or higher
- Laravel 11, 12 or 13
Previous versions
- Laravel 12: PHP 8.2 or higher
- Laravel 11: PHP 8.2 or higher
- Laravel 10: PHP 8.1 or higher
- Laravel 9 & 8: PHP 7.3 or higher
Installation
You can install the package using the Composer package manager running this command in your project root:
composer require josrom/laravel-trello-wrapper
Laravel
The package includes a service providers and a facade for easy integration and a nice syntax for Laravel.
Configuration
Publish the configuration file with:
php artisan vendor:publish --provider="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::getChecklistApi()->items()->create($checklist->getId(), 'Example checklist item'); // Attach an image using a url Trello::getCardApi()->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
Development
Running tests
composer test
Code style
This package uses PHP-CS-Fixer to keep a consistent code style.
Check for style issues without modifying files:
composer cs-check
Automatically fix style issues:
composer cs-fix
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.
Changelog
See CHANGELOG.md for a detailed list of changes.