Choose Once Per Page Request or Every Occurrence for a QCDR PHP Token

Default request-local reuse versus repeated execution at actual Token locations/Rule matches, side-effect risks, caching of result/failure state, and selection guidance.

This guide follows the accepted QC Dynamic Replacer 1.1.05 implementation and applies to Max / All Access + Manage PHP Tokens ACL. Where older manuals or walkthrough wording differs from the current source or the accepted keyless-entitlement behavior, the current implementation takes precedence.

Before You Begin

  • Use least privilege: PHP Tokens require both Max/All Access and the dedicated Manage PHP Tokens ACL.
  • Test dynamic data in the exact Joomla context that provides the requested record/user/menu/article.
  • Treat PHP as trusted server-side code; QCDR does not sandbox it.

Step-by-Step Workflow

  1. Confirm plan and Joomla ACL requirements for the dynamic/PHP capability.
  2. Choose a narrow source/context or test page.
  3. Configure the data/PHP Token and save it without broad deployment.
  4. Test the exact Joomla request context that supplies the value.
  5. Review privacy, caching, failure behavior, and side effects before wider use.

Default request-local reuse versus repeated execution at actual Token

Current new-Rule Find choices focus on rendered output: Anything/detect automatically, Text, HTML, CSS, JavaScript, PHP-like rendered source, and URL or image/media references. Matching can be exact/whole-term or partial, optionally case-sensitive, and can target All, First, Last, or a Specific occurrence. A per-Rule maximum can further bound replacements; 0 means no additional Rule-specific cap, while the global request ceiling in Settings still applies. Retired JSON/XML/INI Find choices and Count Only are not current new-Rule workflows.

For Choose Once Per Page Request or Every Occurrence for a QCDR PHP Token, evaluate this against the exact frontend request that matters. A saved QCDR item can be valid in Administrator yet remain inactive because a different eligibility gate, dependency, permission, cache layer, or runtime safety boundary correctly prevents transformation. Keeping those concerns separate makes both testing and later support much easier.

Side-effect risks

Current new-Rule Find choices focus on rendered output: Anything/detect automatically, Text, HTML, CSS, JavaScript, PHP-like rendered source, and URL or image/media references. Matching can be exact/whole-term or partial, optionally case-sensitive, and can target All, First, Last, or a Specific occurrence. A per-Rule maximum can further bound replacements; 0 means no additional Rule-specific cap, while the global request ceiling in Settings still applies. Retired JSON/XML/INI Find choices and Count Only are not current new-Rule workflows.

For Choose Once Per Page Request or Every Occurrence for a QCDR PHP Token, evaluate this against the exact frontend request that matters. A saved QCDR item can be valid in Administrator yet remain inactive because a different eligibility gate, dependency, permission, cache layer, or runtime safety boundary correctly prevents transformation. Keeping those concerns separate makes both testing and later support much easier.

Caching of result/failure state

Current new-Rule Find choices focus on rendered output: Anything/detect automatically, Text, HTML, CSS, JavaScript, PHP-like rendered source, and URL or image/media references. Matching can be exact/whole-term or partial, optionally case-sensitive, and can target All, First, Last, or a Specific occurrence. A per-Rule maximum can further bound replacements; 0 means no additional Rule-specific cap, while the global request ceiling in Settings still applies. Retired JSON/XML/INI Find choices and Count Only are not current new-Rule workflows.

And selection guidance

Current new-Rule Find choices focus on rendered output: Anything/detect automatically, Text, HTML, CSS, JavaScript, PHP-like rendered source, and URL or image/media references. Matching can be exact/whole-term or partial, optionally case-sensitive, and can target All, First, Last, or a Specific occurrence. A per-Rule maximum can further bound replacements; 0 means no additional Rule-specific cap, while the global request ceiling in Settings still applies. Retired JSON/XML/INI Find choices and Count Only are not current new-Rule workflows.

How This Fits into QCDR

Dynamic/PHP Tokens run inside the Joomla request context. Access checks, targeting, execution mode, and failure behavior matter as much as the code/value itself.

The safest operating pattern is to keep configuration narrow, use QCDR’s private diagnostics before broad activation when your tier permits them, and preserve Joomla Administrator as the recovery surface. Because QCDR changes the rendered response rather than source files, a correctly disabled or bypassed runtime path should expose the underlying Joomla output again without requiring a source-file rollback.

Verify the Result

  • The Rule state and drag order are exactly what you intended.
  • A page that should match changes as expected, and a page outside scope remains unchanged.
  • The Token resolves where it is eligible and preserves authored content where it is intentionally unavailable.
  • Reference/dependency behavior is understood before deleting or downgrading a Token.
  • The current account has Manage PHP Tokens and the Effective tier permits PHP.
  • Normal production error mode is Hide unless a temporary sanitized diagnostic is intentionally active.
  • Reload the real frontend request instead of relying only on the saved Administrator form.

Common Mistakes to Avoid

  • Assuming an unavailable Token should become an empty string; QCDR often preserves the original placeholder or Rule match intentionally.
  • Treating PHP Tokens as sandboxed snippets or granting Manage PHP Tokens more broadly than necessary.
  • Changing several gates at once during troubleshooting, which makes the actual cause difficult to identify.
  • Testing only while signed in as Super User when ordinary users/guests are the intended audience.
  • Skipping a recovery plan before enabling a site-wide HTML, JavaScript, protected-area, or PHP-backed change.

Troubleshooting

  • If nothing changes, confirm the package-owned System plugin is enabled, the relevant Live Processing switch is on, and the item is eligible for the current Effective tier.
  • If targeting appears wrong, inspect page/menu/URL, extension, audience, schedule, IP, technical conditions, and protected-region behavior as separate gates.
  • If a Token-backed Rule preserves the original match, troubleshoot the Token dependency/readiness before changing the Find value.
  • If behavior differs between browsers/users, clear or bypass relevant Joomla/full-page/CDN caches and compare request context.
  • If private Preview/Discovery fails, start a fresh authorized same-site session and confirm the Joomla ACL action as well as the product tier.

Operational Best Practice

Make runtime changes deliberately: use a narrow scope first, keep broad Rules Draft or Disabled until tested, preserve the independent Rule/Token emergency switches, and record the QCDR version plus the exact Rule/Token and affected URL when handing a problem to another administrator. For high-impact HTML, protected-region, JavaScript, dynamic-data, or PHP work, test representative anonymous and authenticated requests and review caching before expanding scope.

Community Discussion

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