Kaufberater für PrestaShop 8 & 9: Dokumentation

Überblick

Das Modul erstellt Kaufberater-Seiten aus Ihrem Katalog. Jeder Kaufberater beantwortet eine Kundenfrage, zum Beispiel „Welchen Saugroboter für eine Wohnung mit Haustieren?“. Sie wählen die verglichenen Produkte und die Kriterien, das Modul berechnet für jedes Produkt eine Punktzahl bis 100, bestimmt drei Empfehlungen und erzeugt Ranking, Vergleichstabelle, Statistiken und FAQ. Das Ranking wird neu berechnet, wenn sich der Katalog ändert.

Installation

1. Klicken Sie unter Module > Modul-Manager auf Modul hochladen und wählen Sie dfbuyingguide-1.1.0.zip.
2. Die Installation legt den Tab Katalog > Kaufberater, die Modultabellen und den Ordner img/dfbuyingguide/ für die Titelbilder an.
3. Der Button Konfigurieren des Moduls öffnet diesen Tab direkt.

Ab Version 1.0.0 laden Sie einfach das ZIP 1.1.0 hoch: Das Update-Skript ergänzt die Spalten und Statistiktabellen, ohne Ihre Kaufberater zu verändern.

Allgemeine Einstellungen

Das Panel Einstellungen unter der Liste der Kaufberater enthält:

• URL-Präfix: standardmäßig guides. Die Kaufberater liegen unter /guides/url-des-ratgebers, die Übersicht aller Kaufberater unter /guides.
• Maximales Alter eines Rankings: standardmäßig 12 Stunden. Danach wird ein Ranking beim nächsten Aufruf neu berechnet, auch ohne Katalogänderung. So werden geplante Aktionen berücksichtigt.
• Analysierte Produkte pro Ratgeber: standardmäßig 300. Die meistverkauften Produkte des Umfangs werden zuerst analysiert. Für große Kategorien erhöhen, bis 5.000.
• Ratgeber-Badge auf Produktseiten anzeigen: Produkte mit einer Empfehlung oder einem Platz unter den ersten 3 zeigen einen Link zum Kaufberater.
• Ratgeber auf Kategorieseiten anzeigen: Ein Block unten in den Kategorien listet die Kaufberater, deren Umfang die Kategorie enthält.
• Reichweite und Verkäufe messen: aktiviert die Statistik und das Zuordnungs-Cookie dfbg_attr (siehe unten).

Einen Kaufberater anlegen

Klicken Sie auf Kaufratgeber hinzufügen. Die wichtigsten Felder:

• Titel: als Frage des Kunden formulieren. Ein Kaufberater wird nur in den Sprachen veröffentlicht, in denen er einen Titel hat.
• Sprechende URL: wird aus dem Titel erzeugt, wenn sie leer bleibt.
• Titelbild: oben im Kaufberater, auf der Übersichtsseite und beim Teilen angezeigt. Querformat, mindestens 1.200 px breit. Es wird auf höchstens 1.600 px Breite verkleinert.
• Autor und Funktion des Autors: unter dem Titel angezeigt und in die strukturierten Daten übernommen.
• Einleitung: für wen der Kaufberater gedacht ist und was bei diesem Einsatz zählt.
• Verglichene Produkte: die Kategorien des Umfangs. Keine Kategorie angehakt bedeutet der gesamte Katalog. Unterkategorien einbeziehen ist standardmäßig aktiv.
• Mindestpreis und Höchstpreis: 0 bedeutet keine Grenze. Maßgeblich ist der Preis, den Besucher sehen, in der Standardwährung. Praktisch für einen Kaufberater wie „Die besten Modelle unter 300 €“.
• Nur Produkte auf Lager: schließt ausverkaufte Produkte aus, wenn die Lagerverwaltung aktiv ist.
• Produkte im Ranking: 1 bis 20, standardmäßig 5. Die Empfehlungen werden immer angezeigt, auch außerhalb dieses Rankings.
• Schwelle der Budget-Empfehlung: standardmäßig 50 % (siehe „Die drei Empfehlungen“).
• Besucher können das Ranking anpassen, Vergleichstabelle anzeigen, FAQ anzeigen.
• Zusätzliche Fragen: eine Frage pro Zeile im Format Frage | Antwort. Sie werden nach den erzeugten Fragen angefügt.
• Fazit, Meta-Titel und Meta-Beschreibung: Titel und Anfang der Einleitung dienen als Standardwerte.
• Veröffentlicht: Ein unveröffentlichter Kaufberater lässt sich im Backoffice als Vorschau öffnen.

