Instagram Feed Integration: setup and help

1. Upload the Instagram Feed Integration ZIP through Modules > Module Manager.
2. Open Configure.
3. Enter Access Token, Instagram User ID and Instagram Username.
4. Choose a real Display Hook supported by your theme, then save.
5. Visit that storefront area so the first feed request runs. Confirm posts link to your intended account.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.

With Instagram User ID filled, the module requests https://graph.facebook.com/v18.0/USER_ID/media. With it empty, the module requests https://graph.instagram.com/me/media. Configure the intended Graph account and check the feed response.

After each uncached feed fetch, the module attempts token renewal through graph.instagram.com/refresh_access_token, including when Instagram User ID is configured. It saves a returned access token on success. Renewal is not guaranteed; replace credentials when authentication fails.

Placement

Only the selected standard hook renders the feed. Your theme must call that hook. You can use the homepage for the initial test, then move it to a footer or column hook supported by your theme.

Layout

For a homepage grid, start with 12 posts, four desktop columns, two mobile columns and three rows. This shows up to 12 posts on desktop and six on mobile; tablets use three columns. Rows limits the visible grid items, while Number of Posts remains the overall maximum. For a footer slider, choose displayFooterBefore and slider, reduce Number of Posts if needed and hide captions or dates for a compact layout.

The supplied slider reads column and gap variables from the section, while the template declares them on the grid. Slider movement therefore falls back to four desktop items, three on tablets, two on mobile and a 10px gap unless your theme supplies those variables on the section. Test the slider after changing layout settings.

Visible content

Videos are represented by thumbnails with a play marker. Carousel albums appear as a linked preview with a gallery marker; the fetcher does not request and display all carousel children. The feed shows account media, not hashtag results. Items without a usable image or video thumbnail are skipped.

Cache and slider

The feed uses a local JSON cache in the module directory. A storefront request fetches media when the file is missing or older than Cache Duration. Shops using the same module directory share this cache. There is no scheduled refresh worker.

Refresh Feed Cache Now and saving the feed settings clear the cache. The next storefront request fetches media and saves only nonempty results. An API error or empty result shows no feed for that request; expired cached content is not served. Lazy loading uses IntersectionObserver, with immediate image loading when it is unavailable.

The configuration includes a publishing section and a Blog Posts panel. The panel needs MPR Blog Revolution data to list posts. Feed reading and publishing are separate operations. Leave Enable Auto-Publish off, its installed default, until you want published blog content to create remote posts. Saving the main feed form resets the separate auto-publish switch and caption template. Save the publishing form again after changing feed settings.

Caption Template defaults to:

{title}

{excerpt}

{url}

You can also use {shop_name}. For example, change the last part to Read the article: {url} and add {shop_name} on another line.

Automatic publishing reacts to object add/update hooks with published status 1 and configured credentials. The Instagram publisher requires Access Token, Instagram User ID and one featured image. It creates a media container and submits it for publication. It does not publish a multi-image carousel.

Manual buttons in the recent blog-post panel also publish real content to Instagram. Check the selected post, account and caption before using them, and make sure the token has permission to publish.

Publishing attempts use shared persistent queue/history data with duplicate and unknown-outcome checks. Publishing is attempted during the request; failed attempts need review before retrying. If the result is unknown or requires reconciliation, inspect the remote account and queue result before trying again.

The shared write policy can block publishing on a development/staging host or when the configured shop host is uncertain. Use the displayed result and PrestaShop logs to diagnose that block. There is no need to change publishing policy to test feed reading.

When the mprsocialrevolution stored platform-active setting is on, this module suppresses its own feed and automatic publishing for that platform. That takeover check reads the platform setting; it is not simply a test that the other module is installed.

• Confirm the required credentials are saved, the feed switch is on and the selected hook executes in your theme.
• Clear the cache, visit the chosen area, and inspect the resulting feed. Check the cache file's timestamp and PHP/API errors if nothing appears.
• Test grid or slider controls, mobile visibility, follow links and post permalinks. Like/comment counters require the User ID request and returned positive values.
• If authentication fails, check the token, account ID, remote API version and permissions. Saving credentials checks that the token is nonempty; it does not verify the remote account identity. Changing the username alone does not change the API account ID.
• If publishing is denied, check the employee's module access, account credentials, host-policy result, shared-package compatibility and previous attempt state. Do not repeatedly publish after an uncertain response.

Keep template overrides in your theme:

themes/your-theme/modules/mprinstagramintegration/views/templates/hook/feed.tpl
themes/your-theme/modules/mprinstagramintegration/views/templates/hook/post_item.tpl

Theme CSS can target .mprinstagram-section, .mprinstagram-title, .mprinstagram-grid, .mprinstagram-slider, .mprinstagram-item and .mprinstagram-follow-btn. Use .mprinstagram-caption for caption styling. Layout variables include --mprinstagram-gap and --mprinstagram-radius.

To pause output, turn off Enable Module. Turn off Enable Auto-Publish separately to stop automatic publishing. Before uninstalling, retain credentials and back up any publication history you need. Uninstall removes the module's menu and settings, clears its cache and runs its schema cleanup. It does not delete posts already created on Instagram.