README

LaraPost is a Laravel package for publishing and scheduling content to Facebook Pages, Twitter / X, and LinkedIn from one API and one dashboard.

LaraPost supports publishing and scheduling for Facebook Pages, Twitter / X, and LinkedIn from one Laravel API and dashboard.

Features

One fluent API via SocialSync\Facades\SocialMedia
Built-in dashboard at /larapost/dashboard
OAuth connect flow for Facebook, Twitter / X, and LinkedIn
Multi-Page Facebook sync from one Meta login
Immediate publishing and scheduled publishing
Bulk composer for different content across different accounts
Retry and scheduled runner commands
CI for PHP 8.1, 8.2, 8.3, 8.4, and 8.5

Support Matrix

Platform	Connect	Publish	Notes
Facebook	OAuth to Facebook login	Page posts with text, image URL, and video URL	Facebook Pages only. Personal profile posting is not supported.
Twitter / X	OAuth 2.0	Text posts	Your X app still needs write access plus billing or credits. The dashboard does not upload media to X.
LinkedIn	OAuth 2.0	Member profile text posts	LinkedIn organization pages are not supported. Image upload expects a readable local file path when used programmatically.

Installation

composer require prateekbhujel/larapost
php artisan larapost:install

Manual setup:

php artisan vendor:publish --tag=larapost-config
php artisan vendor:publish --tag=larapost-migrations
php artisan vendor:publish --tag=larapost-views
php artisan migrate

Configuration

LARAPOST_DEFAULT_PLATFORM=facebook
LARAPOST_QUEUE_ENABLED=true
LARAPOST_MAX_RETRY_ATTEMPTS=3
LARAPOST_UI_ENABLED=true

FACEBOOK_APP_ID=
FACEBOOK_APP_SECRET=
FACEBOOK_API_VERSION=v20.0

TWITTER_CLIENT_ID=
TWITTER_CLIENT_SECRET=

LINKEDIN_CLIENT_ID=
LINKEDIN_CLIENT_SECRET=

Dashboard-saved provider credentials override .env values.

Quick Start

Connect at least one provider account, then publish from code:

use SocialSync\Facades\SocialMedia;

$results = SocialMedia::post()
    ->content('Release update from LaraPost')
    ->platforms(['facebook', 'twitter'])
    ->publish();

Schedule for later:

use SocialSync\Facades\SocialMedia;

$results = SocialMedia::post()
    ->content('Tomorrow morning post')
    ->platforms(['facebook'])
    ->scheduleFor(now()->addHours(12))
    ->publish();

Connect an account from the CLI:

php artisan larapost:add-account facebook
php artisan larapost:add-account twitter
php artisan larapost:add-account linkedin

Dashboard

The built-in dashboard lives at GET /larapost/dashboard.

It includes:

Provider credential forms with encrypted database storage
Login popups for Facebook Pages, Twitter / X, and LinkedIn profiles
Account targeting for exact Pages and accounts
Bulk composer for different copy per connected account
Recent publish history and account toggles

The dashboard is a real operator surface, not a demo screen. It only exposes the support that ships in v1.0.0.

Scheduling

Run the scheduled runner every minute:

* * * * * php /path/to/artisan larapost:run-scheduled >> /dev/null 2>&1

Useful commands:

php artisan larapost:install
php artisan larapost:add-account {platform}
php artisan larapost:test
php artisan larapost:run-scheduled

Docs

Docs portal: https://prateekbhujel.github.io/larapost/
Contributing guide: CONTRIBUTING.md
Security policy: SECURITY.md
Release playbook: RELEASE.md
Changelog: CHANGELOG.md

Contributing

Community contributions should come from forks. See CONTRIBUTING.md for the expected workflow.

License

LaraPost is released under the MIT license.

prateekbhujel / larapost

Maintainers

Package info

Statistics

Security