MULTIFILTER Handbuch

Das OXID-Modul SIT-Multifilter bietet eine hilfreiche Filterfunktion für Artikel in folgenden Bereichen:

  • in Kategorien
  • in Suchergebnissen
  • oder als Produktfinder über Ihren gesamten Artikelbestand.

Enthaltene Funktionen

  • Facettenfilter
    • Verhindert eine Filterung ohne Ergebnis
    • Anzeige der verbleibenden Artikel VOR der Filterauswahl
  • Akkordeon-Funktion für die einzelnen Filtergruppen
  • Suchergebnisfilter
    • Filter wird automatisch anhand des aktuellen Suchergebnisses erstellt
    • Perfekte Interaktion mit unserem Suchmodul SIT-Powersearch
  • Endloses Scrollen (Infinite-Scrolling)
    • Artikel werden beim Scrollen automatisch nachgeladen
  • Preisfilter
    • Integriert als touchfähiger Preis-Slider
  • Individuelle Filterdarstellung
    • Text
    • Checkbox
    • Farbkachel
    • Bild
    • Dropdownliste
  • SEO-URL Unterstützung
    • Per SEO-URL eine bestimmte Filterauswahl ansteuern
  • Contentfilter
    • Anzeige aller bisher gewählten Filter oberhalb der Artikelliste
    • Zurücksetzen von einem oder allen gewählten Filtern per Klick
  • Herstellerfilter
    • Inklusive automatischem Erstellen von Hersteller Attributen
  • Lieferantenfilter
    • Inklusive automatischem Erstellen von Lieferanten Attributen

Das integrierte Template-System erlaubt das Layout individuell anzupassen: Top-Filter, Sidebar-Filter, Checkboxen, Auswahllisten, Farbkacheln etc.

Weitere Funktionen

  • Intelligenter Filter
    • Die Filter-Auswahl bleibt beim Wechsel der Kategorie bestehen (z.B. eine Farb- oder Größenauswahl)
  • Individuelle Sortierung
    • Wichtige Filter-Werte können nach oben sortiert werden (Standard = alphabetisch)
  • Hook-Funktionen
    • zur Funktions-Erweiterung per Javascript

Dateien installieren

  1. Die beigefügte Zip-Datei entpacken.
  2. Den „copy_this“ Ordner (entsprechend Ihrer OXID-Version) in Ihr Shop Rootverzeichnis laden (FTP-Upload).
  3. Adminbereich öffnen und in der Modulverwaltung das SIT-Module-Framework und das Modul aktivieren.

Besonderheit bei OXID Version 4.5

  1. layout/sidebar.tpl
    Block anfügen an der gewünschten Filter-Position

    [{block name="sidebar_adminbanner"}]
    [{/block}]

     

  2. SQL-Update
    INSERT INTO 'oxtplblocks'
    ('OXID', 'OXACTIVE', 'OXSHOPID', 'OXTEMPLATE', 'OXBLOCKNAME', 'OXPOS', 'OXFILE', 'OXMODULE')VALUES
    ('24ea33036af6d976926f455dc7d15bc5', '1', 'oxbaseshop', 'layout/sidebar.tpl', 'sidebar_adminbanner', '1', 'sit_filter_sidebar', 'sit_multifilter');

     

  3. Moduleinträge
    oxseodecoder => sit_multifilter/sit_multifilter_oxseodecoder
    oxviewconfig => sit_multifilter/sit_multifilter_oxviewconfig
    oxsearch => sit_multifilter/sit_multifilter_oxsearch

     

  4. TMP-Ordner löschen
  1. Im Adminbereich den Menüpunkt SIT-Module -> SIT-Module-Framework -> Modulverwaltung öffnen

  2. Ihre 30 Tage Testversion startet nun automatisch

  1. Im Adminbereich den Menüpunkt SIT-Module -> SIT-Module-Framework -> Modulverwaltung öffnen

  2. Das Zahnrad-Symbol neben dem Modul öffnet den Reiter „Modulstatus“. Hier den Button „Abo verwalten“ klicken.

  3. Im geöffneten Fenster den Button „Abo beginnen“ klicken und den weiteren Anweisungen folgen. Sie werden zur Zahlungsabwicklung direkt an Paypal weitergeleitet.

