Configuration
Debug Mode
Twig debugging allows use of dump() to inspect Twig variables.
It becomes active when:
- WordPress debug mode (
WP_DEBUG) is enabled, or ICDS_TWIG_DEBUG = true.
Template Caching
Caching improves Twig template rendering performance.
Enable it with (Advanced settings in DataPress Admin Area):
ICDS_TWIG_CACHE = true
Mobile Device Detection
DataPress exposes MobileDetect helpers in Twig:
isMobile: {% if isMobile %}Yes{% else %}No{% endif %}
isChrome: {% if isChrome %}Yes{% else %}No{% endif %}
isFirefox: {% if isFirefox %}Yes{% else %}No{% endif %}
Intellisense hints are available when typing {{ inside a Dataverse Twig block.
Date/Time Mode
Your Dataverse ICDS_DATETIME_VALUE setting controls how date columns behave:
- Legacy
- UTC
- Local
Different fields (e.g., User Local) adjust their output accordingly.
Use format_datetime() for consistent locale/timezone formatting.
Examples for the createdon column which has User Local behavior:
| Legacy | UTC | Local | |
|---|---|---|---|
{{record.createdon}} | UTC | UTC | convert the date and time to the user's timezone |
{{record.createdon_utc}} | UTC | UTC | UTC |
{{record.createdon_local}} | convert the date and time to the user's timezone | convert the date and time to the user's timezone | convert the date and time to the user's timezone |
Timezone & Locale Sources
- user.timezone / user.locale
- site.timezone / site.locale
These follow the IANA timezone format (e.g., Europe/Paris, UTC).
Request Context
Object request contains information about the current request. It has the following members:
params-- merged map of cookies, POST form values and GET query argumentspath-- relative page URLpath_and_query-- relative page URL with query argumentsquery-- query arguments, start with?if not emptyurl-- full request URL
Global object params is the alias of request.params.
Dataverse Connection Status
{% if crm.connected %}
Dataverse connection active
{% endif %}
Twig Page Rendering
DataPress supports rendering entire pages as unified Twig templates instead of disconnected blocks, enabling seamless conditional logic and visual editing. Learn about the different rendering modes (No Twig, Page Content and Title, Entire HTML), their advantages, and best practices to avoid issues with third-party plugins that may break Twig syntax. Read more