Skip to content
Capell CMS

Social Feeds

Package docs status

Section titled “Package docs status”

This page is generated from public package documentation in capell-4/packages and the package manifest checked into the source repository.

FieldValue
Composer packagecapell-app/social-feeds
Package slugsocial-feeds
Product groupCapell Growth
Tierpremium
Bundlegrowth
Runtime contextsadmin, frontend
Capell version^4.0
Source repositorycapell-app/packages
Source pathpackages/social-feeds
Docs sourcepackages/social-feeds/docs
Manifestcapell.json

Social Feeds is Capell’s premium social-feed widget package. It renders cached social content through Block Library with configurable list, slideshow, carousel, and paginated layouts while keeping public HTML free of credentials, admin URLs, editor markers, and connection internals.

What Ships

Section titled “What Ships”
  • Extendable SocialFeedProvider bridge with tagged provider registration.
  • Built-in provider keys for RSS / Atom, TikTok, YouTube, Bluesky, Instagram, Facebook, LinkedIn, and X.
  • Working RSS / Atom sync provider plus feed URL-backed sync for configured social providers while native API bridges are completed.
  • Cached social_feed_items table used by public rendering.
  • social-feed Block Library block with provider, connection, limit, page size, columns, caption, author, date, media, autoplay, transition, aspect-ratio, and empty-state controls.
  • Public Blade rendering that consumes hydrated DTOs only.

Extension

Section titled “Extension”

Custom packages can add providers by tagging a SocialFeedProviderProvider implementation:

$this->app->tag([MySocialFeedProviderProvider::class], \Capell\SocialFeeds\Contracts\SocialFeedProviderProvider::TAG);

The provider-provider receives SocialFeedProviderRegistry and may register one or more SocialFeedProvider implementations.

Provider Status

Section titled “Provider Status”

RSS / Atom is the native v1 provider. TikTok, YouTube, Bluesky, Instagram, Facebook, LinkedIn, and X are first-class provider keys that can sync from a configured feed_url; missing feed URLs fail the sync with a clear connection error instead of pretending the provider synced successfully.

Verification

Section titled “Verification”
Terminal window
vendor/bin/pest packages/social-feeds/tests --configuration=phpunit.xml
composer validate packages/social-feeds/composer.json --no-check-publish