README

此包可以轻松使用 Laravel 6.x、7.x 和 8.x 创建 Trello 卡片。

内容

• 安装
  • 设置 Trello 服务
• 使用方法
  • 可用的消息方法
• 变更日志
• 测试
• 安全
• 贡献
• 鸣谢
• 许可

安装

您可以通过 composer 安装此包

composer require laravel-notification-channels/trello

设置 Trello 服务

将您的 Trello REST API 密钥添加到 config/services.php

// config/services.php
...
'trello' => [
    'key' => env('TRELLO_API_KEY'),
],
...

使用方法

现在您可以在通知中的 via() 方法中使用该通道

use NotificationChannels\Trello\TrelloChannel;
use NotificationChannels\Trello\TrelloMessage;
use Illuminate\Notifications\Notification;

class ProjectCreated extends Notification
{
    public function via($notifiable)
    {
        return [TrelloChannel::class];
    }

    public function toTrello($notifiable)
    {
        return TrelloMessage::create()
            ->name("Trello Card Name")
            ->description("This is the Trello card description")
            ->top()
            ->due('tomorrow');
    }
}

为了让您的通知知道您要针对哪个 Trello 用户和 Trello 列表，请将 routeNotificationForTrello 方法添加到您的可通知模型中。

此方法需要返回一个包含授权 Trello 用户访问令牌（如果它是私人板）和要添加卡片的 Trello 列表 ID 的数组。

public function routeNotificationForTrello()
{
    return [
        'token' => 'NotifiableToken',
        'idList' => 'TrelloListId',
    ];
}

可用方法

• name('')：接受一个字符串值作为 Trello 卡片名称。
• description('')：接受一个字符串值作为 Trello 卡片描述。
• top()：将 Trello 卡片移至顶部。
• bottom()：将 Trello 卡片移至底部。
• position('')：接受一个整数作为特定的 Trello 卡片位置。
• due('')：接受一个字符串或 DateTime 对象作为 Trello 卡片的到期日期。

变更日志

有关最近更改的更多信息，请参阅 CHANGELOG。

测试

$ composer test

安全

如果您发现任何与安全相关的问题，请通过电子邮件 m.pociot@gmail.com 联系，而不是使用问题跟踪器。

贡献

有关详细信息，请参阅 CONTRIBUTING。

鸣谢

• Marcel Pociot
• 所有贡献者

许可

MIT 许可证 (MIT)。请参阅 许可文件 获取更多信息。