Intelligente Suche mit Sofortvorschau für xt:Commerce

Downloads

Bitte achten Sie darauf, dass Sie das Plugin mit der passenden PHP Version für Ihren Shop downloaden.
Ihre PHP Version können Sie im Adminbereich unter: System -> phpinfo einsehen.

• ad_search_suggest_php_5-6_to_7-4.zip
• ad_search_suggest_php_81.zip
• ad_search_suggest_php_82.zip

Kompatibilität

Das Plugin ist für das Shopsystem xt:Commerce entwickelt und für die folgenden Versionen getestet:

5 und 6

Hinweis: Eine optimale Darstellung kann nur im Standard-Template des Shopsystems gewährleistet werden. Sollten Sie ein eigenes oder modifiziertes Template einsetzen, müssen Sie ggf. Änderungen am Template für die Integration vornehmen.

Ioncube: Sie benötigen für unsere Plugins eine aktuelle Ioncube Version. Es gibt keinen Grund eine veraltete Ioncube Version auf dem Server ein zu setzen, da diese stets abwärtskompatibel sind.

Installation

Vor der Installation eines Plugins sollten stets alle Daten gesichert werden. Besonders wichtig ist die Shopdatenbank.

Ablauf der Installation:

1. Backup (Sicherung) des Shopsystems erstellen.
2. Das Plugin entpacken und die entpackten Daten (Plugin Name) per FTP auf den Server in den Ordner: /plugins des Shops hochladen.
   Hinweis: Überprüfen Sie das wirklich alle Dateien (achten Sie auch auf mögliche .htaccess-Dateien) korrekt hochgeladen wurden.
3. Die Lizenz-Datei des Plugins (Plugin Name.txt) per FTP in den Ordner /lic des Shops hochladen. Ohne Lizenz-Datei ist das Plugin nicht funktionsfähig!
4. Im Adminbereich des Shops das Plugin über den Menüpunkt: Inhalte -> Plugin -> deinstallierte Plugins installieren.
5. Im Adminbereich des Shops das Plugin über den Menüpunkt: Inhalte -> Plugins -> installierte Plugins aktivieren (ggf. auch für den jeweiligen Mandanten).
6. Zuletzt muss noch der komplette Adminbereich neu geladen werden. Dies geht über den "neu laden" -Button Ihres Browsers oder z.B. die F5-Taste.
7. Weitere Informationen und eine Anleitung finden Sie weiter unten.

Integration & Konfiguration

Integration

Es sind keine zusätzlichen Integrationsschritte notwendig.

Sollten Sie ein eigenes Template verwenden, dass nicht auf dem xt_responsive basiert, muss ggf. der Selector für das Suchfeld angepasst werden:

box-search-box input[name="keywords"]

oder

search-box-form input[name="keywords"]

Standard Suchfunktion deaktivieren:

im Template: /templates/aktives_template/xtCore/boxes/box_search.html
in das <form> die Funktion onsubmit="return false" einfügen:

{form class="search-box-form" type=form name=search_box action='search' link_params=getParams method=get conn=SSL onsubmit="return false"}

Suchwörter mit 3 oder weniger Zeichen zulassen

Standardmäßig werden nur Wörter mit mindestens 4 Zeichen oder mehr in der Suche berücksichtigt. D.h. Wörter wie z.B. "das", "der", "und" usw. werden nicht berücksichtigt. In der Regel ist das gut so und gewollt, es kann aber in Einzellfällen (z.B. für Abkürzungen) auch sinnvoll sein nach Wörtern mit 3 oder sogar 2 Zeichen zu suchen.

Folgende Einstellung muss dafür am MYSQL Server gesetzt werden:

• ft_min_word_len=3
• innodb_ft_min_token_size=3
• MYSQL Server neu starten
• FULLTEXT-Indizes neu erstellen

Wenn sie keinen Zugriff auf die entsprechende Konfigurationsdatei für den MYSQL Server haben, müssen Sie ihren Hoster kontaktieren und die Werte anpassen lassen.

Anschließend müssen die FULLTEXT-Indizes neu erstellt werden. Das geht z.B. über PhpMyAdmin indem einfach alle Tabellen ausgewählt werden und ganz unten in dem Dropdown "Repariere Tabelle" auswählen. In dem Zuge empfiehlt es sich auch noch den gleichen Vorgang mit "Optimiere Tabelle" durch zu führen.

Weitere Anpassungen

Anpassungen am Design (CSS)

Grundsätzlich können Sie das Plugin optisch frei nach Ihren Wünschen anpassen, ohne dass Sie Dateien des Plugins "Plugin Name" verändern müssen. Das hat den Vorteil, dass bei einem Update keine Dateien überschrieben und Änderungen verloren gehen.

CSS Anpassungen:
Sie können die gewünschten CSS-Regeln in Ihre CSS-Datei des aktiven Templates einfügen und beeinflussen. Regeln in Ihrer eigenen CSS-Datei werden die Regeln im Plugin überschreiben.

Erweiterte Anpassungen:
Darüber hinaus können Sie die Template-Datei des Plugins in Ihr eigenes Template kopieren und so auch dieses anpassen. Sie können auch die Template-Dateien direkt im Plugin ändern, wir empfehlen aber das Vorgehen wie zuvor beschrieben.

Gehen Sie zum kopieren der Template-Dateien (sofern im Plugin vorhanden) wie folgt vor:

• Kopieren aller Dateien im Ordner: plugins/Plugin Name/templates/
• Einfügen in: templates/[MY_TEMPLATE]/plugins/Plugin Name/

Achtung: Unsachgemäße Änderungen an der Template-Datei (auch in Ihrem eigenem Template) können dazu führen, dass das Plugin oder der Shop nicht mehr korrekt funktionieren.

Language Keys (Sprachtexte)

Wenn Sie Texte im Shop (Template) ausgeben möchten oder vorhandenen bearbeiten möchten, wird das am besten über die sog. Language Keys realisiert. Das hat den Vorteil das diese mehrsprachig angelegt werden können und außerdem über den Adminbereich verwaltet werden.

Die Language Keys finden Sie hier: Einstellungen -> Lokalisierung -> Sprachtexte

Über den Button "Neu" können Sie einen neuen Language Key anlegen.
Über den "Bearbeiten" Button können vorhandene Texte angepasst werden.
Bei "Schlüssel" hinterlegen Sie den Namen für den Language Key, so wie dieser im Templat eingefügt wird. Beispiel: TEXT_MEIN_LANGUAGE_KEY
Bei "Klasse" können Sie wählen ob der Language Key im Frontend, Backend oder an beiden Stellen zur Verfügung stehen soll.
Bei "Text" wird die jeweilige Übersetzung (Text) eingegeben.

Nun kann der Language Key wie folgt an einer beliebigen Stelle im Shop (auch in Plugins) eingefügt werden:

{txt key=TEXT_MEIN_LANGUAGE_KEY}