Backend Funktionen

die XML-Tag-Dokumentation für das Shop-Modul ist hier zu finden: Shop-XML.

Artikelpflege

dynamische Artikelstammdaten

Da die Stammdaten eines Artikels begrenzt sind kann man einem Artikel weitere Stammdaten von einer Datentabelle zuordnen. Damit kann man dann am Artikel die zugehörigen Datensätze mittels „ty:db“ auslesen.

Vorgehensweise

1. Als erstes müssen Sie im Setup für die Backend-Produktpflege definieren, welche Tabellen bzw. Spalten verknüpft werden können und ob man einen oder mehrere Datensätze zuordnen können soll.
2. Danach finden Sie bei den Artikelstammdaten weitere Felder, mit denen Sie die Datensätze verknüpfen können.
3. nach einem Begriff suchen, den Sie verknüpfen wollen
4. darauf klicken, um den Datensatz zuzuweisen.
5. Speichern der Einstellungen

Kunden-Rating

In myty ist es möglich Besteller durch ein Rating voneinander zu unterscheiden. Interessant wird dies, wenn man säumige Zahler, häufige Rücksender oder Reklamierer von guten Kunden unterscheiden möchte. In der Bestellungsliste wird dieser Rating-Status durch Farben gekennzeichnet. Rot für „Vorsicht prüfen“ und grün für „sehr guter Kunde“. Dabei gibt das Rating keine Auskunft über die Kaufleistung des Kunden, sondern über die Note, die dem Kunden durch den Shop-Betreiber erteilt wurde.

Das Rating dient allein der Farbmarkierung der Bestellung. Im System werden keine weiteren Vorgänge gestartet. Welche Bedeutung „schlecht“ für den Kunden bzw. Shop-Betreiber darstellt, muss jeder Betreiber selbst festlegen. Durch den Farbcode hat er aber zumindest die Möglichkeit Mitarbeiter auf „Problemkunden“ aufmerksam zu machen.

Bestellung bewerten

In der Bestell-Detail-Ansicht (unabhängig vom Status) kann man oben links im Pull-Down-Menü einen von 5 Werten vergeben (sehr gut, gut, neutral, schlecht, sehr schlecht). Dies sollte bei jeder Bestellung getan werden, damit die Ranking-Datenbank exakter arbeiten kann.

Bisher werden folgende Werte in das Rating zum Erkennen des Kunden genutzt: e-Mail-Adresse, Vorname, Nachname

Datenbank aktualisieren/pflegen

hin und wieder sollte die Datenbank mit den Keywords (eMail, Vorname, Name) aktualisiert, bzw. optimiert werden. Im Bereich „Einstellungen“ im Shop-Modul gibt es den Punkt > Kundenbewertung

• Im Reiter > „Bewertungen ansehen“ werden alle Bewertungen und Keywords gelistet. Der Button „passe Schlüsselwortbewertungen an“ startet den Optimierungsprozess in der Datenbank. Bitte ca. aller 100 Bewertungen durchführen.

• Im Reiter > „Keywordliste bearbeiten“ werden die Begriffe und ihre Wichtung in der Datenbank einzeln angezeigt. Man ist hier in der Lage von Hand Änderungen am Wert vorzunehmen. Dies sollte man jedoch nur tun, wenn z.B. ein als „eindeutig“ negativ gerankter Kunde, nicht negativ markiert wird (weil ein zu hoher Positivwert hinterlegt ist). Dazu bitte den Wert ändern, wobei 0 neutral ist und +1 gut bedeutet, alles darüber bedeutet sehr gut und umgekehrt. Wird also ein Begriff auf -10 gesetzt, so ist die Chance, dass der Kunde durch einige gute Bestellungen wieder auf neutral gesetzt wird relativ gering. Wohingegen ein Wert von -3 relativ schnell ausgeglichen werden kann.

Artikelpromotion

Gutscheine

Ein Gutschein kann vom Kunden als Produkt ganz normal eingekauft werden. Gutscheine kann der Kunde entweder selbst einlösen oder an Bekannte verschenken. Gutscheine stellen im Gegensatz zu Coupons einen bereits gezahlten Geldwert dar.

Gutscheine generieren

