> For the complete documentation index, see [llms.txt](https://docs.contao-estatemanager.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.contao-estatemanager.com/erweiterungen/erweiterungen/kaeufer-mieterfinder.md). # Käufer- / Mieterfinder {% hint style="info" %} Für diese Erweiterung wird es aufgrund geringer Nachfrage keine Nachfolger geben. Sollten Sie dennoch eine Kompatibilität mit Contao 5 wünschen, können Sie uns gerne [mit der Umsetzung beauftragen](https://www.oveleon.de/kontakt.html#kontaktformular): {% endhint %} ![](/files/-M78HPMZzxW31QeO_Utn) Die `Käufer- / Mieterfinder` Erweiterung liefert ein Tool, welches Verkäufern / Immobilienbesitzern anhand der eigenen Immobilien-Eckdaten ermöglicht, passende Interessenten zu finden. Dabei können bis zu drei Bereiche ausgegeben und kombiniert werden. 1. **Ermittlung der Immobilien-Eckdaten (Filter)**\ \&#xNAN;*Ermöglicht die Filterung der Interessenten anhand eigener Immobilien-Eckdaten*\ \_\_ 2. **Anzeige der gefundenen Interessenten (Liste)**\ \&#xNAN;*Zeigt anonyme Daten der Interessenten wie Anzahl der Zimmer oder Preisvorstellungen.*\ \_\_ 3. **Kontaktaufnahme (Formular)**\ \*\*\*\*Beliebiges Formular, welches über den von Contao mitgelieferten Formulargenerator angelegt werden kann. {% hint style="warning" %} Der Käufer- / Mieterfinder zeigt ausschließlich Daten (Suchanfragen) an, welche manuell im System angelegt, durch andere Systeme importiert wurden oder über ein Formular (Frontend) in die dafür vorgesehene Tabelle (`tl_search_criteria`) gespeichert werden. {% endhint %} ### Installation {% tabs %} {% tab title="Composer" %} ```bash $ composer require contao-estatemanager/lead-matching-tool ``` {% endtab %} {% tab title="GitHub" %} Installation direkt über GitHub: {% endtab %} {% endtabs %} Nach der Installation muss das [Contao-Installtool](https://docs.contao.org/manual/de/installation/contao-installtool/) aufgerufen und die Datenbank aktualisiert werden. ### Suchanfragen Suchanfragen dienen als Grundlage des Käufer- / Mieterfinders und können über verschiedene Wege in das System überführt werden. ![](/files/-MkbQ283rZVNjXP0o8tD) {% hint style="info" %} Mit der Erweiterung [onOffice API Import](/erweiterungen/erweiterungen/onoffice-api-import.md) können alle benötigten Daten für den Käufer- / Mieterfinders direkt aus onOffice importiert und aktuell gehalten werden. {% endhint %} ### Konfiguration Um das Tool im Frontend über das mitgelieferte Modul ausgeben lassen zu können, muss vorerst eine Konfiguration im Backend angelegt werden. #### Titel / Grundkonfiguration :small\_blue\_diamond:`Titel` *Dieser Titel wird ausschließlich zu Beschreibungszwecken im Backend verwendet.* :small\_blue\_diamond:*`Vermarktungsart`* *Hier stehen drei Auswahlmöglichkeiten zur Verfügung. Bei Auswahl einer fest definierten Option wie **Kauf** oder **Miete**, wird die Auswahl der Vermarktungsart im Frontend unterbunden.* :small\_blue\_diamond:*`Regionen Eingabemodus`* *Definiert die Möglichkeit, wie Regionen im Frontend ausgegeben und gewählt werden können. Regionen können im Reiter "Regionen" verwaltet werden. Bei Auswahl einer Umkreissuche (empfohlen) werden Längen- und Breitengrade in den Regionen vorausgesetzt.* #### *Daten-Konfiguration* :small\_blue\_diamond:*`Vermarktungsarten`* *Sofern die Vermarktungsart nicht fest definiert wurde, kann der Besucher aus den hier ausgewählten Vermarktungsarten wählen.* :small\_blue\_diamond:`Objektarten` *Definiert die wählbaren Objektarten im Frontend. Objektarten können im Reiter "Objektarten" verwaltet werden.* #### *Suchanfragen / Liste* :small\_blue\_diamond:`Feld Meta-Daten` *Definiert die auszugebenden Felder der Suchaufträge innerhalb der Liste.* :small\_blue\_diamond:*`Überschrift`* *Eine Überschrift, welche oberhalb der Liste ausgegeben wird.* :small\_blue\_diamond:*`Beschreibung`* *Ein Beschreibungstext, welcher oberhalb der Liste ausgegeben wird.* :small\_blue\_diamond:*`Gesamtanzahl der Beiträge`* *Definiert die Gesamtanzahl der Beiträge. Bei 0 werden alle Beiträge ausgegeben.* :small\_blue\_diamond:`Elemente pro Seite` *Definiert die Anzahl pro Seite (Paginierung).* :small\_blue\_diamond:*`Listen Element-Template`* *Definiert das zu verwendende Template für Listenelemente.* :small\_blue\_diamond:*`Anzahl anzeigen`* *Gibt die Anzahl der gefundenen Interessent aus und aktualisiert die Zahl sofort, sofern ein Filter verwendet und durch den Besucher angepasst wird.* #### *Filter / Immobilienformular* :small\_blue\_diamond:`Filter hinzufügen` *Definiert, ob ein Filter für Immobilien-Eckdaten aktiviert und angezeigt wird.* :small\_blue\_diamond:*`Überschrift`* *Eine Überschrift, welche oberhalb des Filters ausgegeben wird.* :small\_blue\_diamond:*`Beschreibung`* *Ein Beschreibungstext, welcher oberhalb der Liste ausgegeben wird.* :small\_blue\_diamond:*`Liste immer anzeigen`* *Definiert, ob die Liste bereits ohne Filterung ausgegeben werden darf.* :small\_blue\_diamond:*`Immobilien-Formularfelder`* *Definiert die Felder, welche im Filter ausgegeben werden. Das Feld Vermarktungsart wird nur ausgegeben, sofern keine feste Vermarktungsart unter "Daten-Konfiguration" gewählt wurde. Das Feld **Umkreis** wird nur berücksichtig, sofern eine Umkreissuche unter **Regionen Eingabemodus** ausgewählt wurde.* #### *Kontaktformular* :small\_blue\_diamond:`Kontaktformular hinzufügen` *Definiert, ob ein Kontaktformular ausgegeben werden soll.* :small\_blue\_diamond:*`Überschrift`* *Eine Überschrift, welche oberhalb des Formulars ausgegeben wird.* :small\_blue\_diamond:*`Beschreibung`* *Ein Beschreibungstext, welcher oberhalb des Formulars ausgegeben wird.* :small\_blue\_diamond:*`Kontaktformular immer anzeigen`* *Definiert, ob das Kontaktformular bereits ohne Filterung ausgegeben werden darf.* :small\_blue\_diamond:*`Kontakt-Formular`* *Definiert das auszugebende Formular, welches zuvor im Formulargenerator gebaut wurde.* ### Module Hier finden Sie eine Übersicht neuer (🟢) Module. {% tabs %} {% tab title="🟢 Käufer- / Mieterfinder" %} Gibt das Tool "Käufer- / Mieterfinder" anhand einer Konfiguration aus. **Einstellungen** :small\_blue\_diamond:`Konfiguration` *Die zu verwendende Konfiguration.* **Template** :small\_orange\_diamond:`mod_lead_matching` :small\_orange\_diamond:`search_criteria_item_default` {% endtab %} {% endtabs %} ### Lizenz Für diese Erweiterung ist eine Lizenz erforderlich. Zum Erwerb einer Lizenz folge bitte den Schritten unter [Lizenzen](/erweiterungen/lizenzen.md).