Automatic Internal SEO Linker: setup and help

Upload the ZIP in Modules > Module Manager > Upload a module. Install it and click Configure. Open Improve > Internal SEO Linker for Dashboard, Link Groups, and Settings > Configuration. Configure opens the configuration screen.

Its final-page processing uses actionOutputHTMLBefore on PrestaShop 1.7.1 and later, with displayHeader and a Smarty output filter on older supported cores. It skips AJAX and non-HTML responses. The final-page engine needs a body section. Verify the result on your core and theme.

For PrestaShop 1.6 and 1.7.0, the module uses a legacy fallback: displayHeader registers a Smarty output filter, which waits for an assembled page containing opening and closing body tags before applying link insertion once. On PrestaShop 1.7.1 and later, it uses the available final-output hook. The legacy path therefore needs the theme to call displayHeader. Both paths change the rendered response rather than saving edited descriptions or changing theme template files.

Use small positive limits for your first rule. Save and inspect output before increasing them.

In Display, set these fallbacks. A group's selected content zones take precedence over its advanced selectors, which take precedence over global selectors.

Advanced matching supports simple selectors: .class, #id, tag, tag.class, and tag#id. Do not assume a browser's full CSS selector syntax is available. Built-in zones can include additional predefined theme patterns.

In Exclusions, review:

Excluded CMS selections are stored in a shape such as {"cms":[3,4,6]}. Use the form rather than editing storage directly.

Open Link Groups and add one narrowly scoped group.

When an entity destination resolves successfully, its current-language entity URL takes precedence over the manual URL language override. To control a destination entirely with manual language URLs, leave Target Entity empty.

For example:

Name: Shower trays
Target URL: /12-shower-trays
Keywords: shower tray, shower trays, walk-in shower tray
Content Zones: Product description (long), Product short description
Page Types: product
Max links from this group: 1
Ignore case: Yes
Active: Yes

Keyword syntax supports * within a term and | alternatives:

shower tray, walk-in shower tray, shower*, seo|search engine|SEO tool

The wildcard matches non-whitespace characters within the term. It is not a wildcard for arbitrary text across words.

Save the group, then open a page with a matching phrase in the selected zone. Inspect the link's destination, text, target, rel, and class. Check an excluded page and a page without the phrase.

Existing anchors are skipped. Existing links to the same target reduce that group's positive limit. Saved product, category, CMS, and blog descriptions remain unchanged because insertion happens during rendering.

A generated link can look like:

<p>Choose a <a href="/12-shower-trays" class="mpr-autolink">shower tray</a> for your bathroom.</p>

With group attributes enabled:

<a href="/12-shower-trays" target="_blank" rel="noopener" class="internal-seo-link"><strong>shower tray</strong></a>

You can style automatic links in your theme:

.mpr-autolink {
  text-decoration: underline;
  text-underline-offset: 2px;
}

The dashboard reports groups, keywords, zone and entity usage, recent groups, and catalog coverage. It does not verify every possible source page.

Use Import CSV or Export CSV on Link Groups. Import creates new records. It does not update existing groups by name, so importing an export again can create duplicates. Choose the intended shop context before importing.

Required columns:

name,target_url,keywords

Full exported columns:

name,target_url,keywords,link_position,max_links,ignore_case,add_strong,link_target,link_rel,link_class,content_zones,page_types,entity_type,entity_id,position,active

Example:

Shower trays,/12-shower-trays,"shower tray, shower trays, shower*",first,1,1,0,_self,,mpr-autolink,"[""product_description""]","[""product""]",category,12,10,1

Use a lowercase .csv extension and comma delimiters. Check imported and skipped counts. This export format does not include translated keyword/URL overrides or every advanced field, so keep a database backup if you need a complete restore.

For missing links, check Active, current language, target resolution, page type, zone selectors, eligible parent tags, and both limits. Check whether the target is the current URL or already linked enough times. A keyword split across HTML elements may not match one text segment.

Enable Enable debug profiling and enter your IP in Debug IP addresses. Inspect page source near the closing body tag for MPR Internal Linking Debug v2.0, page type, existing link count, generated link count, and group matches. Debug responses are marked private and no-store. Turn debug off when finished.

Use Settings > Integrity for infrastructure checks. Refresh any relevant page cache after edits.

Disable groups or the module to stop insertion temporarily. Uninstall removes its admin menu, settings, preferences, and link-group storage. Export or back up groups first. Your saved catalog and CMS text remains unchanged.