Gutscheine müssen im Backend, im Bereich Shop, als Produkte angelegt und den entsprechenden Warengruppen zugeordnet werden. Dabei kann man den Gutscheinen den gewünschten Wert zuweisen. Im Bereich Shopnavigation wählt man die gewünschte Rubrik und fügt den Gutschein als neues Produkt hinzu. Desweiteren werden dort alle relevanten Daten wie Artikelnummer, Beschreibung,gewünschter Warenwert zugewiesen.

Gutscheine freischalten

Gutscheine sperren, auszahlen

Gutschein PDF generieren

Gutscheine im Kunden-Account

Wer kaufte mit Gutschein?

geplante Features

Coupons

Ein Coupon kann als Aufmerksamkeit, als Geburtstagsgeschenk, zur Neukundengenerierung etc. des Shopeigners verwendet werden. Diese Coupons werden dann vom Endkunden einglöst. Coupons stellen im Gegensatz zu Gutscheinen keinen bereits geleisteten Geldwert dar. Coupons können als eine Art Rabatt angesehen werden.

Anlegen eines Coupons

Einen Coupon können Sie im Modul „Shop“ bei Artikelpromotion → Coupons anlegen. Dazu klicken Sie auf „Neuen Coupon“. Geben Sie im öffnenden Popup die benötigten Informationen ein und klicken Sie auf übernehmen.

Freigeben eines Coupons

Um einen Coupon freizugeben müssen müssen Sie einfach nur auf das kleine rote Icon rechts neben dem Coupon klicken.

Sperren eines Coupons

Um einen Coupon zu sperren müssen müssen Sie einfach nur auf das kleine grüne Icon rechts neben dem Coupon klicken.

Auswerten einer Couponaktion

Wenn Sie auf den Bearbeitungsstift rechts klicken kommen Sie zur Detailansicht des Coupons, in dem Sie auch die mit diesem Coupon getätigten Bestellungen betrachten können. Diese Übersicht finden Sie im unteren Abschnitt des Popups.

geplante Features

N/A

Beispielcode für Templates

<tr>    <td colspan="3">Gutschein</td>    <td valign="top">Code :</td>    <td><ty-Shop:basketGutscheinCode type="editable"/></td>    <td class="price-one"></td>    <ty-Shop:basketGutschein>      <td class="pieces" colspan="2">       <ty-Shop:basketGutscheinDiscountPrice/> / <ty-Shop:basketGutscheinDiscountPriceRemaining/> / <ty-Shop:basketGutscheinDiscountPriceMax/>     </td>    </ty-Shop:basketGutschein>  </tr>  <tr>    <td colspan="3">Coupon</td>    <td valign="top">Code :</td>    <td><ty-Shop:basketCouponCode type="editable"/></td>    <td class="price-one"></td>    <ty-Shop:basketCoupon>      <td class="pieces" colspan="2"><ty-Shop:basketCouponDiscountPrice/></td>    </ty-Shop:basketCoupon>  </tr>  

Import / Export

Export für Produktportale

Google Base (csv)

Die Artikeldaten werden über eine CSV-Datei (Splaten durch Tabstopp getrennt) exportiert. Die Schnittstellenbeschreibung befindet sich auf http://base.google.com/support/bin/answer.py?answer=78170&hl=de_DE .

Google Merchant Center

Allgemeine Informationen und der Unterschied zu Google Base.
:google_merchant_center_i_google_base.pdf

ungültige Produkt-IDs

Bei der Meldung „Ihre Artikelliste enthält ungültige Produkt-IDs. Bitte geben Sie gültige IDs an.“ sind die vergebenen EANs der Artikel fehlerhaft. Diese dürfen für den Export nur Zahlen (keine Buchstaben oder Symbole) enhalten. Weitere Informationen finden Sie unter: http://base.google.de/support/bin/answer.py?hl=de&answer=107495

yatego (csv)

Um Produkte für einen Yatego-Account zu exportieren, muss folgendes eingerichtet werden:

1. eine Seite in der Shop-Navigation, der die zu exportierenden Produkte zugewiesen werden (Seitenname muss „export_yatego“ sein)
2. die Seite muss mit einer Vorlagen-Seite verknüpft werden, die eine Variable Namens „yatego_category_id“ besitzt
3. Dem Navigationspunkt müssen dann die Kategorie-Ids (max 3; Komma-getrennt) übergeben werden (unter Seitenspezifische Variablen).
4. Die gewünschten Produkte müssen dem Navigationspunkt zugewiesen werden

