meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
public:condition_toc_resolution [2026/06/30 14:37] – external edit 127.0.0.1public:condition_toc_resolution [2026/07/08 23:38] (current) – doreps
Line 2: Line 2:
 ====== Condition Plugin, Include Plugin, and TOC Interaction (Resolution – April 2026) ====== ====== Condition Plugin, Include Plugin, and TOC Interaction (Resolution – April 2026) ======
  
-This page documents the resolution of a cascading Table of Contents issue that occurred when using the Condition plugin together with the Include plugin on a PHP 8 environment. It is published for the benefit of other administrators who may encounter similar behavior.+This page documents the resolution of a cascading Table of Contents issue that occurred when using the Condition plugin alongside the Include plugin in a PHP 8 environment. It is published for the benefit of other administrators who may encounter similar behavior.
  
 ~~NOCACHE~~ ~~NOCACHE~~
Line 8: Line 8:
 ===== Summary ===== ===== Summary =====
  
-A page that used the Condition plugin to display a time‑based announcement behaved correctly on a local DokuWiki installation, but produced duplicated and cascading TOC entries when deployed on a shared hosting environment. The issue was reproducible only when the Condition plugin and an Include block were placed near the top of the page, causing the parser to misinterpret heading boundaries.+A page that used the Condition plugin to display a time‑based announcement behaved correctly on a local DokuWiki installation but produced duplicate and cascading TOC entries when deployed to a shared hosting environment. The issue was reproducible only when the Condition plugin and an Include block were placed near the top of the page, causing the parser to misinterpret heading boundaries.
  
 The root cause was a combination of: The root cause was a combination of:
Line 19: Line 19:
   * The final finding that an Include block is safe only when placed at the very top of the page, before all headings, where it is evaluated during the pre‑parse stage rather than during TOC assembly     * The final finding that an Include block is safe only when placed at the very top of the page, before all headings, where it is evaluated during the pre‑parse stage rather than during TOC assembly  
  
-After applying PHP 8 compatibility fixes and restructuring the page so that the Include banner appears as the first element on the page—above the page title and before any headings—the TOC stabilized and the Condition plugin behaved consistently across environments.+After applying PHP 8 compatibility fixes and restructuring the page so that the Include banner appears as the first element on the page—above the page title and before any headings—the TOC stabilized, and the Condition plugin behaved consistently across environments.
  
 ===== Environment ===== ===== Environment =====
Line 64: Line 64:
 ===== Temporal Conditions ===== ===== Temporal Conditions =====
  
-The Condition plugin’s ``time`` test accepts full date and time formats. A ``date`` test has been added locally and mirrors the same logic.+The Condition plugin’s ``time`` test accepts full date-and-time formats. A ``date`` test has been added locally and mirrors the same logic.
  
 Examples:\\  Examples:\\ 
Line 89: Line 89:
 ===== Resolution ===== ===== Resolution =====
  
-After applying the PHP 8 fixes, adding the ``date`` test, and restructuring the page so that the Include banner appears as the first element on the page, the TOC now renders correctly and the Condition plugin behaves consistently across environments. This placement ensures that conditional and included content is fully evaluated before DokuWiki constructs the TOC, preventing cascading, duplication, and frozen heading states across all tested environments.+After applying the PHP 8 fixes, adding the ``date`` test, and restructuring the page so that the Include banner appears as the first element on the page, the TOC now renders correctly, and the Condition plugin behaves consistently across environments. This placement ensures that conditional and included content is fully evaluated before DokuWiki constructs the TOC, preventing cascading, duplication, and frozen heading states across all tested environments.
  
 <WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP> <WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP>
 ~~DISCUSSION~~ ~~DISCUSSION~~