Total 5.6.1 introduced new “Dynamic Variables” which can be used when adding text within elements or in certain theme settings (such as custom page titles) to display non-static text. For example lets say you are creating a dynamic template and you want to display the page title with the date in the format “Page Title – Published Date” the dynamic variables will allow you to do this via the Heading element like such:
Available Dynamic Variables
Belo is a table showing the variables currently available in the theme and what they can be used to display.
| Variable name | Return value |
|---|---|
{{post_id}} |
Current post id. |
{{post_author}} |
Current post author name. |
{{post_date}} |
Current post publish date. |
{{post_modified}} |
Current post last modified date. |
{{post_title}} |
Current post title. |
{{post_slug}} |
Current post slug. |
{{post_rating}} |
Current post rating. |
{{permalink}} |
Current post url. |
{{title}} |
Current title (post or archives). |
{{taxonomy}} |
Current taxonomy name. |
{{term_name}} |
Current taxonomy term name. |
{{term_id}} |
Current taxonomy term id. |
{{post_count}} |
Number of posts in current archive. |
{{category}} |
Current post primary category. |
{{primary_term_id}} |
Returns the post primary term id. |
{{paged}} |
Displays the paged text for paginated pages. |
{{acf_KEY}} |
Returns ACF value where KEY is your acf field key or name. |
{{cf_KEY}} |
Returns Custom field value where KEY is your custom field key. |
How to Add Custom Variables?
Yes, it’s possible to add your own custom replacement variables using the “wpex_replacement_vars” filter.
Let’s say there is a specific string of text you need to use in many places on your site, by defining a custom variable you can make sure that this string can be modified globally.
View the example snippet here.