Zum Hauptinhalt springen
Bei der FACT-Finder-Direktanbindung übernimmt FACT-Finder die Suche und die Filterung, und der Shop zeigt die Ergebnisse mit seinen eigenen Produkt-Tags an. Diese Seite enthält die vier Templates, die Sie dafür brauchen. Alle Beschriftungen sind Beispieltexte, und alle vier Templates zeigen die Produkte bewusst nur als Namen. Setzen Sie dort Ihre eigene Produktdarstellung ein.
Die Direktanbindung ist veraltet und wird nicht mehr unterstützt. Sie steht nur bis FACT-Finder 6.9 zur Verfügung und wird von WEBSALE weder gepflegt noch weiterentwickelt. Für neue Integrationen verwenden Sie die FACT-Finder WebComponents nach der offiziellen Dokumentation von FACT-Finder.Diese Seite ist für bestehende Shops gedacht, die noch mit der Direktanbindung arbeiten.
Wegweiser: FACT-Finder-Integration · Referenz: E-Search-Tags · Materialien: FACT-Finder Suggest-Layer

Die vier Templates

Der Einstieg ist ws_search.htm. Es holt sich die Ergebnisse über einen ExternInclude, und was dabei herauskommt, gestalten Sie in incl_factfinder_search.htm.

ws_search.htm

Dieses Template entspricht der normalen Suchseite des Shops. Der einzige Unterschied ist eine Zeile:
Sie ruft das Suchmodul auf, das seinerseits incl_factfinder_search.htm verarbeitet und das Ergebnis an dieser Stelle einsetzt.

incl_factfinder_search.htm

Hier steckt die eigentliche Arbeit. Das Template zeigt der Reihe nach das Sucheingabefeld, die Filter, die Sortierung, die Trefferzahl je Seite, die Blätterleiste, die Kampagnen und zuletzt die Treffer. Filter, Sortierung und Trefferzahl stehen in einem gemeinsamen form-Element und lösen beim Umschalten ein Absenden aus. Die Blätterleiste und die Ergebnisse stehen außerhalb, weil sie mit Links arbeiten.
Das versteckte Feld mit ~E-Search_FollowSearchName~ reicht die Kennung der vorherigen Suche an FACT-Finder weiter. Darüber erkennt FACT-Finder, dass der Besucher seine Suche verfeinert, statt eine neue zu starten, und wertet das in seiner Statistik aus. Lassen Sie es nicht weg.
~E-Search_FilterField_Select~ ist im Quelltext des Moduls als veraltet markiert. Der Nachfolger ist ~E-Search_FilterField_Link~ für einen fertigen Link auf den gefilterten Stand, beziehungsweise ~E-Search_FilterField_Params~ für die Parameter allein.Das Beispiel baut die Filter als Auswahllisten und braucht dafür weiterhin die Werte. Wenn Sie die Filter stattdessen als Linkliste bauen, kommen Sie ganz ohne _Select aus.

incl_factfinder_shopnavigation.htm

Dieses Template übernimmt dieselbe Aufgabe für die Kategorieansicht. Es sieht dem Suchtemplate ähnlich, hat aber drei wichtige Unterschiede. Erstens prüft es außen mit {E-Search_Success}, ob FACT-Finder überhaupt geantwortet hat, und innen mit {E-Search_Result}, ob die Filterung Treffer liefert. Beide Gegenstücke sind im Beispiel leer gelassen und als Hinweis kommentiert: Dort gehört die normale WEBSALE-Kategorieansicht als Rückfallweg hinein. Zweitens stehen Filter einerseits und Sortierung mit Trefferzahl andererseits in zwei getrennten Formularen, weil sie an verschiedene Ziele gehen. Damit beim Umschalten des einen die Einstellung des anderen nicht verloren geht, trägt jedes Formular die Werte des anderen als versteckte Felder mit. Drittens behandelt es Preis-Schieberegler gesondert. Ein pricerange-Filter hat keinen einzelnen Wert, sondern einen Anfang und ein Ende.
Die beiden leeren Rückfallbereiche am Ende sind kein Schönheitsfehler, sondern die wichtigste Stelle des Templates. Lassen Sie sie leer, sieht der Besucher eine leere Kategorieseite, sobald FACT-Finder nicht erreichbar ist. Bauen Sie dort die normale WEBSALE-Kategorieansicht ein.
Kategoriefilter erscheinen in der Shop-Navigation nicht in {@E-Search_FilterField}. Das Modul filtert sie bewusst heraus, weil die Kategorie bereits über die Navigation gesetzt ist. Wenn Sie sie doch brauchen, prüfen Sie einen Filter mit {E-Search_FilterField_IsCat}.

incl_factfinder_campaign.htm

Kampagnen definieren Sie im FACT-Finder Campaign Manager und geben ihnen dort ein Kriterium. Im Template fragen Sie dieses Kriterium als Parameter ab und bestimmen so, welche Kampagne an welcher Stelle erscheint.
Der dritte Block zeigt ein nützliches Muster: Die negative Klammerung mit mehreren Kriterien fängt alle Kampagnen ab, für die Sie keine eigene Gestaltung vorgesehen haben. So fällt keine neu angelegte Kampagne unter den Tisch.

Voraussetzung in der shop.config

Beide Filterlisten tragen denselben Kommentar: Sie brauchen im Abschnitt <SearchFactFinder-Filter> den Eintrag DirectShow = yes. Der Unterschied ist feiner, als der Kommentar vermuten lässt. Mit DirectShow = yes übernimmt der Shop die Filter so, wie FACT-Finder sie liefert, samt der dort hinterlegten Beschriftungen. Ohne diesen Eintrag zeigt er nur die Filter, die Sie in der shop.config selbst aufgelistet haben, und verwendet die dort hinterlegten Beschriftungen. ~E-Search_FilterField_Text~ liefert je nach Einstellung die eine oder die andere Beschriftung. Referenz: shop.config, Abschnitt SearchFactFinder-Filter

Was die Beispiele nicht zeigen

Die Templates nutzen einen kleinen Teil der verfügbaren Filter-Tags. Die Referenzseite beschreibt sie vollständig. Referenz: FACT-Finder, Filter, Sortierung und Navigation Sie sind nützlich, wenn Sie die Filterleiste nicht als Auswahllisten, sondern nach Filtertyp unterschiedlich gestalten wollen. Die Zahl der angebotenen Filteroptionen lässt sich in der shop.config begrenzen. Ist die Grenze gesetzt, bricht das Modul die Schleife {@E-Search_FilterField_Option} nach dieser Anzahl ab.

Hinweis zu allen vier Templates

Die Beispiele tragen den HTML-4.01-Doctype und charset=ISO-8859-1. Für einen neuen Shop übernehmen Sie stattdessen Doctype und Zeichensatz Ihrer übrigen Templates, üblicherweise HTML5 und UTF-8.