Settings: Projects
The project settings can be found in your website’s admin area (wp-admin) under WP-ImmoMakler → Settings → Projects. They control how development projects and their units (flats, offices, etc.) are displayed in the list view, on the project detail page, and in the [immomakler-project-units] shortcode.
Settings overview
Section titled “Settings overview”The first three options — the two list view options plus the grouping field for project assignment — are available in all editions; all others configure the units table and the project detail page and are only available in the PLUS editions — they are hidden in the Basic edition. Detailed explanations of the more complex options can be found in the sections below the table.
| Label | Type | Default | Description |
|---|---|---|---|
| Show project units and parent properties together in the list view | Checkbox | on | List units and parent properties together. |
| Also show hidden development-project parent properties | Checkbox | off | Also show parent properties marked as “not visible”. |
| Grouping field for project assignment | Select | Prefer gruppen_kennung | Which OpenImmo field the project identifier is derived from. |
| Project assignment of units | Select | Via grouping fields | Assignment via grouping fields or property ID prefix. |
| Display of units on the project detail page | Select | Sortable table | Table or classic list/tile view. |
| Units table columns | Text | 5 columns | Displayed columns as a field-key list. |
| Default sort: column | Text | objektnr_extern | Column for the pre-sort on load. |
| Default sort: direction | Select | Ascending | Direction of the pre-sort. |
| Show availability status | Checkbox | on | Colour-coded status column (available, reserved …). |
| Show details column | Checkbox | on | Info icon on the right, opens the detail page. |
| Link property ID column | Checkbox | off | Property ID as a link to the detail page. |
| Entire table row clickable | Checkbox | on | Clicking the row opens the detail page. |
| Hide price for sold/rented units | Checkbox | on | Leave the price blank when sold/rented. |
| Remove links for sold/rented units | Checkbox | on | No longer link sold/rented units. |
| Show other units on the unit detail page | Checkbox | on | Show the project’s other units on the detail page. |
| Enable expandable detail rows | Checkbox | off | Accordion detail panel instead of navigation. |
| Preview image in detail panel | Select | Floor plan | Floor plan or cover image in the detail panel. |
| Data fields in detail panel | Text | 4 fields | Fields in the expandable detail panel. |
| Contact form in detail panel | Checkbox | on | “Get in touch” button in the detail panel. |
Grouping field for project assignment
Section titled “Grouping field for project assignment”On import, WP-ImmoMakler derives one project identifier for each property from the two OpenImmo grouping fields. Units belong to the same project exactly when they share the same project identifier. This option determines which of the two fields takes precedence:
- Prefer
gruppen_kennung(default):gruppen_kennungis used, falling back togruppennummer. This fits most real estate CRM software exports. - Prefer
gruppennummer:gruppennummeris used, falling back togruppen_kennung.
You need the second setting if your export populates both fields and gruppen_kennung contains its own value per unit — for example a running number like 14465-001, 14465-002 — while the shared project identifier is stored in gruppennummer (for example 81925as). If you leave the default setting in this case, every unit gets its own project identifier and the units are not assigned to their project.
Purely numeric values below 10 (1, 2, 3 …) are ignored in both fields: some exports use them as a general sort or group counter, not as a project identifier.
You can see which value a property actually received by editing the property and checking the Group Identifier or Group Number field.
Project assignment of units PLUS
Section titled “Project assignment of units ”Determines how a unit is assigned to its project:
- Via grouping fields (default): The unit and the project share the same project identifier — that is, the same value in the grouping field you set above under Grouping field for project assignment.
- Via property ID prefix: Units belong to a project if their property ID (
objektnr_extern) begins with the project’s property ID. Example: projectPROJ-001→ unitsPROJ-001-WE1,PROJ-001-WE2, etc. Useful when units do not maintain their own grouping field but are named consistently after the project.
Display and columns PLUS
Section titled “Display and columns ”Display of units on the project detail page lets you choose between the sortable table (default) and the classic list/tile view. In the table view, Units table columns defines the displayed fields, and Default sort: column / direction define the initial order. Visitors can then re-sort any column by clicking its heading; the floor column is sorted sensibly (ground floor before 1st floor before 2nd floor before top floor), not purely alphabetically.
Columns for which no unit provides a value are automatically hidden — the column list is therefore the maximum selection, not the guaranteed display. The full list of available column keys and all shortcode attributes (e.g. columns, default_sort, sortable) can be found under Shortcodes.
Expandable detail rows (accordion) PLUS
Section titled “Expandable detail rows (accordion) ”When Enable expandable detail rows is switched on, clicking a table row opens a detail panel directly below it instead of navigating to the unit’s detail page. The detail panel shows a preview image and — by default — bathroom, WC, balcony/terrace, and heating type; clicking the image opens the full image gallery (photos and floor plans). Content is only loaded when a row is expanded, so even projects with many units load quickly.
- Preview image in detail panel chooses between the first floor plan (default, with fallback to the cover image) and the cover image (first photo).
- Data fields in detail panel defines — in the same way as the table columns — which fields appear, as a comma-separated list. The special fields
balkon_terrasse(combined count of balconies/terraces) andheizungsart(list of heating types) are rendered specially; any other key is treated as a property meta field and formatted like a table column (e.g.wohnflaeche,anzahl_zimmer,baujahr). Fields with no value are automatically hidden.
Contact form in detail panel
Section titled “Contact form in detail panel”When Contact form in detail panel is enabled (default), each expanded detail panel shows a “Get in touch” button. Clicking it opens the WP-ImmoMakler contact form for that exact unit directly below the panel — an enquiry is sent to the unit’s assigned contact person, without visitors having to leave the project page.
The button only appears for units that also show a contact form on the unit’s own detail page (status “available”; for “reserved” it depends on the setting for whether reserved properties get a contact form). Per embedding, you can turn the button off via the shortcode attribute contact="0". The form’s own behaviour (recipient, fields, required fields) is configured under Contact Form.
Sold and rented units PLUS
Section titled “Sold and rented units ”Two options control how already sold or rented units are treated in the table — both are enabled by default:
- Hide price for sold/rented units displays the purchase price, cold rent, and warm rent as blank for these units. Reserved and available units continue to show their price.
- Remove links for sold/rented units makes these units no longer clickable: no row link, no linked property ID, and no details icon. The unit remains visible in the table, but its detail page is no longer reachable from the table.
Project data in the overview and detail view
Section titled “Project data in the overview and detail view”OpenImmo has no vocabulary for development projects. Every real estate CRM software therefore transmits project data in its own custom fields with its own field names — ImmobilienScout24 differently from onOffice, and JustImmo differently again. On import, WP-ImmoMakler translates these fields into a shared set of data fields, so the same development project looks the same regardless of the connected software, and the values are formatted according to your website’s number, currency, and language settings.
| Data field | Display |
|---|---|
project_status | Project status: in planning, under construction, completed, or sold |
project_gesamtzahl_einheiten | Total units |
project_anzahl_einheiten_verfuegbar | Units available |
project_gesamtzahl_haeuser | Number of buildings |
project_salesprogress | Percentage sold or rented |
project_kaufpreis | Purchase price or rent range across all units |
project_preis_pro_qm_von | Purchase price per m², starting from |
project_flaeche | Area range across all units |
project_anzahl_zimmer | Room range across all units |
project_verkaufsstart | Sales start |
fertigstellung_geplant | Planned completion |
anzahl_dachgeschosse | Number of top floors |
project_gebaeude_zustand | Building condition |
project_lagebewertung, project_zustandsbewertung | Location and condition rating |
project_laermpegel, project_naehe | Noise level and proximity |
Which of these fields appear depends on what your real estate CRM software transmits: a data field with no value is not displayed. WP-ImmoMakler calculates the sales progress from the unit figures if your real estate CRM software does not transmit it itself.
In the list view, you choose the displayed data in the Customizer under WP-ImmoMakler → Property List View, in the Show property data and Show prices fields. On the detail page, they appear in the property data table.