Bedienung für Shop-Betreiber

Diese Anleitung richtet sich an Shop-Betreiber und OXID-Admin-Benutzer ohne Server- oder Programmierzugriff. Installation, Composer-Einträge und technische Updates sind unter Installation für Agenturen beschrieben.

Wo sich das Modul befindet

AdminLists ersetzt drei Standardlisten im OXID-Admin durch erweiterte Arbeitslisten:

  • Bestelliste unter Bestellungen verwalten ‣ Bestellungen,

  • Kundenliste unter Benutzer verwalten ‣ Benutzer und

  • Artikelliste unter Artikel verwalten ‣ Artikel.

Jede Liste lässt sich in den Moduleinstellungen einzeln ein- und ausschalten. Die Moduleinstellungen erreichen Sie unter Erweiterungen ‣ Module über den Eintrag „eComStyle.de: AdminLists“ im Tab Einstell.. Sie sind in vier Blöcke gegliedert: „Bestelliste“, „Kundenliste“, „Artikelliste“ und „Artikelliste CSV“.

Tipp

Schalten Sie die drei Listen zuerst einzeln frei und prüfen Sie jede Ansicht, bevor Sie Spalten und Aktionen anpassen. Deaktivierte Schalter stellen die normale OXID-Liste wieder her.

Einstellungen: Bestelliste

Einstellung

Wirkung

Bestellungen-Liste erweitern

Schaltet die erweiterte Bestellliste ein oder aus. Standard: aktiv.

Diese Spalten aus der OXORDER anzeigen

Liste der Spalten der Bestelltabelle, eine je Zeile, zum Beispiel oxordernr. Vorgegeben sind unter anderem Zahlart, Firma, Bestellnummer, Bezahldatum, Rechnungsnummer und -datum, Bestellsumme, Name, Kundennummer, PLZ, Ort und Land.

Gesamtsumme des Ordners anzeigen

Zeigt über der Spalte oxtotalordersum die Summe der Bestellungen im aktuellen Ordner beziehungsweise Filter. Standard: deaktiviert.

Maximale Anzahl für die Gesamtsumme

Begrenzt, wie viele Bestellungen in die Summenberechnung einfließen; Vorgabe 500. Bei zu hohen Werten drohen Performanceprobleme.

Ordner-Switch Dropdown bei jeder Bestellung zeigen

Blendet je Bestellung eine Auswahl ein, mit der Sie die Bestellung direkt in einen anderen Ordner (Neu, Bearbeitet, Probleme) verschieben. Standard: aktiv.

Versandbestätigungs-E-Mail beim Versandt-Klick senden

Versendet beim Markieren als versandt zusätzlich die Standard-Versandmail des Shops an den Kunden. Standard: deaktiviert.

Filter suchen immer in allen Ordnern

Sucht bei gesetzten Filtern auch außerhalb des gerade gewählten Ordners, wenn der Ordner „Neu“ aktiv ist. Standard: aktiv.

CSV Export Buttons für DHL / Hermes / GLS / UPS / DPD

Blendet die Export-Schalter des jeweiligen Paketdienstes in der Bestelliste ein, jeweils für die gefilterte Liste und je einzelne Bestellung. Standard: alle aktiviert.

Aufschlag für Verpackung beim Versandgewicht

Pauschale in Kilogramm, die auf das Positionsgewicht der Bestellung aufgeschlagen wird, zum Beispiel 0.2. Steuert die Gewichtsangabe in den Versand-CSV-Dateien.

E-Mail-Adresse des Kunden an den Paketdienst übermitteln

Steuert, ob die Kunden-E-Mail in die Versand-CSV geschrieben wird: „Niemals“, „Immer“ oder „Zustimmung mit ShippingMailConsent erteilt“. Standard: „Niemals“.

Achtung

Die Übermittlung der Kunden-E-Mail-Adresse an Paketdienste ist eine Datenübertragung an Dritte. Prüfen Sie, ob dafür eine Rechtsgrundlage beziehungsweise Kundenzustimmung vorliegt. Diese Einschätzung ersetzt keine Rechtsberatung.

Einstellungen: Kundenliste

Einstellung

Wirkung

Benutzerliste erweitern

Schaltet die erweiterte Kundenliste ein oder aus. Standard: aktiv.

Diese Spalten aus der OXUSER anzeigen

Liste der Spalten der Kundentabelle, eine je Zeile. Vorgegeben sind Nachname, Vorname, Firma, E-Mail, Straße, Hausnummer, PLZ, Ort, Land, Kundennummer, Telefon und Rechte.

