PHPackages alexhackney/laravel-socialbu - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. alexhackney/laravel-socialbu ActiveLibrary[API Development](/categories/api) alexhackney/laravel-socialbu ============================ Publish and schedule social media posts via SocialBu in Laravel v1.4.1(3mo ago)0635↑22.2%MITPHPPHP ^8.2CI passing Since Feb 5Pushed 3mo agoCompare [ Source](https://github.com/alexhackney/laravel-socialbu)[ Packagist](https://packagist.org/packages/alexhackney/laravel-socialbu)[ Docs](https://github.com/alexhackney/laravel-socialbu)[ RSS](/packages/alexhackney-laravel-socialbu/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (7)Versions (12)Used By (0) Laravel SocialBu ================ [](#laravel-socialbu) A Laravel package for the [SocialBu](https://socialbu.com) social media management API. Publish posts, upload media, manage accounts, and handle webhooks. Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11.x or 12.x Installation ------------ [](#installation) ``` composer require alexhackney/laravel-socialbu ``` Publish the config: ``` php artisan vendor:publish --tag=socialbu-config ``` Add your credentials to `.env`: ``` SOCIALBU_TOKEN=your-api-token SOCIALBU_ACCOUNT_IDS=123,456 ``` Usage ----- [](#usage) ### Quick Publish [](#quick-publish) ``` use Hei\SocialBu\Facades\SocialBu; // Text post to all configured accounts SocialBu::publish('Hello world!'); // With an image SocialBu::publish('Check this out!', '/path/to/image.jpg'); ``` ### Fluent Builder [](#fluent-builder) For more control, use the builder: ``` SocialBu::create() ->content('Big announcement!') ->media('/path/to/image.jpg') ->media('https://example.com/video.mp4') ->to(123, 456) ->scheduledAt('2025-06-15 14:00:00') ->send(); // Save as draft SocialBu::create() ->content('Work in progress') ->asDraft() ->send(); // Validate without sending $payload = SocialBu::create() ->content('Test post') ->dryRun(); ``` The builder accepts Carbon instances, DateTime objects, or date strings for scheduling. Account IDs default to your `.env` config but can be overridden per-post with `->to()`. ### Posts [](#posts) ``` $posts = SocialBu::posts()->list(); $posts = SocialBu::posts()->list(type: 'scheduled', page: 2); $post = SocialBu::posts()->get(123); $post = SocialBu::posts()->create( content: 'Hello!', accountIds: [1, 2], publishAt: '2025-06-15 14:00:00', ); SocialBu::posts()->update(123, ['content' => 'Updated!']); SocialBu::posts()->delete(123); ``` Pagination: ``` $page = SocialBu::posts()->paginate(perPage: 20); // $page->items, $page->currentPage, $page->lastPage, $page->total // Memory-efficient iteration over all posts foreach (SocialBu::posts()->lazy() as $post) { echo $post->content; } ``` ### Accounts [](#accounts) ``` $accounts = SocialBu::accounts()->list(); $account = SocialBu::accounts()->get(123); $account->isActive(); $account->requiresMedia(); // true for Instagram, TikTok, Pinterest $account->isTwitter(); // also matches 'x' ``` ### Media Upload [](#media-upload) Media uploads use a 3-step signed URL flow (request signed URL, upload to S3, confirm). The package handles this automatically: ``` // Local file $media = SocialBu::media()->upload('/path/to/image.jpg'); // Remote URL $media = SocialBu::media()->upload('https://example.com/photo.jpg'); // Attach to a post SocialBu::posts()->create( content: 'With media!', accountIds: [1], attachments: [$media->toAttachment()], ); ``` The builder's `->media()` method handles uploads for you, so you typically don't need to call this directly. Error Handling -------------- [](#error-handling) All exceptions extend `SocialBuException` and include request/response context for debugging: ``` use Hei\SocialBu\Exceptions\AuthenticationException; use Hei\SocialBu\Exceptions\ValidationException; use Hei\SocialBu\Exceptions\RateLimitException; use Hei\SocialBu\Exceptions\NotFoundException; use Hei\SocialBu\Exceptions\ServerException; use Hei\SocialBu\Exceptions\MediaUploadException; try { SocialBu::publish('Hello!'); } catch (AuthenticationException $e) { // 401 - invalid or missing token } catch (ValidationException $e) { $e->errors(); // ['field' => ['message', ...]] } catch (RateLimitException $e) { $e->retryAfter(); // seconds until reset, or null } catch (NotFoundException $e) { // 404 } catch (ServerException $e) { // 5xx } catch (MediaUploadException $e) { $e->getStep(); // 'signed_url', 's3_upload', or 'confirmation' } // All exceptions provide logging context Log::error('SocialBu failed', $e->context()); ``` Webhooks -------- [](#webhooks) Enable in config to receive post and account status updates: ``` // config/socialbu.php 'webhooks' => [ 'enabled' => true, 'prefix' => 'webhooks/socialbu', 'middleware' => ['api'], ], ``` This registers two routes: - `POST /webhooks/socialbu/post` -- post status updates - `POST /webhooks/socialbu/account` -- account status updates Listen for the dispatched events: ``` use Hei\SocialBu\Events\PostStatusChanged; use Hei\SocialBu\Events\AccountStatusChanged; // In a listener public function handle(PostStatusChanged $event): void { $event->postId; $event->accountId; $event->status; // 'published', 'failed', etc. $event->payload; // full webhook data } ``` Artisan Commands ---------------- [](#artisan-commands) ``` # List connected accounts php artisan socialbu:accounts php artisan socialbu:accounts --json # Send a test post php artisan socialbu:test "Hello from CLI!" php artisan socialbu:test "With image" --media=/path/to/image.jpg php artisan socialbu:test "Later" --schedule="2025-12-25 09:00:00" php artisan socialbu:test "Preview" --dry-run php artisan socialbu:test "Specific" --to=123 --to=456 # Get post details php artisan socialbu:post 12345 php artisan socialbu:post 12345 --json ``` Testing ------- [](#testing) The package ships with `FakeSocialBu` for testing your application code without hitting the API: ``` use Hei\SocialBu\Testing\FakeSocialBu; test('it shares to social media', function () { $fake = FakeSocialBu::fake(); // ... your application code that calls SocialBu ... $fake->assertPublished('Hello!'); $fake->assertPublishedCount(1); $fake->assertPublishedTo([123, 456]); $fake->assertUploaded('/path/to/image.jpg'); $fake->assertUploadedCount(1); $fake->assertNothingPublished(); }); ``` Simulate errors: ``` use Hei\SocialBu\Exceptions\PostCreationException; test('it handles publish failures', function () { $fake = FakeSocialBu::fake() ->throwOnPublish(new PostCreationException('API down')); // ... test your error handling ... }); ``` Seed fake data: ``` $fake = FakeSocialBu::fake() ->withAccounts([ ['id' => 1, 'name' => 'My Page', 'type' => 'facebook'], ]) ->withPosts([ ['id' => 100, 'content' => 'Existing post', 'created_at' => now()], ]); $accounts = $fake->accounts()->list(); // returns seeded accounts ``` Configuration Reference ----------------------- [](#configuration-reference) ``` // config/socialbu.php return [ 'token' => env('SOCIALBU_TOKEN'), 'account_ids' => [], // parsed from SOCIALBU_ACCOUNT_IDS (comma-separated) 'base_url' => env('SOCIALBU_BASE_URL', 'https://socialbu.com/api/v1'), 'webhooks' => [ 'enabled' => env('SOCIALBU_WEBHOOKS_ENABLED', false), 'prefix' => env('SOCIALBU_WEBHOOKS_PREFIX', 'webhooks/socialbu'), 'middleware' => ['api'], ], 'http' => [ 'timeout' => env('SOCIALBU_TIMEOUT', 30), 'connect_timeout' => env('SOCIALBU_CONNECT_TIMEOUT', 10), ], ]; ``` License ------- [](#license) MIT. See [LICENSE](LICENSE). ### Health Score 43 — FairBetter than 91% of packages Maintenance81 Actively maintained with recent releases Popularity19 Limited adoption so far Community6 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 6 Last Release 101d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7d69e58d2b5fde078774b6fce6ab6ba531b0720581b1a05dcb793ec71609b108?d=identicon)[alexhackney](/maintainers/alexhackney) --- Top Contributors [![alexhackney](https://avatars.githubusercontent.com/u/4718954?v=4)](https://github.com/alexhackney "alexhackney (6 commits)") --- Tags apilaravelschedulingsocial mediasocialbu ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/alexhackney-laravel-socialbu/health.svg) ``` [![Health](https://phpackages.com/badges/alexhackney-laravel-socialbu/health.svg)](https://phpackages.com/packages/alexhackney-laravel-socialbu) ``` ### Alternatives [andreaselia/laravel-api-to-postman Generate a Postman collection automatically from your Laravel API 1.0k586.2k3](/packages/andreaselia-laravel-api-to-postman)[api-ecosystem-for-laravel/dingo-api A RESTful API package for the Laravel and Lumen frameworks. 3121.5M10](/packages/api-ecosystem-for-laravel-dingo-api)[essa/api-tool-kit set of tools to build an api with laravel 52680.5k](/packages/essa-api-tool-kit)[api-platform/laravel API Platform support for Laravel 59126.4k6](/packages/api-platform-laravel)[dragon-code/laravel-json-response Automatically always return a response in JSON format 1118.6k1](/packages/dragon-code-laravel-json-response)[grazulex/laravel-apiroute Complete API versioning lifecycle management for Laravel 1036.0k](/packages/grazulex-laravel-apiroute) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)