f4838865c9
Add 21 screenshots across the Elementor Tools docs and rework the pages around them: clearer opening lines, settings tables that state defaults, and callouts for the parts people trip over. Also refreshes the Pro getting-started, Custom Product Tabs and Product Filter pages, plus the matching marketing copy. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
53 lines
3.6 KiB
Markdown
Executable File
53 lines
3.6 KiB
Markdown
Executable File
# Keyword Linker
|
||
|
||
Turn chosen words into links automatically, across every post using a template.
|
||
|
||
Found in the Elementor panel under **Dotjuice → Keyword Linker**.
|
||
|
||
|
||
*Screenshot: the widget's **Keyword Links** repeater expanded, showing two or three keyword rows with their URL, Bold and Link all occurrences settings.*
|
||
|
||
## How it works
|
||
|
||
This widget renders nothing visible. It works in the background: it hooks into WordPress's content output, scans for the keywords you've defined, and converts matching occurrences into links. Add it once to a template that renders post content — a Single Post or Single Page Theme Builder template — and it applies to every post or page using that template.
|
||
|
||
That "invisible widget on a template" model is the part people trip over. You are not adding it to one article; you are adding it to the template all your articles share.
|
||
|
||
**Matching rules:**
|
||
|
||
- Only text inside paragraph (`<p>`) and heading tags is scanned. Text inside list items, tables, or custom block markup is left alone.
|
||
- Matching is **whole-word**, so `cat` will not match `category`.
|
||
- Matching is **case-insensitive**, and the matched text keeps its original capitalisation in the resulting link — you don't need to define both "Elementor" and "elementor".
|
||
- Text that is already inside a link is never re-linked, so you won't get nested anchors.
|
||
|
||
## Content settings — Keyword Links
|
||
|
||
A repeater. Add one row per keyword you want linked.
|
||
|
||
| Setting | Default | What it does |
|
||
|---|---|---|
|
||
| **Keyword** | — | The word or phrase to look for. Whole-word, case-insensitive. |
|
||
| **URL** | — | Where the link points. Supports Elementor's usual open-in-new-tab and nofollow options. |
|
||
| **Bold link text** | Off | Renders the generated link in bold. |
|
||
| **Link all occurrences** | Off | On: every match on the page is linked. Off: only the first few, capped by Max links. |
|
||
| **Max links** | 3 | Only shown when **Link all occurrences** is off. How many times this keyword may be linked on a single page (1–50). |
|
||
|
||
:::tip Why you usually want the cap
|
||
Linking every occurrence of a common word reads as spam to both visitors and search engines. The default of three is deliberate — it catches the keyword early in the article where it matters, and leaves the rest as plain text.
|
||
:::
|
||
|
||
## Setting it up
|
||
|
||
1. Open the Theme Builder template that renders your post content — typically **Single Post**. Do not add this to an individual page.
|
||
2. Drop the Keyword Linker widget anywhere on that template. Position is irrelevant; it renders nothing.
|
||
3. Add a row per keyword, each with its destination URL.
|
||
4. Decide per keyword whether to link every occurrence or cap it.
|
||
5. Save, then visit a post containing one of your keywords and confirm the link appears.
|
||
|
||
## Good to know
|
||
|
||
- **It must sit on a template that actually renders post content.** On a page with no post content being output there is nothing to scan, so nothing happens. This is the most common reason it appears not to work.
|
||
- **Links are only added inside `<p>` and heading tags.** If your target text lives in a list, table, or a custom block's markup, it won't be matched — move the text into a paragraph if you need it linked.
|
||
- **Keywords are matched independently.** If two keywords overlap in the same sentence, both can be linked; there's no ordering guarantee between them, so avoid defining a keyword that is a substring of another phrase you also link.
|
||
- Because it works on rendered output rather than stored content, removing the widget removes every generated link cleanly — your posts are never modified in the database.
|