Social Feeds
Package docs status
Section titled “Package docs status”This page is generated from package source documentation in the Capell packages repository and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account.
| Field | Value |
|---|---|
| Composer package | capell-app/social-feeds |
| Package slug | social-feeds |
| Product group | Capell Marketing & Growth |
| Tier | premium |
| Bundle | marketing-growth |
| Runtime contexts | admin, frontend, console |
| Capell version | ^1.0 |
| Source repository | capell-app/packages |
| Source path | packages/social-feeds |
| Docs source | packages/social-feeds/docs |
| Manifest | capell.json |
What This Plugin Adds
Section titled “What This Plugin Adds”Social Feeds is an Available, Schema-owning Capell package in the Capell Marketing & Growth product group. It ships as capell-app/social-feeds and extends these surfaces: admin, frontend, console.
Social Feeds adds provider-backed feed connections, scheduled item synchronization, and cached public widgets with list, slideshow, carousel, and paginated layouts.
Admins manage feed connections and synchronized items, then place the social-feed widget on a page. Visitors see cached posts without a live provider request during page rendering.
Evidence: src/Contracts/SocialFeedProvider.php, src/Actions/SyncSocialFeedConnectionAction.php, src/Blocks/SocialFeedBlockRenderer.php, capell.json, tests/Feature/Admin/SocialFeedsAdminSurfaceTest.php, src/Actions/FetchSocialFeedRenderDataAction.php, tests/Feature/SocialFeedBlockRenderTest.php, docs/overview.admin.md.
Status details:
- Status: Available
- Tier: premium
- Bundle: marketing-growth
- Composer package:
capell-app/social-feeds - Namespace:
Capell\SocialFeeds - Theme key: not applicable
Why It Matters
Section titled “Why It Matters”For developers: The provider registry and typed feed data separate network retrieval from synchronization and public rendering.
For teams: Editors can reuse recent social posts on site pages and reconnect or re-sync a feed when updates stop arriving.
Evidence: src/Support/SocialFeedProviderRegistry.php, src/Data/SocialFeedPostData.php, src/Data/SocialFeedRenderData.php, tests/Unit/SocialFeedProviderRegistryTest.php, docs/overview.admin.md, src/Actions/SyncSocialFeedConnectionsAction.php, tests/Feature/RssFeedSyncTest.php.
Screens And Workflow
Section titled “Screens And Workflow”Screenshot contract: docs/screenshots.json.
- Social feed carousel widget (frontend, required).
- RSS feed sync and cached items (admin, required).
- Provider registry extension surface (shared, required).
- Social feed connection setup (admin, optional).
- Social feed empty public state (frontend, optional).
- Social feed item moderation (admin, optional).
Technical Shape
Section titled “Technical Shape”- Service providers:
Capell\SocialFeeds\Providers\SocialFeedsServiceProvider,Capell\SocialFeeds\Providers\AdminServiceProvider,AbstractConfiguredProvider,BlueskyFeedProvider,FacebookFeedProvider,InstagramFeedProvider,LinkedInFeedProvider,RssFeedProvider,TikTokFeedProvider,XFeedProvider,YouTubeFeedProvider. - Config files:
packages/social-feeds/config/capell-social-feeds.php. - Migrations:
packages/social-feeds/database/migrations/2026_06_04_000001_create_social_feed_connections_table.php,packages/social-feeds/database/migrations/2026_06_04_000002_create_social_feed_items_table.php,packages/social-feeds/database/migrations/2026_06_04_000003_create_social_feed_oauth_states_table.php,packages/social-feeds/database/migrations/2026_07_09_000001_add_render_index_to_social_feed_items_table.php. - Models:
SocialFeedConnection,SocialFeedItem,SocialFeedOAuthState. - Filament classes:
CreateSocialFeedConnection,EditSocialFeedConnection,ListSocialFeedConnections,SocialFeedConnectionResource,ListSocialFeedItems,SocialFeedItemResource. - Policies:
AbstractSocialFeedsResourcePolicy,SocialFeedConnectionPolicy,SocialFeedItemPolicy. - Extension contracts:
SocialFeedHostResolver,SocialFeedProvider,SocialFeedProviderProvider. - Actions:
FetchSocialFeedRenderDataAction,RedactSocialFeedSyncErrorAction,SyncSocialFeedConnectionAction,SyncSocialFeedConnectionsAction,UpsertSocialFeedItemsAction. - Data objects:
ResolvedFeedEndpointData,SocialFeedPostData,SocialFeedRenderData,SocialFeedRenderItemData,SocialFeedWidgetConfigData. - Command signatures:
capell:social-feeds:sync. - Manifest action API:
fetchRenderData: Capell\SocialFeeds\Actions\FetchSocialFeedRenderDataAction,syncConnection: Capell\SocialFeeds\Actions\SyncSocialFeedConnectionAction,upsertItems: Capell\SocialFeeds\Actions\UpsertSocialFeedItemsAction. - Scheduled commands:
capell:social-feeds:sync --all. - Console command classes:
SyncSocialFeedsCommand. - Manifest contributions:
admin-resource: Capell\SocialFeeds\Manifest\SocialFeedConnectionResourceContribution,admin-resource: Capell\SocialFeeds\Manifest\SocialFeedItemResourceContribution,frontend-component: Capell\SocialFeeds\Manifest\SocialFeedWidgetContribution,model: Capell\SocialFeeds\Manifest\SocialFeedConnectionModelContribution,model: Capell\SocialFeeds\Manifest\SocialFeedItemModelContribution,scheduled-job: Capell\SocialFeeds\Manifest\SocialFeedsSyncScheduleContribution. - Health checks:
Capell\SocialFeeds\Health\SocialFeedsHealthCheck. - Blade views:
packages/social-feeds/resources/views/blocks/social-feed.blade.php. - Cache tags:
social-feeds.
Data Model
Section titled “Data Model”- Required tables:
social_feed_connections,social_feed_items,social_feed_oauth_states. - Models:
SocialFeedConnection,SocialFeedItem,SocialFeedOAuthState. - Core record references in migrations:
sites via site_id. - Migration files:
2026_06_04_000001_create_social_feed_connections_table.php,2026_06_04_000002_create_social_feed_items_table.php,2026_06_04_000003_create_social_feed_oauth_states_table.php,2026_07_09_000001_add_render_index_to_social_feed_items_table.php. - Migration impact: run host migrations through the package install flow before opening package surfaces.
- Deletion/retention behaviour: migrations declare cascade-on-delete relationships and null-on-delete relationships; no timed pruning or retention schedule is declared in
capell.json.
Install Impact
Section titled “Install Impact”- Required packages:
capell-app/admin,capell-app/block-library,capell-app/core. - Admin navigation: declares
admin-resource: SocialFeedConnectionResourceContribution,admin-resource: SocialFeedItemResourceContribution; each Filament page or resource controls its own navigation visibility. - Admin/editor extensions: none declared.
- Permissions:
View:SocialFeedConnection,Create:SocialFeedConnection,Update:SocialFeedConnection,Delete:SocialFeedConnection,View:SocialFeedItem. - Public routes: none declared.
- Database changes: package migrations are declared.
- Config:
config/capell-social-feeds.php. - Settings: no package settings declared.
- Queues or schedules: scheduled commands
capell:social-feeds:sync --all. - Cache tags:
social-feeds. - Commands:
capell:social-feeds:sync.
Common Pitfalls
Section titled “Common Pitfalls”- Keep required Capell packages on compatible v4 releases:
capell-app/admin,capell-app/block-library,capell-app/core. - Run migrations before opening package resources or public routes.
- Review package configuration before production-like verification:
config/capell-social-feeds.php. - Register the host scheduler so these declared commands run at their documented frequencies:
capell:social-feeds:sync --all. - Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries.
- Custom write integrations must preserve invalidation for
social-feedscache tags.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Likely cause | Check | Fix |
|---|---|---|---|
| Package surface is missing after install | Provider or manifest is not loaded | Confirm capell.json, package composer.json, and provider registration | Reinstall the package, refresh Composer autoload, and clear host caches |
| Admin screen or command fails on missing table | Package migrations have not run | Check the tables listed in Data Model | Run host migrations and rerun the focused package test |
| Background work does not run | Queue worker or declared schedule is not active | Check the jobs and scheduled commands listed in Technical Shape | Start the queue worker or host scheduler, then run the focused command or package test |
| Public output leaks unexpected state | Render data, cache variation, or authoring boundary has regressed | Check public Blade, cache tags, and public-output safety tests | Move data loading out of Blade and rerun the package public-output tests |
Quick Start
Section titled “Quick Start”- Install the package:
composer require capell-app/social-feeds. - Run the required setup:
php artisan migrate. - Open the RSS feed sync and cached items and confirm the admin workflow loads.
Next Steps
Section titled “Next Steps”- Package docs
- Overview
- Admin guide
- Configuration files:
config/capell-social-feeds.php. - Troubleshooting
- Screenshot contract
- Marketplace assets
- Capell content language plan
- Capell documentation design system
- Capell and package ERD notes
- Related packages: Block Library.
- Focused tests:
vendor/bin/pest packages/social-feeds/tests --configuration=phpunit.xml.