Einstellungen: Artikelliste

Einstellung

Wirkung

Artikelliste erweitern

Schaltet die erweiterte Artikelliste ein oder aus. Standard: aktiv.

Diese Artikelfelder in der Artikelliste zeigen

Feldliste im Format feldname => 1 je Zeile. => 1 macht das Feld in der Liste editierbar, => 0 zeigt es schreibgeschützt. Vorgegeben sind Preis, Einkaufspreis, UVP, EAN, Lagerbestand, Verkauft (schreibgeschützt) und Hersteller.

Dezimalstellen der Preisfelder

Nachkommastellen für Preisfelder in der Liste, Vorgabe 4.

Erweiterte Suche in der Artikelliste zeigen

Blendet eine freie Feld-Suche ein: Sie wählen ein Artikelfeld und suchen direkt darin; das Feld ist gleichzeitig je Artikel editierbar. Standard: deaktiviert.

Varianten eines Artikels suchbar

Zeigt bei Vaterartikeln die Schaltfläche VAR, mit der die Liste auf die Varianten des Artikels wechselt. Standard: deaktiviert.

Artikelicons in der Artikelliste zeigen

Zeigt neben der Artikelnummer ein kleines Vorschaubild, das beim Überfahren mit der Maus vergrößert wird. Standard: aktiv.

Fix-Button bei OXSOLDAMOUNT zeigen

Blendet in der Spalte „Verkauft“ die Schaltfläche Fix ein, die den gespeicherten Verkaufszähler aus den tatsächlich bestellten, nicht stornierten Positionen neu berechnet. Standard: deaktiviert.

Enter speichert alle sichtbaren Artikel

Aktiv: Die Eingabetaste speichert alle sichtbaren Artikel. Inaktiv: Die Eingabetaste speichert nur den Artikel der aktuellen Zeile. Standard: deaktiviert.

Breite der Eingabefelder in px

Breite der Inline-Eingabefelder, Vorgabe 80.

SQL-Bearbeitung in der Artikelliste aktivieren

Blendet unter der Liste ein Eingabeformular für eine direkte SQL-Massenänderung an der Artikeltabelle ein. Standard: deaktiviert.

Warnung

Die SQL-Bearbeitung führt UPDATE-Anweisungen direkt auf der Artikeltabelle des aktiven Shops aus – ohne Rückfrage und ohne Wiederherstellung. Aktivieren Sie sie nur, wenn Sie genau wissen, welche Felder Sie ändern, und sichern Sie vorher die Datenbank. Dieselbe Vorsicht gilt für den Fix-Knopf beim Verkaufszähler.

Einstellungen: Artikelliste CSV

Einstellung

Wirkung

Diese Artikelfelder in der CSV ausgeben

Exportfelder, eines je Zeile. Neben Tabellenfeldern stehen die Pseudofelder vorjahr und aktjahr für die Verkaufsmengen des Vor- beziehungsweise laufenden Jahres zur Verfügung.

Datenfelder mit „ “ einfassen

Setzt jeden Feldwert in Anführungszeichen. Standard: deaktiviert.

Zahlen mit mehr als 11 Zeichen ein ‚ voranstellen

Verhindert, dass Excel lange Nummern wie EAN-Codes kürzt oder umwandelt. Standard: deaktiviert.

CSV-Trennzeichen

Trennzeichen der Exportdatei, Vorgabe ;.

Lieferanten- und Hersteller-ID in den Titel umwandeln

Schreibt statt der internen ID den Namen des Lieferanten beziehungsweise Herstellers in die Datei. Standard: aktiv.

Preise formatieren

Formatiert Preisfelder mit Komma als Dezimaltrennzeichen und ohne Tausendertrennzeichen; verhindert die Excel-Umwandlung in ein Datum. Standard: aktiv.

Dezimalstellen der Preisfelder in der CSV

Nachkommastellen für formatierte Preise, Vorgabe 4.

Maximale Anzahl an Artikeln in der CSV

Begrenzt die Exportgröße, Vorgabe 1000. Bei zu vielen Artikeln drohen Abbrüche durch Zeit- oder Speicherlimits.

Schnellstart

  1. Öffnen Sie Bestellungen verwalten ‣ Bestellungen. Die Liste zeigt jetzt die konfigurierten Spalten mit einem Filterfeld je Spalte.

  2. Filtern Sie zum Beispiel über die Zahlungsart-Auswahl oder geben Sie in der Land-Spalte ein ISO2-Kürzel wie AT ein. Das Globus-Symbol an der Spalte sucht mit dem Wert xxx gezielt Auslandsbestellungen.

  3. Markieren Sie eine Bestellung über das rote beziehungsweise grüne Zeichen als bezahlt und über das graue LKW-Symbol als versandt.

  4. Nutzen Sie dhl, hlg, GLS, UPS oder DPD in der Filterzeile für den Export aller sichtbaren Bestellungen beziehungsweise in der Bestellzeile für eine einzelne Sendung.

