laravel-notification-channels / facebook-poster by laravel-notification-channels

Use notification to create posts on Facebook

81,544

138

Package Data
Maintainer Username:	laravel-notification-channels
Maintainer Contact:	ahmed29329@gmail.com (Ahmed Ashraf)
Package Create Date:	2016-11-10
Package Last Update:	2024-03-12
Home Page:	http://laravel-notification-channels.com
Language:	PHP
License:	MIT
Last Refreshed:	2024-11-29 15:15:30

Package Statistics
Total Downloads:	81,544
Monthly Downloads:	1,329
Daily Downloads:	47
Total Stars:	138
Total Watchers:	13
Total Forks:	28
Total Open Issues:	1

FacebookPoster Notification Channel For Laravel 5.5

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

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 awesome!'))->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 awesome!'))->withImage(url('uploads/images/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 awesome!'))
    	->withVideo('bedaer.mp4',[ 'title' => 'My First Video' , 'Description' => 'published by FacebookPoster.' ]);
}

Publish Facebook scheduled post

It is also possible to publish a scheduled post. You just have to pass a UNIX timestamp to the scheduledFor method.

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

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.