Breakdance
2 min read
With Breakdance 1.x or 2.x active, three dynamic data entries read your fields. They are free. Oxygen 6 runs on the Breakdance engine and uses the same entries.
Entries
In any Breakdance setting that supports dynamic data, open the dynamic data picker and choose from the category WPM Fields:
Entry | Type | Used for | What it prints |
|---|---|---|---|
Field value | text | Headings, text, any text setting | The field's value as escaped plain text |
Field URL | URL | Link and button targets | The field's URL (a Link field's address, a URL, |
Field image | image | Image elements and backgrounds | The image of an Image field, or the first image of a Gallery, handed to Breakdance as an attachment so it builds sizes and |
Every entry has one control, Field, a dropdown of "Field group › Field" entries that fit the entry's type:
Entry | Fields offered |
|---|---|
Field value | Every field with a value except Password and layout fields |
Field URL | URL, Link, Email, File, Image, Page link, Post object, oEmbed |
Field image | Image and Gallery |
Without a chosen field, or when the field is empty, the entry prints nothing (an empty image for Field image).
Which post is read
The current post of the page or template Breakdance renders. Options page groups need no post. The entries do not read other posts by id.
Escaping
Breakdance prints text data as it is, so the plugin escapes the value for HTML before handing it over. URLs are cleaned as URLs (allowed protocols only, no quotes or angle brackets).
Troubleshooting
- The WPM Fields category is missing. Breakdance must be active and provide its dynamic data API (1.x or 2.x). The entries register on WordPress
init. - An entry prints nothing. The field is empty on that post, the dropdown has no field chosen, or the field is a Password.
- An element shows an empty image. The Image or Gallery field has no image that is still in the media library.
Still stuck? Contact support