Bestelliste im Alltag

Sortierung und Filter

Jede konfigurierte Spalte besitzt ein eigenes Filterfeld und ist über den Spaltenkopf sortierbar. Datumsfelder öffnen eine Datumsauswahl, die Zahlart-Spalte eine Auswahl aller aktiven Zahlarten und die Spalte „Bezahlt“ eine Statusauswahl mit Suchfeld. Über die kleinen Lupen-Symbole bei Firma, Kundennummer, Ort und Land suchen Sie mit einem Klick weitere Bestellungen desselben Kunden, Ortes oder Landes. X setzt alle Filter zurück.

Status und Ordner

  • Bezahlt-Schalter: Ein Klick auf das rote Zeichen setzt das Bezahldatum auf jetzt; ein Klick auf das grüne Zeichen entfernt es nach einer Sicherheitsfrage wieder.

  • Versandt-LKW: Das graue LKW-Symbol setzt das Versanddatum auf jetzt. Nach dem Versand zeigt das Symbol das Versanddatum an; ist eine Sendungsnummer hinterlegt, führt das Symbol zur Tracking-Seite. Ob zusätzlich die Versandmail des Shops ausgeht, steuert die Einstellung „Versandbestätigungs-E-Mail“.

  • Ordnerwechsel: Die Auswahl je Bestellung verschiebt sie ohne weitere Rückfrage in den Ordner Neu, Bearbeitet oder Probleme.

  • Ordnersumme: Bei aktivierter Summenanzeige erscheint über der Summenspalte die Bruttosumme der nicht stornierten Bestellungen des Ordners beziehungsweise des Filters.

Versand-CSV-Export

Die Export-Schalter stehen einmal in der Filterzeile für alle gerade gelisteten beziehungsweise gefilterten Bestellungen und einmal je Bestellung. Die Datei wird sofort zum Download angeboten und ist Windows-1252-kodiert, damit sie sich in die Versandsoftware importieren lässt:

  • DHL: Adressdatei mit Absender aus den Shop-Stammdaten; das Modul wählt das DHL-Produkt (PAK02, PAK05, PAK10, PAK20 oder PAK315) anhand des Bestellgewichts inklusive Verpackungsaufschlag.

  • Hermes (hlg), GLS und DPD Privat: Adressdateien im jeweiligen Importformat; bei GLS und DPD landet die Firmenangabe in den dafür vorgesehenen Feldern.

  • UPS: Komma-getrennte Datei mit Service „UPS Standard“, dem Netto-Bestellwert als Zollwert und dem Einkaufswert der Positionen als deklariertem Warenwert.

Ohne Lieferadresse wird die Rechnungsadresse exportiert. Telefonnummern werden auf Ziffern reduziert. Ob die Kunden-E-Mail mit in die Datei geschrieben wird, hängt von der Einstellung zur E-Mail-Übermittlung ab.

Bemerkung

Die CSV-Dateien enthalten Empfängerdaten und werden an die Software oder den Dienst des jeweiligen Paketdienstes übergeben. Formate und Produktcodes richten sich an den Importvorgaben der Anbieter; prüfen Sie einen ersten Import in Ihrer Versandsoftware, bevor Sie den Export produktiv nutzen.

Kundenliste im Alltag

Die erweiterte Kundenliste zeigt die konfigurierten Spalten mit Filterfeldern. Zusätzlich stehen bereit:

  • Benutzergruppen-Auswahl im Filterbereich: begrenzt die Liste auf Mitglieder der gewählten Gruppe.

  • Umsatz-Spalte: summiert die nicht stornierten Bestellungen des Kunden.

  • Sperr-Schalter User blockieren: nimmt den Kunden in die Gruppen oxidblocked und oxidblacklist auf beziehungsweise entfernt ihn wieder daraus. Gesperrte Kunden können sich nicht mehr einloggen und nicht bestellen.

  • Länderfilter: ISO2-Kürzel filtert ein Land, xxx listet Kunden außerhalb des Heimatlandes.

Artikelliste im Alltag

Inline-Bearbeitung

