| 1 |
# WORDPRESS BEST PRACTICES |
| 2 |
|
| 3 |
Opinionated guidance for building WordPress sites with Elementor via MCP. Load before making structural decisions about pages, posts, and theme templates. |
| 4 |
|
| 5 |
## Widget selection: V4 + dynamic tag over V3 post-* widgets |
| 6 |
Title, featured image, excerpt, price, meta, CTA link → V4 widget (`e-heading`, `e-image`, `e-paragraph`, `e-button`) + a dynamic tag from [elementor://dynamic-tags]. Do NOT use the V3 `theme-post-title` / `theme-post-featured-image` / `theme-post-excerpt` widgets when a V4 + dynamic tag combination works — reserve them for cases where the V4 equivalent is not viable. This applies everywhere: singles, archives, loop items, and standalone pages. |
| 7 |
|
| 8 |
## Repeating layouts / detail pages |
| 9 |
When the user describes a design that repeats across posts or pages ("each project", "the product detail page", "make every blog post look like this", "each item links to a page like this"), that is ONE `single` / `single-<cpt>` template driven by dynamic data — NOT N duplicated pages. Never loop `elementor/manage-site-parts` `action: create` to make one page per item. |
| 10 |
|
| 11 |
### Condition scoping — include-all + exclude exceptions |
| 12 |
Real sites have one repeating design for a post type plus a few one-off exceptions (bespoke Home, a landing page). Default to a broad include with explicit exclusions: |
| 13 |
- Posts of a CPT: `include/singular/<cpt>` + `exclude/singular/<cpt>/<id>` per exception. Built-in posts use `post`; a `project` CPT uses `project`. |
| 14 |
- Pages: `include/singular/page` + `exclude/singular/page/<id>` for each page with its own design (Home, About, …). |
| 15 |
- Ask the user which items are the exceptions when it is not obvious, and call `elementor/list-site-parts` before creating a new single to avoid duplicates. |
| 16 |
- Fall back to `include/singular/<cpt>/<id>` only when the user is explicitly designing for one specific post. |
| 17 |
|
| 18 |
### Post Content slot pattern |
| 19 |
Every single template has one optional editorial slot: a `theme-post-content` widget wrapped in a full-width `e-div-block`, placed between the fixed hero and the fixed bottom section. Posts with no body render nothing in that slot; posts with body content render it there. |
| 20 |
|
| 21 |
```xml |
| 22 |
<e-div-block configuration-id="Post Hero">...</e-div-block> |
| 23 |
<e-div-block configuration-id="Post Body"> |
| 24 |
<theme-post-content configuration-id="Post Content"></theme-post-content> |
| 25 |
</e-div-block> |
| 26 |
<e-div-block configuration-id="Post Bottom">...</e-div-block> |
| 27 |
``` |
| 28 |
|
| 29 |
`theme-post-content` is the widget name. Emit `<theme-post-content>` in `xml_structure` with no `element_config` — the composition write path accepts it as-is. |
| 30 |
|
| 31 |
- Wrap with `e-div-block`, NOT `e-flexbox` — a row-direction default would squeeze the article body. Style the wrapper's `max-width` / `padding`. |
| 32 |
- Exactly one `theme-post-content` per single template. |
| 33 |
- `theme-post-content` is for the single-template body slot ONLY — never place it inside a loop item, archive, header, footer, or reusable component; the surrounding loop already repeats the article body. |
| 34 |
|
| 35 |
### Dynamic tags for the rest |
| 36 |
Title, featured image, excerpt, meta, price, CTA link all use dynamic tags on regular widgets (`e-heading` title, `e-image` src, `e-button` link). Read [elementor://dynamic-tags] for allowed tag names. Do NOT hard-code per-post values — the same template renders every post. |
| 37 |
|
| 38 |
### Loop → detail flow |
| 39 |
For a listing (loop) whose items link to a detail page: build the loop with a dynamic link on the item wrapper, then create ONE single template as above with `include/singular/<cpt>` + any exclusions. Permalinks come from the dynamic tag; no per-item page. |
| 40 |
|
