README

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

Contents

• Installation
• Setting up the Facebook posts service
• Usage
  • Publish Facebook post
  • Publish Facebook post with link
  • Publish Facebook post with image
  • Publish Facebook post with video
• Changelog
• Testing
• Security
• Contributing
• Credits
• License

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 life 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, after this add access_token parameter into the query string me?fields=id,name,access_token then submit and copy the access token value to your env FACEBOOK_ACCESS_TOKEN.

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

• Ahmed Ashraf
• All Contributors

License

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