GMC Facebook Feed Gallery documentation

Facebook page posts, photos and videos rendered as CMS-native galleries.

What this component does

GMC Facebook Feed Gallery belongs to the FuerteventuraTV CMS catalogue and is supported through GMC AI Ticketing. Product package key: pkg_gmc_facebook_feed_gallery.

Requirements

A supported Joomla 5/6 or WordPress install according to the product platform.
PHP 8.1 or newer unless the product page says otherwise.
Administrator access for installation, configuration and update checks.
A valid FuerteventuraTV purchase/licence for paid downloads and private updates.

Daily workflow

Use GMC Facebook Feed Gallery from the CMS backend, not from external SaaS dashboards unless the product explicitly connects to one.
Document the exact page, shortcode, module position or menu item where the output is published.
Keep a small test item published so support can reproduce display and update problems quickly.

Updates and licence checks

Open the CMS administrator and confirm the product version before changing files.
Keep the licence/download id active in the product settings when the component exposes that field.
For Joomla updates use Extensions > Update, click Check For Updates, select the product and run Update.
If the update is not listed, clear the update cache and confirm the update site points to the FuerteventuraTV feed.

Support ticket

Open a support ticket with product name, installed version, domain, order email, licence/download id if available, and the exact error message. The AI assistant must cite this documentation or escalate to a human when the answer is not fully covered.

Installation guide

Use the Joomla or WordPress installation guide linked from the CMS documentation hub. Install the correct ZIP, keep a backup, save the license key when requested and test on a private page before publishing.

Configuration guide

Open the product settings in the CMS administrator area. Check license, roles, cache, privacy, notifications and provider keys only when that product uses an external provider.

User documentation

These notes are written for site owners and editors: first test, daily use, support limits, privacy duties and what to include in a support ticket. They do not require editing source code.

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-feed block 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 extra gmcsocialpage shortcode 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 developer access?

No for normal use. Administrator access to the CMS is enough for installation, configuration, updates and first tests.

Can I install Joomla and WordPress packages interchangeably?

No. Use the Joomla ZIP on Joomla and the WordPress ZIP on WordPress. If a product exists on both platforms, follow the guide for that CMS.

Where do I configure license and updates?

Use the product settings or update/licensing screen in the CMS. Paid downloads and private updates require the active FuerteventuraTV license/download key.

What should I send to support?

Send product name, version, CMS, site URL, screenshot, exact error and what you already tried. Do not send passwords, API keys or tokens in the ticket.

GMC Facebook Feed Gallery documentation