Facebook Posts Integration: setup and help
Quick start
- Upload the module ZIP in Modules > Module Manager and open Configure.
- Enter Page Access Token and Page ID for the intended account.
- Set Page Name and keep the feed enabled.
- Select Display hook supported by your theme, such as displayHome.
- Set Layout mode, columns and visible content, then save.
- Use Force sync now if replacing cached content.
- 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
- Upload the Facebook Posts Integration ZIP through Modules > Module Manager.
- Open Configure.
- Enter Page Access Token, Page ID and Page Name.
- Choose a real Display hook supported by your theme, then save.
- 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
PHP 7.1 compatibility
Credential cannot be saved from setup dialog
Setup warning remains after saving
Slow configuration page
Feature Requests
1
Implemented
Automatic Facebook publishing and scheduling
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.
By downloading, you accept the demo terms and privacy policy.
By opening this demo you accept the demo terms and the privacy policy.