Facebook Posts Integration: setup and help

Quick start

  1. Upload the module ZIP in Modules > Module Manager and open Configure.
  2. Enter Page Access Token and Page ID for the intended account.
  3. Set Page Name and keep the feed enabled.
  4. Select Display hook supported by your theme, such as displayHome.
  5. Set Layout mode, columns and visible content, then save.
  6. Use Force sync now if replacing cached content.
  7. Open the chosen storefront area, confirm media loads and test post/follow links.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.

Setup manual

Install and connect

  1. Upload the Facebook Posts Integration ZIP through Modules > Module Manager.
  2. Open Configure.
  3. Enter Page Access Token, Page ID and Page Name.
  4. Choose a real Display hook supported by your theme, then save.
  5. Use Force sync now, then open the chosen storefront area. Posts link to the connected Page.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.

Connection settings

Setting Installed default What you do
Enable module Yes Enables the storefront feed. It is separate from Enable Auto-Publish.
Page Access Token Empty Paste a token authorized for your Page. The connection form asks for pages_read_engagement and pages_read_user_content for reading. Saving does not test the token; load the feed or publish a test post to check that it can read and publish.
Page ID Empty Enter the numeric Page ID, not its username or URL.
Page Name Empty Enter the name used in the header and post author area.

The module requests https://graph.facebook.com/v21.0/PAGE_ID/posts. It asks for message, dates, full picture, permalink, shares, reaction/comment summaries, attachments, status type and publication data. It renders one Page feed at a time.

The storefront follow action opens Facebook; reactions and comments happen there, not inside PrestaShop.

Display and layout

Placement

Setting Installed default What it does
Display hook displayHome Choose displayHome, displayFooterBefore, displayFooter, displayLeftColumn or displayRightColumn.
Section title Follow us on Facebook Heading above the feed.
Show follow button Yes Displays the Page link in the feed header.
Follow button text Follow Text before the configured Page name.
Show on mobile Yes Turn off to omit feed output for visitors detected as mobile by PrestaShop.

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

Setting Installed default What it does
Layout mode grid Choose grid, slider or list.
Columns 3 Desktop columns or visible slider items.
Mobile columns 1 Mobile columns or visible slider items.
Number of posts 6 Maximum posts displayed. The request fetches up to twice that amount, capped at 100, before filtering.
Theme light Choose light or dark.
Hover effect elevate Choose elevate, glow, border or none.
Gap (px) 16 Card spacing in pixels.
Border radius (px) 8 Card corner rounding.

For a homepage grid, start with six posts, three desktop columns, one mobile column, 16px gap and 8px radius. For a compact footer slider, choose displayFooterBefore and slider, then review scrolling and mobile width.

Post content and performance

Visible content

Setting Installed default What it does
Show post text Yes Display the post message.
Max text length 200 Shorten post text. Set 0 for no truncation.
Show media/images Yes Display available media previews.
Show date Yes Display the post date or relative time.
Show reactions count Yes Display the returned reaction count.
Show shares count Yes Display the returned share count.
Show comments count Yes Display the returned comment count.
Show author Yes Display the configured Page author details.
Exclude shared posts No Skip posts marked shared_story.

Multi-image posts can show a compact grid using up to four preview images. Items without a message or full_picture are skipped by the fetcher, so the displayed count can be lower than requested.

Cache and slider

Setting Installed default What it does
Auto-scroll (slider) No Moves the slider automatically.
Scroll speed 5000 ms Delay between automatic movements.
Lazy load images Yes Defers feed image loading until near the viewport.
Cache duration 3600 seconds Choose 30 minutes, 1, 2, 6, 12 or 24 hours.

Feed snapshots are stored in the database for each shop and connected Page. Storefront visits display the saved snapshot without requesting Meta. Scheduled refreshes or synchronization retrieve new posts; a failed refresh keeps the previous snapshot.

Use Force sync now to request fresh posts. A failed synchronization retains the previous snapshot; read the displayed feed status. Lazy loading uses IntersectionObserver with immediate loading when unavailable.

Optional Blog Revolution publishing

The configuration can show a publishing section when MPR Blog Revolution is available. Feed reading and publishing are separate operations. Leave Enable Auto-Publish off, its installed default, until you deliberately want new published blog content to create remote posts.

Caption Template defaults to:

{title}

{excerpt}