Klicken Sie auf Speichern und bleiben: Unter dem Formular erscheinen die Panels für Kriterien, aktuelles Ranking, Reichweite und Verlauf.

Die Kriterien

Ohne Kriterien werden die Produkte nach Verkäufen sortiert. Klicken Sie auf Kriterium hinzufügen und wählen Sie einen Typ.

Kriterientypen

• Merkmal: bevorzugte Werte: Sie vergeben 0 bis 100 Punkte für jeden Wert eines Merkmals, zum Beispiel Material: Edelstahl 100, Aluminium 70, Kunststoff 30. Nach dem ersten Speichern zeigt das Formular alle Werte des Merkmals mit Schieberegler und Buttons, um alle Werte auf einmal zu füllen. Ein Produkt mit mehreren Werten behält den besten.
• Merkmal: Zahlenwert: Das Modul liest die Zahl im Wert („90 min“, „1.200 W“, „2,5 kg“) und vergleicht die Produkte. Legen Sie unter Bevorzugte Werte fest, ob höher oder niedriger besser ist. Mindestwert und Höchstwert schließen Produkte außerhalb des Bereichs oder ohne Wert aus. Einheit wird an die Zahlen der Statistik angehängt.
• Preis (niedriger ist besser).
• Verkäufe (Beliebtheit): basiert auf den verkauften Mengen.
• Neue Produkte: basiert auf dem Anlagedatum des Produkts.

Gewicht, Pflicht und Texte

• Gewicht: 0 bis 10. Gewicht 0 zeigt das Kriterium in der Vergleichstabelle, ohne es in die Punktzahl einzurechnen.
• Pflicht (Merkmalskriterien): Produkte ohne dieses Merkmal oder mit einem Wert von 0 Punkten werden aus dem Kaufberater ausgeschlossen.
• Für Besucher angezeigte Bezeichnung: bleibt sie leer, wird der Merkmalsname verwendet.
• Kauftipp: erklärt, warum das Kriterium wichtig ist. Er erscheint im Abschnitt „So wählen Sie“ über den Katalogstatistiken.

Mit den Pfeilen der Kriterienliste ändern Sie die Reihenfolge in der Vergleichstabelle und im Abschnitt „So wählen Sie“.

Berechnung der Punktzahl

Für jedes Kriterium werden die Produktwerte auf eine Skala von 0 bis 100 gebracht: Bei numerischen Kriterien, Preis, Verkäufen und Neuheit erhält das beste Produkt des Umfangs 100 und das schwächste 0, bei Wertekriterien gelten die von Ihnen vergebenen Punkte. Die Gesamtpunktzahl ist der nach den Kriteriengewichten gewichtete Durchschnitt. Preise werden in der Standardwährung verglichen.

Das Panel Aktuelles Ranking zeigt die ersten 20 Produkte mit Gesamtpunktzahl, Preis, Empfehlung und einer Punktespalte pro Kriterium. Nutzen Sie es, um die Gewichte vor der Veröffentlichung abzustimmen.

Die drei Empfehlungen

