Configuration Guide for Cross-Linking Extension

Displays the current module version and checks for available updates. Use this to stay up-to-date with the latest features and bug fixes.

Master switch for the entire module. When disabled, no cross-links are inserted anywhere on the store, regardless of other settings.

Match keywords regardless of capitalization. When enabled, a rule for "Yoga" will also match "yoga", "YOGA" and "yOgA" in your content.

When to enable:

• Your content has inconsistent capitalization
• You want broader matching without creating duplicate rules

When to disable:

• You need exact case matching (e.g., brand names like "iOS" shouldn't match "IOS")

Turn cross-linking on or off specifically for product pages. When enabled, the module scans product descriptions and short descriptions for matching keywords.

The maximum number of cross-links to insert on a single product page. Once this limit is reached, no more keywords are replaced — even if there are more matching rules.

Recommended:

• Start with 5-10 for standard product pages
• Use lower values (2-3) for pages with short descriptions
• Higher values (15-20) for content-heavy product pages

Turn cross-linking on or off specifically for category pages. When enabled, the module scans category descriptions for matching keywords.

The maximum number of cross-links to insert on a single category page.

Recommended:

• Start with 5-10 for categories with description text
• Keep in mind that category descriptions are often shorter than product descriptions

Turn cross-linking on or off specifically for CMS pages. When enabled, the module scans CMS page content and CMS block content for matching keywords.

Important: This only works on content rendered through Magento's CMS template filter. Content hardcoded in .phtml template files (like the Hyva default homepage hero) is not affected.

The maximum number of cross-links to insert on a single CMS page.

Recommended:

• Start with 5-10 for standard content pages
• Blog-style pages with lots of text can use higher values (10-20)

The word or phrase to match in content. Uses word boundary matching — "yoga" matches the word "yoga" but not "yogalicious" or "ayoga".

The link target. Can be a relative URL (e.g., /collections/yoga.html) or absolute URL (e.g., https://example.com/yoga).

Optional title attribute on the anchor tag. Shows as a tooltip on hover in most browsers.

Optional CSS class added to the anchor tag. Useful for styling cross-links differently from regular links.

Link target attribute (_blank, _self, etc.). Leave empty for default behavior (opens in same window).

Maximum number of times this specific keyword is replaced per page. Set to 0 for unlimited (will replace every occurrence up to the page-level max).

Recommended:

• 1 for most keywords — avoid over-linking the same word
• 0 (unlimited) only for very important keywords on content-heavy pages

Add rel="nofollow" to the generated link. Use this for links that shouldn't pass link equity.

When to use:

• External links
• Affiliate links
• Links to non-essential pages

Higher priority rules are processed first. When multiple rules could match overlapping text, the higher priority rule wins. Rules with the same priority are sorted by keyword length (longer keywords first).

Example:

• "yoga mats" (priority 10) matches before "yoga" (priority 5)
• Both "yoga mats" and "yoga" with same priority — "yoga mats" wins because it's longer

Which store views this rule applies to. Select "All Store Views" to apply everywhere, or select specific stores for targeted rules.

Enable or disable individual rules without deleting them.

Enable detailed logging for troubleshooting. Logs which keywords are replaced, how many times, and on which store.

When to enable:

• Setting up for the first time
• Troubleshooting why a keyword isn't being replaced
• Verifying replacement counts

When to disable:

• Production environments after verification
• Logs are getting too large

Run diagnostic tests on your configuration. Checks module status, PHP version and Magento compatibility.