34 lines
2.4 KiB
Markdown
Executable File
34 lines
2.4 KiB
Markdown
Executable File
# Keyword Linker
|
||
|
||
Found in the Elementor panel under **Dotjuice → Keyword Linker**.
|
||
|
||
## 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.
|
||
|
||
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.
|
||
|
||
## Content settings — Keyword Links
|
||
|
||
A repeater list; 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 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.
|
||
|
||
## 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.
|