Darstellung (GUI)

  • Wie kann Ich … Attribute als Akkordeon-Layout (eingeklappt) anzeigen?
    Aktivieren Sie die entsprechende Einstellung in der Modulkonfiguration unter:
    Einstellungen -> Darstellung -> Akkordeon-Layout in der Filterliste verwenden
  • Wie kann Ich … Attribute als Dropdown (Selectbox) darstellen?
    Wählen Sie einfach in der Modulkonfiguration alle Attribute aus, die als Dropdown (Selectbox) dargestellt werden sollen. Sie finden die Einstellung unter:
    Spezialfilter -> Dropdown Attribute festlegen
  • Wie kann Ich … Attribute als Farbplättchen darstellen?
    Wählen Sie zunächst in der Modulkonfiguration alle Attribute aus, die als Farbplättchen dargestellt werden sollen. Sie finden die Einstellung unter:
    Spezialfilter -> Farbfilter Attribute festlegen
    Wechseln Sie danach auf den Reiter „Attributdaten“. Hier tragen Sie für jede verwendete Farbe den Farbnamen im Feld „Attributwert“ und den zugehörigen Farbcode (als Hexwert) im Feld „Datenwert“ ein.
    Beispiele:
    Attributwert = blau und Farbwert = #000066
    Attributwert = weiß und Farbwert = #FFFFFF
  • Wie kann Ich … Templates anpassen oder eigene Templates erstellen? Versuchen Sie zunächst Ihre Anforderungen über eine eigene CSS-Datei zu lösen. Für tiefergehende Anpassungen besteht die Möglichkeit die mitgelieferten Template-Dateien anzupassen. Sie finden die Template-Dateien unter:
    SITModuleFramework/SITModuleFramework/modules/SITMultiFilter/templates
  • Wie kann Ich … die Reihenfolge / Anordnung der Filteroptionen ändern?
    Die Reihenfolge der Filteroptionen entspricht der Sortierung im Adminbereich. Sie können die Sortierung im OXID-Admin unter folgendem Punkt vornehmen:
    Artikel verwalten -> Attribute -> Reiter Stamm -> SortierungDie Reihenfolge des Preisfilters können Sie direkt über das mitgelieferte Template anpassen:
    SITModuleFramework/SITModuleFramework/modules/SITMultiFilter/templates/multifilter_filter_list.tpl

Hinweis: Wenn Sie im oben genannten Ordner einen Unterordner „custom“ erstellen und dort Ihre angepassten Templates ablegen, werden Ihre Anpassungen bei zukünftigen Modulupdates nicht überschrieben!

Hook-Funktionen

Im Folgenden eine Tabelle allen verfügbaren Hook-Funktionen:

Funktion / Beschreibung

mf_loadHtmlFilterHook() / Feuert nach dem Laden der HTML-Filteransicht
mf_loadHtmlNavigationHook() / Feuert nach dem Laden der Navigationselemente
mf_loadHtmlArticlesHook() / Feuert nach dem Laden der Artikelliste

Zum Ausführen der Hook-Funktionen binden Sie ein Javascript-Element oder eine Javascript-Datei ein, die die Funktionen entsprechen den oben aufgeführten Namen enthalten. z.B.

function mf_loadNavigationHook() {
    $('div.dropDown p').oxDropDown();
}

 

Funktionen

  1. Berücksichtigt der Filter die Verfügbarkeit von Artikeln?

    Ja. Damit der Filter die Verfügbarkeit eines Artikels über Lagerbestand oder Lieferstatus berücksichtigt setzten Sie einfach die entsprechenden Haken in der Modulkonfiguration unter:

    Einstellungen -> Konfiguration -> Lagerbestand berücksichtigen

    Einstellungen -> Konfiguration -> Lieferstatus berücksichtigen

  2. Berücksichtigt der Filter Varianten?

    Ja. Damit auch Attributwerte von Varianten dargestellt werden setzen Sie einfach den entsprechenden Haken in der Modulkonfiguration unter:

    Einstellungen -> Konfiguration -> Varianten durchsuchen

Hinweis: Sie haben zudem die Möglichkeit in der Ergebnisliste alle gefundenen Varianten oder nur deren Eltern-Artikel anzeigen zu lassen. Diese Einstellung aktivieren Sie in der Modulkonfiguration unter: Einstellungen -> Darstellung -> Eltern-Modus

