Konfiguration

Es sollte bereits eine Root-Seite vorhanden sein.

1 / Seiten anlegen

Lege nun als erstes jeweils eine Seite für die Listen- und Detailansicht an.

2 / Module anlegen

In der linken Navigation wählen Sie unter Layout den Menüpunkt Themes aus und wählen für das Theme Ihrer Webseite das Zahnrad-Icon Die Frontend-Module des Themes ID … bearbeiten aus.

Modul für die Listenansicht anlegen

Wählen Sie Neues Modul aus und legen ein Modul für die Listenansicht an:

  • Vergeben Sie einen Titel für Ihre Immobilienliste.
  • Wählen Sie bei Modultyp unter pdirMaklermodul Immobilienliste aus.
  • Wählen Sie bei Detailansicht die entsprechende Seite aus.
  • Wenn kein Template ausgewählt wird, wird standardmäßig das Template makler_list genutzt

Wie Sie Felder und Filter in der Listenansicht anzeigen können, finden Sie auf der Seite Dargestellte Felder und Filter. Weitere Einstellungsmöglichkeiten finden Sie auf der Seite Konfiguration der Listenansicht.

Modul für die Detailansicht (Exposé) anlegen

Wählen Sie Neues Modul aus und legen ein Modul für die Detailansicht an:

  • Vergeben Sie einen Titel für das Exposé.
  • Wählen Sie bei Modultyp unter pdirMaklermodul Expose aus.
  • Wählen Sie bei Immobilienliste die Seite aus, mit der die Immobilienliste dargestellt werden soll.
  • Wählen Sie bei Immobilien-Templates entweder das Template makler_details_simple oder makler_details_extended aus.

Optional:

  • Sie können eine Google Maps Karte darstellen. Genaueres erfahren Sie auf der Seite Google Maps integrieren.
  • Sie können ein eigenes Platzhalterbild setzen, falls beim Immobilienobjekt kein Bild hinterlegt ist. Wird kein Platzhalterbild ausgewählt und das Immobilienobjekt besitzt kein Bild, wird ein moduleigenes Platzhalterbild dargestellt.

3 / Module einbinden

Wenn Sie die Module angelegt haben, müssen Sie sie noch die Module in den Artikeln der Listen- und Detailansicht einbinden.

  • Den entsprechenden Artikel der Listen- oder Detailansicht auswählen.
  • Neues Element wählen und an einer beliebigen Stelle platzieren.
  • Elementtyp Modul auswählen und das angelegte Modul auswählen.

4 / Einstellungen anpassen

Ab Contao 4.9 nicht mehr notwendig. Ansonsten muss in den Einstellungen unter Frontend-Einstellungen Auto_item aktivieren werden.

Damit die Verlinkung zur Detailseite funktioniert muss Auto_item aktiviert sein. Ab Contao 4.9 ist dies bereits standardmäßig aktiv und muss in der config.yml explizit deaktiviert werden, wenn es nicht gewünscht ist:

# config/config.yml
contao:
    localconfig:
        useAutoItem: false

5 / Anpassung für die Objekt-Url in der parameters.yml

Ab Version 2.5.0 notwendig. Hier kannst du die Alias Generierung für die Objekt-Url direkt anpassen.

Empfohlene Konfiguration

In der parameters.yml in app/config/ oder ab Contao 4.9 config/ bitte folgende Zeilen einfügen: (“parameters:” kann bereits vorhanden sein)

parameters:
    pdir_maklermodul.aliasPrefix: null
    pdir_maklermodul.alias: 'freitexte/objekttitel'
    pdir_maklermodul.aliasSuffix: 'verwaltung_techn/objektnr_extern'
    pdir_maklermodul.validAliasCharacters: '0-9a-z'    
    pdir_maklermodul.aliasDelimiter: '-'
    pdir_maklermodul.aliasLocale: 'de'

Um den Alias aus dem Objekttitel und der externen Objektnummer zu generieren und nur ASCII-Zahlen und Kleinbuchstaben zu erlauben.

So könnte die Url dann aussehen:

example.org/details/expose/traumhafte-grosszugig-und-hochwertig-sanierte-wohnung-mit-erholungswert-14246.html

Beispiel nur Objekttitel:

parameters:
    pdir_maklermodul.aliasPrefix: null
    pdir_maklermodul.alias: 'freitexte/objekttitel'  
    pdir_maklermodul.aliasSuffix: null  
    pdir_maklermodul.validAliasCharacters: '0-9a-z'  
    pdir_maklermodul.aliasDelimiter: '-'  
    pdir_maklermodul.aliasLocale: 'de'

So könnte die Url dann aussehen:

example.org/details/expose/traumhafte-grosszugig-und-hochwertig-sanierte-wohnung-mit-erholungswert.html

Erlaubte Zeichen für den Alias

- Unicode-Zahlen und -Kleinbuchstaben -> '\pN\p{Ll}'
- Unicode-Zahlen und -Buchstaben -> '\pN\pL'
- ASCII-Zahlen und -Kleinbuchstaben -> '0-9a-z' 
- ASCII-Zahlen und -Buchstaben -> '0-9a-zA-Z'

Aus technischen Gründen beim Import kann derzeit nicht auf die Einstellungen der Root Seite zurückgegriffen werden.

Trennzeichen für den Alias (aliasDelimiter)

pdir_maklermodul.aliasDelimiter: '-'
Ergebnis: example.org/details/expose/traumhafte-grosszugig-und-hochwertig-sanierte-wohnung-mit-erholungswert.html  

pdir_maklermodul.aliasDelimiter: '_'        
Ergebnis: example.org/details/expose/traumhafte_grosszugig_und_hochwertig_sanierte_wohnung_mit_erholungswert.html

Regionalspezifischer Alias (aliasLocale)

pdir_maklermodul.aliasLocale: 'en'  
Ergebnis: example.org/details/expose/traumhafte-grosszugig-und-hochwertig-sanierte-wohnung-mit-erholungswert.html  

pdir_maklermodul.aliasLocale: 'de'
Ergebnis: example.org/details/expose/traumhafte-großzügig-und-hochwertig-sanierte-wohnung-mit-erholungswert.html