Recover Quickly from a QCDR Rule or Token That Breaks Frontend Output

A bad rendered-output replacement should not require uninstalling QC Dynamic Replacer. QCDR keeps Joomla Administrator outside normal Rule processing, provides a Super User emergency bypass, and lets you stop Rule and Token live processing independently while preserving saved configuration.

Use the narrowest recovery action that restores the site, then correct the item in Draft/disabled state and Preview it before re-enabling live behavior.

Fastest Recovery Sequence

  1. If the affected frontend page is usable enough to reach, retry it as a logged-in Super User with qcdr_bypass=1.
  2. Open Components > QC Dynamic Replacer in Joomla Administrator. Normal QCDR Rules do not process Administrator output.
  3. If you know the offending Rule or Token, disable that item first.
  4. If you do not know which item is responsible, turn off the relevant Live Processing switch: Rules on the Rules tab, Tokens on the Tokens tab.
  5. If necessary, turn both live-processing switches off to stop all normal QCDR runtime changes while you investigate.

Understand the Two Live-Processing Switches

Turning off Rule Live Processing stops normal live Rules but does not disable standalone Tokens. Turning off Token Live Processing stops standalone Token resolution and causes Token-dependent Rules to remain unapplied, while direct-value Rules can still run.

Turning a live switch off preserves the saved Rules, Tokens, targeting, schedules, PHP, and notes. It is a runtime stop, not a delete/reset operation.

Identify the Offending Item

Start with the most recent change. For a Rule, review its find value, occurrence mode, targeting, replacement source, Stop Processing, protected-area option, and Target Fingerprint. For a Token, review its state, output type, targeting, dependencies, and—in the case of PHP—the custom code/error mode.

Use Preview & Rule Health for saved Rules when your current plan/ACL permits it. Preview can test a saved Draft or Disabled Rule without publishing it to visitors.

Repair Without Losing Configuration

  1. Keep the item Disabled/Draft while correcting it.
  2. Narrow targeting and replacement scope before broadening it again.
  3. Preview representative pages, including pages where the Rule should not match.
  4. Re-enable the item, then re-enable the corresponding Live Processing switch if you disabled it globally.
  5. Retest the clean frontend URL without qcdr_bypass=1.

If the Problem Persists with Both Live Switches Off

If QCDR Rule and Token Live Processing are both disabled and the same broken HTML is still being served, check Joomla/full-page/CDN caches. A cached transformed response can outlive the request that originally produced it. Purge or bypass that cache and test again.

If the failure affects Joomla Administrator itself, investigate a broader Joomla/PHP/plugin installation issue; normal rendered-output Rules are frontend-only.

Community Discussion

Want to compare workflows, share practical tips, or discuss how you use this QCDR feature? Visit the QC Dynamic Replacer Community. For private support, bug reports, account-specific issues, or feature requests, use the QuantaCade support system.