Loupe

Die Filterregel „Loupe“ (Paket filter_loupe, ab MM 2.4) erzeugt einen Volltext-Index über ausgewählte Attribute in einer eigenen SQLite-Datenbank und ermöglicht eine leistungsfähige Volltextsuche mit Ähnlichkeitssuche (Fuzzy-Search). Die Implementierung basiert auf der PHP-Bibliothek Loupe.

Im Unterschied zur Levenshtein-Suche verwendet Loupe eine eigenständige SQLite-Datenbank für den Index und bietet erweiterte Konfigurationsmöglichkeiten für Fuzzy-Distanz und Ranking.

Siehe auch

Detaillierte Dokumentation zu Loupe: Loupe-gestützte Volltextsuche

Installation

Die Filterregel wird über den Contao Manager oder Composer installiert:

composer require metamodels/filter_loupe

Einstellungen beim Anlegen der Filterregel

Einstellung	Beschreibung
Typ	Auswahl des Filterregeltyps – hier: „Loupe“.
Aktiviert	Aktiviert oder deaktiviert diese Filterregel.
Kommentar	Freitextfeld zur Beschreibung des Zwecks dieser Filterregel.
Zu indizierende Attribute	Auswahl der Attribute (checkboxWizard), die in den Loupe-Suchindex aufgenommen werden sollen. Pflichtfeld.
Fuzzy-Distanz	MCW-Tabelle, die für verschiedene Wortlängen (Mindestzeichen) den erlaubten Levenshtein-Abstand (Fuzzy-Distanz, 0–10) festlegt. Standard: Wortlänge 5 → Distanz 1; Wortlänge 9 → Distanz 2.
Ranking gleichgewichten	Ist diese Option aktiv, werden alle Treffer unabhängig von ihrer Relevanz gleichwertig gerankt (kein Relevanz-Ranking).
Formatierte Werte verwenden	Ist diese Option aktiv, werden die formatierten Ausgabewerte der Attribute indiziert (statt der Rohwerte aus der Datenbank).

Einstellungen für das Frontend-Widget

Einstellung	Beschreibung
URL-Parameter	Der Schlüssel (Key) des URL-Parameters für die Übergabe des Filterwerts. Ohne Angabe wird der Spaltenname des Attributs verwendet. Mit auto_item wird nur der Wert – ohne Schlüssel – in die URL eingebaut.
URL-Typ für den Parameter	Legt fest, ob der Parameter als Slug (sprechende URL), als GET-Parameter übergeben wird (ab MM 2.4) - siehe SEO
Label	Beschriftung des Sucheingabefelds.
Label beim Filterwidget ausblenden	Unterdrückt die Ausgabe des Labels.
Template	Template für die Widget-Ausgabe. Standard: mm_filteritem_default.
Diesen Filter für verbleibende Werte ignorieren	Dieser Filter liefert beim Berechnen verbleibender Werte seine eigenen Optionen nicht als Einschränkung zurück.
CSS-ID/Klasse	Setzt eine CSS-ID oder -Klasse am Widget-Element.

Passende Attribute

Die Filterregel „Loupe“ kann die folgenden Attributtypen indizieren:

• Text

• Langtext

• Alias

• Kombinierte Einträge

• Token

• Übersetzter Text

• Übersetzter Langtext

Sonderfunktionen

Index neu aufbauen

In der Filterregelliste erscheint für Loupe-Filterregeln ein zusätzliches Operationssymbol (Loupe-Icon) zum manuellen Neuaufbau des SQLite-Suchindex. Der Index wird außerdem automatisch bei Änderungen an indizierten Items aktualisiert.

SQLite-Datenbank

Der Loupe-Index wird in einer eigenständigen SQLite-Datei gespeichert (nicht in der Contao-Hauptdatenbank). Dies ermöglicht schnelle Volltextsuchen auch bei großen Datenmengen.