• Bester insgesamt: das erstplatzierte Produkt.
• Bestes Preis-Leistungs-Verhältnis: unter den Produkten, die günstiger als der Beste insgesamt sind und mindestens 60 % seiner Punktzahl erreichen, das mit dem besten Verhältnis von Punktzahl zu Preis.
• Bester für kleines Budget: das günstigste Produkt, das den unter Schwelle der Budget-Empfehlung eingestellten Prozentsatz der Punktzahl des Besten insgesamt erreicht, sofern es günstiger als die beiden anderen Empfehlungen ist.

Eine Empfehlung erscheint nur, wenn ein Produkt die Bedingung erfüllt. Stärken eines Produkts sind seine Kriterien mit 70 oder mehr Punkten (höchstens 3), Schwächen die mit 30 oder weniger (höchstens 2).

Aktualisierung der Rankings

Eine Änderung an einem Produkt, einem Sonderpreis, einem Merkmalswert oder einer Kategorie markiert die Rankings zur Neuberechnung. Eine Bestandsänderung markiert nur Kaufberater mit „Nur Produkte auf Lager“. Die Neuberechnung erfolgt:

• beim nächsten Aufruf des Kaufberaters;
• per Cronjob, wenn Sie ihn einrichten;
• mit dem Button Jetzt neu berechnen eines Kaufberaters oder Alle Rankings jetzt neu berechnen in der Liste.

Cronjob

Die Cron-URL steht über der Liste der Kaufberater. Rufen Sie sie stündlich auf, damit Besucher nie auf eine Neuberechnung warten. Mit &force=1 werden alle Kaufberater neu berechnet. Der Button Neues Token ersetzt das Token, die alte URL funktioniert dann nicht mehr. Beispiel:

0 * * * * curl -s "https://ihr-shop.de/index.php?fc=module&module=dfbuyingguide&controller=cron&token=IHR_TOKEN" > /dev/null

Angezeigtes Datum und Verlauf

Das Datum „Ranking aktualisiert am“ ändert sich für Besucher nur, wenn sich die Spitzenplätze oder die Empfehlungen ändern. Das Panel Verlauf der Empfehlungen listet diese Änderungen mit den ersten 5 Produkten zu jedem Datum.

Die Kaufberater-Seite

In dieser Reihenfolge: Titel, Autor, Anzahl verglichener Produkte und Aktualisierungsdatum, Titelbild, Einleitung, Inhaltsverzeichnis, Empfehlungen, Ranking, Vergleichstabelle, Abschnitt „So wählen Sie“, Fazit, FAQ, ein Methodenhinweis und verwandte Kaufberater (veröffentlichte Kaufberater mit gemeinsamer Kategorie).

Ranking anpassen

Ist die Option aktiv und hat der Kaufberater mindestens 2 gewichtete Kriterien, bietet ein Panel über dem Ranking einen Wichtigkeitsregler pro Kriterium und einen Regler für das Höchstbudget. Das Ranking wird im Browser unter den 20 besten Produkten neu berechnet, ohne Neuladen, und ein Link stellt das Ranking des Kaufberaters wieder her. Ohne JavaScript bleibt das Panel ausgeblendet. Suchmaschinen sehen immer das Ranking des Kaufberaters.

In den Warenkorb

Produkte, die sich ohne Variantenwahl direkt in den Warenkorb legen lassen, zeigen einen Button In den Warenkorb, der die Warenkorbfunktion des Themes nutzt. Die übrigen zeigen Zum Produkt. Im Katalogmodus wird kein Warenkorb-Button angezeigt.

Vorschau eines unveröffentlichten Kaufberaters

Der Button Vorschau des Ratgebers öffnet die Seite mit einem Vorschau-Hinweis. Der Link enthält ein Token für diesen Kaufberater, die Seite steht auf noindex und die Statistik zählt nicht mit.

Farben anpassen

Die Farben sind als CSS-Variablen definiert, die Ihr Theme überschreiben kann: --dfbg-accent, --dfbg-accent-soft, --dfbg-muted, --dfbg-line, --dfbg-surface, --dfbg-low und --dfbg-radius. Die Schriften kommen aus dem Theme.