Danach kann man die zugewiesenen Produkte exportieren und bei yatego bereitstellen.

Vorhandene Export-Plugins für Produktportale erweitern

Wenn man ein vorhandenes Plugin ändern möchte kann man ein eigenes PHP-Skript für dieses Plugin definieren. Dieses wird dann per PHP-Befehl „include“ eingebunden statt das Plugin abzuarbeiten. Zusätzlich stehen in diesem Skript die Artikeldaten aller aktiven Artikel im Shop zur Verfügung in der Variable „$GLOBALS['articleData']“ und können als Array durchlaufen werden.

Eigene Export-Plugins für Produktportale

Ab myty 4.1 können die vorhandenen Exporte durch eigene Export-Plugins ersetzt werden oder neue benutzerdefinierte Exporte eingebunden werden.

Plugin entwickeln

Beispiel-Plugin

include_once($GLOBALS['mytyInstallPath'].'/modules/shop/classes/tyshopexportplugin.class.php');   class customExport extends tyShopExportPlugin {    protected $name = 'eigener Export';     protected $outputFileName = 'customExport.xml';         const PLUGIN_VERSION = '1.0';           public function header() {             return '<root><version>'.self::PLUGIN_VERSION.'</version><date>'.date('d.m.Y').'</date>';  }       public function footer() {              return '</root>';         }       public function article(&$article) {                $showManufacturer = $this->getSetting();             $item = '<article><id>'.$article->getId().'</id><name>'.$article->getName($_SESSION['language']).'</name>';                 if( $showManufacturer == true ) {                       $item .= '<manufacturer>'.$article->getManufacturer().'</manufacturer>';                 }               $item .= '</article>';    } }

Dieses Beispiel generiert aus allen Produkten, die geladen werden eine XML-Datei mit Version, Datum und Artikeln. Für jeden Artikel werden die Werte id, Name und je nach Einstellung im Plugin-Setup der Hersteller in die XML-Datei geschrieben.

Plugin aktivieren

Um ein neues Plugin in das System einzubinden muss die Datei im folgenden Ordner abgelegt werden: [DOCUMENT_ROOT]/tycon/modules/shop/export/plugins/products/

Außerdem kann man auch ein zusätzliches Setup-Formular für dieses Plugin anlegen. Dieses wird dann unter dem Namen [Plugin-Name].setup.php im Ordner ./setup abgelegt. Der Quelltext wird dann automatisch im Setup-Bereich für das Plugin ausgegeben und die Werte mit übernommen.

Beispiel-Setup-Formular

<div class="mytyTemplates-labelbox-left">      <label for="custom-setting"><strong><?php echo $GLOBALS['shopLang']->getText('Einstellung A');?></strong></label> </div> <div class="myty-floatl">     <input type="text" name="config[custom_setting_a]" value="<?php echo $settings['custom_setting_a'];?>" class="tyFormText"/> </div><div class="myty-fixfloat"></div>

Setup

Mailvorlagen

Im Shop werden teilweise automatisch Mails an Kunden verschickt. Diese Mails müssen festgelegt und den im Mailvorlagen-Manager vorliegenden Vorlagen zugeordnet werden.

Die Mailvorlagen entsprechen mailversandtauglichen Vorlage-Dateien, die mit myty-üblichen XML-Tags (ty:content, ty:area, ty:shop) versehen werden können, und deshalb voll dynamisch sind. Die Mailvorlagen müssen zunächst angelegt werden und können dann im Shop-Setup verlinkt werden.

Folgende Vorlagen sind grundsätzlich erforderlich:

• Bestelleingangs-Mail (automatisch)
• Bestellbestätigungs-Mail (aus dem Backend zu starten)
• Normale Kunden-Mail mit Bestellinformationen (aus dem Backend zu starten)

Versandkosten-Matrix

Die Versandkostenmatrix von myty kann bisher mit folgenden Werten umgehen:

• Preisspanne
• Gewichtsspanne
• Regionszuordnung
• Volumen

