Docs pass: add widget screenshots and expand the user guides
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>
This commit is contained in:
@@ -1,33 +1,52 @@
|
||||
# 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 doesn't display anything visible on the page itself — it works in the background, scanning your post and page content for the keywords you've defined and converting matching occurrences into links. Add it once to a template that renders post content (a Single Post or Single Page template), and it applies to every post/page using that template.
|
||||
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.
|
||||
|
||||
Matching happens inside paragraph and heading text only — text inside list items, tables, or other structural elements isn't scanned. Matching is whole-word and case-insensitive, and any text that's already part of an existing link is left alone.
|
||||
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 list; add one row per keyword you want linked.
|
||||
A repeater. Add one row per keyword you want linked.
|
||||
|
||||
| Setting | What it does |
|
||||
|---|---|
|
||||
| **Keyword** | The exact word or phrase to search for. Matches are whole-word only (so "cat" won't match "category") and case-insensitive. |
|
||||
| **Link** | The destination URL, with options to open in a new tab and/or add a "nofollow" attribute. |
|
||||
| **Bold** | Makes the generated link bold. |
|
||||
| **Link All Occurrences** | If on, every matching occurrence on the page gets linked. If off, only the first few (see Max Links below). |
|
||||
| **Max Links** | Only shown when "Link All Occurrences" is off. The maximum number of times this specific keyword gets linked per page (1–50, default 3). |
|
||||
| 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. Add the widget to a template that renders your post/page content (typically your Single Post or Single Page Elementor template — this is a "Theme Builder" style template in Elementor, not a specific individual post).
|
||||
2. Add a row for each keyword you want automatically linked, with its destination URL.
|
||||
3. Save and visit a post that contains one of your keywords — it should now appear as a link.
|
||||
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
|
||||
|
||||
- **This widget needs to sit on a template that actually renders post content** — placing it on a page with no post content being displayed does nothing, since it works by intercepting WordPress's content output.
|
||||
- The first occurrence of a keyword found in a matching heading or paragraph keeps its original capitalization in the resulting link — you don't need to match the exact case when defining the keyword.
|
||||
- Links are only ever added inside `<p>` and heading tags — if your target text lives inside a list, table, or custom block markup, it won't be matched.
|
||||
- **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.
|
||||
|
||||
Reference in New Issue
Block a user