0.0.1 2016-11-12 08:56 UTC

README

Latest Version on Packagist Software License Build Status StyleCI SensioLabsInsight Quality Score Code Coverage Total Downloads

This package makes it easly to post on facebook using FacebookPoster Notification with Laravel 5.3

Contents

Installation

You can install this package via composer:

composer require laravel-notification-channels/facebook-poster

Next add the service provider to your config/app.php:

...
'providers' => [
    ...
     NotificationChannels\FacebookPoster\FacebookPosterServiceProvider::class,
],
...

Setting up the Facebook Poster service

You will need to create a Facebook app in order to use this channel. Within in this app you will find the APP Id and APP Secret Key. Place them inside your .env file. In order to load them, add this to your config/services.php file:

...
'facebook_poster' => [
    'app_id'    => getenv('FACEBOOK_APP_ID'),
    'app_secret' => getenv('FACEBOOK_APP_SECRET'),
    'access_token'    => getenv('FACEBOOK_ACCESS_TOKEN'),
]
...

This will load the Facebook app data from the .env file. Make sure to use the same keys you have used there like FACEBOOK_APP_ID.

To create a long time access token for your fan page, open the Graph Api Explorer on the right body heading, select your app then click on the get token button and select Get Page Access Token then select your page and click on the same button again and select Request publish_pages - this will allow app to publish posts to yourpage with your account authorization, after this add access_token parameter into the query string me?fields=id,name,access_token then submit and copy the access token and open this Facebook Debugger Tool and paste your token then click on the Extend Access Token and take the long time expire token value to your env FACEBOOK_ACCESS_TOKEN.

Note : use Facebook Debugger Tool to make sure that your token has these scopes : [ manage_pages, publish_pages, public_profile ]

Usage

Follow Laravel's documentation to add the channel to your Notification class.

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];
    }

    public function toFacebookPoster($notifiable) {
        return new FacebookPosterPost('Laravel notifications are awesome!');
    }
}

Available methods

Take a closer look at the FacebookPosterPost object. This is where the magic happens.

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.

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

Publish Facebook post with image

It is possible to publish image with your post too. You just have to pass the image path to the withImage method.

public function toFacebookPoster($notifiable) {
    return (new FacebookPosterPost('Laravel notifications are awesom!'))->withImage('tayee.png');
}

Notice : withImage accepts absolute url not system paths like /home/user/downloads/image.png

Publish Facebook post with video

It is also possible to publish video with your post too. You just have to pass the video path to the withVideo method.

public function toFacebookPoster($notifiable) {
    return (new FacebookPosterPost('Laravel notifications are awesom!'))
        ->withVideo('bedaer.mp4',[ 'title' => 'My First Video' , 'Description' => 'published by FacebookPoster.' ]);
}

Changelog

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Security

If you discover any security related issues, please email ahmed29329@gmail.com instead of using the issue tracker.

Contributing

Please see CONTRIBUTING for details.

Credits

License

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