Copied pictures are now stored as WebP where the server supports it, and album slides in two sizes: a smaller cache and smaller downloads at the same quality. Existing copies are kept; switch the setting off and on again to rebuild them as WebP.<\/p>","6.0.0":"
Pictures are now copied to your site in three sizes and served from there: far less data per page, no visitor connection to Meta for pictures. Copying runs in the background and needs about 200 MB per 300 posts; switch it off under Behavior if you prefer. Includes the 5.4.1 fixes.<\/p>","5.4.1":"
Fixes a crash anyone could trigger on the feed route, stops a failing feed from calling Instagram on every page view, and makes Load more work when REST is blocked or the account label has an underscore. Recommended for all users.<\/p>","5.4.0":"
Pages with a gallery load much faster: only the posts the page can show are built into it, Load more fetches the rest. Also fixes the header avatar frame, the Translations labels and several lightbox, token and cache issues. Hashtag filters now match whole hashtags only \u2014 see the changelog.<\/p>","5.3.14":"
Fixes a gallery that stops loading for visitors on page-cached sites, a duplicated post after "Load more", requests for a non-existent page caused by posts without a picture, and the error message that was never visible.<\/p>","5.3.13":"
Security hardening: removes old, no longer used copies of the Instagram access token left behind by earlier upgrades, and makes uninstall clean up completely. No visible changes.<\/p>","5.3.12":"
Shortcode limit and columns now work, captions with apostrophes and hashtags like #s\u00f8ndag display correctly, and a failing Instagram connection no longer slows down every page view. If your shortcode sets limit or columns, the gallery will now follow them.<\/p>","5.2.0":"
Permanent token support (no more 60-day expiry), English defaults, bug fixes, and improved image loading. Recommended for all users.<\/p>","5.1.1":"
Fix: images no longer flicker when scrolling back to the feed on mobile.<\/p>","5.1.0":"
Instagram Stories integration: active Stories show as a gradient ring on the profile avatar. Click to view in a fullscreen viewer with auto-advance and tap navigation. Enable in Behavior tab.<\/p>","5.0.0":"
Major release: Multi-account support (up to 20 accounts), redesigned admin (9 tabs consolidated to 7), visual Shortcode Builder with account selector. Existing single-account setups auto-migrate \u2014 no action needed.<\/p>","4.6.0":"
New features: content moderation, video hover preview, carousel autoplay, and API failure alerts. All are opt-in via the Behavior tab.<\/p>","4.5.4":"
Fixes missing files from the 4.5.3 SVN release. Recommended for all users.<\/p>","4.5.3":"
Frontend CSS prefix renamed from tg- to sdawsoga- for namespace compliance. No settings changes needed.<\/p>","4.5.2":"
Fixes fatal error on sites where wp_salt() is unavailable during plugin loading. Recommended for all users.<\/p>","4.5.1":"
WordPress.org compliance: removed custom CSS editor, fixed escaping, corrected plugin filename.<\/p>","4.5.0":"
Security hardening and responsive column fixes. Recommended for all users.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3471763,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3471763,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3471763,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3471763,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"sdawsoga\/gallery":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"sdawsoga\/gallery","version":"6.0.1","title":"Social Galleri Feed","category":"embed","icon":"format-gallery","description":"Display your Instagram feed as a responsive gallery.","keywords":["instagram","gallery","feed","social"],"textdomain":"sdaweb-social-galleri-feed","supports":{"html":false,"align":["wide","full"],"anchor":true},"attributes":{"feedId":{"type":"string","default":""},"account":{"type":"string","default":""},"limit":{"type":"number","default":0},"columns":{"type":"number","default":0},"layout":{"type":"string","default":"","enum":["","grid","masonry","highlight"]},"aspectRatio":{"type":"string","default":"","enum":["","square","instagram","portrait","original"]},"showHeader":{"type":"boolean","default":true},"showLoadmore":{"type":"boolean","default":true},"hashtag":{"type":"string","default":""},"excludeHashtags":{"type":"string","default":""}},"editorScript":"file:..\/..\/assets\/js\/block-editor.js"}},"tagged_versions":["4.10.0","4.10.1","4.10.2","4.10.3","4.10.4","4.10.5","4.11.0","4.12.0","4.5.1","4.5.2","4.5.4","4.7.0","4.7.1","4.7.2","4.7.3","4.7.8","4.8.0","5.1.0","5.1.1","5.2.0","5.2.1","5.2.2","5.2.3","5.2.4","5.3.0","5.3.1","5.3.10","5.3.11","5.3.12","5.3.13","5.3.14","5.3.2","5.3.4","5.3.5","5.3.6","5.3.7","5.3.8","5.3.9","5.4.0","6.0.0","6.0.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3471763,"resolution":"1","location":"assets","locale":"","width":1200,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3471763,"resolution":"2","location":"assets","locale":"","width":1200,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3465870,"resolution":"3","location":"assets","locale":"","width":1200,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3471763,"resolution":"4","location":"assets","locale":"","width":1200,"height":900},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3471763,"resolution":"5","location":"assets","locale":"","width":1200,"height":900}},"screenshots":{"1":"Grid gallery on frontend","2":"Lightbox with engagement stats","3":"Admin settings \u2014 Accounts tab with multi-account management","4":"Admin settings \u2014 Shortcode Builder with account selector","5":"Mobile lightbox view"}},"plugin_section":[],"plugin_tags":[252,210,311,237,154],"plugin_category":[50,56],"plugin_contributors":[257114,256141],"plugin_business_model":[],"class_list":["post-282597","plugin","type-plugin","status-publish","hentry","plugin_tags-feed","plugin_tags-gallery","plugin_tags-instagram","plugin_tags-lightbox","plugin_tags-social-media","plugin_category-media","plugin_category-social-and-sharing","plugin_contributors-rstake","plugin_contributors-sdaweb","plugin_committers-rstake"],"banners":{"banner":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/banner-772x250.png?rev=3471763","banner_2x":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/banner-1544x500.png?rev=3471763","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/icon-128x128.png?rev=3471763","icon_2x":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/icon-256x256.png?rev=3471763","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/screenshot-1.png?rev=3471763","caption":"Grid gallery on frontend"},{"src":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/screenshot-2.png?rev=3471763","caption":"Lightbox with engagement stats"},{"src":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/screenshot-3.png?rev=3465870","caption":"Admin settings \u2014 Accounts tab with multi-account management"},{"src":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/screenshot-4.png?rev=3471763","caption":"Admin settings \u2014 Shortcode Builder with account selector"},{"src":"https:\/\/ps.w.org\/sdaweb-social-galleri-feed\/assets\/screenshot-5.png?rev=3471763","caption":"Mobile lightbox view"}],"raw_content":"\n
SDAweb Social Galleri Feed connects to the Instagram Graph API and displays your posts in a customizable grid gallery with lightbox. Supports multiple Instagram accounts \u2014 connect up to 20 accounts and display different feeds on different pages. Built for speed \u2014 feeds load instantly on cached pages with zero network requests.<\/p>\n\n
Multi-Account Support<\/strong>\n* Connect up to 20 Instagram accounts, each with its own token and cache\n* Per-account test connection, cache management, and failure tracking\n* Display different accounts on different pages with the Layout & Design<\/strong>\n* Multiple layouts \u2014 Grid, masonry, and highlight modes\n* Responsive columns \u2014 Separate settings for desktop, laptop, tablet, and mobile\n* Profile header \u2014 Avatar, username, follower count, bio, and follow button\n* Hover effects \u2014 Overlay on image hover with gradient\n* Color pickers \u2014 Customize likes icon, comments icon, and date text colors<\/p>\n\n Instagram Stories<\/strong>\n* Story ring \u2014 Gradient ring on avatar when Stories are active (like Instagram)\n* Fullscreen Story viewer \u2014 Auto-advance, tap navigation, progress bars, keyboard support\n* Video Stories play automatically (muted by default)\n* Per-account Stories refresh every 15 minutes via WP-Cron\n* Toggle on\/off globally or per shortcode<\/p>\n\n Lightbox<\/strong>\n* Fullscreen lightbox \u2014 Carousel navigation with keyboard and swipe support\n* Swipe-up-to-close \u2014 Mobile-native gesture\n* Engagement stats \u2014 Likes, comments, media type badge, and relative date<\/p>\n\n Content & Filtering<\/strong>\n* Multiple feeds \u2014 Use Performance<\/strong>\n* Instant loading \u2014 The first screens are built into the page, zero network requests on cache hit\n* REST API endpoint with legacy AJAX fallback\n* Stale-while-revalidate \u2014 Expired cache served instantly while refreshing\n* Per-account WP-Cron background refresh \u2014 All caches stay warm automatically\n* Lean pages \u2014 Only the posts a page can show are built into it; Load more fetches the rest on demand\n* Lazy loading and incremental grid rendering\n* Local picture cache \u2014 Pictures are copied to your uploads folder in three sizes during the background refresh and served from your site with a srcset; a phone loads a 320 px copy instead of Instagram's 2 MB original, visitors' browsers never connect to Meta for pictures, and the gallery survives Instagram's expiring picture links. Can be switched off.\n* Per-IP rate limiting<\/p>\n\n Localization<\/strong>\n* All 30+ frontend strings configurable in admin (translated defaults, override any of them)\n* Relative timestamps and month names customizable<\/p>\n\n Security<\/strong>\n* Bearer token authentication \u2014 API token sent via Authorization header\n* AES-256-CBC token encryption at rest with random IV per encryption\n* CSRF protection \u2014 check_admin_referer() on all admin actions\n* XSS prevention \u2014 gallery built with DOM methods, all output escaped\n* Clean uninstall \u2014 Removes all options, transients, and cron jobs per account<\/p>\n\n Accessibility<\/strong>\n* Full keyboard navigation in lightbox and gallery\n* ARIA labels and screen reader support\n* Respects prefers-reduced-motion<\/p>\n\n This plugin connects to the Instagram Graph API<\/strong> (via Facebook) to retrieve your Instagram posts, profile information, and engagement metrics.<\/p>\n\n When data is sent:<\/strong> When the plugin refreshes the feed cache \u2014 by the WP-Cron background refresh, by \"Refresh now\" or a settings change in the admin panel, or when a visitor opens a gallery page while the cache is empty. With default settings, this happens approximately once per hour.<\/p>\n\n What data is sent:<\/strong> Your Facebook Page Access Token and Instagram Business Account ID are sent to Facebook's servers to authenticate and retrieve your posts. No visitor information is included in these requests.<\/p>\n\n Pictures:<\/strong> with the default setting \"Serve pictures from this site\" (Behavior tab), the plugin copies the pictures of your posts to your site's uploads folder during its background refresh, and visitors' browsers load them from your site. Until a picture has been copied, and whenever the setting is off, pictures are loaded by the visitor's browser directly from Instagram's media servers<\/strong> (cdninstagram.com and fbcdn.net, operated by Meta), as with any embedded Instagram content; Meta then receives the visitor's IP address and browser details for those requests, under the privacy policy linked above. Videos<\/strong> are always played from Instagram's servers when a visitor starts them, and Stories<\/strong>, if enabled, are loaded from Instagram's servers. When a visitor opens a gallery page while the cache is empty, the plugin stores a one-way hash of the visitor's IP address for five minutes to limit how often Instagram is contacted. The plugin sets no cookies. A suggested privacy-policy text is provided under Settings \u2192 Privacy \u2192 Policy Guide.<\/p>\n\n\n For token setup instructions, see the built-in setup guide in the Global tab.<\/p>\n\n\n Yes. Go to the Accounts tab and add up to 20 accounts, each with its own token. Use The Instagram Graph API only returns engagement metrics for accounts owned by the token holder.<\/p><\/dd>\n Yes. Use the Go to Social Galleri > Translations<\/strong> and update any string.<\/p><\/dd>\n Yes. The shortcode works in Elementor, WPBakery, Divi, and any builder that supports WordPress shortcodes. A Gutenberg block is also available.<\/p><\/dd>\n Feed data is embedded in the page HTML when the cache is warm (nearly always, thanks to per-account WP-Cron background refresh), so it loads instantly with zero network requests.<\/p><\/dd>\n Four permissions: Yes. The plugin documents 25 WordPress filter and action hooks covering rendering, post filtering, API data, SEO schema, and lifecycle events; The most recent releases are listed here. The complete history is in changelog.txt in the plugin folder.<\/p>\n\naccount<\/code> shortcode attribute\n* Visual Shortcode Builder shows which account you're building for<\/p>\n\nfeed_id<\/code> attribute for independent feeds on different pages\n* Hashtag filtering \u2014 Include or exclude posts by hashtag\n* Media type filter \u2014 Filter by image, video, or carousel\n* Load more \u2014 Paginated loading with customizable button<\/p>\n\nShortcode<\/h4>\n\n
[sdawsoga_gallery]\n<\/code><\/pre>\n\nShortcode Attributes<\/h4>\n\n
\n
account<\/code> \u2014 Account slug from Accounts tab (default: default account)<\/li>\nfeed_id<\/code> \u2014 Gallery name for CSS targeting<\/li>\nlimit<\/code> \u2014 Number of posts to display (default: 9)<\/li>\ncolumns<\/code> \u2014 Number of columns (default: 3)<\/li>\nlayout<\/code> \u2014 grid, masonry, or highlight<\/li>\naspect_ratio<\/code> \u2014 square, portrait, instagram, or original<\/li>\npadding<\/code> \u2014 Gap between images in pixels<\/li>\nshow_header<\/code> \u2014 Show\/hide profile header (true\/false)<\/li>\nshow_loadmore<\/code> \u2014 Show\/hide load more button (true\/false)<\/li>\nhover_effect<\/code> \u2014 Enable\/disable hover overlay (true\/false)<\/li>\nfilter_type<\/code> \u2014 all, image, video, or carousel<\/li>\nhashtag<\/code> \u2014 Only show posts containing this hashtag<\/li>\nexclude_hashtags<\/code> \u2014 Comma-separated hashtags to exclude<\/li>\nshow_stories<\/code> \u2014 Show\/hide Instagram Stories ring (true\/false)<\/li>\n<\/ul>\n\nRequirements<\/h4>\n\n
\n
instagram_basic<\/code>, pages_show_list<\/code>, pages_read_engagement<\/code>, and instagram_manage_insights<\/code> permissions (all four are required for the feed)<\/li>\nThird-Party Services<\/h3>\n\n
\n
\n
sdaweb-social-galleri-feed<\/code> folder to \/wp-content\/plugins\/<\/code><\/li>\n[sdawsoga_gallery]<\/code> to any page or post<\/li>\n[sdawsoga_gallery account=\"slug\"]<\/code><\/li>\n<\/ol>\n\n\n
Can I connect multiple Instagram accounts?<\/h3><\/dt>\n
[sdawsoga_gallery account=\"slug\"]<\/code> to display a specific account. The Shortcode Builder lets you select accounts visually.<\/p><\/dd>\nWhy do likes and comments show 0?<\/h3><\/dt>\n
Can I use multiple feeds on the same page?<\/h3><\/dt>\n
feed_id<\/code> attribute: [sdawsoga_gallery feed_id=\"homepage\"]<\/code>. Each feed operates independently. Combine with account<\/code> for different accounts: [sdawsoga_gallery account=\"oslo\" feed_id=\"sidebar\"]<\/code>.<\/p><\/dd>\nHow do I change the language?<\/h3><\/dt>\n
Does it work with page builders?<\/h3><\/dt>\n
How fast does the feed load?<\/h3><\/dt>\n
What Facebook Graph API permissions do I need?<\/h3><\/dt>\n
instagram_basic<\/code>, pages_show_list<\/code>, pages_read_engagement<\/code>, and instagram_manage_insights<\/code>. All four are required for the feed \u2014 the plugin reads your posts through the Graph API Business Discovery endpoint, which needs the insights scope (it is also used by Stories). Omitting instagram_manage_insights<\/code> causes a \"(#10) Application does not have permission for this action\" error when the feed loads. The setup guide in the plugin admin lists all of these with step-by-step instructions for Graph API Explorer.<\/p><\/dd>\nCan I extend the plugin from my theme or another plugin?<\/h3><\/dt>\n
docs\/hooks.md<\/code> inside the plugin folder has the full reference with copy-paste examples and says which hooks fire on the default gallery (the gallery is built in the browser, so the per-post helpers in PHP fire only from a custom template). Examples include: rewriting Instagram CDN picture addresses through your own image proxy, overriding the gallery template from your theme, and busting your page cache when the feed refreshes. All hooks are stable within the 5.x major version.<\/p><\/dd>\n\n<\/dl>\n\n\n6.0.1<\/h4>\n\n
\n
sdawsoga_media_cache_slide_sizes<\/code> and sdawsoga_media_cache_mime<\/code>. See docs\/hooks.md.<\/li>\n<\/ul>\n\n6.0.0<\/h4>\n\n
\n
sdawsoga_media_cache_enabled<\/code> and sdawsoga_media_cache_sizes<\/code>; posts passed to sdawsoga_feed_item<\/code> now carry media_srcset<\/code> (or thumbnail_srcset<\/code> for videos) next to a local address when a copy exists. See docs\/hooks.md.<\/li>\n5.4.1<\/h4>\n\n
\n
?account[]=x<\/code>) caused a PHP fatal error on PHP 8. Anyone could send it, without logging in, which filled the error log and could set off WordPress's \"technical issue\" email to the site administrator. No data was exposed. The request now gets an ordinary 400 answer.<\/li>\nsdawsoga_feed_item<\/code> filter could still be fetched there, along with posts without a picture and Instagram's paging cursors. It now answers exactly like the REST route, and also accepts offset and per_page.<\/li>\nshow_header=\"false\"<\/code> or the block setting), the lightbox had no profile picture and showed a lone \"@\" before the caption.<\/li>\n&<\/code> and '<\/code> in it.<\/li>\n5.4.0<\/h4>\n\n
\n
sdawsoga_cached_feed_data<\/code> filter now also runs on the page itself, where nearly every gallery view gets its posts; before, it ran only on the REST and AJAX routes, so a filter written after docs\/hooks.md had no visible effect. The schema.org JSON-LD is now printed by PHP whenever the feed is on the page, so the sdawsoga_schema_markup<\/code> filter fires too (same shape, once per page). docs\/hooks.md gains a \"Which hooks fire\" section: eleven of the documented hooks live in renderer helpers the default browser-built gallery never calls, and the reference now says so and shows how to get the same result with sdawsoga_cached_feed_data<\/code>.<\/li>\nsdawsoga_feed_item<\/code> filters one post at a time just before it leaves the server (page and REST route) \u2014 rewrite a picture address or caption, or return false to hide the post; sdawsoga_feed_refreshed<\/code> fires after a fresh feed has been stored, the moment to purge a page cache; sdawsoga_feed_need<\/code> changes what a gallery asks to have inlined; sdawsoga_frontend_config<\/code> filters everything handed to the browser script. All documented in docs\/hooks.md.<\/li>\n5.3.14<\/h4>\n\n
\n
5.3.13<\/h4>\n\n
\n
5.3.12<\/h4>\n\n
\n