M0098 Erfolgszähler für Gambio
Handbuch
1. Was das Modul leistet
Das Modul blendet im Shop animierte Kennzahlen ein – zum Beispiel die Anzahl der Jahre, die es Ihren Shop schon gibt, die Zahl der ausgelieferten Bestellungen, der registrierten Kunden, der abgegebenen Bewertungen oder der geführten Hersteller. Jeder Zähler zählt beim Erscheinen auf dem Bildschirm sichtbar auf seinen Zielwert hoch (oder von einem höheren Startwert herunter).
Sie legen so viele Zähler an, wie Sie möchten. Jeder Zähler bekommt eine Beschriftung in jeder Sprache Ihres Shops, ein Symbol und eine Kennzahl. Der Wert ist dabei entweder eine feste Zahl, eine der vorbereiteten Kennzahlen, die das Modul laufend selbst aus Ihrer Shopdatenbank ermittelt, oder eine Abfrage, die Sie selbst hinterlegen.
Die Anzeige wird als Widget im StyleEdit an der Stelle platziert, an der Sie sie haben möchten – üblicherweise auf der Startseite. Oberhalb der Zähler lässt sich wahlweise ein frei gestalteter Inhalt aus dem Content-Manager einblenden, etwa ein einleitender Satz.
2. Wo Sie das Modul im Backend finden
Das Modul hat zwei Anlaufstellen, beide im Menü „Xycons-Module“:
| Was | Wo |
|---|---|
| Das Setup | Menü „Xycons-Module“ ► „Kundenkonto / Setups“, dort der TAB „Erfolgszähler“. Hier stehen die Einstellungen, die für alle Zähler gemeinsam gelten. |
| Die Zählerverwaltung | Menü „Xycons-Module“ ► „Erfolgszähler“. Hier legen Sie die einzelnen Zähler an und bearbeiten sie. |
Richten Sie zuerst das Setup ein, legen Sie danach Ihre Zähler an und platzieren Sie zuletzt das Anzeige-Widget.
3. Das Setup
Im Setup stehen die Einstellungen, die für alle Zähler gemeinsam gelten. Solange Sie einrichten, hilft Ihnen der Admin-Modus (Abschnitt 3.4): Sie sehen die Zähler dann bereits im Shop, Ihre Besucher aber noch nicht.
3.1 Modul und Lizenz
| Einstellung | Bedeutung |
|---|---|
| Modulstatus - Erfolgszähler | Schaltet das Modul ein oder aus. Solange das Modul ausgeschaltet ist, erscheint im Shop nichts – auch dann nicht, wenn Zähler angelegt und das Widget platziert ist. (Standard: Ausgeschaltet) |
| Ihre Lizenz: | Zeigt an, welcher Lizenztyp für Ihren Shop erkannt wurde. Reine Anzeige. |
3.2 Inhalt oberhalb der Zähler
| Einstellung | Bedeutung |
|---|---|
| Content | Die Nummer eines Inhalts aus dem Content-Manager, der oberhalb der Zähler eingeblendet wird – zum Beispiel eine Überschrift oder ein einleitender Satz. Lassen Sie das Feld leer, wenn Sie keinen Text darüber möchten. (Standard: leer) |
Den Inhalt legen Sie im Admin unter „Inhalte“ ► „Content-Manager“ im TAB „Elemente“ im Abschnitt „Sonstige“ an. Die Nummer, die Sie hier eintragen müssen, wird Ihnen in der Liste angezeigt, wenn Sie mit der Maus auf der Zeile des Inhalts stehen bleiben.
3.3 Anzeige im Shop
| Einstellung | Bedeutung |
|---|---|
| Kacheln je Reihe | Wie viele Zähler auf einem breiten Bildschirm nebeneinander stehen (2 bis 6). Haben Sie mehr Zähler angelegt, rücken die übrigen in die nächste Reihe. Auf Tablets und Telefonen verringert das Modul die Anzahl von selbst, damit die Zahlen lesbar bleiben. (Standard: 5) |
| Multi-Run | Steuert, ob der Zählvorgang wiederholt wird. Bei Nein zählen die Zähler genau einmal hoch, sobald sie zum ersten Mal in den sichtbaren Bildschirmbereich kommen, und bleiben dann stehen. Bei Ja läuft die Animation jedes Mal erneut, wenn der Besucher wegscrollt und den Bereich später wieder hereinholt. (Standard: Nein) |
| Zähldauer | Wie lange der Zählvorgang dauert, in Millisekunden. 5000 bedeutet: Der Zähler braucht fünf Sekunden vom Startwert bis zum Zielwert. Kleinere Werte wirken flotter, größere feierlicher. Zulässig sind 100 bis 60000. (Standard: 5000) |
| Tausendertrennzeichen | Bestimmt, ob große Zahlen gegliedert dargestellt werden (12.345 statt 12345). Das Trennzeichen richtet sich nach der Sprache, in der der Besucher den Shop gerade betrachtet. (Standard: Ja) |
3.4 Betrieb
| Einstellung | Bedeutung |
|---|---|
| Admin-Modus | Bei Ja, nur Admins anzeigen sehen ausschließlich angemeldete Administratoren die Zähler. So können Sie die Werte in Ruhe einrichten und im Shop kontrollieren, bevor Ihre Besucher sie zu Gesicht bekommen. Nach dem Einrichten auf Nein, keine Einschränkung stellen – sonst sieht sie nie jemand. (Standard: Nein, keine Einschränkung) |
| Zwischenspeicher | Wie lange – in Minuten – einmal ermittelte Zählerwerte aufbewahrt werden, bevor sie neu aus der Datenbank geholt werden. Mit dem Standardwert 60 werden die Zähler einmal je Stunde berechnet statt bei jedem einzelnen Seitenaufruf jedes Besuchers. Das entlastet Ihren Shop spürbar, sobald ein Zähler seinen Wert aus der Datenbank holt. 0 schaltet den Zwischenspeicher ab; dann ist jeder Zähler auf die Sekunde aktuell, jede Shopseite fragt dafür aber die Datenbank. (Standard: 60) |
4. Die Zählerverwaltung
Die einzelnen Zähler verwalten Sie über das Menü „Xycons-Module“ ► „Erfolgszähler“.
4.1 Die Übersicht
Die Übersicht listet alle angelegten Zähler in der Reihenfolge, in der sie im Shop nebeneinander erscheinen.
| Spalte bzw. Schaltfläche | Bedeutung |
|---|---|
| Reihenfolge | Kleinere Zahlen stehen weiter links. |
| Beschriftung | Der Text unter der Zahl, in der Sprache, in der Sie gerade im Backend arbeiten. Darunter steht ggf. der gewählte Vorsatz und die Einheit. |
| Kennzahl | Woher der Wert kommt. |
| Eigener Wert | Nur belegt bei „Feste Zahl“ und „Eigene Abfrage (SQL)“. |
| Startwert | Die Zahl, bei der der Zählvorgang beginnt. |
| Symbol | Das Symbol über der Zahl, mit der zugehörigen FontAwesome-Klasse. |
| Aktiv | Schiebeschalter: Ausgeschaltete Zähler erscheinen im Shop nicht; die übrigen rücken auf. |
| Auge | Ermittelt den Wert dieses Zählers sofort und zeigt ihn in einem Fenster an – siehe Abschnitt 4.6. |
| Stift | Öffnet den Zähler zum Bearbeiten. |
| Papierkorb | Löscht den Zähler nach einer Rückfrage. |
Über „Neuer Zähler“ oben rechts legen Sie einen weiteren Zähler an. Die Bearbeitungsmaske ist beim Anlegen und beim Bearbeiten dieselbe und besteht aus vier Abschnitten.
4.2 Grundeinstellungen
| Feld | Bedeutung |
|---|---|
| Zähler aktiv | Ob dieser Zähler im Shop erscheint. Ausgeschaltete Zähler bleiben erhalten, werden aber nicht angezeigt – praktisch, um einen Zähler vorzubereiten oder vorübergehend auszublenden. (Standard bei neuen Zählern: Ja) |
| Reihenfolge | Bestimmt die Position. Kleinere Zahlen stehen weiter links. Lassen Sie Lücken (10, 20, 30 …), dann können Sie später bequem etwas dazwischenschieben. (Standard: 0) |
4.3 Beschriftung je Sprache
| Feld | Bedeutung |
|---|---|
| Beschriftung | Der Text unter der Zahl. Sie erhalten je Shopsprache ein eigenes Feld – bei einem zweisprachigen Shop also zwei, bei einem fünfsprachigen fünf. Bleibt ein Feld leer, verwendet das Modul die Beschriftung einer anderen Sprache, damit die Kachel nicht ohne Text dasteht. |
4.4 Woher kommt der Wert?
| Feld | Bedeutung |
|---|---|
| Kennzahl | Die Quelle des Wertes. Wählen Sie eine der vorbereiteten Kennzahlen (Abschnitt 5.1), dann ermittelt das Modul den Wert selbst und hält ihn laufend aktuell – Sie müssen nichts weiter eintragen. Für eine feste Zahl wählen Sie „Feste Zahl“, für eine selbst geschriebene Abfrage „Eigene Abfrage (SQL)“. |
| Eigener Wert | Nur bei „Feste Zahl“ und „Eigene Abfrage (SQL)“ auszufüllen – bei allen anderen Kennzahlen blendet sich das Feld von selbst aus. Feste Zahl: einfach die Zahl eintragen, z. B. 24. Eigene Abfrage: siehe Abschnitt 5.2. |
4.5 Darstellung
| Feld | Bedeutung |
|---|---|
| Startwert | Die Zahl, bei der der Zählvorgang beginnt. 0 bedeutet: Der Zähler startet bei null und zählt hoch zum Zielwert. Tragen Sie einen Wert oberhalb des Zielwertes ein, zählt der Zähler von dort herunter. (Standard: 0) |
| Symbol (FontAwesome) | Das Symbol über der Zahl, angegeben als FontAwesome-Klasse, zum Beispiel fas fa-users. Direkt darunter sehen Sie das Symbol – so merken Sie sofort, wenn die Angabe nicht stimmt. Näheres in Kapitel 7. |
| Vorsatz | Text, der unmittelbar vor der Zahl steht, zum Beispiel über oder +. Darf leer bleiben. |
| Einheit | Text, der unmittelbar hinter der Zahl steht, zum Beispiel kg, € oder +. Darf leer bleiben. |
| Nachkommastellen | Wie viele Nachkommastellen die Zahl zeigt (0 bis 4). Für Stückzahlen bleibt es bei 0; für Gewichte oder Beträge sind 1 oder 2 sinnvoll. (Standard: 0) |
4.6 Den Wert vorab prüfen
Sie müssen nicht speichern und in den Shop wechseln, um zu sehen, was ein Zähler anzeigen wird. An zwei Stellen ermittelt das Modul den Wert sofort:
- In der Übersicht über das Auge in der Zeile des Zählers – für den gespeicherten Stand.
- In der Bearbeitungsmaske über „Wert jetzt ermitteln“ – für das, was gerade in den Feldern steht, auch ungespeichert.
Stimmt etwas nicht, erscheint statt der Zahl ein Hinweis im Klartext, zum Beispiel dass die Abfrage keine Spalte Counter liefert oder dass sie aus Sicherheitsgründen abgewiesen wurde.
5. Die Kennzahlen im Überblick
5.1 Die vorbereiteten Kennzahlen
Für die gängigen Zahlen müssen Sie nichts eintragen – wählen Sie einfach aus:
| Kennzahl | Was gezählt wird |
|---|---|
| Anzahl Bestellungen | Alle Bestellungen in Ihrem Shop. |
| Höchste Bestellnummer | Die größte vergebene Bestellnummer. Wirkt oft beeindruckender als die reine Anzahl, wenn Ihre Nummernfolge nicht bei 1 beginnt. |
| Anzahl Kunden | Alle angelegten Kundenkonten. |
| Anzahl aktiver Artikel | Alle Artikel, die im Shop eingeschaltet sind. |
| Verkaufte Artikel (Stückzahl) | Die Summe aller bestellten Stückzahlen – nicht die Anzahl der Bestellungen. |
| Anzahl Bewertungen | Alle abgegebenen Artikelbewertungen. |
| Anzahl Hersteller | Alle im Shop geführten Hersteller. |
| Anzahl Kategorien | Alle Warengruppen Ihres Shops. |
| Versandtes Gesamtgewicht | Die Summe der Versandgewichte aller Bestellungen (ohne stornierte). Hier bietet sich die Einheit kg an. |
| Feste Zahl (von Hand eingetragen) | Sie tragen die Zahl selbst ein – für Angaben wie „Jahre am Markt“, die in keiner Datenbank stehen. |
| Eigene Abfrage (SQL) | Sie hinterlegen die Abfrage selbst – siehe Abschnitt 5.2. |
5.2 Eine eigene Abfrage hinterlegen
Brauchen Sie eine Zahl, die nicht in der Liste steht, wählen Sie „Eigene Abfrage (SQL)“ und tragen die Abfrage in das Feld „Eigener Wert“ ein. Das Modul erwartet eine lesende Abfrage, die genau einen Wert zurückgibt, und dieser Wert muss den Namen Counter tragen. Dafür sorgt der Zusatz AS Counter:
SELECT COUNT(*) AS Counter FROM orders;
Gelesen: „Zähle alle Bestellungen und gib das Ergebnis unter dem Namen Counter zurück.“ Genau diesen Wert übernimmt das Modul als Zielwert des Zählers.
SELECT beginnt. Mehrere aneinandergehängte Anweisungen, Kommentare und alles, was Daten verändern würde, werden abgewiesen – und zwar bereits beim Speichern, mit einer Meldung im Klartext.5.3 Fertige Beispiele zum Übernehmen
| Kennzahl | Eintrag im Feld „Eigener Wert“ |
|---|---|
| Kunden seit einem Stichtag | SELECT COUNT(*) AS Counter FROM customers WHERE customers_date_added > '2020-01-01'; |
| Artikel einer Kategorie | SELECT COUNT(*) AS Counter FROM products_to_categories WHERE categories_id = '12'; |
| Bestellungen des laufenden Jahres | SELECT COUNT(*) AS Counter FROM orders WHERE YEAR(date_purchased) = YEAR(NOW()); |
| Newsletter-Empfänger | SELECT COUNT(*) AS Counter FROM customers WHERE customers_newsletter = '1'; |
| Durchschnittliche Bewertung | SELECT ROUND(AVG(reviews_rating),1) AS Counter FROM reviews; (dazu 1 Nachkommastelle einstellen) |
Ob eine Abfrage das liefert, was Sie erwarten, prüfen Sie am schnellsten über „Wert jetzt ermitteln“ in der Bearbeitungsmaske. Alternativ können Sie sie im Admin unter „Toolbox“ ► „SQL“ ausprobieren; dort muss eine einzige Spalte mit der Überschrift Counter und dem erwarteten Wert erscheinen.
6. Das Anzeige-Widget im Theme platzieren
Ist das Modul eingeschaltet und sind die gewünschten Zähler angelegt, fehlt nur noch die Stelle, an der die Anzeige erscheinen soll.
- Öffnen Sie den StyleEdit über „Inhalte“ ► „Template-Einstellungen“ ► „Theme bearbeiten“.
- Wechseln Sie auf den TAB „Widgets“.
- Dort finden Sie das Widget „Erfolgszähler“. Ziehen Sie es bei gedrückter Maustaste an die gewünschte Stelle – üblicherweise auf die Startseite.
- Speichern Sie die Änderung und rufen Sie anschließend Ihre Startseite auf.
Im StyleEdit selbst sehen Sie an der Stelle des Widgets nur einen Hinweistext – die Zähler werden erst im laufenden Shop erzeugt.
7. Symbole für die Zähler auswählen
Über jeder Zahl steht ein Symbol. Welches es ist, bestimmen Sie im Feld „Symbol (FontAwesome)“ des jeweiligen Zählers. Eingetragen wird die Klassenangabe eines FontAwesome-Symbols, also beispielsweise:
fas fa-users fas fa-shopping-cart fas fa-history fas fa-star fas fa-industry fas fa-truck
Eine Übersicht aller verfügbaren Symbole samt der zugehörigen Klassenangabe finden Sie unter fontawesome.com. Suchen Sie dort das gewünschte Symbol und übernehmen Sie die angezeigte Klasse unverändert in das Feld.
8. Modultexte ändern
Modultexte können Sie – wie bei allen Modulen von uns – über die Shopfunktion „Texte ändern“ im Admin-Bereich an eigene Bedürfnisse anpassen. Das betrifft die Beschriftungen der Bedienoberfläche und die Hilfetexte im Setup.
9. Aussehen der Zähler anpassen
Die Zähler bringen ein schlichtes eigenes Aussehen mit: Kacheln in einem Raster, mit hellem Hintergrund und gestrichelter Umrandung. Wie viele Kacheln nebeneinander stehen, bestimmen Sie im Setup über „Kacheln je Reihe“; auf schmalen Bildschirmen bricht das Raster von selbst um.
Möchten Sie Farben, Rahmen oder Schriftgrößen an Ihr Theme angleichen, lässt sich das über die eigenen Gestaltungsangaben Ihres Themes erledigen. Maßgeblich sind die Bezeichner .successcounter für den Gesamtbereich sowie .box, .icon, .counter und .text für die einzelnen Bestandteile einer Kachel.
10. Umstieg von einer Vorgängerversion
Bis Version 2.11 waren genau fünf Zähler vorgesehen, und sie wurden im Setup eingerichtet. Ab Version 2.12 gibt es stattdessen die Zählerverwaltung aus Kapitel 4.
Sie müssen dafür nichts tun. Beim ersten Aufruf des Adminbereichs nach der Aktualisierung übernimmt das Modul Ihre bisherigen Zähler selbständig in die neue Verwaltung – samt Wert, Startwert, Symbol, Ein/Aus-Zustand und den Beschriftungen in allen Sprachen Ihres Shops. Die alten Felder verschwinden danach aus dem Setup, weil es sie nicht mehr braucht.
| Was sich ändert | Wo es jetzt steht |
|---|---|
| Erfolgszähler -1- bis -5- | Je ein Eintrag in der Zählerverwaltung, Feld „Zähler aktiv“. |
| Wert -1- bis -5- | Felder „Kennzahl“ und „Eigener Wert“. |
| Startwert -1- bis -5- | Feld „Startwert“. |
| FA-Icon -1- bis -5- | Feld „Symbol (FontAwesome)“. |
| Anzeigetexte über „Texte ändern“ | Feld „Beschriftung“, je Shopsprache. |
11. Shopupdate und Modulpflege
Ein Modul passt sich einer neuen Shopversion nicht von selbst an. Bitte beachten Sie deshalb vor jedem Shopupdate:
- Vorher prüfen: Sehen Sie auf unserer Seite www.xycons.de nach, ob das Modul für die geplante neue Shopversion freigegeben ist.
- Immer mitaktualisieren: Installieren Sie beim Shopupdate stets die neuesten Fassungen des Moduls und der Modulumgebung – nicht nur den Shop. Wird nur der Shop aktualisiert, arbeitet das Modul danach möglicherweise nicht mehr richtig.
Wenn wir das Update Ihres Shops für Sie durchführen, aktualisieren wir Modulumgebung und Module immer mit, sofern die passenden Fassungen vorliegen.
12. Problembehandlung
| Beobachtung | Das sollten Sie prüfen |
|---|---|
| Die Zähler erscheinen gar nicht | Ist das Modul im Setup eingeschaltet? Wurde das Widget im StyleEdit platziert und gespeichert? Ist in der Zählerverwaltung mindestens ein Zähler angelegt und aktiv? |
| Die Zähler sieht nur der Administrator | Der Admin-Modus steht noch auf „Ja, nur Admins anzeigen“. Stellen Sie ihn auf „Nein, keine Einschränkung“. |
| Ein Zähler steht auf 0 | Prüfen Sie ihn über das Auge in der Übersicht – dort steht im Klartext, woran es liegt. Häufig: die eigene Abfrage liefert keine Spalte Counter, oder es gibt schlicht noch keine Datensätze. |
| Ein Zähler zeigt einen veralteten Wert | Der Zwischenspeicher ist noch gültig. Warten Sie die eingestellte Anzahl Minuten ab, leeren Sie den Cache des Shops oder setzen Sie den Zwischenspeicher im Setup auf 0. |
| Statt des Symbols erscheint ein Fragezeichen | Das Feld „Symbol“ ist leer oder die Klassenangabe stimmt nicht. Die Vorschau unter dem Feld zeigt es Ihnen sofort. |
| Der Zähler zählt rückwärts | Im Feld „Startwert“ steht eine Zahl oberhalb des Zielwertes. Tragen Sie 0 ein. |
| Die Kacheln stehen ungünstig | Stellen Sie im Setup „Kacheln je Reihe“ passend zur Anzahl Ihrer Zähler ein – bei sechs Zählern etwa 3 (zwei Reihen zu dritt) oder 6 (eine Reihe). |
| Der Inhalt oberhalb der Zähler fehlt | Wurde er im Content-Manager im TAB „Elemente“ im Abschnitt „Sonstige“ angelegt? Steht die richtige Nummer im Feld „Content“? Gibt es den Inhalt in der aufgerufenen Sprache? |
| Eine Beschriftung fehlt in einer Sprache | Öffnen Sie den Zähler und füllen Sie das Feld für diese Sprache. Solange es leer ist, zeigt das Modul die Beschriftung einer anderen Sprache. |
Kommen Sie damit nicht weiter, wenden Sie sich gern an uns. Nennen Sie dabei bitte Ihre Shopversion sowie die Version des Moduls und der Modulumgebung.
Wir wünschen Ihnen viel Erfolg beim Einsatz dieses Moduls!