Platzierungen und SEO

• Übersicht der Kaufberater: /guides, mit dem Titelbild oder dem erstplatzierten Produkt jedes Kaufberaters.
• Kategorieseiten: Hook displayFooterCategory.
• Produktseiten: Hook displayProductAdditionalInfo, Empfehlungs-Badge oder „Platz X“ mit Link zum Kaufberater.
• Freie Platzierung: {hook h='displayDfBuyingGuides' id_category=12} in einem Template des Themes. Ohne id_category werden alle Kaufberater gelistet.
• Sitemap: Ist das native Modul gsitemap installiert, werden Übersicht und Kaufberater mit dem Datum ihrer letzten Empfehlungsänderung aufgenommen.
• Strukturierte Daten: Article (mit Autor und Bild), ItemList des Rankings und FAQPage. Open-Graph-Tags werden in den Head eingefügt.
• Mehrsprachigkeit: Canonical, hreflang zu jeder Sprache, in der der Kaufberater einen Titel hat, und 301-Weiterleitung, wenn eine URL in einer anderen Sprache aufgerufen wird.

Reichweite und Verkäufe

Die Liste der Kaufberater zeigt Aufrufe und Umsatz der letzten 30 Tage sowie vier Gesamtkennzahlen oben. Jeder Kaufberater hat ein Panel Reichweite und Verkäufe für 30 Tage und seit Beginn:

• Aufrufe: einer pro Besucher, Kaufberater und Tag, ohne Bots.
• Produktklicks und Klickrate im Verhältnis zu den Aufrufen.
• Klicks auf In den Warenkorb aus dem Ranking.
• Besucher, die das Ranking angepasst haben.
• Bestellungen und Konversionsrate im Verhältnis zu den Aufrufen.
• Umsatz netto: Nettobetrag der Produkte, die über den Kaufberater kamen, umgerechnet in die Standardwährung.

Zuordnung der Verkäufe

Klickt ein Besucher in einem Kaufberater auf ein Produkt, merkt sich das eigene Cookie dfbg_attr Produkt und Kaufberater 30 Tage lang. Kommt das Produkt in den Warenkorb, wird die Zuordnung auf den Warenkorb übertragen. Bei der Bestätigung der Bestellung, auch per Zahlungs-Webhook, werden die Bestellung und der Nettobetrag dieses Produkts dem Kaufberater zugeordnet. Nur bestätigte Bestellungen (Status bezahlt oder gleichwertig) zählen.

Kaufberater duplizieren

Die Aktion Duplizieren in der Liste kopiert den Kaufberater mit Kriterien, Punkten pro Wert, Shops und Bild. Die Kopie wird unveröffentlicht mit einer URL mit Suffix angelegt und öffnet sich direkt zur Bearbeitung.

Multishop

Jeder Kaufberater wird den in seinem Formular gewählten Shops zugeordnet. Rankings, Verlauf und Statistik werden pro Shop berechnet.

Fehlerbehebung

• „Derzeit passt kein Produkt zu diesem Ratgeber“: Prüfen Sie Kategorien, Preisspanne, Lager-Option und Pflicht- oder Schwellenkriterien.
• Ein erwartetes Produkt fehlt: Es muss aktiv, im Katalog sichtbar und unter den analysierten Produkten sein. Erhöhen Sie „Analysierte Produkte pro Ratgeber“ für große Kategorien.
• Der Kaufberater liefert einen 404-Fehler: Er ist nicht veröffentlicht, hat keinen Titel in dieser Sprache oder ist diesem Shop nicht zugeordnet.
• Das Ranking folgt einer Änderung nicht: Klicken Sie auf „Jetzt neu berechnen“ und richten Sie den Cronjob ein.
• Das Titelbild wird abgelehnt: Prüfen Sie, ob der Ordner img/dfbuyingguide/ beschreibbar ist.