# 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:

<https://github.com/contao-estatemanager/lead-matching-tool>
{% 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.contao-estatemanager.com/erweiterungen/erweiterungen/kaeufer-mieterfinder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