Read more: {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 Facebook publisher supports text, link or one-photo posts. The blog path supplies a link, so the publisher normally chooses a link post even when a featured image exists.

Manual buttons in the recent blog-post panel also create real remote content. Check the selected post, account and caption before using them. Publishing works only if the token has publishing permission for that Page.

Publishing attempts are recorded in shared queue/history data, with duplicate checks and records of unknown outcomes. This module attempts publication during the request. If the outcome is unknown or needs reconciliation, review the remote account and queue result before trying again to avoid duplicate posts.

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 Facebook platform is enabled in Social Revolution (mprsocialrevolution), this module hides its own feed and stops its automatic publishing for Facebook. Installing Social Revolution alone does not trigger this change.

Verify and troubleshoot

  • Confirm the required credentials are saved, the feed switch is on and the selected hook executes in your theme.
  • Synchronize the feed and open the chosen area. If nothing appears, read the feed status and PHP/API errors.
  • Test grid or slider controls, mobile visibility, follow links and post permalinks. Shared-post filtering may leave fewer cards.
  • If authentication fails, check the token, account ID, remote API version and permissions. Saving settings confirms local storage only. Use a numeric Page 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.

Customize and uninstall

Keep template overrides in your theme:

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

Theme CSS can target .mprfb-section, .mprfb-title, .mprfb-grid, .mprfb-slider, .mprfb-item and .mprfb-follow-btn. Additional hooks include .mprfb-header, .mprfb-list, .mprfb-media, .mprfb-text and .mprfb-footer.

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 Facebook.

Questions

1

Does the feed load Facebook Pixel, and are all requests server-side?

The feed fetches posts through server-side Graph API requests and does not initialize Facebook Pixel or the Facebook SDK. Post images and Page avatars can load from Meta in the visitor’s browser. The Page-avatar URL contains the saved Page Access Token. Remote image requests do not guarantee cookie-free browsing.

Known Issues

5

Missing or damaged interface translations

ResolvedUpdated:
Fixed in: 1.0.21
Some module labels remained in English or displayed damaged text when another shop language was selected.

PHP 7.1 compatibility

ResolvedUpdated:
Fixed in: 1.0.21
The module could fail to load on shops running PHP 7.1.

Credential cannot be saved from setup dialog

ResolvedUpdated:
Fixed in: 1.0.21
Saving the Facebook credential from the setup dialog could fail with a configuration save error.

Setup warning remains after saving

ResolvedUpdated:
Fixed in: 1.0.21
The setup banner could continue showing the previous configuration status immediately after a successful save.

Slow configuration page

ResolvedUpdated:
Fixed in: 1.0.14
Opening the configuration page could wait for a remote Facebook API request.

Feature Requests

1

Implemented

Automatic Facebook publishing and scheduling

Implemented
Configure automatic Facebook publishing with a caption and use the shared post scheduling controls.

Changelog

v1.0.152026-09-18

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedAvoid remote API call during config render
Older releases

v1.3.02026-04-20

  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations

v1.2.02026-02-04

  • Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
  • Addedsupport for Reels and video post thumbnails in the feed widget
  • Improvedresponsive grid layout — columns collapse gracefully on mobile
  • Fixedtoken expiry not refreshing automatically when using long-lived page tokens
  • Addedpost caption truncation with configurable character limit and 'Read more' toggle

v1.0.02025-12-02

  • Initialrelease: display your Facebook Page feed directly in your PrestaShop storefront
  • InitialConfigurable number of posts to fetch (up to 20) via Facebook Graph API
  • InitialResponsive masonry/grid layout with customizable column count
  • InitialOption to open posts in a lightbox or redirect to Facebook

v1.1.02025-08-19

  • Addedskeleton loading placeholder while feed is fetching from the API
  • Improvedcaching — feed data now stored in PrestaShop object cache (Redis-compatible)
  • Fixedfeed not updating after Facebook Page name change
  • Addedcolumn count selector (1–4 columns) for desktop and mobile breakpoints separately

Demo

Test the full module before you buy

Buy a licence later and keep your settings.

  • Your 30-day demo Test it on your own shop for 30 days from the first install.
  • Ready demo shop Explore a ready demo shop in your browser.
  • No registration No account, email or store domain needed.
Launch demo shop

By downloading, you accept the demo terms and privacy policy.

By opening this demo you accept the demo terms and the privacy policy.

Loading...
Back to top