Jede konfigurierte Spalte erscheint als Eingabefeld direkt in der Zeile. Änderungen speichern Sie je Artikel über Speichern in der Zeile oder für alle sichtbaren Artikel über Alle Speichern im Listenkopf. Die Eingabetaste speichert je nach Einstellung die Zeile oder die ganze Seite. Felder mit => 0 in der Feldliste sind schreibgeschützt.

Zusatzangaben neben den Feldern:

  • Beim Einkaufspreis zeigt das Modul die Differenz zum Verkaufspreis in Prozent und absolut an.

  • Bei Verkauft stehen die Verkaufsmengen des Vorjahres und des laufenden Jahres darunter.

  • Lieferant und Hersteller sind als Auswahlfelder ausgeführt und speichern bei Auswahl sofort.

Suche und Filter

Über der Liste stehen zwei Kontrollkästchen für „nur aktive Artikel“ und „versteckte Artikel nicht zeigen“, die Auswahl nach Kategorie, Hersteller oder Lieferant sowie – bei aktivierter erweiterter Suche – ein frei wählbares Suchfeld. VAR wechselt bei Vaterartikeln in die Variantenansicht und zurück.

CSV-Export

CSV in der Filterzeile exportiert die gerade gefilterte Artikelliste mit den unter „Artikelliste CSV“ konfigurierten Feldern als oxarticles.csv. Neben Tabellenfeldern liefern die Pseudofelder vorjahr und aktjahr die Verkaufsmengen der Jahre. Die Datei ist Windows-1252-kodiert.

SQL-Bearbeitung

Ist die Option aktiviert, erscheint unter der Liste ein Formular nach dem Schema UPDATE oxarticles SET feld = wert WHERE feld operator wert. Als Operatoren stehen =, !=, >, < und like zur Verfügung; die Änderung gilt immer nur für den aktiven Shop. Nach der Ausführung meldet das Modul die Zahl der geänderten Artikel.

Warnung

Massenänderungen lassen sich nicht zurücknehmen. Testen Sie die Bedingung zuerst mit einem passenden Filter in der Liste und sichern Sie die Datenbank, bevor Sie das Formular produktiv einsetzen.

Grenzen und Hinweise

  • Das Modul lädt Versanddaten nur als CSV herunter. Es erstellt keine Versandlabels, bucht keine Sendungen und überträgt nichts selbst an die Paketdienste.

  • „Als versandt markieren“ setzt nur das Versanddatum; die optionale E-Mail ist die Standard-Versandbestätigung des Shops, kein eigenes Modul-Template.

  • Der Sperr-Schalter wirkt sofort auf Kundenkonto und Bestellmöglichkeit; eine Sperrhistorie oder Begründung wird nicht geführt.

  • Die Umsatz- und Verkaufszahlen werten nicht stornierte Bestellungen des aktiven Shops aus; Retouren oder Gutschriften werden nicht abgezogen.

  • Die erweiterte Suche und große CSV-Exporte arbeiten direkt auf der Datenbank; bei sehr großen Datenbeständen die konfigurierten Grenzen beachten.

  • Alle Aktionen gelten für den gerade aktiven (Mandanten-)Shop.

Häufige Anwenderfragen

Die Liste sieht aus wie vorher

Die jeweilige Erweiterungs-Option („Bestellungen-Liste erweitern“, „Benutzerliste erweitern“, „Artikelliste erweitern“) ist deaktiviert oder der Shopcache wurde nach der Installation nicht geleert. Prüfen Sie die Moduleinstellungen und leeren Sie den Cache.

Eine Spalte fehlt oder zeigt falsche Werte

Prüfen Sie die Feldliste der betreffenden Einstellungsgruppe: ein Feld je Zeile, Schreibweise exakt wie der Datenbankfeldname in Kleinbuchstaben. Nicht vorhandene Felder bleiben leer.

Excel zeigt EAN oder Preise falsch an

Aktivieren Sie „Preise formatieren“ für Komma-Dezimalwerte und die Apostroph-Option für lange Nummern. Die Datei ist für Excel bewusst Windows-1252-kodiert; importieren Sie sie über den Excel-Importdialog und nicht per Doppelklick.

Der Versandt-Klick löst keine E-Mail aus

Die Option „Versandbestätigungs-E-Mail beim Versandt-Klick senden“ ist deaktiviert. Ohne sie setzt das Modul nur das Versanddatum.

Eine Massenänderung war falsch

Es gibt keine Rückgängig-Funktion. Stellen Sie den vorherigen Stand aus Ihrem Datenbankbackup wieder her oder korrigieren Sie die Felder mit einer Gegenänderung. Deaktivieren Sie die SQL-Bearbeitung nach dem Einsatz wieder.