YouTube Feed Integration: setup and help

On older PrestaShop versions, use the equivalent module installation page. Open this module through Configure whenever you need to return to its settings.

The header’s profile/channel link is nested inside the section-title block. Set a Section Title if you want that header link to appear. The separate follow/subscribe button has its own switch.

Column and spacing controls apply to the feed layout. Review the carousel at your storefront's desktop and mobile widths.

For manual videos, use these URL formats with a real 11-character YouTube video ID:

https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/ABCDEFGHIJK
https://www.youtube.com/embed/ABCDEFGHIJK
https://www.youtube.com/shorts/ABCDEFGHIJK

The example ID is a placeholder. Replace it with an available video. The parser extracts the ID and builds the watch URL, embed URL, and img.youtube.com thumbnail URL. It requests YouTube oEmbed for the title and author. A valid parsed ID still produces a card if oEmbed fails, but the title/author can be empty and the thumbnail/player can fail.

For an automatic source, enter YouTube API Key plus Playlist ID or Channel ID. With a playlist set, the module uses the playlistItems endpoint. Otherwise it uses search for the channel’s videos ordered by date. It then requests videos details for durations and statistics. The result is capped at 25 per API request. If no API videos are returned, it falls back to manual URLs. It does not retry Channel ID after a failed playlist request.

Manual mode has no duration, view count, or publish date. API date display uses the date supplied by the selected source. You display one configured feed; the module has no per-product video assignments. A product page can show the same feed if its theme renders the selected hook.

In Player Mode embed, the module’s JavaScript intercepts the thumbnail link and opens a lightbox. It fills a YouTube iframe URL with autoplay=1&rel=0. Use the close button, click the backdrop, or press Escape to close it. Closing clears the iframe source and stops playback.

In newtab mode, the link opens the YouTube watch page in a new tab. With JavaScript unavailable, the thumbnail link also leads to YouTube, though JavaScript-based lazy thumbnails may remain unloaded. The module does not control the remote player’s availability, ads, or account/video restrictions. Test the specific videos you intend to use.

Feed thumbnails are requested directly by the visitor's browser from their source URLs; manual videos use img.youtube.com. In embed mode, clicking a video also loads a youtube.com iframe. Selecting newtab avoids the on-page player but does not remove thumbnail requests. Lazy loading and clicking to play are not consent checks; the supplied thumbnail and player code has no built-in consent gate.

The feed cache uses this local file:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Feed data is stored in one local JSON file per module installation, shared by shops using that directory. A storefront request fetches videos when the cache is missing or expired. No scheduled background worker refreshes this feed.

Use Clear Cache to delete the cached file. Saving the main settings also clears it. The next storefront request fetches fresh videos; existing cached content is not kept visible during that request.

Only nonempty results are saved. If retrieval fails or returns no videos, that request shows no feed and later storefront requests try again. An expired file may remain on disk, but its old videos are not served. API counts and relative dates reflect the cached response.

The examples below describe values to enter in the back-office forms. They are not shell commands. Replace account names, pin/video IDs, and credentials with real values. The theme hook must match Display Hook.

Manual product demo grid without an API key:

MPRYOUTUBE_ENABLED=1
MPRYOUTUBE_VIDEO_URLS=https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/LMNOPQRSTUV
https://www.youtube.com/shorts/WXYZabcdefg
MPRYOUTUBE_DISPLAY_HOOK=displayHome
MPRYOUTUBE_LAYOUT=grid
MPRYOUTUBE_POST_COUNT=3
MPRYOUTUBE_COLUMNS=3
MPRYOUTUBE_PLAYER_MODE=embed

Playlist slider with cached API fetching:

MPRYOUTUBE_ENABLED=1
MPRYOUTUBE_API_KEY=AIza...
MPRYOUTUBE_PLAYLIST_ID=PL...
MPRYOUTUBE_DISPLAY_HOOK=displayFooterBefore
MPRYOUTUBE_LAYOUT=slider
MPRYOUTUBE_POST_COUNT=6
MPRYOUTUBE_AUTO_SCROLL=1
MPRYOUTUBE_SCROLL_SPEED=4000
MPRYOUTUBE_CACHE_DURATION=3600

Accepted manual URL formats:

https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/ABCDEFGHIJK
https://www.youtube.com/embed/ABCDEFGHIJK
https://www.youtube.com/shorts/ABCDEFGHIJK

If your theme does not output the selected hook, add the matching PrestaShop hook call in the relevant Smarty template:

{hook h='displayFooterBefore'}

Theme CSS can target the module's storefront classes:

.mprfeed-youtube .mprfeed-title {
  font-size: 20px;
}

.mprfeed-youtube .mprfeed-follow-youtube {
  background: #cc0000;
}

.mprfeed-youtube .mprfeed-caption {
  min-height: 2.8em;
}

The feed cache uses this local file:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Keep CSS and template changes in your theme.

• If the section is absent, check Enable Module, the source fields, Show on Mobile, and the selected hook. The module returns no section when no items are available.
• Check that your theme calls displayHeader to load the stylesheet and JavaScript, and renders your selected display hook.
• If images remain blank, inspect browser network errors. Try disabling lazy loading and check the image URLs.
• If the layout is wrong, test the grid first, then verify the carousel at desktop and mobile widths.
• If MPR Social Revolution has its YOUTUBE_ACTIVE setting enabled, this standalone feed is suppressed. This check reads the saved flag; it does not require Social Revolution to be currently enabled as a module.

Open the module’s Integrity page for configuration and hook checks. License, Support, and Update are maintenance pages. Test the actual destinations after changing account identifiers or feed sources.

Set Enable Module to No and save to hide the feed while retaining its configuration. Uninstall through the module manager to remove this module’s configuration, local cache, and admin menu entries.