Auf diese Weise können Versandkosten für jede Region separat mit eigenen Preis- und Gewichtsabhängigkeiten definiert werden. Wird für eine bestimmte Preis- oder Gewichtsspanne nichts definiert, gilt dies als Versandkostenfrei. Bei Definitionsüberlappungen wird automatisch die höherpreisige Definition bei der Berechnung der Kosten verwendet.

Möchte man Versandkosten für ein Land festlegen, so muss das Land zuvor in der Regionen-Matrix einer Region zugeordnet werden. Dort werden auch Währung, Kurse. etc. bestimmt.

Beispiel für die Eingabe von Versandkosten:

• ein Einkauf ist ab 60€ Versandkostenfrei (darunter kostet es 4,50€), unabhängig vom Gewicht, so muss eingegeben werden: MinPreis: -1, MaxPreis: 59.99, MinGewicht: -1, MaxGewicht: -1, Region1: 4.5, Region2: -1, RegionX: -1 (-1 steht für keine Angabe)
• in Östereich bezahlt der Kunde für ein 23.5 KG Paket mit Wert 134€, also unter 300€, 8€ Versandkosten, so muss es eingegeben werden: MinPreis: 100, MaxPreis: 300, MinGewicht: 20, MaxGewicht 30, Region1: -1, Region2(Österreich): 8, Region3: -1 usw.

Das Gewicht muss an jedem Artikel separat angegeben werden! Es erfolgt keine klassifizierte Berechnung bisher.

Regionen-Matrix

Sofern im Shop das Bestellen aus verschiedenen Ländern erlaubt sein soll, müssen Regionen angelegt werden. Es können beliebig viele Regionen angelegt werden! In einer Regionsdefinition können auch mehrere Länder festgelegt werden, z.B. Region 1 steht für WestEuropa, so werden Frankreich, Deutschland, Belgien usw. in Region 1 auftauchen. Die Kombination von Ländern macht solange Sinn, wie die gleichen Währungseinheiten und Versandbedingungen gelten können.

Folgende Werte können je Region definiert werden:

• Währungssymbol
• Währungseinheit Abkürzung
• Umrechnungskurs
• Dezimaltrenner
• Befreiung von der Steuer bei korrekter Umsatzsteuer-ID (für innergemeinschaftlichen Handel)
• Preisausgabe „Netto“ (Steuerbefreiung für die Region)

Screenshot zeigt: die Regionen-Matrix mit Währungsdefinitionen

Die Regionsdefinition erfolgt Sprachabhängig, d.h. wenn man die Länderbezeichnungen auf der englischen Version des Shops englisch darstellen möchte, schaltet man im System die Sprache auf englisch und überschreibt die deutschen Bezeichnungen.

!!Wichtig für das betreiben von Shops in für verschiedene Länder ist die Berücksichtigung von gesetzlichen Bestimmungen für Online-Verkäufe in diese Länder. Bitte prüfen Sie für jedes Land die Rechtmäßigkeit ihres Angebotes.

Steuerklassen-Matrix

Für jede Region können in der Steuerklassen-Matrix Mwst./Vat. Werte festgelegt werden. Es können beliebig viele Klassen angelegt werden. Jede Produkt-Variante kann dann einer dieser Klassen zugeordnet werden. Die Klassen müssen also vorab angelegt werden.

Zusätzlich kann man einzelne Rollen (z.B. Händler) von den Steuerklasse befreien. Die Nutzer dieser Rolle, bekommen dann Nettopreise angezeigt, sofern in der Vorlage nicht ausdrücklich definiert ist, dass der Brutto-Wert angezeigt werden soll. Um Rollen von der Steuerklasse zu befreien, klickt man auf das Benutzer-Symbol (r.u.) und wählt die Rollen aus, die man befreien möchte.

Steuerklassen-Matrix

Zahlungsarten Gebühren

In myty können den Zahlungsarten zusätzliche Kosten auferlegt werden. Zum Beispiel kann für die Zahlungsart Nachnahme im System eine zusätzliche Gebühr von 4€ aufgeschlagen werden. Der Aufschlag erfolgt wieder Regionsabhängig.

• wird für eine Region ein Aufschlag von 0 oder mehr definiert, so gilt die Zahlungsart in dieser Region als Verfügbar.
• wird jedoch ein -1 in der Region als Kostennote festgelegt, so ist die Zahlungsart in dieser Region nicht verfügbar.

