2017 © Pedro Peláez
 

library facebook-poster

Use notification to create posts on Facebook

image

laravel-notification-channels/facebook-poster

Use notification to create posts on Facebook

  • Thursday, February 8, 2018
  • by laravel-notification-channels
  • Repository
  • 8 Watchers
  • 50 Stars
  • 4,422 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 10 Forks
  • 0 Open issues
  • 5 Versions
  • 22 % Grown

The README.md

FacebookPoster Notification Channel For Laravel

Latest Version on Packagist Software License Build Status StyleCI Total Downloads, (*1)

This package makes it easy to post to Facebook using Laravel notification channels., (*2)

Contents

Installation

You can install this package via Composer:, (*3)

composer require laravel-notification-channels/facebook-poster

Configuration

You'll need to get the Facebook Page ID as well as a page access token with the pages_read_engagement and pages_manage_post permissions. You will need to go through App Review in order to use these permissions. Then, add the configuration to your config/services.php file:, (*4)

...
'facebook_poster' => [
    'page_id' => env('FACEBOOK_PAGE_ID'),
    'access_token' => env('FACEBOOK_ACCESS_TOKEN'),
],

Usage

Follow Laravel's documentation to add the channel to your Notification class., (*5)

Publish Facebook post

use NotificationChannels\FacebookPoster\FacebookPosterChannel;
use NotificationChannels\FacebookPoster\FacebookPosterPost;

class NewsWasPublished extends Notification
{

    /**
     * Get the notification's delivery channels.
     *
     * @param  mixed  $notifiable
     * @return array
     */
    public function via($notifiable)
    {
        return [FacebookPosterChannel::class];
    }

    /**
     * Get the Facebook post representation of the notification.
     *
     * @param  mixed  $notifiable.
     * @return \NotificationChannels\FacebookPoster\FacebookPosterPost
     */
    public function toFacebookPoster($notifiable) {
        return new FacebookPosterPost('Laravel notifications are awesome!');
    }
}

Publish Facebook post with link

It is possible to publish link with your post too. You just have to pass the URL to the withLink method., (*6)

public function toFacebookPoster($notifiable) {
    return (new FacebookPosterPost('Laravel notifications are awesome!'))
        ->withLink('https://laravel.com');
}

Publish Facebook post with custom configuration

You can implement routeNotificationForFacebookPoster() on your notifiable class in order to provide custom configuration., (*7)

public function routeNotificationForFacebookPoster(): array
{
    return [
        'page_id' => 'customPageId',
        'access_token' => 'customAccessToken',
    ];
}

Changelog

Please see CHANGELOG for more information what has changed recently., (*8)

Testing

$ composer test

Contributing

Please see CONTRIBUTING for details., (*9)

Credits

License

The MIT License (MIT). Please see License File for more information., (*10)

The Versions