Filtering Properties
WP-ImmoMakler offers several ways to show a selection of your properties. Which one fits depends on who does the filtering and where the selection should appear:
| You want to … | Method |
|---|---|
| Let your visitors search for themselves | Search form PLUS |
| Link to a fixed selection, for example in a menu | Category pages and URL parameters |
| Embed a fixed selection on a page of your own | Shortcode [immomakler-archive] |
| Design search and list with your page builder | Page builders |
| Filter custom fields or customise the search form with code | Filter hooks |
Visitors filter for themselves: the search form
Section titled “Visitors filter for themselves: the search form”PLUS WP-ImmoMakler shows a search form above your property list. In it, your visitors choose, for example, the marketing type, property type and location, search within a radius of an address, or narrow down area, number of rooms and price under more options. The choices depend on the properties you have: only what actually has results is offered.
Which fields appear and how they behave is set in the Customizer under WP-ImmoMakler → Search. You will find all options with examples under Configuring the Search Form.
The search form is part of the PLUS licences. In the Basic licence, the property list shows your properties without a search form; category pages and URL parameters from the next section still work there.
If you want your visitors to be notified about new results for their search, they create a saved search from the search form.
Filtered URLs: category pages and URL parameters
Section titled “Filtered URLs: category pages and URL parameters”Every category of your properties has a page of its own, for example:
/immobilien-ort/hamburg/– all properties in Hamburg/immobilien-arten/wohnung/– all apartments/immobilien-vermarktungsart/miete/– all rental properties
How these addresses are built and how you rename the sections is described under URL structure of the property pages. Category pages work well as menu items.
You combine several criteria with URL parameters on the address of your property list:
/immobilien/?vermarktungsart=kauf&typ=wohnung/immobilien/?ort=hamburg&ausstattung=balkon| Parameter | Filters by | Example values |
|---|---|---|
vermarktungsart |
Marketing type | kauf, miete |
typ |
Property type | wohnung, haus |
nutzungsart |
Usage type | wohnen, gewerbe |
ort |
Location | hamburg |
land |
Country | deutschland |
ausstattung |
Amenities | balkon |
status |
Status | reserviert |
The value is the short name (slug) of the category, as it also appears in the address of the category page. If the search form is active, it takes over the selection from the address:
Pre-filtered lists on your own pages
Section titled “Pre-filtered lists on your own pages”With the shortcode [immomakler-archive] you embed a fixed selection on any page, for example the rental apartments on a landing page or the units of a development project:
[immomakler-archive vermarktungsart=miete typ=wohnung columns=3][immomakler-archive ort=hamburg posts_per_page=6][immomakler-archive projekt=BAUFELD-A columns=2][immomakler-archive idprefix=2026-]In addition to the parameters from the table above, the shortcode understands all parameters of a WordPress query, for example meta_key and meta_value. You will find all attributes under Shortcodes: property list.
You will find more examples under Displaying similar properties and Embedding reference properties.
Page builders
Section titled “Page builders”If you design your property pages with a page builder, the search form and property list are available there as elements of their own, for example the Search Form block in the block editor. You will find which elements your page builder offers under Page Builder.
For developers: filter hooks
Section titled “For developers: filter hooks”With programming knowledge, you adapt filtering via filter hooks. Place the code in the functions.php of your WP-ImmoMakler child skin plugin so that it survives updates.
Making custom fields filterable
Section titled “Making custom fields filterable”WP-ImmoMakler stores most data fields of a property bundled in a single database entry, which cannot be filtered on. Stored individually, and therefore filterable, by default are the number of rooms, areas, prices, street, house number and postcode. You add further fields with the filter immomakler_searchable_postmeta_keys:
add_filter( 'immomakler_searchable_postmeta_keys', function ( $keys ) { $keys[] = 'etage'; return $keys;} );From the next import of a property onwards, WP-ImmoMakler stores the field individually. You can then query it in the shortcode, for example:
[immomakler-archive meta_key=etage meta_value=3]This filter does not add an extra field to the search form.
Adjusting the range filters under “more options”
Section titled “Adjusting the range filters under “more options””The range filters for area, number of rooms and prices are defined by the filter immomakler_search_enabled_ranges. You will find a complete example under Filter hooks: examples.
All hooks related to search are listed in the hook reference: Search.
Custom modifications
Section titled “Custom modifications”If needed, we develop individual filters and modifications for you. Tell us what you have in mind: we will check whether it is covered by our support or create a non-binding quote for you. You can reach us through our Support or by email at info@wp-immomakler.de.