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

The grid uses three columns at intermediate widths up to 991px and the mobile setting below 768px.

Column and spacing settings apply to the grid. The carousel uses its built-in column and spacing defaults. Check the carousel at your storefront widths; use the grid when you need the configured column counts.

You do not need a token or a business account for the public URL feed path. You choose each video manually. Entering a username does not import future account posts. The server calls https://www.tiktok.com/oembed?url=... for each accepted URL and skips failed responses. The storefront displays a thumbnail, play badge, optional caption/author, and optional follow link. Clicking opens the video on TikTok in a new tab. The module does not embed an in-page TikTok player.

The module stores retrieved items in:

modules/mprtiktokintegration/mprtiktok_feed_cache.json

The web-server process must be able to write this file in the module directory. Keep the normal owner/group permissions for your hosting setup. You do not need a cron task for feed display. A storefront request fetches data after the cache expires. Saving the main feed form clears the cache. The file is shared across this module’s shop contexts, rather than having a separate file per shop.

Saving the feed form clears the cache. The renderer has a case-sensitive cache refresh action. The spelling refreshMprTiktokCache is not accepted; the required parameter is refreshMPRTiktokCache. The supplied main form has no visible cache-clear button. Use Save, or have your administrator remove only the cache file.

Only non-empty fetch results are saved. An empty or failed fetch hides the feed and can be retried on later storefront requests. If items look stale, clear the cache after checking the source. API counts and relative dates reflect the cached response, not a live browser subscription.

The separate Automatic TikTok submission form contains:

The TikTok submissions panel requires MPR Blog Revolution. It offers Submit to TikTok and Check status. The state can be Not submitted, processing, Confirmation required in TikTok, Published, Blocked, or Failed. A returned publish ID means TikTok accepted a submission for processing. Use Check status before retrying. If the account requires confirmation, complete it in TikTok.

Feed display and publication are separate. The publisher sends one video URL to TikTok’s Content Posting API with PULL_FROM_URL and SELF_ONLY privacy. Its connection check currently requires a non-empty access token; the configuration map also includes the client key. The module does not provide an OAuth authorization flow here.

Blog submissions use the post’s featured image from img/mprblogrevolution/posts/, but TikTok publishing requires a video. An ordinary blog image cannot be published as a TikTok video. Keep automatic submission off until your installation supplies suitable video media.

Saving the main feed form processes the separate auto-submission keys too and can reset the switch/caption. Configure the feed first, then save the separate submission form and recheck it after future feed saves. The outbound-write policy can block development/staging or unresolved shop hosts. The panel reports that reason. The Social Revolution TikTok takeover flag also suppresses standalone publishing.

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.

Add public TikTok videos, one per line:

https://www.tiktok.com/@yourbrand/video/1234567890123456789
https://www.tiktok.com/@yourbrand/video/9876543210987654321
https://www.tiktok.com/@yourbrand/video/1122334455667788990

Homepage grid setup:

ENABLED=1
DISPLAY_HOOK=displayHome
TITLE=Watch us on TikTok
LAYOUT=grid
POST_COUNT=6
COLUMNS=3
MOBILE_COLUMNS=1
GAP=16
BORDER_RADIUS=8
SHOW_FOLLOW_BTN=1
FOLLOW_TEXT=Follow

Compact slider setup above the footer:

DISPLAY_HOOK=displayFooterBefore
LAYOUT=slider
POST_COUNT=6
COLUMNS=3
MOBILE_COLUMNS=1
AUTO_SCROLL=1
SCROLL_SPEED=5000
LAZY_LOAD=1
CACHE_DURATION=3600

Render the selected hook manually in a theme template when your theme supports Smarty hooks:

{hook h='displayHome' mod='mprtiktokintegration'}

Use the feed CSS classes in your theme stylesheet or custom CSS:

.mprfeed-tiktok .mprfeed-title {
  font-size: 24px;
}

.mprfeed-tiktok .mprfeed-grid {
  --mprfeed-gap: 20px;
}

.mprfeed-tiktok .mprfeed-follow-btn {
  border-radius: 4px;
}

Optional auto-publish caption template placeholders:

{title}

{excerpt}

Read more: {url}

Available placeholders for the publishing template:

{title}
{excerpt}
{url}
{shop_name}

For a carousel, verify the actual sizing limitation described above. 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 TIKTOK_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. The feed enable switch does not disable publishing. Also turn off the separate publishing switch if you use it. Save the publishing form after the main feed form. Uninstall through the module manager to remove this module’s configuration, local cache, and admin menu entries. Shared mpr_social_publish and mpr_social_queue tables are marked shared and are retained on uninstall. Uninstall does not delete posts already sent to the platform.