Einstellungen und Attribute

  1. Wie kann Ich … Attribute automatisch erzeugen?

    Das Filtermodul liefert eine Funktion zur Automatischen Attributerstellung mit. Sie können Attribute aus den vorhandenen Artikelstammdaten automatisch erzeugen lassen. Derzeit funktioniert dies für Hersteller, Lieferanten und Kategorien. Sie finden die Funktion in der Modulkonfiguration unter dem Reiter „Attribute erstellen“

  2. Wie kann Ich … Attribute automatisch erzeugen für Hersteller?

    In der Modulkonfiguration unter:

    Attribute erstellen -> Hersteller

  3. Wie kann Ich … Attribute automatisch erzeugen für Lieferanten?

    In der Modulkonfiguration unter:

    Attribute erstellen -> Lieferanten

  4. Wie kann Ich … Attribute automatisch erzeugen für Kategorien?

    In der Modulkonfiguration unter:

    Attribute erstellen -> Kategorien

  5. Wie kann Ich … Attributen mehrere Attributwerte zuweisen?

    Erstellen Sie hierzu einfach mehrere Attribute mit dem gleichen Namen und weisen Sie Diese dem Artikel zu. Das Filtermodul fasst alle Attribute in der Darstellung dann unter dem Haupteintrag (z.B. „Farbe“) zusammen.

    Zur besseren Unterscheidung können Sie die Attribute auch mit einem Unterstrich im Namen versehen (z.B. Farbe_1 oder Farbe_2 etc.). Für die Darstellung im Filter wird nur der Wert vor dem Unterstrich verwendet.

  6. Wie kann Ich … in Kategorien nur ausgewählte Filter anzeigen?

    Aktivieren Sie zunächst in der Modulkonfiguration die entsprechende Einstellung unter:

    Einstellungen -> Konfiguration -> Shopeinstellungen für Attribute berücksichtigen

    Ist diese Einstellung gesetzt, werden die Attribute nur noch in allen zugewiesenen Kategorien als Filter dargestellt. Sie können die Kategorien über den OXID-Administrationsbereich zuweisen unter:

    Artikel verwalten -> Attribute -> Reiter Kategorien

  7. Wie kann Ich … den Zwischenspeicher (Filtercache) leeren / deaktivieren?

    Löschen oder deaktiveren Sie hierzu einfach Ihre aktuellen Browser-Cookies. Änderungen an den Filtereinstellungen sollten dann sofort sichtbar sein.

     

Probleme

  1. Meine erstellten Attribute werden nicht angezeigt

    Prüfen Sie ob einer der verwendeten Template-Blocks in Ihrem Template vorhanden ist: array('template' => 'layout/sidebar.tpl', 'block'=>'sidebar_categoriestree', 'file'=>'views/blocks/sit_filter_sidebar.tpl')
    array('template' => 'page/list/list.tpl', 'block'=>'page_list_listbody', 'file'=>'views/blocks/sit_filter_sidebar.tpl')

    Prüfen Sie ob ggf. die Einstellung „Shopeinstellungen für Attribute berücksichtigen“ in der Modulkonfiguration gesetzt ist. In diesem Fall muss die gewählte Kategorie mindestens bei einem Attribut zugewiesen sein. Siehe auch: Einstellungen und Attribute (6.)

    Löschen Sie Ihre Browser-Cookies wie unter Einstellungen und Attribute (7.) beschrieben.

  2. Meine Attribute werden in der falschen Reihenfolge anzeigt

    Das Modul berücksichtig die verwendete Sortierreihenfolge für Attribute:

    Artikel verwalten -> Attribute -> Reiter Stamm

  3. Meine Attributwerte werden in der falschen Reihenfolge angezeigt Die Attributwerte werden im Standard nach Alphabet sortiert. Sie können die Reihenfolge für bestimmte Attributwerte über die Modulkonfiguration beeinflussen unter dem Reiter „Manuelle Sortierung“.

    Tragen Sie hier den Attributwert sowie eine Sortierreihenfolge ein für jeden Attributwert den Sie nicht Alphabetisch sortieren möchten. Der kleinste Sortierwert steht weiter vorne in der Darstellung.

    Beispiele: Attributwert = XXS und Sortierung = 100

    Attributwert = XS und Sortierung = 200

Hinweis: Verwenden Sie am Besten 100 Schritte für die Sortierung, so können Sie später Problemlos weitere Attributwerte hinzufügen ohne alle anderen Einträge ändern zu müssen.