Custom Fields

Under WP-ImmoMakler → Settings → Custom Fields you configure any WordPress post meta field as custom property data. The fields are then available for manual selection in all theme builder widgets (Elementor, Bricks, Divi, WPBakery) and can be shown automatically in the Classic skin between the general property data and the price data.

What are custom fields for?

Property portals such as FlowFact or Propstack, and individual import scripts, frequently write additional data into WordPress post meta fields that WP-ImmoMakler does not know out of the box. The “Custom Fields” feature lets you bring those fields into the property display without any programming.

Typical use cases:

• The length of a swimming pool (flaechen-user_defined_simplefield-laenge_swimmingpool)
• The number of underground parking spaces from a custom import field
• Internal reference numbers that are meant to appear in the property brochure

Adding a field

1. In the back end of your website (wp-admin), open WP-ImmoMakler → Settings → Custom Fields.
2. Click + Add field.
3. Fill in the row:

Column	Description
Meta key (post_meta)	Technical key name of the WordPress post meta field, e.g. flaechen-user_defined_simplefield-laenge_swimmingpool. Mind upper and lower case; no spaces.
Name	The label shown in the front end, e.g. “Pool length”.
Show automatically	When active, the field is shown automatically in the Classic skin between the general property data and the price data, provided a value exists.

4. Click Save in the row.

Tip

You find a field’s meta key in the data view of your properties. In the back end of your website (wp-admin), go to WP-ImmoMakler → Properties and click “Edit” on the property in question. All meta keys are listed there with their values.

Adopting fields from onOffice

If you transfer your properties via the onOffice API, a selection Custom fields from onOffice additionally appears below the table. It lists the individual fields you created yourself in onOffice, with their onOffice label, grouped by the onOffice area they belong to (e.g. features, prices or additional).

1. Choose the field you want and click Adopt.
2. WP-ImmoMakler creates a new row with the matching meta key and the label from onOffice. Adjust the label if needed and enable Show automatically if the field should appear in the Classic skin.
3. Click Save in the row.

From the next sync onwards, the onOffice API transfers the values of this field. WP-ImmoMakler prepares the values in a readable form: selection fields appear with their onOffice label, dates in the format DD.MM.YYYY, and a yes/no field appears only if it is ticked in onOffice. Empty number and date fields are not transferred.

If you remove such a field from the table again, it is no longer retrieved at the next sync.

Note

The selection contains only the individual fields of your onOffice installation, not the standard onOffice fields. Notes and separator lines that you created in onOffice do not appear because they contain no value. The list of fields is refreshed from onOffice once a day, so a newly created field may take up to a day to become available.

Editing or deleting a field

• Edit: Click Edit in the field’s row, change the values and click Save again.
• Delete: Click the red bin icon next to the field. The field is removed immediately and all remaining fields are saved.

Display in the front end

Classic skin (automatic)

If Show automatically is enabled for a field, it appears in the detail view between the general property data and the price data — provided the property in question has a value for that meta key.

Theme builder widgets (manual)

All configured custom fields are available for manual selection in the following widgets:

Theme builder	Widget / element
Elementor	Dynamic tag “Property: Value”, dynamic tag “Property: Name”, widgets Data Boxes, Single Data, Archive Inline List, Icon List, Display Condition
Bricks	Elements Data Boxes, Single Data List
Divi	Modules Single Data Boxes, Single List
WPBakery	Elements Data Boxes, Single Data

Value formatting

WP-ImmoMakler converts boolean raw values into readable terms automatically:

Raw value in post_meta	Display in the front end
true, yes, ja, on, y, j	Yes
false, no, nein, off, n	No

All other values are shown unchanged.

Relationship to OpenImmo user_defined_simplefields

WP-ImmoMakler imports OpenImmo user_defined_simplefield values automatically and displays them if the option Show custom OpenImmo-Fields automatically is active in the back end of your website (wp-admin) under Appearance → Customiser → WP-ImmoMakler → Property Detail View. If you additionally configure such a field under “Custom Fields”, it appears only once — controlled by the configuration under “Custom Fields”, no longer as an automatic user_defined_simplefield.

Note

The option “Show custom OpenImmo-Fields automatically” (Customiser) and “Custom Fields” complement each other: the former displays all imported OpenImmo extra fields automatically; the latter gives you full control over the label and visibility of individual fields.

---

You might also be interested in

• Settings: General
• Customising the detail view
• Settings: Theme Builder
• Making changes update-safe
• onOffice