README

Share your Eloquent models to LinkedIn, X and Facebook, each one switched on or off on its own, and add more networks later with one class and one config entry.

Each network has two switches: enabled (on or off) and autopost (post automatically when a model goes live).
A switched-off network is invisible: no UI, no routes (404), no auto-post, no sharing, and its commands say so.
One connection per network, stored encrypted; one share history for all networks.
Auto-post runs on a queue, once per model and network, with retries only when a network asks for it.
Optional Telegram, Slack and email messages, each naming the network.
Ready-made connection cards and share buttons (Tailwind or Bootstrap 5, Blade or Livewire), or headless.

Requires PHP 8.4+ and Laravel 12 or 13.

Quick start

composer require siberfx/social-autopost
php artisan social:install --theme=tailwind
php artisan migrate

LINKEDIN_ENABLED=true
LINKEDIN_AUTOPOST=true     # post automatically when a model goes live
X_ENABLED=false
FACEBOOK_ENABLED=false

// app/Providers/AppServiceProvider.php → boot()
Gate::define('manage-social-autopost', fn (User $user) => $user->is_admin);

use Siberfx\SocialAutopost\Concerns\PostsToSocial;
use Siberfx\SocialAutopost\Contracts\ShareableOnSocial;
use Siberfx\SocialAutopost\Posts\LinkPost;

class Article extends Model implements ShareableOnSocial
{
    use PostsToSocial;

    public function isLiveForSocial(): bool
    {
        return $this->status === 'published';
    }

    public function toSocialPost(): LinkPost
    {
        return LinkPost::make(route('blog.show', $this), $this->title)
            ->description(Str::limit(strip_tags($this->body), 250))
            ->commentary("New on the blog: {title}\n\n{url}");
    }
}

<x-social-autopost::connection network="linkedin" />
<x-social-autopost::connection network="x" />

<x-social-autopost::share-button :model="$article" network="facebook" />
<x-social-autopost::share-button :model="$article" />  {{-- every enabled, connected network --}}

Switching networks on and off

Every network is listed in config/social-autopost.php under networks:

Switch	Env (LinkedIn example)	Default	Meaning
`enabled`	`LINKEDIN_ENABLED`	`false`	Off: hidden everywhere, routes answer 404, sharing and commands refuse it.
`autopost`	`LINKEDIN_AUTOPOST`	`false`	On: queued automatically when a live model is saved. Manual sharing needs no switch.

The env names are LINKEDIN_, X_ and FACEBOOK_ followed by ENABLED or AUTOPOST. A network is only used when it is both switched on and connected.

use Siberfx\SocialAutopost\Facades\Social;

Social::enabled();                  // collect(['linkedin', 'facebook'])
Social::isEnabled('x');             // false
Social::isConnected('linkedin');    // true when a connection is stored (no network call)

Social::share($article);            // every enabled, connected network; one record per network
Social::share($article, 'x');       // only X; rethrows if X refuses
Social::queue($article, 'facebook');
Social::wasPosted($article, 'linkedin');

share() returns one SharedPost per network it tried, posted or failed. When sharing to all, one network's failure is recorded and the others still run.

Setting up each network

Each network needs an app in its developer portal. Register the callback URL of each one you switch on. The default is {your app}/social/{network}/callback; set {NET}_REDIRECT_URI when your URL differs.

Network	Developer portal	Register this callback	Credentials	Scopes or permissions
LinkedIn	developers.linkedin.com → your app	`https://example.com/social/linkedin/callback`	`LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`	Products "Share on LinkedIn" and "Sign In with LinkedIn using OpenID Connect"
X	developer.x.com → your app → User authentication settings (OAuth 2.0)	`https://example.com/social/x/callback`	`X_CLIENT_ID`, `X_CLIENT_SECRET` (optional for a PKCE-only public app)	`tweet.read tweet.write users.read offline.access` (set by the package)
Facebook	developers.facebook.com → your app → Facebook Login	`https://example.com/social/facebook/callback`	`FACEBOOK_APP_ID`, `FACEBOOK_APP_SECRET`	`pages_show_list`, `pages_manage_posts`, `pages_read_engagement`; the account must manage the Page

Optional settings per network: LINKEDIN_VISIBILITY (PUBLIC or CONNECTIONS), LINKEDIN_API_VERSION, FACEBOOK_PAGE_ID (the Page to post to; the first managed Page when empty), FACEBOOK_API_VERSION.

X text is composed to 280 characters, counting every URL as 23. LinkedIn escapes characters it reserves for mentions and hashtags. Facebook sends the link in its own field and takes the preview from the page's Open Graph tags.

Connecting

Send an admin to route('social-autopost.redirect', 'linkedin'). The callback returns them to routes.after_connect with ?social=linkedin&state=connected (or cancelled, error, exchange_failed, invalid_state, missing_code, not_configured).

