nimbles-nl/laravel-slack

Laravel package for sending slack messages

, _(*1)

Laravel Slack Package

A laravel package for sending Slack messages, _(*2)

For more information see Slack, _(*3)

Requirements

Laravel 5.1 or later, _(*4)

Installation

Installation is a quick 3 step process:, _(*5)

1. Download laravel-slack using composer
2. Configure your HTTP Adapter
3. Enable the package in app.php
4. Configure your Slack credentials
5. (Optional) Configure the package facade

Step 1: Download laravel-slack using composer

Add nimbles-nl/laravel-slack by running the command:, _(*6)

composer require nimbles-nl/laravel-slack

Step 2: Configure you HTTP Adapter in your service container

Configure the http adapter in your AppServiceProvider.php, _(*7)

``` php use GuzzleHttp\Client as GuzzleClient; use Http\Adapter\Guzzle6\Client as GuzzleAdapter;, <sub>(*8)</sub>

$this->app->singleton('http.client', function() { return new GuzzleAdapter(new GuzzleClient()); });, <sub>(*9)</sub>

### Step 3: Enable the package in app.php

Register the Service in: **config/app.php**

``` php
Nimbles\Slack\SlackServiceProvider::class,
````

### Step 4: Configure Slack credentials

php artisan vendor:publish, <sub>(*10)</sub>

Add this in you **.env** file

SLACK_ACCESS_TOKEN=your_secret_slack_access_token ```, <sub>(*11)</sub>

Step 5 (Optional): Configure the package facade

Register the Slack Facade in: config/app.php, <sub>(*12)</sub>

``` php 'aliases' => [, <sub>(*13)</sub>

    'App' => Illuminate\Support\Facades\App::class,
    'Artisan' => Illuminate\Support\Facades\Artisan::class,
    'Auth' => Illuminate\Support\Facades\Auth::class,
    ...
    'Slack' => Nimbles\Slack\Facade\Slack::class,

Usage
-----

``` php
$slackMessage = new SlackMessage('You re looking great today!', '#general', 'AwesomeBot', 'https://www.link-to-avatar.com/image.png');

app('slack')->sendMessage($slackMessage);

Or if you want to use facade, add this in your class after namespace declaration:, <sub>(*14)</sub>

``` php Slack::sendMessage(new SlackMessage('You are looking great today!')); ````, <sub>(*15)</sub>