Setting up an advanced property search

The advanced search offers many filter options that enable the visitor to quickly find what they are looking for. The first time the visitor views the search page only the search filter is displayed. Once the visitor has submitted the search the search results, if any, are displayed.

Technical info:

This plugin uses the fluid template: openimmo/Resources/Private/Templates/Immobilie/Search.html

Every real estate list element found within this template uses the fluid partial: openimmo/Resources/Private/Partials/Immobilie/Search/Item.html

  1. Go to the Seiten module and open the page where you want to create the advanced search.
  2. Click on Neues Inhaltselement erstellen in the content area and select plugin type OpenImmo - List/Search/Show.
  3. Under the Plug-In tab you will find the usual Erweiterungseinstellungen. We first want to take a look at the General tab, which should look as follows:

    OpenImmo advanced property search - general settings

    • Plugin view: Here you set the view or function of the List/Search/Show plugin - set this option to Immobilien-Suche+Liste.
    • Headline: Here you can set the title for your real estate search.
    • Search fields: Here you can select which filter options should be used in the search. Use the arrow buttons to sort the selected items. The following filter options are currently available:
      • Anzahlzimmer: Here you can choose how many rooms the property should have. The visitor can enter their own values ​​via the input fields.
      • Wohnfläche: Here you can choose how much living space the property should have. The visitor can enter their own values ​​via the input fields.
      • Nettokaltmiete: Here you can select the maximum basic rent (without heating costs). Euros are entered as whole numbers.
      • Ort: Here you can choose the location of the real estate. The entries for the places indicated in the available real estate are collected together.
      • Ausstattung: Here you can choose the minimal fixtures and fittings. There will be options listed from the available properties.
      • Radius: This allows the user to find properties in a certain radius around a given location. You need the extesion "openimmo_pro" to be installed in order to use this feature. It uses the Google Geocoding API and Google Places Autocomplete feature. Please fill in your Google API key in the Constant Editor, section "Javascript" and fill in the keyword "places", also in that section under "Google Maps Libraries". You can specify the values in the dropdown box for the distances via typoscript. Please have a look at openimmo/Configuration/TypoScript/setup.typoscript under "radius_distances".
  4. Under the Filtering tab you can choose which properties should be displayed. The selection is carried out using the stored real estate object categories Nutzungsart, Vermarktungsart und Objektart.

    OpenImmo advanced property search - filter settings

    • Zeige aus Immobilien aus Objektkategorie: Nutzungsart: Here you can specify what type of use the real estate should have. If you do not select an entry, all usage types are allowed. These are the available options:

      OptionFeld im OpenImmo-XML Standard
      Wohnenobjektkategorie->nutzungsart->wohnen
      Gewerbeobjektkategorie->nutzungsart->gewerbe
      Anlageobjektkategorie->nutzungsart->anlage
      WAZobjektkategorie->nutzungsart->waz
    • Zeige aus Immobilien aus Objektkategorie: Vermarktungsart: Here you can specify what type of marketing the real estate should have. If you do not select an entry, all marketing types are allowed. These are the available options:

      OptionFeld im OpenImmo-XML Standard
      Kaufobjektkategorie->vermarktungsart->kauf
      Miete/Pachtobjektkategorie->vermarktungsart->mietePacht
      Erbpachtobjektkategorie->vermarktungsart->erbpacht
      Leasingobjektkategorie->vermarktungsart->leasing
    • Zeige aus Immobilien aus Objektkategorie: Objektart: Here you can specify what type of object the real estate should belong to. If you do not select an entry, all object types are allowed. These are the available options:

      OptionFeld im OpenImmo-XML Standard
      Wohnungobjektkategorie->objektart->wohnung
      Zimmerobjektkategorie->objektart->zimmer
      Hausobjektkategorie->objektart->haus
      Grundstückobjektkategorie->objektart->grundstueck
      Büro/Praxenobjektkategorie->objektart->bueroPraxen
      Einzelhandelobjektkategorie->objektart->einzelhandeln
      Gastgewerbeobjektkategorie->objektart->gastgewerbe
      Hallen/Lage/Produktionobjektkategorie->objektart->hallenLagerProd
      Land- und Forstwirtschaftobjektkategorie->objektart->landUndForstwirtschaft
      Parkenobjektkategorie->objektart->parken
      Sonstigeobjektkategorie->objektart->sonstige
      Freizeitimmobilien Gewerblichobjektkategorie->objektart->freizeitimmobilieGewerblich
      Zinshaus/Renditeobjektobjektkategorie->objektart->zinshausRenditeobjekt
  5. Under the Sorting tab you can specify how the results of the property search are to be sorted.

    OpenImmo advanced property search - sort settings

    • Sort by field: Here you can specify the sort field.
    • Sort ascending/descending: This field determines whether the sort is ascending or descending.

    The settings Stand vom and absteigend would display the 3 most recent properties as a teaser.

Use

Here are some common possibilities:

TabelleNutzungsartVermarktungsartObjektart
Wohnungen zur MieteWohnenMiete/PachtWohnung
Wohnungen zum KaufWohnenKaufWohnung
Häuser zur MieteWohnenMiete/PachtHaus
Häuser zum KaufWohnenKaufHaus
Gewerbe zur MieteGewerbeMiete/PachtBüro/Praxen, Einzelhandel
Gewerbe zum KaufGewerbeKaufBüro/Praxen, Einzelhandel
GrundstückeKaufGrundstück
KaptialanlagenAnlageKauf

For these you would use the following filter options:

TabelleZimmerNettokaltmieteWohnflächeKaufpreisGrundstücksfl.Bürofl.Gesamtfl.
Wohnungen zur Mietexxx----
Wohnungen zum Kaufx-xx---
Häuser zur Mietexxx-x--
Häuser zum Kaufx-xxx--
Gewerbe zur Miete-x---x-
Gewerbe zum Kauf---x-x-
Grundstücke---xx--

Fittings and location can always be used.

Settings

You can change the size of the real estate images displayed in the search results by using TypoScript constants. You will need to create two constants (you can find more detailed information about the constants here).

themes.configuration.extension.openimmo.search.image.width = 260px
themes.configuration.extension.openimmo.search.image.height =

These two constants are passed from settings to the fluid template und notify f:image how big the image should be. If one of the two values is left blank, as in the last example, image size is calculated as a proportion of the value given.

In addition, there is a TypoScript constant that sets which page the property search is on.

themes.configuration.pages.openimmo.search = 302