Reconciled Word (v1 & v2) WordPress Plug-in

---

Quick Reference

---

1. Purpose

Render a Reconciled Word entry (Etymology–Polarity Object / EPO) with:

• Dual polarities: A and B
• Four divisions: Literal, Metaphorical, Allegorical, Collective

---

2. Key Differences

Feature	Version 1 (Shortcode)	Version 2 (Block + Shortcode)
Shortcode	[reconciled_word]	[reconciled_word_v2]
Gutenberg Block	❌	✅ “Reconciled Word v2”
Delegates to v1	N/A	✅ if v1 is active
Internal Renderer	✅	✅ (used if v1 is inactive)
Data Schema	EPO JSON	EPO JSON (same schema)
Data Location	data/epo_seed.json (default)	data/epo_seed.json (default)
Coexistence	—	Works alongside v1

---

3. Shortcode Syntax

v1:

[reconciled_word term="TERM" show="all" data="data/epo_seed.json"]

v2:

[reconciled_word_v2 term="TERM" show="all" data="data/epo_seed.json"]

Attributes (both versions):

• term (required) – Matches "term" in JSON.
• show (optional) – all (default) or literal | metaphorical | allegorical | collective
• data (optional) – Relative path to JSON file inside plugin folder.

---

Examples (either version):

[reconciled_word term="Fear of the Lord" show="all"]

[reconciled_word term=”Wisdom” show=”literal”]

[reconciled_word_v2 term=”Truth” show=”metaphorical” data=”data/epos_philosophy.json”]

---

4. Gutenberg Block (v2 only)

Block name: “Reconciled Word v2”

Sidebar settings:

• Term: Text entry.
• Show section: Dropdown – all, literal, metaphorical, allegorical, collective
• Data file: Optional JSON file path (relative to plugin).

Front-end rendering:

• If v1 active → uses v1 renderer.
• If v1 inactive → uses v2 internal renderer.

---

5. Data Schema (EPO JSON)

Example entry:

{
  "term": "Fear of the Lord",
  "definition_reconciled": "Filial, reverent awe before the Holy that orders cognition, affection, and will, excluding cowardly dread while preserving moral gravity.",
  "polarities": {
    "A": "Fear/Terror (boundary honesty)",
    "B": "Awe/Reverence (attraction to holiness)"
  },
  "units": {
    "tokens": ["Fear","of","the","Lord"],
    "source_languages": ["Hebrew","Greek","Latin","English"]
  },
  "divisions": {
    "literal": ["Heb. yirʾāh / yārēʾ; Gk. phobos/eulabeia; Lat. timor (filialis vs servilis)"],
    "metaphorical": ["holy ground", "fire/light", "throne/majesty"],
    "allegorical": ["beginning of wisdom", "covenant fidelity"],
    "collective": ["honor (kavod)", "piety (eusebeia)", "cowardice (rejected)"]
  },
  "provenance": {
    "canon": "Holy Bible",
    "languages": ["Hebrew","Greek","Latin","English"]
  }
}

---

6. Styling (both versions)

Optional CSS (Customizer → Additional CSS):

.rw-entry {
  background: #fff;
  border: 1px solid #e5e5e5;
  border-radius: 12px;
  padding: 16px;
}
.rw-entry h3 { margin-top: 0; }
.rw-entry details { margin: 8px 0; }
.rw-entry summary { cursor: pointer; font-weight: 600; }

---

7. Coexistence Rules

• v1 and v2 can both be active.
• Use v1 shortcode for existing content.
• Use v2 block (or its shortcode) for new content.
• v2 automatically delegates to v1’s rendering if v1 is active.

---