Sofern externe Zahlungsarten-Anbieter eingenbunden sind, können zus. benötigte Felder im Zahlungsarten-Popup angelegt werden.

Im Feld abgefragte Felder, muss das Feld eingetragen werden, welches bei der Zahlungsart abgefragt wird. Das muss nur dann gemacht werden, wenn externe Zahlungsanbieter eingebunden sind.

Bei einer Zahlung mit Kreditkarte wäre das creditcard_number. Bei Bankeinzug bzw. ELV muss bank_account eingetragen werden.

Betreiberdaten-Blatt

Hier können sämtliche Daten des Shop-Betreibers hinterlegt werden. Sie werden, wie üblich mit dem <ty:db>-Tag ausgelesen. Die Daten werden zudem in den Rechnungs-PDFs und an anderen Stellen im System verwendet.

• Adressdaten
• Telefon, Fax, Mail etc.
• 2 Bankverbindungen
• Gerichtsstand
• Steuernummer
• UstID
• Handelsregisternummer
• Geschäftsführer Namen
• Rücktrittsrecht in Tagen
• Rechnungszahlungsbedingungen in Tagen

XML-Import/Export

myty erlaubt das importieren und exportieren von Produktdaten im XML-Format. Dabei muss die Struktur des myty-Shops in der XML exakt abgebildet werden.

Shop-Import-/Exportstruktur sehen sie hier: Shop-XML

CSV-Import

myty erlaubt auch das importieren und exportieren von Produktdaten im CSV-Format. Die Felder, die importiert werden sollen können im Setup konfiguriert werden.

Rechnungen/Bestellungen

Unter dem Punkt gibt es die Möglichkeit An der Bestellung noch Dateien/Scripte anzuhängen. Entweder unterhalb von jedem

Artikel (Shop/backend/setup/order/article/additional=„show“), (Shop/backend/order/article/additional=„show“) oder

rechnung (Shop/backend/setup/bill/article/additional=„show“), (Shop/backend/bill/article/additional=„show“) oder

direkt unter der Bestellung (Shop/backend/setup/order/additional=„show“), (Shop/backend/order/additional=„show“).

Ebay-Setup

Die Push-to-Ebay-Funktion ist noch nicht vollständig im aktuellen myty Shop V3.3 implementiert. Wird hier zu einem späteren Zeitpunkt beschrieben. Der Punkt Ebay - sollte für Redakteure im site roles Rollen-Setup deaktiviert werden.

Basis-Shop-Setup

erreichbar hier(Setup-Feld muss unten ausgeklappt werden):

Folgende Grundeinstellungen können im Shop festgelegt werden:

• Kunden-E-Mail
• Bestell-E-Mail
• Bestellungen per Mail an
• Kopie der Bestellungs-Mail an
• Startpunkt der Shop-Seitenstruktur - vereinfacht Arbeit im Backend
• AGB-Bestätigung erforderlich? (ja/nein)
• Bestellung von nicht mehr vorrätigen Artikeln zulassen? (ja/nein) - prüft Lagerstatus
• nur Shop-Keywords anzeigen - blendet Standardkeywors im Shopbackend aus
• Bildpfad auf dem Server für Standardbild - wenn keine Bilder am Produkt festgelegt sind
• Formularfeld-Validierung aktivieren für div. Felder des Käufer-Daten-Formulres, erforderliche werden per Checkbox aktiviert
• Prefix o. Suffix für Rechnungsnummernkreis (z.B. webshop-RGNR-2006)
• Typ für Rechnungsdarstellung (Sammel-/Einzelansicht)

Einbindung von Shop-Vorlageseiten

Shop-Vorlagen folgen den selben Regeln, wie die Vorlagen normaler Inhaltsseiten. Shop-Funktionen können über die Vorlage selbst (also in deren Quellcode) oder über Vorlagen-Schnipsel eingefügt werden. Wir empfehlen die Schnipsel-Variante, weil sie einfacher und pflegeleichter ist. Die Vorlagen müssen dann an jeweils versteckt bleibenden Navigationspunkten in der Seitenstruktur angelegt werden, mit möglichst eindeutigem Seitennamen (Topic). Ist dies geschehen, müssen im Setup die Seitennamen (Topics) entsprechend der folgenden Abfrage eingetragen werden, damit der Shop automatisch auf die richtigen Seiten verweisen kann. Folgende Seiten müssen angelegt werden und sind für den Shop-Betrieb erforderlich.