Social::isConnected('x');
Social::connection('x')->name;      // the account name, from the network
Social::disconnect('x');            // revokes at the network, then forgets it

Auto-post

When a model is saved and isLiveForSocial() turns true, the observer queues one job per network that is enabled, has autopost on, is connected, and has not already posted the model. Jobs run after the database commit, are unique per model and network while queued, and retry only on 429, 5xx or no answer. Seeders and Artisan commands do not auto-post unless autopost.in_console is true.

php artisan queue:work --queue=default

Commands

Command	Does
`social:install [--theme=] [--headless]`	Publishes config and migrations, sets the UI theme, prints the redirect URI of each enabled network.
`social:status`	Every network: enabled, auto-post, connected, status.
`social:disconnect {network} [--force]`	Revokes and forgets one connection. Refuses a switched-off network.
`social:share {network} {model} {id} [--force]`	Shares one model to one network now.
`social:check-token [--days=]`	Fires `TokenExpiringSoon` for enabled networks expiring within `expiry_warning_days`.
`social:test-notification [--channel=]`	Sends a test to the enabled notification channels.

Notifications

Set SOCIAL_NOTIFY=true and one or more channels:

Telegram: SOCIAL_NOTIFY_TELEGRAM, SOCIAL_TELEGRAM_BOT_TOKEN, SOCIAL_TELEGRAM_CHAT_ID
Slack: SOCIAL_NOTIFY_SLACK, SOCIAL_SLACK_WEBHOOK_URL
Email: SOCIAL_NOTIFY_MAIL, SOCIAL_NOTIFY_MAIL_TO, SOCIAL_NOTIFY_MAILER

Every message names the network, for example "Shared on X: …" or "The Facebook token expires in 5 days".

Adding a network

Write a class implementing Siberfx\SocialAutopost\Contracts\SocialNetwork: key(), label(), isConnected(), connection(), beginConnection(), completeConnection(), disconnect() and publish(). Keep its tokens in the ConnectionStore, and read its settings from config('social-autopost.networks.{key}').
Add an entry under networks with enabled, autopost, class and its own keys.
Optionally add post_url (with {id}) for links in notifications, and brand for its colour and logo.

'mastodon' => [
    'enabled' => (bool) env('MASTODON_ENABLED', false),
    'autopost' => (bool) env('MASTODON_AUTOPOST', false),
    'class' => App\Social\MastodonNetwork::class,
    'post_url' => 'https://example.social/@me/{id}',
    'brand' => ['color' => '#6364FF'],
],

Upgrading from the standalone packages

This package replaces siberfx/linkedin-autopost, siberfx/x-autopost and siberfx/facebook-autopost. The data and settings differ in these ways:

Callback URLs change to /social/{network}/callback. Update the redirect URL in each developer portal, or keep the old URL by setting {NET}_REDIRECT_URI.
Connections are not carried over. Each network stores its own connection in social_connections, so reconnect each one after upgrading.
Shared history moves to social_posts. The old linkedin_posts, x_posts and facebook_posts tables are not read; keep them until you no longer need the history.
Environment names: FACEBOOK_AUTO_POST is now FACEBOOK_AUTOPOST. LINKEDIN_AUTOPOST and X_AUTOPOST are unchanged, and each network now also has {NET}_ENABLED, which defaults to off: set it to true for every network you use.
Gate: one gate, manage-social-autopost, replaces the three per-network gates.

Headless

Set SOCIAL_UI=false to ship without views or components. Routes then answer JSON only, and you use the facade, events and commands yourself.

Events

Each event carries the network key: Connected, Disconnected, Shared, ShareFailed and TokenExpiringSoon.

Configuration reference

Key	Purpose
`networks.{key}.enabled`, `.autopost`, `.class`	The switches and the driver.
`networks.{key}.*`	The network's own keys (credentials, API version, page id…).
`networks.{key}.post_url`, `.brand`	Notification links and the UI colour and logo.
`connection_store`	Where connections are kept (encrypted, `DatabaseConnectionStore` by default).
`routes`	`enabled`, `prefix` (`social`), `name`, `middleware`, `after_connect`.
`autopost`	`in_console`, `queue_connection`, `queue`.
`ui`	`enabled` (headless when false), `theme`.
`notifications`	`enabled`, `events`, `queued`, `tries`, `backoff`, `channels`.
`job`	`tries` and `backoff` of the auto-post job.
`expiry_warning_days`, `status_cache_ttl`, `http.timeout`	Tuning.

Tests

composer install
vendor/bin/pest
vendor/bin/pint --test
vendor/bin/phpstan analyse --memory-limit=1G

License

MIT. See LICENSE.

siberfx / social-autopost

Package info

Security

Statistics