Initial commit: Docusaurus docker stack and docs
This commit is contained in:
33
docs/dotjuice-elementor-tools/widgets/keyword-linker.md
Executable file
33
docs/dotjuice-elementor-tools/widgets/keyword-linker.md
Executable file
@@ -0,0 +1,33 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user