• Template für Login-Seite
• Template für Bestellbestätigungs-Seite
• Template für die Daten der Zahlungsart
• Template für Prüf-Seite der Bestellung
• Template für Warenkorb
• Standard Template für Artikel-Detail-Seite
• Template für Artikel-Detail (unbegrenzt viele Definitionen möglich)
• Template für Bestellung
• Template für Benutzerdatenformular

Änderung müssen immer gespeichert werden. Zugriff auf das Basis-Setup hat im normalfall nur der Shop-Admin.

Verknüpfungsbereinigung

Shop-Artikel können einzelnen Navigationspunkten als Produkt, Cross-Selling-Produkt oder direkte Empfehlung zugewiesen werden. Wird ein Navigationspunkt einmal gelöscht, so geht diese Verknüpfung verloren. Damit die verlorenen Verknüpfungen nicht länger in der Datenbank verweilen, ist es hilfreich Verknüpfungen zu bereinigen. Dies kann man mit dem entsprechenden Button im Setup erledigen.

Auto-/Teilautomatische Updates

Bilderupdate

Das automatische Bilderupdate dient zum Finden und Zuweisen von Bildern für Shopartikel. Dabei werden vom Startverzeichnis aus, alle Verzeichnisse rekursiv nach Bildern durchsucht. Wird ein Bild gefunden, so wird dies der entsprechenden Shopartikeloption und dem Shopartikel als erstes Bild zugewiesen (auch wenn dieser schon ein anderes Bild besitzt). Wird zu einem Shopartikel kein Bild gefunden, so wird an diesem nichts geändert. Folgende Einstellmöglichkeiten lassen das Verhalten noch verändern:

• Benennung nach EAN/distributor_code - Legt fest ob die Bilder nach EAN oder distributor_code benannt sind. Der Bildname (ohne Endung) muss exakt der EAN/dem distributor_code entsprechen.
• Shopartikel ohne Bild deaktivieren - Alle Artikeloptionen/Artikel zu denen kein Bild gefunden wird, werden deaktiviert. (Hat ein Artikel eine Option mit und eine ohne Bild, so wird dieser deaktiviert)
• Nur nach Bildern für deaktivierte Artikel suchen - Sucht nur nach neuen Bildern für deaktivierte Artikel/Artikeloptionen. Wird ein Bild gefunden, wird der entsprechende Artikel/die Artikeloption wieder aktiviert!
• Bild 1 des Artikels nicht ändern, sondern nur Bild der Artikeloption - Das Bild des Artikels wird nicht überschrieben.

Baumzuweisung

Mit der Baumzuweisung können Shopartikel automatisch ihren übergeordneten Punkten zugewiesen werden. Damit erspart man es sich, alle Artikel aus einer Unterkategorie auch der übergeordneten Kategorie per Hand zuzuweisen. Folgende Einstellungen können vorgenommen werden:

• Start-/Zuweisungspunkt - Hier wird die übergeordnete Kategorie eingestellt. Alle Artikel der Unterkategorien werden dieser Kategorie zugewiesen
• Zuweisung auch auf alle Unterpunkte anwenden - Wählt man diesen Punkt an, wird die Zuweisung zusätzlich rekursiv für alle Unterpunkte ausgeführt

Ein Beispiel zur Veranschaulichung:

Im Shop ist folgende Navigationstruktur vorhanden: Kategorie1→Unterkategorie1→Speziellekategorie1. Um jetzt alle Artikel der Speziellenkategorie1 auch Kategorie1 zuzuweisen wählt man Kategorie1 als Startpunkt aus und klickt auf Baumupdate starten. Will man die Speziellekategorie1 zusätzlich auch der Unterkategorie1 zuweisen, so setzt man das Häckchen in der Checkbox vor dem Starten des Updates.

Abo Funktion

Informationen zur Abo Funktion und zum Einrichten von Abonnements befinden sich hier.

Retourenverwaltung

Informationen zur Retourenverwaltung des Shops finden sich hier.