GMC Facebook Feed Gallery
Product detail · Joomla 5/6 and WordPress 6+
GMC Facebook Feed Gallery
Facebook pages, posts, photos and videos rendered as CMS-native galleries.
Your Facebook content stops being a fragile embed and becomes a controlled content block.
Who it is for
Hotels, schools, venues, local businesses and publishers who already maintain Facebook but need it to look clean on their own site.
Choose the calm option: install it once, keep the feed or form under your control, and stop wondering which external widget will change next.
What is inside
- Official Page Plugin fallback without tokens
- Meta Graph API mode for posts, photos and videos
- Cards or list layout with Load More
- Optional local media cache for GDPR-oriented setups
Requirements
- Joomla 5/6 or WordPress 6+
- PHP 8.1+
- Public Facebook page URL
- Meta Page access token only for Graph API galleries
Shortcodes
{gmcfacebookfeed page="https://www.facebook.com/PAGE_NAME" tabs="timeline" height="600"}
{gmcfacebookgallery source="graph" type="photos" columns="3" page_size="6"}
[gmcfacebookgallery page_id="PAGE_ID" access_token="META_PAGE_ACCESS_TOKEN" type="videos"]Everything included
61 real capabilities, grouped by area — the full depth of the Facebook Feed Gallery, not a highlight reel.
Feed sources & reliability
- No-token Page Plugin mode — embed the official Facebook Page Plugin with zero API setup; just paste a public Page URL.
- Meta Graph API galleries — pull the Page's own posts, photos, videos or photo albums as a real on-site gallery using an official Page access token.
- Automatic fallback — if the Graph API returns nothing or errors, it falls back to the Page Plugin embed so the block never renders empty.
- Stays online during outages — serves the last cached copy of media it already fetched when the Graph API is slow or unreachable, so pages keep rendering instead of breaking.
- Multi-account merged feeds — store one token per Page and render several Facebook Pages merged into a single newest-first, de-duplicated feed (up to 10 sources).
- Multi-ID feeds — a
page_id="111,222"list (comma or pipe, up to 10 IDs) fans out to per-ID Graph calls and merges the results. - Four content types — posts, photos, videos, or an interactive photo-albums browser, each from the same widget.
Layouts & on-page display
- Six display styles — cards, list, masonry, YOOtheme/theme-match, info-rich "showcase", and a magazine home-feed layout.
- Native theme-match preset — inherits your active theme's look automatically (real UIkit markup on Joomla/YOOtheme Pro; self-contained matching CSS on WordPress).
- Info-rich showcase preset — photo grid with a dark gradient overlay showing caption, date and like/comment counts, plus a Facebook permalink glyph and hover-reveal.
- Carousel / slider mode — render the theme-match preset as a swipeable slider with prev/next arrows and dots.
- In-widget content tabs — one widget can show a Posts / Photos / Videos tab switcher fed by separate Graph edges.
- Photos-albums browser — a grid of the Page's albums (cover + name + count); click an album to reveal its photos in the lightbox, with a back button — fetched in a single Graph call.
- Album filter chips — define labelled albums by caption keyword and let visitors filter the grid client-side ("All" + per-album chips).
- Configurable grid — 1–6 columns, adjustable gutter spacing, and square or natural image crop.
- Load More + infinite scroll — a Load More button with a configurable initial threshold, or auto-trigger on scroll.
- Call-to-action button — optional per-card CTA (custom label + URL) linking wherever you choose.
- Toggle what shows — independent switches for the header, post text, and the like/comment/share stats row.
- Engagement stats + link-back — optional like, comment and share counts on posts, with an optional link back to the original Facebook post.
- Quick-start presets — one-click starting points (Simple, Showcase, Carousel, Magazine home, Albums) that set sensible layout defaults.
- Accent & overlay colour pickers — brand the showcase overlay/accent with validated hex colours.
Media & lightbox
- Built-in lightbox — opens photos and videos in an on-page modal (no redirect), with an info panel showing caption, date, likes, comments and a "View on Facebook" link.
- Local media cache (GDPR-friendly) — optionally download remote media to your own server so nothing streams live from Meta's CDN on each page view; skips re-downloading files already on disk.
- Smart media extraction — picks the largest image for display and smallest for thumbnails, and detects video attachments (including sub-attachments) on posts.
Content curation & filtering
- Include / exclude keyword filters — show or hide posts by words in their caption.
- Banned words — suppress any post containing terms you list.
- Hide specific posts — exclude individual posts by ID.
- De-duplication — merged multi-source feeds drop repeats automatically.
Connect your Page (admin setup)
- Easy Connect via GMC (no Meta app needed) — one button: log in with Facebook, approve your Page, done; the hosted GMC relay brokers the login and the plugin saves the Page token — it never stores your token itself. (Requires your licence key; unlocks when the relay is live.)
- Connect with Facebook (advanced, your own Meta app) — one-click OAuth that fetches the token and Page ID automatically, with a multi-Page picker when you manage several.
- Manual permanent-token exchange — paste a short-lived User token and get a non-expiring Page token back, no Access Token Debugger needed.
- Guided setup wizard — a three-step connection walkthrough on the settings screen.
- Test connection button — validates the token/Page ID against the live Graph API and returns clear messages (expired/invalid token, wrong Page ID, missing permission, rate limit).
- Token-invalid alerts — a Graph error 190 flags the token and surfaces an admin notice so you know to reconnect.
- Minimal permissions — requests only
pages_show_list+pages_read_engagement, avoiding "Invalid Scopes" errors. - Configurable Graph version & locale — set the Meta Graph API version and the Facebook SDK locale.
Admin management & authoring
- Saved-feed manager — a backend list of saved widgets with create/edit, duplicate, and copy-shortcode; embed any saved feed by ID (
id="N"). - Live layout preview panel — a placeholder-tile preview in the editor that updates as you change columns/style/crop/carousel/albums (approximate; exact theme look is front-end).
- Global vs per-widget connection — reuse one global Page connection or override credentials per saved feed.
- Shortcodes everywhere — drop a feed into any article/page with four interchangeable shortcode aliases; inline attributes always override saved defaults.
- WordPress Gutenberg block — a native
gmc/facebook-feedblock for the editor. - WordPress classic widget — a legacy widget for sidebar/footer areas.
- WordPress FB Feeds CPT — manage saved feeds as a custom post type with a display-options meta box and a shortcode column in the list.
- Page Plugin embed options — timeline/events/messages tabs, width/height, small header, hide cover, and facepile toggles.
Performance & caching
- Graph response caching — configurable TTL (file cache on Joomla, transients on WordPress) with adjustable request timeout.
- Gateway negative caching — a failed licence check is cached for ~10 minutes so a gateway outage doesn't re-fire a blocking HTTP call on every page view.
- Daily media-cache purge — a scheduled task prunes stale cached media automatically.
- Concurrency-safe writes — cache/media files written with locking to avoid corruption under load.
Security, privacy & GDPR
- Full output escaping & input hardening — regex-cleaned Page IDs, whitelisted tokens, escaped output throughout.
- Meta CDN host allowlist — local-media downloads are restricted to Meta's own hosts via a safe remote-get.
- Secrets stay server-side — the Meta App Secret is stored encrypted and used only server-side, never exposed on the front end; the licence key is sent server-to-server only.
- Self-hosting for GDPR — optional local media cache keeps copies on your own server; documented cache locations for retention/erasure.
Internationalisation
- English, Italian & Spanish out of the box — both admin and front-end strings (wizard, connection boxes, lightbox, Load More, album filters, stats labels) are fully translated, and it respects your site's multilingual setup.
Trust & licensing
- GPLv2-or-later — open-source licence.
- Self-hosted, official data — reads directly from the official Meta Graph API / Facebook Page Plugin; no third-party SaaS middleman (unlike competitor feeds routed through a vendor API).
- Licensed one-click updates — the extension auto-checks the GMC / FuerteventuraTV update server (~every 24h) and offers new versions through the normal CMS updater while your licence is active.
- Download Key via email — delivered with your purchase email; entered once to unlock updates.
- Graceful licence grace period — a previously-licensed site keeps rendering during a gateway outage (last-known-good); it only blocks on a definitive denial.
- One-site licence — covers one site; volume/agency arrangements on request. Sold per platform (Joomla and WordPress are separate products/builds).
Joomla & WordPress
- Joomla — theme-match/carousel/tabs/lightbox emit native UIkit markup (
uk-card,uk-slider,uk-tab,uk-lightbox) so galleries inherit the active YOOtheme Pro theme, with graceful fallback on non-UIkit sites; ships a real admin component with a saved-widgets manager and an extragmcsocialpageshortcode alias; richer post normalization (engagement stats). - WordPress — the same feature set with self-contained CSS/JS (no UIkit dependency); adds a Gutenberg block, a classic widget, and an FB Feeds custom post type; auto-update toggle and full uninstall cleanup of settings, licence and cached data.
FAQ
- Do I need a Meta token?
No for Page Plugin mode. Yes for automatic Graph API galleries of posts, photos or videos.
- Can it cache media locally?
Yes, supported media can be cached locally so the page is less dependent on remote loading.
- Does it work on Joomla and WordPress?
Yes. The purchase covers the product; install the package that matches your CMS.
Privacy notes
Page Plugin mode loads resources from Facebook. Graph mode can render remote media or cache supported files locally; document this in your privacy/cookie policy.
