# Chameleon Dokumentation

![](/files/-LIutBDxujWGsKyRCkUk)

> * E-Commerce und Content Management in einem
> * suchmaschinenoptimiert, schnell, erweiterbar&#x20;
> * umfassende Internetpräsenz mit nur einem System

Sie finden hier die Anwenderdokumentation für Chameleon Shop Version 6.


# Verwendete Browser

Im Frontend gehen wir (falls nichts anderes während der Projektplanung vorgegeben) davon aus, dass die Benutzer grundsätzlich Browser der neuesten Generation verwenden. Wir bitten Sie, für das Backend ebenfalls einen Browser der aktuellen Generation zu nutzen (vorzugsweise Chrome oder Mozilla Firefox).


# Test und Live-Umgebung

Änderungen sollten grundsätzlich immer zuerst im Testsystem vorgenommen und getestet werden. Nach erfolgreicher Abnahme werden sie per Deploy (= Kopieren des kompletten Ist-Standes des Dateisystems einer Entwicklungsversion) auf das Live-System überspielt. Die Datenbank und kundenprojektspezifische Mediadaten wie Bilder und Downloads, werden dabei nicht überspielt. Änderungen, die im Livesystem ebenfalls dargestellt werden sollen, müssen daher dort erneut ins Backend eingegeben werden.


# Datenbackup

Die projektspezifischen Daten (s.o.) werden standardmäßig im Live-System jede Nacht vollständig gesichert, wobei immer das Backup des Vortages überspielt wird. Sollten einmal Daten versehentlich vom Anwender gelöscht werden, so kann nur eine komplette Version des Vortages zurückgespielt werden. Bei Datenverlust muss daher unmittelbar am selben Tag das Backup aufgespielt werden.


# Backend

Anwender sollten mit individuellen Zugängen Arbeiten am Backend vornehmen, da ein paralleles Arbeiten mit demselben Zugang nicht möglich ist (automatischer Logout der „älteren“ Session).

Menüpunkte im Backend werden in dieser Dokumentation wie folgt aufgeführt:

{% hint style="success" %}
Artikel → Artikelkategorien
{% endhint %}

![](/files/-LIut2EcLPdWInh-_3qM)

Zahlreiche Hilfestellungen finden Sie in der kontextsensitiven Hilfe, gekennzeichnet durch ![](/files/-LIut2Ee2JcKrjxsQB1z).


# Persönliches Benutzerprofil

Im Profil des CMS-Benutzers kann dieser seine persönlichen Angaben wie Name, Passwort, E-Mail, Bild, Editiersprache des Backend usw. ändern. Als Benutzer mit administrativen Rechten hat man im Profil die Möglichkeit, dem Benutzer bestimmte Rollen zuzuordnen.

Das persönliche Profil ist über das Top-Menü (schwarze Leiste) erreichbar.

![](/files/-LIut2FLyuj0q8cmHXqj)


# Menüführung

Über das Top-Menü (schwarze Leiste oben) haben Sie einen Schnellzugriff auf die Navigation, die Seiten, Medien und Dokumente, verschiedene Editiersprachen, das Frontend, den Cache und die Hilfe. Darunter findet sich das Hauptmenü, welches in verschiedene Blöcke unterteilt ist.

![](/files/-LIut2G_kxHaGjalr-tm)

\
&#x20;Über die Breadcrumb verfolgt das System die vom Benutzer durchgeführten Schritte. Mit Klick auf einen der Punkte können Sie jederzeit zur vorher angesteuerten Seite zurückkehren.

![](/files/-LIut2GbrTBlvNbAITkt)

\
&#x20;Innerhalb eines Datensatzes stehen die Punkte der Breadcrumb auch über das Rechtsklick-Menü zur Verfügung.

![](/files/-LIut2GdTVHa__JKgSDB)


# Listenansicht von Datensätzen

Alle Daten, bei denen mehr als ein Datensatz zur Verfügung steht, werden über Listen präsentiert.

![](/files/-LIut2vSUCFeRjJ5SrUZ)

## Sortierung

Die Listen können durch Klicken auf die Spaltennamen umsortiert werden. Wird bereits nach einer Spalte sortiert, wird neben dem Spaltennamen angezeigt an welcher Stellung die Sortierung steht. Eine eins (1) deutet also darauf hin, dass nach diesem Feld primär sortiert wird, eine zwei (2) darauf, dass nach diesem Feld sekundär sortiert wird, usw. Zusätzlich wird die Sortierrichtung über einen kleinen Pfeil angezeigt.

Klickt man auf ein Spaltennamen, nach dem bereits aufsteigend sortiert wird, ändert sich die Sortierrichtung von aufsteigend zu absteigend. Ein erneutes Klicken entfernt die Sortierung wieder.

## Suchen

Über das Suchfeld kann nach einem oder mehreren Begriffen in der Liste gesucht werden. Wichtig: dabei werden nur die Felder durchsucht, die angezeigt werden.

Eine Ausnahme davon ist das ID-Feld. Danach kann auch dann gesucht werden, wenn das Feld nicht als eigene Spalte geführt wird.

## Gruppierung

Bei manchen Listen wird links neben dem Suchfeld noch ein Gruppierungsfeld angezeigt. Wählt man eine Gruppe aus, werden nur noch Einträge angezeigt die der gewählten Gruppe zugewiesen wurden.

In diesen gruppierten Listen werden alle Einträge unter der jeweils zugewiesen Gruppe aufgeführt. Dabei kann es durchaus vorkommen, dass ein Eintrag mehr als einer Gruppe zugewiesen wurde und daher mehr als einmal auftaucht.

## Datensätze löschen

Benutzer mit entsprechenden Rechten können Datensätze aus der Listenansicht löschen. Einzelne Datensätze werden über das rote X rechts gelöscht. Mehrere Datensätze können auf einmal gelöscht werden, indem die Checkbox vor jedem Datensatz markiert und dann der Button "Markierte löschen" betätigt wird.

## Neuen Eintrag anlegen

Benutzer mit entsprechenden Rechten können aus der Listeansicht über den Button `Neuen Eintrag anlegen` einen neuen Datensatz in der Tabelle erstellen.

## Datensatz editieren

Durch einen Klick auf einen Datensatz wird der Editor für den Datensatz geöffnet (entsprechende Rechte vorausgesetzt).

Bitte beachten: Um einen Datensatz zu öffnen, kann in jede Spalte des Datensatzes geklickt werden, außer der Funktionsspalte sowie eventuell vorhandener Bilder. Durch ein Klick auf ein Bild wird immer eine Vorschau des Bilds angezeigt und nie der Editor geöffnet.

## Andere Funktionen

Je nach Rechten und Tabelle werden neben dem `Neuen Eintrag anlegen` und `Markierte Löschen` weitere Funktionen aufgeführt. Dazu gehört z.B. der Button `Tabelleneinstellungen`, über den ein Admin-Benutzer die Definition der Tabelle ändern kann.


# Tabelle / Datensatz

Im oberen Bereich eines Datensatzes werden - wie in der Listenansicht - die verfügbaren Funktionen aufgeführt. Diese können auch jederzeit über das Rechtsklick-Menü im Datensatz erreicht werden.

![](/files/-LIut2uxRNZsU5ZVqhuW)

## Speichern

Über den Button wird der aktuelle Stand der Daten in die Datenbank geschrieben. Sollten nicht alle Pflichtangaben ausgefüllt worden sein, wird der Speichervorgang mit einer entsprechenden Meldung unterbrochen (es werden also keine Daten gespeichert).

## Kopieren

Kopiert den aktuellen Datensatz *direkt aus der Datenbank*. Sollten also Änderungen gemacht worden sein, die noch nicht gespeichert wurden, dann sind diese Änderungen weder im Original-Datensatz noch in der Kopie enthalten.

## Neu

Legt einen neuen, leeren Datensatz an.

{% hint style="warning" %}
Auch wenn Sie den Datensatz nicht befüllen und noch nicht gespeichert haben, ist dieser angelegt. Wenn Sie also versehentlich einen neuen Datensatz erstellt haben, löschen Sie ihn wieder. Ansonsten weist das Backend zahlreiche leere Datensätze auf (in der Listenansicht können Sie prüfen, ob leere Datensätze vorhanden sind).
{% endhint %}

## Löschen

Löscht den aktiven Datensatz. Nach dem Löschen landet der Benutzer wieder auf der Listenansicht der Tabelle.

## Sprache kopieren

Hier werden Felder, die in der aktuellen Sprache nicht übersetzt sind, aus der anderen Sprache kopiert.

## Datensatz wechseln

Im oberen Bereich des Datensatzes steht ein Eingabefeld zur Verfügung über welches andere Datensätze aus der Datensatzliste geladen werden können. Angezeigt und durchsucht wird immer das Namensfeld der Datensätze.

![](/files/-LIut2uzbaURdU23zrDI)

## Datensatz-Details

Im oberen linken Bereich wird die ID des aktiven Datensatzes angezeigt. Dabei werden sowohl eine ID wie auch eine GUID (global unique identifier) aufgeführt. Bei der GUID handelt es sich entweder um die gleiche Nummer wie ID, oder um ein 36 Zeichen langen Identifier (je nachdem ob Komplexe ID Felder in den CMS-Einstellungen aktiviert wurden).

Darauf folgt eine Liste aller Felder des Datensatzes. Neben manchen Feldern taucht Links neben dem Eingabefeld zusätzlich ein kleines Fragezeichen ![](/files/-LIut2Ee2JcKrjxsQB1z) auf - hinter diesem Symbol verbirgt sich ein Hilfe/Erklärungstext für das Feld. Der Text wird durch einen Klick auf das Symbol eingeblendet.

{% hint style="warning" %}
Bei manchen Feldern wird bei Editieren die Seite gewechselt. Da das System Änderungen nicht automatisch speichert, sollte der Benutze diese vorher durch ein Klick auf den Speichern-Button sichern.
{% endhint %}


# Sprache / Website / Cache / Hilfe

![](/files/-LIut51LZPn3mGxijTtD)

* `Sprache`: Bei multilingualen CMS/Shops hat man die Möglichkeit, während der Arbeit die Sprache zu wechseln, indem man auf „Editiersprache“ klickt und in der Auswahl die entsprechende Sprache wählt.
* `Webseite`: öffnet das Frontend in einem neuen Browser-Tab.
* `Cache`: Zwischenspeicher leeren von entweder a) Seiten-Cache leeren und b) Seiten- und Template-Cache leeren
* `Hilfe`: öffnet eine Schnellreferenz aller Hilfetexte im System. Bei Einträgen mit diesem Zeichen können Sie direkt an die entsprechende Stelle im Backend springen.


# Portale und Webseiten

{% hint style="success" %}
CMS / Portal-Einstellungen → Portale / Webseiten
{% endhint %}

Mit Chameleon können mehrere Webseiten oder Shops parallel betrieben werden. Jede dieser Webseiten wird als Portal geführt. An dieser Stelle legen Sie die Grundeinstellungen Ihrer Webseite fest.

Je Portal können beliebige Domain-Namen hinterlegt werden, unter welchen die Webseite erreichbar sein soll. Neben einer Domain-Unterscheidung, können auch mehrere Portale auf der gleichen Domain laufen, müssen dann aber über einen URL-Präfix unterscheidbar sein.

Jedes Portal wird in Chameleon in `Bereiche` unterteilt. Dabei sollte mindestens ein Bereich je Navigationsstartpunkt definiert werden. Über die Bereiche lassen sich Einstellungen hinterlegen, die für einen Sub-Baum innerhalb des Portals (also für eine ganze Reihe von Seiten) gelten soll. Dazu gehört unter anderem die Sprache des Bereichs.

Die zu einem Portal gehörenden Seiten können in mehrere Navigationen (Top- Navigation, Primäre Navigation, Footer-Navigation usw.) unterteilt werden. Dabei ist jeder Navigationseinstiegspunkt auch gleichzeitig der URL-Startpunkt der sich darunter befindenden Seiten (der Navigationspunkt selbst wird dabei nicht mehr mit in der URL geführt).

Ist nur ein Portal definiert, gelangt man direkt in die Einstellungen des Portals, sind jedoch mehrere definiert, wird eine Listenansicht der verfügbaren Portale eingeblendet.

`Basisdaten`

| Bezeichnung                   | Beschreibung                                                                                      | Erforderlich |
| ----------------------------- | ------------------------------------------------------------------------------------------------- | ------------ |
| Name                          | Verwendung im CMS-Backend                                                                         | ja           |
| Titel des Portals             | wird im title Tag der Seite verwendet und in der oberen Browserleiste dargestellt                 | ja           |
| Homeseite des Portals         | Hier muss die Startseite des Portals verknüpft werden                                             | ja           |
| 404 Page-Not-Found Seite      | Die 404-Page wird immer angezeigt wenn eine nicht existierende Seite des Portals aufgerufen wird. | ja           |
| Domains                       | Alle für das Portal zuständigen Domains, über welche das Portal erreichbar sein soll.             | ja           |
| Systemmeldungen / Fehlercodes | Hier kann der Benutzer die im System verwendeten Meldungen selbst beliebig anpassen.              | ja           |

![](/files/-LIut434rP-56zb0MjRX)

`Metadaten`

![](/files/-LIut436aIzks1Bk3s0c)

`robots`

Hier kann der Inhalt der robots.txt festgelegt werden. Bitte beachten: Der Feldinhalt wird nur ausgespielt, wenn KEINE robots.txt im document root hinterlegt wurde!

![](/files/-LIut438an19QyCAZJ5C)

## Speichern / Seitenbaum editieren

Am oberen Rand des Datensatzes steht der Button `Seitenbaum Editieren` zur Verfügung.

Hier haben Sie die Möglichkeit, den Seitenbaum des ausgewählten Portals zu editieren. Sie können die einzelnen Baumknoten per Drag\&Drop verschieben oder mit der rechten Maustaste auf die Editiermöglichkeiten im Kontextmenü zugreifen.

![](/files/-LIut43A64NsDJ3MABr3)

Der Seitenbaum kann aber auch zentral in der oberen Menüleiste (schwarz) beim Punkt *Navigation* angesteuert werden.


# Navigationsverwaltung

Die Navigationsverwaltung öffnet sich über den Button `Navigation` im Topmenü (in einem PopUp-Fenster). Über die Navigationsverwaltung lässt sich die Seitenstruktur der Webseite definieren.

Dabei muss zwischen dem Seitenbaum und den einzelnen Seiten unterschieden werden, denn Navigationspunkte und Seiten sind zwei voneinander getrennte Objekte. So kann eine Seite mit mehreren Navigationspunkten verbunden sein, z.B. eine Kontaktseite, die in der Hauptnavigation sowie in der Footer-Navigation verlinkt sein soll.

Außerdem ist es möglich, mehrere Seiten mit einem Navigationspunkt zu verbinden. Welche Seite dem Website-Besucher angezeigt wird, ergibt sich aus den Verbindungseinstellungen (aktiv j/n sowie dem Aktivierungszeitraum). Damit ist es z.B. möglich, Jahreszeiten-abhängig komplett unterschiedlich gestaltete Home-Seiten einzurichten.

![](/files/-LIut33c6GxMLcSz9lY5)

Aus dem Seitenbaum ergeben sich die URLs für die einzelnen Seiten. Dabei werden die einzelnen Einträge aus dem Baum bis zu der gewünschten Seite durch ein "/" getrennt aneinander gereiht. Da URLs nicht alle Zeichen unterstützen, werden Sonderzeichen entfernt oder ersetzt (ä=ae, ö=oe, usw.). Leerzeichen werden durch ein "-" ersetzt.

Da über den Baum die Navigationen von mehr als einer Webseite verwaltet werden können und auch Webseiten mehr als eine Navigation enthalten können, beginnt der Pfad der URL an dem Punkt, an welchem in den Portaleinstellungen eine Navigation und ein Bereich definiert wurde.

So kann z.B. die Primäre Navigation, die Top-Navigation und die Footer-Navigation unterschieden werden. Wichtig ist dabei, dass es keine identischen Navigationspunkte gibt, da das System keine gleichlautenden Punkte unterscheiden kann (Ausnahme ist, wenn es sich bei den Punkten tatsächlich um die gleiche Seite handelt (also z.B. "Home" unter der Primären sowie der Top-Navigation).

![](/files/-LIut33eigp7nybhz96D)

Einträge im Baum können über Drag-and-Drop untereinander positioniert werden.

Über Rechtsklick können Navigationspunkte angelegt, editiert oder gelöscht werden. Ist bei einem Punkt bereits eine Seite hinterlegt, kann diese per Rechtsklick editiert werden `(Seite editieren)` oder es können die Einstellungen der Seite geöffnet werden `(Seiten- Einstellungen)`.


# Seitenverwaltung

Eine Liste aller Seiten wird über `Seiten` im Topmenü geladen. Alternativ kann die Liste über das Hauptmenü `Website → Meine Webseiten` geöffnet werden. Die Liste zeigt neben dem Namen der Seite auch den oder die zugewiesenen Navigationspunkte. Bitte beachten Sie, dass der Name der Seite nur im CMS verwendet wird. Auf der Webseite wird für den Namen der Seite der zugewiesene Hauptnavigationspunkt verwendet.

![](/files/-LIut3Y_WAZDcktqR1fM)

Über den Button `Navigationspfade aktualisieren` wird der URL-Pfad-Cache für die Seiten aktualisiert. Da Cache-Einträge automatisch beim Speichern eines Navigationspunktes aktualisiert werden, ist diese Funktion nur dann notwendig, wenn der Navigationsbaum durch z.B. einen Import verändert wurde.


# Seite anlegen

Eine neue Seite können Sie entweder über die Navigationsverwaltung oder auch über die Seitenverwaltung (`Neu`) anlegen. Da in der Regel sowieso ein Navigationsknoten (= Menüpunkt) angelegt werden muss, empfiehlt es sich, die Seite bereits beim Einrichten des Menüpunktes in der Navigationsverwaltung mit anzulegen.

Klicken Sie mit der rechten Maustaste auf den Navigationspunkt, unter dem die neue Seite anlegt werden soll. Ferner klicken Sie auf `Neu`, um einen neuen Navigationspunkt anzulegen.

![](/files/-LIut3rO6dK1ERwjpief)

Es öffnet sich ein Dialog, bei dem u.a. folgende Angaben gemacht werden können:

![](/files/-LIut3rQRpM3llkxTCkT)

| Bezeichnung                                      | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                                             | Titel der Seite                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| URL-Name                                         | wird an die URL des darüberstehenden Knoten angehängt. Mit der so entstehenden URL kann die Seite im Browser aufgerufen werden. Standardmäßig wird der URL-Name automatisch aus der Eingabe im Feld ‘Name’ kopiert. Der URL Name kann anschließend aber auch verändert werden.                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| verstecken                                       | schaltet die Seite unsichtbar. Wichtig: Die Seite wird nur in der Navigation nicht aufgeführt, ist aber über Eingabe der URL, wenn bekannt, erreichbar.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Zugriffsbeschränkte Seite in Navigation anzeigen | Ist ein Navigationspunkt mit einer Seite verbunden, für die der Zugriff auf angemeldete Benutzer eingeschränkt wurde (Einstellung "Zugriff einschränken" in den Seiten-Einstellungen), wird dieser Navigationspunkt für nicht angemeldete Benutzer normalerweise nicht angezeigt. Wählen Sie hier JA wenn Sie möchten, dass die Seite dennoch in der Navigation erscheint. Um die Seite öffnen zu können, muss der Benutzer weiterhin angemeldet sein. Stellen Sie dazu sicher, dass in der Extranet-Konfiguration für "Zugriff verweigert" eine passende Login-Seite hinterlegt ist, auf die weitergeleitet werden kann. Sh. auch [Zugriff auf eine Seite einschränken](/inhalte/seitenverwaltung/zugriff-auf-eine-seite-einschranken). |
| externer Link                                    | Sie können anstatt einer lokalen Seite auch eine externe Website in ihrer Navigation verlinken. Wichtig: Geben Sie hierbei den vollen Link mit http\:// an.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Seiten / Layouts                                 | Wenn Sie hier ein Seitenlayout wählen, wird daraufhin automatisch eine Seite angelegt und mit diesem Navigationspunkt verknüpft. Der Seitentitel wird dabei aus dem Namen des Navigationspunkts übernommen und kann später geändert werden.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| SEO                                              | Im SEO Tab haben Sie die Möglichkeit, den Navigationspunkt von der Indizierung durch Suchmaschinen auszuschließen und Ausnahmeregeln zu definieren. So können Sie z.B. dafür sorgen, dass die Kontaktseite, die auf allen Seiten in der Footer-Navigation verlinkt ist, auf allen Seiten außer der Home-Seite als noFollow markiert wird und so Linkpower von dieser Seite nehmen.                                                                                                                                                                                                                                                                                                                                                       |

\
&#x20;Jetzt geben Sie der neuen Seite einen Namen und wählen ein Layout für die Seite (dies ist wichtig, da der Navigationspunkt ansonsten ohne Seite erstellt wird, zu erkennen an der Kursivschrift). Der Navigationspunkt und eine damit verbundene Seite werden daraufhin angelegt. Im Rechtsklick-Menü der Navigationsverwaltung haben Sie diese Menüpunkte:

![](/files/-LIut3rSSvPUKUPLImeD)

| Bezeichnung          | Beschreibung                                                                                                                                                                                                                 |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Verbundene Seiten    | Listet alle Seiten auf, die mit dem Navigationspunkt verbunden sind. Verbindungen können, wie oben beschrieben, auch von mehreren Seiten zeitabhängig auf einen Navigationspunkt erfolgen.                                   |
| Seite editieren      | Führt zur Layout-Ansicht der Seite und damit zur Möglichkeit, die Seiten-Inhalte zu editieren.                                                                                                                               |
| Seiten-Einstellungen | Führt zur Seiten-Konfiguration, wo Einstellungen wie: Extranet Gruppe, Seiten-Titel, Bild-Meta-Tags und weitere Navigationspunkte vorgenommen werden können.                                                                 |
| Navigation editieren | Öffnet den vorher beschriebenen Dialog mit den Optionen des Navigationspunkts.                                                                                                                                               |
| Neu                  | Legt einen Navigationspunkt (+ evtl. Seite) an                                                                                                                                                                               |
| Löschen              | Löscht den Navigationspunkt. Wichtig: Es wird nur der Navigationspunkt gelöscht, nicht aber die Seite. Diese müssen Sie manuell in „Meine Webseiten“ löschen oder können diese mit einem anderen Navigationspunkt verbinden. |


# Seiten-Layout wählen

Das Seiten-Layout legen Sie bereits beim Anlegen der Seite in der Navigationsverwaltung fest (wählen Sie dort kein Seiten-Layout, wird auch keine Seite angelegt).

Haben Sie die Seite aufgerufen, können Sie über `Seitenvorlagen` das gewählte Layout einer Seite jederzeit wechseln. Hier haben Sie außerdem die Möglichkeit, die verschiedenen zur Verfügung stehenden Layouts anzusehen und das passende auszuwählen. In der linken Spalte sehen alle verfügbaren Layouts.

![](/files/-LIut2H_cyOxkLcJbd5o)

Dabei kann es sein, dass die Layouts eine unterschiedliche Anzahl an Modul-Spots haben. Das CMS übernimmt beim Wechsel des Layouts alle gleichnamigen Spots, so dass die vorher aktiven Module im neuen Layout entsprechend am neuen Platz des Modulspots wieder aktiv sind.

{% hint style="warning" %}
Wenn das neue Layout allerdings weniger Spots hat als das vorherige, tauchen diese im neuen Layout nicht mehr auf. Wenn nun zurück auf das Layout mit mehreren Spots gewechselt wird, müssen die noch vorhandenen Module wieder neu zugeordnet werden.
{% endhint %}


# Seite bearbeiten / Module anlegen

Klicken Sie im Kontext-Menü des Navigationsbaums auf `Seite editieren` oder suchen Sie die Seite über `Seiten`. Der letztere Weg ist häufig der schnellere, wenn ihnen der Name der Seite bekannt ist, da Sie sich dann nicht durch den Navigationsbaum klicken müssen.

In den Seitenvorlagen sind sogenannte Modul-Spots festgelegt. Dies sind Steckplätze, an die beliebige Module platziert werden können.

Über `Funktionen` können Sie ein neues Modul anlegen:

![](/files/-LIut2HT6n2sa-R1mHKb)

Bei einem bereits angelegten Modul gelangen Sie ebenfalls über `Funktionen` in das Kontextmenü zum Bearbeiten:

![](/files/-LIut2HVITS5JMLam72M)

| Bezeichnung                | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Editieren                  | Führt zu den Modul-Einstellungen bzw. zum Editieren der Inhalte des Moduls. Besteht das Modul aus mehreren Datentabellen, z.B. bei einer Liste, die Konfiguration der Liste (Sortiereinstellungen etc.) und Listeneinträge, so werden ihnen 2 Editiermöglichkeiten angeboten.                                                                                                                                                                                                                                                                                                                               |
| Vorlage ändern             | Damit können Sie die HTML-Vorlage des Moduls wechseln. So können Sie z.B. für ein Listenmodul Vorlagen für eine Teaser-Liste mit Verlinkung auf eine Detailseite sowie eine Vorlage für eine Kurzliste ohne Detailseite erstellen. Je nach Modul und Projekt stehen Ihnen hier andere Vorlagen zur Verfügung, die auf Ihre Anforderungen angepasst wurden.                                                                                                                                                                                                                                                  |
| Umbenennen                 | Beim Anlegen einer neuen Modul-Instanz wird standardmäßig der Name der Seite, in der das Modul platziert wird, als Modul-Instanz-Name gesetzt. Sie sollten diesen auf jeden Fall sinnvoll umbenennen, damit Sie den Modul-Inhalt später wiederfinden können.                                                                                                                                                                                                                                                                                                                                                |
| Steckplatz zurücksetzen    | Leert den Modulsteckplatz. Das bisher hier angelegte Modul wird NICHT gelöscht, sondern ist nur nicht mehr mit diesem Steckplatz verbunden. Es kann also jederzeit über den Namen des Modul-Inhalts wiedergefunden und geladen werden.                                                                                                                                                                                                                                                                                                                                                                      |
| Inhalt löschen             | Löscht die Modul-Instanz und alle damit verbundenen Inhalte unwiderruflich (In der CHAMELEON Enterprise Edition mit aktivem Freigabe-Prozess gilt diese Aussage natürlich erst nach Freigabe der Löschung).Beim Löschen eines Listenmoduls werden dabei also die Konfigurationseinstellungen sowie alle Listeneinträge gelöscht. Inhalte, die nicht direkt über den Editieren-Dialog im Modul verwaltet werden, werden nicht gelöscht! Bei einem Artikel- Modul wird also z.B. nur die Selektionskonfiguration gelöscht, nicht aber die Artikel, die durch die Konfiguration in dem Modul angezeigt wurden. |
| Inhalt kopieren            | Legt eine identische Kopie der Modul-Instanz inkl. aller verknüpften Modulinhalte an. Wenn Sie z.B. einen Textbaustein auf mehreren Seiten über die gleiche Instanz verwendet haben, aber auf einer Seite den Text ändern wollen, ohne dass sich dieser auf den restlichen Seiten auch ändert, müssen Sie vorher eine Kopie davon anlegen.                                                                                                                                                                                                                                                                  |
| Anlegen                    | Gibt eine Liste aller zur Verfügung stehenden Module aus. Je nach Konfiguration der Steckplätze durch den Administrator kann sich die Liste je Steckplatz unterscheiden. So ist es z.B. möglich, dass in einer schmalen Spalte des Layouts die dort liegenden Modul-Steckplätze so eingestellt sind, dass nur Module wählbar sind, die dort vom Platz her auch hinpassen würden.                                                                                                                                                                                                                            |
| Laden                      | Gibt eine Liste aller im System vorhandenen Modul- Instanzen aus, aus der Sie ein Modul Laden können.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Laden (gemeinsame Instanz) | Lädt ein Modul als gemeinsame Instanz. Das bedeutet, dass diese Modul-Instanz (inklusive Inhalt) an mehreren Stellen vorhanden ist und Sie beim Editieren des Moduls auch alle anderen Stellen verändern.                                                                                                                                                                                                                                                                                                                                                                                                   |
| Laden (als Kopie)          | lädt ein Modul als Kopie (siehe auch: „Inhalt kopieren“). Somit kann Inhalt von einer anderen Stelle kopiert und verändert werden, an der ursprünglichen Stelle bleibt dieser aber unverändert.                                                                                                                                                                                                                                                                                                                                                                                                             |
| Verschieben                | Wie oben bereits als Drag\&Drop-Option erklärt, haben Sie hier die Möglichkeit, das Modul an einen anderen Spot zu verschieben. Bei Mouse-Over über den Spotnamen wird Ihnen der entsprechende Spot in der Seite mit einem farbigen Rahmen kenntlich gemacht.Alternativ können Sie auch das Modul per Drag\&Drop an einen anderen Steckplatz verschieben. Dabei können auch Steckplätze gewählt werden, die bereits mit einem Modul gefüllt sind. In diesem Fall tauschen die beiden Module die Plätze.                                                                                                     |
| Spot bearbeiten            | ist ein Shortcut für Administratoren und öffnet die Spot- Einstellungen. Hier können z.B. Modul-Einschränkungen vorgenommen werden (ist nur für Administratoren sichtbar).                                                                                                                                                                                                                                                                                                                                                                                                                                  |

Am oberen Rand einer Seite gibt es 4 Buttons, über die Sie schnell den Bearbeitungsmodus wechseln:

![](/files/-LIut2HXzgzjnKvf03cm)

* `Seiten-Einstellungen`: Grundkonfiguration der Seite, wie z.B. Name, verbundene Navigationspunkte, Zugriffsbeschränkungen etc.
* `Inhalte editieren`: Hier können die Module in den Steckplätzen bearbeitet werden.
* `Seitenvorschau`: Öffnet die Webansicht der Seite.&#x20;
* `Seitenvorlagen`: Zeigt mögliche Seiten-Layouts sowie das für diese Seite ausgewählte Layout an.


# Mehrere Seiten mit einem Navigationspunkt verbinden

{% hint style="info" %}
Nur bis Chameleon Version 5:
{% endhint %}

Wenn Sie weitere Seiten mit einem Navigationspunkt verbinden wollen, gehen Sie im Rechtsklick-Menü des Navigationspunktes auf `Verbundene Seiten`. Hier können Sie über `Neu` eine weitere Seite aus der Liste auswählen und mit dem Punkt verknüpfen. Die Seitenverbindung muss aktiv sein. Außerdem können Sie hier den Veröffentlichungszeitraum bestimmen, so dass z.B. automatisch zwischen einer Sommer- und Winterseite umgeschaltet wird.

![](/files/-LIut2Ftee5VzFiqmEls)


# Eine Seite mit mehreren Navigationspunkten verknüpfen

Sie haben ebenso die Möglichkeit, eine Seite mit mehreren Navigationspunkten zu verknüpfen, die gleiche Seite erscheint dann an mehreren Stellen auf Ihrer Webseite, z.B. das Kontaktformular im Footer und im Header Ihrer Seite. Der Vorteil ist, dass bei Änderungen diese Seite nur einmal bearbeitet werden muss.

Gehen Sie in die Seiten-Einstellungen der Seite und wählen Sie unter `primärer Navigationspunkt` einen weiteren Navigationspunkt aus (Rechtsklick auf den `Navigationspunkt → Seite verbinden`).


# Seiten-Einstellungen

`Basisdaten`

| Bezeichnung                                    | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Seitenname                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                |
| SEO Pattern                                    | Wird verwendet, um die Überschrift (title) der Seite SEO konform gestalten zu können. Um alle an dieser Stelle verfügbaren Platzhalter angezeigt zu bekommen tragen Sie hier \[{SHOW}] ein und rufen Sie die Seite erneut auf.                                                                                                                                                                                                 |
| gehört zu Portal / Webseite                    | Wenn Sie mehrere Portale (z.B.: verschiedene Sprachversionen) verwalten, können Sie hier wählen, zu welchem Portal diese Seite gehört.                                                                                                                                                                                                                                                                                         |
| primärer Navigationspunkt                      | Hier sehen Sie, welchem Navigationspunkt die Seite zugeordnet ist. Sie können die Seite hier auch einem anderen (oder weiteren) Punkt zuordnen (S. 16 ff.)                                                                                                                                                                                                                                                                     |
| Seitenbild                                     | die hier hinterlegten Bilder können, im Kombination mit Bildern die bei jedem Bereich hinterlegt werden können, vom dem Modul MTPageImageCore verwendet werden, um ein Headerbild für eine Seite (oder alle Seiten eines Bereichs) anzuzeigen.                                                                                                                                                                                 |
| Hintergrundbild                                | Hier kann ein Bild angegeben werden, welches in der Seite als Hintergrundbild verwendet wird. Diese Einstellung überschreibt das bei Portal oder Bereich hinterlegte Bild.                                                                                                                                                                                                                                                     |
| Zusätzlich berechtigte Gruppen                 | Normalerweise kann eine Seite nur von den Benutzern editiert werden, die Zugang zu dem der Seite zugewiesenen Portal haben. Ausgenommen davon sind CMS-Benutzer, die zu den hier hinterlegten Gruppen gehören.                                                                                                                                                                                                                 |
| SSL verwenden                                  | Ist SSL aktiv, werden Links auf die Seite automatisch mit https\:// aufgerufen.                                                                                                                                                                                                                                                                                                                                                |
| Zugriff einschränken                           | Über dieses Feld kann der Zugriff auf die Seite auf angemeldete Benutzer eingeschränkt werden. Sie können den Zugriff zusätzlich auf bestimmte Extranet-Benutzergruppen einschränken, indem Sie weiter unten im Feld "Auf folgende Extranet-Gruppen einschränken" die entsprechenden Benutzergruppen auswählen. Sh. auch [Zugriff auf eine Seite einschränken](/inhalte/seitenverwaltung/zugriff-auf-eine-seite-einschranken). |
| Zugriff für nicht bestätigte Benutzer zulassen | Wenn JA, haben angemeldete Benutzer, die noch nicht bestätigt sind, Zugriff auf diese Seite. Diese Option wird nur berücksichtigt, wenn in der Extranet-Konfiguration der Login von nicht bestätigten Benutzern auf JA gestellt ist und der Zugriff auf die Seite eingeschränkt ist. Ist die Seite auf Benutzergruppen eingeschränkt, muss sich auch der nicht bestätigte Benutzer in diesen Gruppen befinden.                 |
| Auf folgende Extranet-Gruppen einschränken     | Hier kann der Zugriff auf die Seite bestimmten Kundengruppen (= Extranet-Gruppen) erteilt werden. Werden keine Gruppen angegeben, dann können alle angemeldeten Benutzer auf die Seite zugreifen.                                                                                                                                                                                                                              |
| Sprache der Seite                              | Setzt die Sprache der Seite und überschreibt, was in Bereich und Portal eingestellt wurde.                                                                                                                                                                                                                                                                                                                                     |

`Meta-Daten`: Hier können SEO-relevante Daten hinterlegt werden


# Zugriff auf eine Seite einschränken

Der Zugriff auf eine Seite kann auf angemeldete Benutzer eingeschränkt werden. Gehen Sie dafür in die `Seiten-Einstellungen` und stellen Sie das Feld `Zugriff einschränken` auf JA. Zusätzlich kann hier der Zugriff auf bestimmte Extranet-Benutzergruppen (z.B. Kundengruppen) eingeschränkt werden, indem Sie weiter unten im Feld "Auf folgende Extranet-Gruppen einschränken" die entsprechenden Benutzergruppen auswählen.

![](/files/-LIut37wt2byLjjvltn2)

\
&#x20;Ist die zugriffsbeschränkte Seite mit einem Navigationspunkt verbunden, wird dieser standardmäßig für nicht angemeldete Benutzer *nicht* angezeigt. Soll die Seite dennoch in der Menüführung erscheinen, wählen Sie in der `Navigationsverwaltung` beim Feld `Zugriffsbeschränkte Seite in Navigation anzeigen` JA. Der Navigationspunkt ist nun im Frontend sichtbar. Um die Seite öffnen zu können, muss der Benutzer weiterhin angemeldet sein. Stellen Sie dazu sicher, dass in der Extranet-Konfiguration für "Zugriff verweigert" eine passende Login-Seite hinterlegt ist, auf die weitergeleitet werden kann.

![](/files/-LIut37y67TewO3uSb4v)


# Seite löschen

Wenn Sie eine Seite mit dem dazugehörigen Navigationspunkt löschen möchten, müssen Sie

* den Navigationspunkt löschen (über `Navigation`) sowie
* die Seite selbst (über `Seiten`).

Die Seite selbst ist noch nicht gelöscht, wenn Sie nur den Navigationspunkt löschen (da beide unabhängig voneinander existieren).


# Texte editieren mit dem CKEditor

Der CKEditor, auch WYSIWYG („What You See Is What You Get“) genannt, ermöglicht die einfache Pflege der Inhalte auf den Content-Seiten der Website. Nicht nur Text, sondern auch Medien wie Bilder, Videos oder Dokumenten-Downloads lassen sich mit ihm platzieren.

Der Editor findet sich vor allem in Fließtextmodulen.

![](/files/-LIut2QkInmwHK9hMyPl)

Die einzelnen Funktionen ähneln dabei denen von bekannten Textverarbeitungsprogrammen.

Weitere Informationen finden sich unter <http://ckeditor.com/> bzw. eine Erklärung zu den Funktionen unter <http://docs.cksource.com/CKEditor_3.x/Users_Guide>.


# Textbausteine

{% hint style="success" %}
Website → Textbausteine
{% endhint %}

Mit dem Textbausteine-Modul können in einer zentralen Liste im Backend Textblöcke redaktionell erstellt werden, die dann an beliebigen Stellen auf der Website über entsprechend benannte Platzhalter wiederverwendet werden können. So ist das einheitliche Verwalten und Aktualisieren oft wiederverwendeter Textblöcke einfach möglich. Die Textblöcke können für alle oder auch nur bestimmte Portale definiert werden.

Angelegte Textbausteine können Sie in WYSIWYG-Felder (in Fließtextmodulen) über das Format `[{cmsblock_systemname}]` einfügen.

### Beispiel:

* Textbaustein *über Chameleon* (SEO-Text)
* Systemname: seo-footer
* \[{cmsblock\_seo-footer}]

In Chameleon sind bereits einige Textbausteine für den Shop vorkonfiguriert:

*Footer*

* über Chameleon (SEO-Text)
* Sie finden uns auch bei (Facebook, Twitter, ...)
* Zahlungsmethoden
* Wir verschicken mit (Versandunternehmen)
* Sicherheit

*Checkout / Anmeldung*

* Bereits Kunde (Login für Nutzer, die bereits ein Kundenkonto haben)
* Neukunde (Registrieren)
* als Gast bestellen (Kauf ohne Kundenkonto)
* Ich möchte telefonisch bestellen (Formular für Rückruf)
* Telefonbestellung Info (Shopinfos wie Öffnungszeiten etc.)

*PayPal*

* Zusätzlicher Text für PayPal via Link

*Bestätigung / Danke-Seite*

* Doch noch ein Kundenkonto anlegen? (erscheint bei einer Gastbestellung nach dem Kauf)

\
&#x20;**Es können beliebig weitere Textbausteine für die Verwendung im Shop und/oder auf Content-Seiten erstellt werden.**


# Redaktionelles Artikelmodul

Mit dem redaktionellen Artikelmodul als Basis können Sie Teaser, Listen und Detailseiten ganz unterschiedlicher Artikeltypen wie News, Blog, Event, Video, Bildergalerie usw. zusammenstellen. So lassen sich z.B. themenbezogene Content-Listen generieren und an jeder beliebigen Stelle auf der Website platzieren.

Die Artikel lassen sich in Kategorien einteilen, die dann z.B. bestimmen können, unter welchem Navigationspunkt ein Artikel erscheint. Es ist sogar möglich, die Navigation oder Teile davon automatisch aus den Artikelkategorien generieren zu lassen.

## Artikeltypen

{% hint style="success" %}
Artikel (redaktionell) → Artikeltypen
{% endhint %}

Jeder Artikel muss einem Artikeltyp zugeordnet sein. Der Artikeltyp bestimmt, welche Darstellung für den Artikel verwendet wird und welche Datenbankfelder aus pkg\_article für diesen Typ freigeschaltet sind. Alle anderen Felder werden dann beim Editieren des Artikels im Backend ausgeblendet. So können z.B. bei einem Artikel vom Typ *Magazin* die Felder Herausgeber, Jahrgang, Heftnummer etc. angegeben werden, die aber bei einem Artikel vom Typ *News/Text* nicht erscheinen. Wenn es unterschiedliche Artikeltypen gibt oder die Artikel sich stark unterscheiden, ist es sinnvoll, eine zusätzliche Tabelle mit den benötigten Feldern anzulegen und die Einstellung „enthält nur einen Datensatz“ zu aktivieren. Dann in der Artikeltabelle nur eine Eigenschaft für diese Tabelle anlegen. Außerdem kann für jeden Artikeltyp eine eigene Extension für das pkg\_article-Objekt angegeben werden.

In der Regel werden die Artikeltypen durch Ihren Dienstleister vorkonfiguriert.

## Artikelkategorien

{% hint style="success" %}
Artikel (redaktionell) → Artikelkategoriegruppen
{% endhint %}

Das Artikel-Package kennt Artikelkategoriegruppen und Kategorien. Kategorien sind Eigenschaften der Artikelkategoriegruppen und können beliebig verschachtelt sein. Artikel werden immer Kategorien zugeordnet, nicht Artikelkategoriegruppen. Kategorie und Kategoriegruppe sind auch Teil des SEO-Links.

Legen Sie zuerst eine Artikelkategoriegruppe an, danach entsprechenden Kategorien.

![](/files/-LIut3VthTRX-ewIsOFY)

Die Kategorien können verwendet werden, um Listen danach zu filtern und Artikel in die Navigation bzw. Breadcrumb einzubinden. Hierfür wird die Kategorie einer Seite im CMS zugewiesen über das Feld `Listen / Übersichtsseite`.

![](/files/-LIut3VvZONrlZ7ym7Li)

## Teaser

Es können verschiedene Teaser angelegt werden, die dann auf Artikel oder wahlweise auch auf eine CMS-Seite oder eine externe URL verweisen können. Für die Teaser kann ein Teaser-Format gewählt werden über das die Darstellung des Teasers bestimmt wird. Die Teaser-Formate können im Backend angelegt werden.

{% hint style="success" %}
Artikel (redaktionell) → Artikel Teaser-Formate
{% endhint %}

Beispiele von Teaserformaten:

![](/files/-LIut3VxGYyM-ehwZz3g)


# Redaktionelle Artikel und Artikellisten anlegen

## Einen redaktionellen Artikel anlegen

{% hint style="success" %}
Artikel (redaktionell) → Artikel (redaktionell)
{% endhint %}

`Basisdaten`

In den Basisdaten wird der Inhalt des Artikels sowie alle relevanten Daten zur Veröffentlichung hinterlegt.

Wie bereits oben beschrieben, muss hier der `Artikeltyp` ausgewählt werden. Damit der Artikel in einer automatisierten Liste oder an einer bestimmten Stelle in der Navigation erscheint, muss er ebenfalls einer vorher definierten `Kategorie` zugewiesen werden.

Der eigentliche Text wird im Feld `Artikeltext` eingetragen. Hier stehen alle Funktionen des [WYSIWYG-Editors](/inhalte/ckeditor) zur Verfügung.

`Teaser`

Über das Teaser-Format wird festgelegt, wie der Teaser auf der Website erscheint, ob z.B. als Slider, Bild mit Link, nur Bild, Bild mit Überschrift und Text usw.

Zusätzlich zur Überschrift und dem eigentlichen Teasertext kann noch ein Bild eingefügt werden (die Anzeige des Bildes ist abhängig vom gewählten Teaser-Format).

Für einen Artikel können beliebig viele Teaser mit unterschiedlichen Ausgabearten (Teaser-Formaten) angelegt werden. So kann ein Artikel an mehreren Stellen in unterschiedlicher Form eingebunden werden.

## Redaktionelle Artikel über Artikellisten anzeigen

Das Listenmodul stellt eine Liste von Artikeln dar, die mit Filtern eingeschränkt werden kann. Die Liste kann dabei auf einzelne Artikel, Artikelkategorien oder Artikeltypen eingeschränkt werden. Für die Liste kann zudem eine Sortierung und ein Filter angegeben werden. Außerdem kann gewählt werden, welche Sortierung und Filter im Frontend zur Auswahl stehen sollen.

Das Artikellistenmodul kann z.B. auch auf Artikeldetailseiten verwendet werden, um passende Artikel zum aktuell aktiven Artikel darzustellen, einfach den entsprechenden Filter verwenden. Der Name des Listviews ergibt sich aus dem Namen des Views vom Listenmodul.

Um eine Artikelliste anzulegen, wählen Sie im Modul `Artikel-Liste (redaktionell)`. Wählen Sie sodann die gewünschte Listenansicht aus, zum Beispiel `Bild mit Überschrift auf schwarzem Overlay (Bildergalerie)`.

![](/files/-LIut3xoPz1UqP2bsHsx)

\
&#x20;Über `Editieren` und `Neu` legen Sie eine Liste an. <br>

`Basisdaten`

`Sortierung`: Sie können beliebig viele Listen im Modul unterbringen. Über Sortierung kann die Reihenfolge der Liste verschoben werden.

`Standardsortierung`: Wählen Sie, in welcher Reihenfolge die Artikel erscheinen sollen (nach Datum, Überschrift oder manueller Selektion

`Überschrift:` Wird im Frontend über der Liste angezeigt

`Einträge je Seite`: Hier können Sie angeben, wieviele Artikel auf einer Seite erscheinen dürfen. Wenn es mehr Artikel gibt als auf einer Seite erscheinen dürfen, wird eine nächste Seite erstellt, die über Blättern erreichbar ist)

`Artikelanzahl beschränken auf`: Hier können Sie angeben, wieviele Artikel insgesamt ausgespielt werden dürfen.

### Beispiel:

Es existieren 30 freigeschaltete Artikel, es sollen aber nur die neuesten 10 angezeigt werden, jedoch pro Seite nur 5 Artikel. Einträge je Seite = 5; Artikelanzahl beschränken auf = 10

\
&#x20;Die Liste kann nun weiter eingeschränkt werden, z.B. nach **Artikeltyp** oder **Kategorie** (z.B. Thema (Kategoriegruppe) *Literatur* / Kategorie *Zeitgenössische Autoren* - in der Liste werden nur Teaser von Artikeln angezeigt, die der Kategorie *Zeitgenössische Autoren* zugewiesen sind).

`Filter`

Es ist auch möglich, einer Liste manuell Artikel zuzuweisen, indem man bei `Auf folgende Artikel einschränken` den entsprechenden Datensatz (Artikel) verknüpft). Dann ist eine Einschränkung über Typen oder Kategorien nicht notwendig.


# Medien

Über den Punkt `Medien` gelangt man zu der zentralen Bilder- und Medienverwaltung im Chameleon-System. Hier können neue Medien wie Bilder und Videos hochgeladen sowie bestehende entfernt oder aktualisiert werden.

Die Verwaltung öffnet sich in einem neuen Fenster (d.h. die aktuelle Seite, die man bearbeiten möchte, bleibt im Hintergrund geöffnet).

![](/files/-LIut3rNFEcVL0ASNh1U)

Die Verzeichnisstruktur links und die Suchfunktion unten ermöglichen ein schnelles Auffinden der gesuchten Datei. Über die rechte Maustaste erreicht man das Kontextmenü. Hier hat man die Möglichkeit, die Baumstruktur links zu bearbeiten (Ordner anlegen, löschen, verschieben, umbenennen) und Dateien hochzuladen, zu importieren oder zu verschieben. Es können mehrere Dateien gleichzeitig hochgeladen werden.

| Bezeichnung                 | Beschreibung                                                                                                                                         |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Neuer Ordner                | Erstellt einen neuen Ordner.                                                                                                                         |
| Löschen                     | Verzeichnis sowie alle Unterverzeichnisse und Medien werden entfernt. Alle Zuweisungen in Seiten und Datensätzen werden entfernt.                    |
| Bewegen                     | Versetzen kompletter Baumknoten innerhalb der Baumstruktur.                                                                                          |
| Dateien hochladen           | Manuelles Hochladen der Dateien vom Client-Rechner.                                                                                                  |
| Dateien importieren (FTP)   | Importieren aller Dateien, die im Verzeichnis *private/cmsdata/mediaImport* liegen und zuvor per FTP *(FTP-Zugang erforderlich)* hochgeladen wurden. |
| Dateien hierhin verschieben | Alle Dateien, die markiert und ausgeschnitten wurden, können über diese Funktion in das markierte Verzeichnis verschoben werden.                     |
| Umbenennen                  | Benennt ein Verzeichnis um.                                                                                                                          |

Möchten Sie ein Bild oder Video durch ein anderes ersetzen, rufen Sie den entsprechenden Bild-Datensatz in `Medien` auf und laden über `Mediendatei ersetzen` die neue Datei hoch. Das Bild (Video, ...) wird nun an allen hinterlegen Stellen auf der Website automatisch ersetzt.

Die Medienverwaltung ist auch im Datensatz, in dem das Bild eingefügt werden soll, über den Button `Medien verwalten` erreichbar. Zudem kann die Datei auch direkt im Datensatz in den entsprechenden Ordner hochgeladen werden.

![](/files/-LIut3rPfedWqMASRqbS)

Beim Bildmaterial muss grundsätzlich darauf geachtet werden, dass keine Bilder im CMYK-Format hochgeladen werden (das Hochladen funktioniert in dem Fall nicht). Des Weiteren sollte darauf geachtet werden, dass nach Möglichkeit keine Bilder in zu hoher Auflösung (z.B. direkt von der Kamera) hochgeladen werden - je nach Server-Konfiguration kann dies zu Problemen führen. Die Dateigröße darf die unter *CMS Einstellungen → Uploader Konfiguration* eingestellten Upload-Werte nicht überschreiten.


# Dokumente

Über den Punkt `Dokumente` gelangt man zur zentralen Dokumentenverwaltung im Chameleon-System. Hier werden alle Daten abgelegt, die den Besuchern der Webseite als Download zur Verfügung gestellt werden sollen.

Von hier aus kann man neue Dokumente hochladen sowie bestehende entfernen oder aktualisieren. Die Verzeichnisstruktur links und die Suchfunktion ermöglichen ein schnelles Auffinden der gesuchten Datei. Für die genaue Beschreibung der Funktionen aus dem Kontextmenü siehe Kapitel [Medien](/inhalte/medien).

Die Dateigröße darf die unter `CMS / Portal-Einstellungen → CMS Einstellungen → Uploader Konfiguration` eingestellten Werte nicht überschreiten.

Eine Besonderheit der Dokumente ist die Einstellung *geschützt: NEIN/JA*. Für nicht geschützte Dokumente wird ein öffentlich verfügbarer und menschlich lesbarer Link auf die Datei angelegt (<http://ww.mydomain.de/chameleon/outbox/public/categoryId/FileName.pdf>).

Als *geschützt* markierte Dateien werden hingegen nicht direkt verlinkt, sondern durch einen Download-Manager ausgeliefert (SEO Handler). Dieser reagiert auf eine per config einstellbare URL (Config Konstante: URL\_PROTECTED\_DOCUMENT\_VIRTUAL\_OUTBOX). Außerdem kann aktiviert werden, dass der Download nur für angemeldete Benutzer zugreifbar ist (CHAMELEON\_CHECK\_VALID\_USER\_SESSION\_ON\_PROTECTED\_DOWNLOADS). Für z.B. kaufbare Downloadprodukte kann alternativ zu Login-Prüfungen ein Download auch mit einem temporären "Schlüssel" (Token) versehen werden, der nach Zeit x ausläuft (einstellbar über: CHAMELEON\_DOCUMENT\_AUTH\_TOKEN\_LIFE\_TIME\_IN\_MINUTES).


# Bildergalerien

{% hint style="success" %}
Website → Bildergalerien
{% endhint %}

Durch die Bildergalerien hat man die Möglichkeit, im Frontend Bildsammlungen zu präsentieren. Es können beliebig viele Bildergalerien angelegt werden, die jeweils beliebig viele Bilder enthalten können.

| Bezeichnung                                           | Beschreibung                                                                                                |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Name**                                              | Name der Bildergalerie                                                                                      |
| **Portal**                                            | Portal, zu welchem die Bildergalerie gehört                                                                 |
| **Aktiv**                                             | gibt an, ob die Bildergalerie aktiv/inaktiv geschaltet ist                                                  |
| **Maximale Breite**                                   | maximale Breite der Bildergalerie (Darstellung)                                                             |
| **Maximale Höhe**                                     | maximale Höhe der Bildergalerie (Darstellung)                                                               |
| **Vorschaubild**                                      | Vorschaubild der Bildergalerie                                                                              |
| **Beschreibung**                                      | kurze Beschreibung der Bildergalerie                                                                        |
| **Bilder aus Mediendatenbank-Verzeichnis übernehmen** | Bilder, die zuvor zu *Medien* hinzugefügt wurden, können hier direkt in die Bildergalerie übernommen werden |
| **Bilder**                                            | Ein Bild hochladen und eine Liste aller Bilder der Galerie                                                  |

Die Bildergalerien können über einen im Frontend anzulegenden View angezeigt werden.

## Beispiel Bildergalerie im Frontend:

![](/files/-LIut4x8A9PPLIMP_3BA)

![](/files/-LIut4xA-5NxYTg5Yxfd)


# Übersetzungen

> Ab CHAMELEON Version 6.1 steht eine komplett überarbeite Funktionalität der Mehrsprachigkeit zur Verfügung.


# Zentrale Shop-Einstellungen

### Shops

{% hint style="success" %}
Shop-Einstellungen → Shops
{% endhint %}

Unter `Shops` werden alle vom System verwalteten Shops aufgelistet. Ist nur ein Shop definiert, gelangt man direkt in die Einstellungen des Shops, sind jedoch mehrere definiert, wird eine Auswahl eingeblendet.

| Tab                   | Beschreibung                                                                                                                                                                               |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Basisdaten            | Pflege der grundlegenden Daten zum Besitzer und Zugehörigkeit des Shops                                                                                                                    |
| Standardeinstellungen | Einstellungen (z.B. Standard-MwSt-Satz, Standardsortierung der Artikellisten), die verwendet werden, wenn keine abweichenden Detail-Einstellungen (z.B. in Kategorien) vorgenommen wurden. |
| Sucheinstellungen     | Für den Suchindex und die Suche relevante Angaben                                                                                                                                          |
| Konfiguration         | Die zentrale Konfiguration des Shops                                                                                                                                                       |
| Systemeinstellungen   | Angaben über die zuletzt verwendeten Bestell-/Kundennummern sowie den zentralen Shop-Handler sowie max. Größe des Artikelhistorie-Cookies und welche SEO-URLs-Version aktiv ist.           |
| Bewertung             | Nach wieviel Tagen erhält der Kunde eine Bewertungsaufforderung, wieviel Prozent der Kunden erhalten diese, erhält der Kunde bei jeder Bestellung eine Bewertungsaufforderung              |
| Trusted Shops         | TrustedShop-Konfiguration                                                                                                                                                                  |

### Shop-Textbausteine

{% hint style="success" %}
Shop-Einstellungen → Shops → Konfiguration → Shop-Textbausteine (z.B. AGB)
{% endhint %}

Hier können Textbausteine, die ausschließlich für Shops gedacht sind, erstellt werden. Somit können Sie z.B. eine Seite mit Informationen wie AGB, Datenschutz etc. erstellen. Natürlich lassen sich einzelne Bausteine auch auf verschiedenen Seiten anlegen.

Im Backend ist dafür auf einer Seite das Modul `Shop spezifische Informationen` anzulegen. Im Modul können Sie dann einfach per Klick auswählen, welche Textbausteine auf der Seite angezeigt werden sollen.

![](/files/-LIut3ZeZZrMBKsoyqoe)

Der Unterschied zu den [Textbausteinen](/inhalte/textbausteine) ist, dass die Shop-Textbausteine ausschließlich den Shop betreffen, die Textbausteine (`Website → Textbausteine`) jedoch global eingesetzt werden können, also auch auf reinen Content-Webseiten.

### Benutzereinstellungen (Extranet-Konfiguration)

{% hint style="success" %}
CMS / Portal-Einstellungen → Extranet-Konfiguration
{% endhint %}

In der Extranet-Konfiguration können Einstellungen vorgenommen werden, die für die Interaktion mit dem Portal-/Shop-Besucher notwendig sind, z.B. bei der Registrierung, bei ungültigem Login oder bei vergessenem Passwort. Unter `Seiten` können entsprechende Landing-Pages definiert werden, die dem Kunden bei Aktionen wie „verweigertem Zugriff“ oder nach einer „erfolgreichen Registrierung“ angezeigt werden sollen.

### Benutzerländer

{% hint style="success" %}
Shop-Einstellungen → Benutzerländer
{% endhint %}

Die zur Registrierung verfügbaren Länder. In welche Länder generell Ware geliefert wird, wird in den [Versandkostenarten](/shop/bestellinformation/bestellprozess-einstellungen/versandkostenart) definiert.

### Maßeinheiten

{% hint style="success" %}
Shop-Einstellungen → Maßeinheiten
{% endhint %}

Hier werden die Maßeinheiten für die Grundpreisberechnung hinterlegt.

Jede Einheit besteht dabei aus folgendem:

* Name: *Gramm*
* Symbol oder Abkürzung: *g*
* Faktor, mit dem eine Einheit multipliziert werden muss, um auf die Grundeinheit zu kommen. Beispiel: Für die Einheit Gramm muss der Faktor *0,001* sein, um auf die Grundeinheit kg zu kommen.
* Die Grundeinheit (ein Verweis auf eine Maßeinheit mit dem Faktor 1): Kilogramm

### Umsatzsteuergruppen

{% hint style="success" %}
Shop-Einstellungen → Umsatzsteuergruppen
{% endhint %}

Alle über den Shop verwaltbaren Steuergruppen.

### Variantensets

Werden mehrere Varianten eines Artikels angeboten, müssen hier die passenden Variantensets angelegt werden, wie z.B. ein Variantenset *Rahmengröße und Farbe* bei Fahrrädern.

Das Anlegen von Variantensets und Varianten eines Artikels wird im Kapitel [Artikelvarianten](/shop/produktinformation/artikelvarianten) beschrieben.

### Währungen

Wenn Ihr Shop über mehrere Währungen verfügt, werden diese hier definiert. Dabei wird ein Umrechnungsfaktor zur Basiswährung angegeben.


# Anzeige Shop-Hauptnavigation

{% hint style="success" %}
Website → Shop-Hauptnavigation
{% endhint %}

Über diesen Menüpunkt wird die Anzeige der Shop-Hauptnavigation gesteuert.

![](/files/-LIut75Ts5Bxub7WMKgT)

Sie können beliebige Menüpunkte hinzufügen oder bestehende ändern. Ein Menüpunkt kann entweder mit einer Seite oder auch mit einer Artikelkategorie verknüpft werden.

![](/files/-LIut75VO0TEYic0hXyw)

| Bezeichnung                                       | Beschreibung                                                                                                                                                                                                                 |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Gehört zum Portal**                             | Wählen Sie den Name des Portals aus (sofern Sie mehrere Portale im CMS verwalten).                                                                                                                                           |
| **Name**                                          | Der Name des Menüpunktes, wie er im Frontend erscheinen soll.                                                                                                                                                                |
| **Gehört zu diesem Brand-Store**                  | Falls Ihr Shop Brand-Stores verwendet, wählen Sie den entsprechenden aus (so können Sie z.B. Artikel aus Brand-Stores für den Kunden schnell erreichbar zur Verfügung stellen).                                              |
| **Aktiv**                                         | Aktiviert den Menüpunkt                                                                                                                                                                                                      |
| **Position**                                      | Die angezeigte Reihenfolge können Sie hier verändern.                                                                                                                                                                        |
| **Navigation aus**                                | Wählen Sie hier aus, ob der Menüpunkt mit einer Seite oder einer Produktkategorie verknüpft werden soll.                                                                                                                     |
| **Untermenü durch Shop-Hauptkategorien ersetzen** | Jeder Menüpunkt kann weitere Unterpunkte haben. Bei JA werden hier die Hauptkategorien des Shops (*Artikel → Artikelkategorien*) automatisch als Untermenü hinzugefügt.                                                      |
| **Eigene CSS-Klasse**                             | Hier kann eine CSS-Klasse definiert werden, die dann auf den Navigationspunkt angewendet wird. Standardmäßig kann „onSale“ für Angebote verwendet werden (der Menüpunkt wird dann in einer hervorgehobenen Farbe angezeigt). |


# Produktinformation

![](/files/-LIut3Ukgj-aBVi4Y4Rq)


# Artikel

{% hint style="success" %}
Artikel → Artikel
{% endhint %}

In der Artikelverwaltung sind alle im Shop verfügbaren Artikel aufgelistet. Die Suchfunktion ermöglicht ein schnelles Auffinden des gesuchten Artikels. Die Artikel gelangen entweder per Import in den Shop oder werden manuell angelegt.

`Basisdaten`

| Bezeichnung                        | Beschreibung                                                                                                                                                                                                                                                                                          | erforderlich |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Name**                           | Benennung des Artikels. Der Name ist erforderlich, um den Artikel im CMS-Backend finden zu können.                                                                                                                                                                                                    | ja           |
| **Artikelnummer**                  | Die eindeutige Nummer des Artikels im Shop                                                                                                                                                                                                                                                            | nein         |
| **Artikeldetailbilder**            | Bilder des Artikels. Wenn keine Artikelvorschaubilder definiert sind, wird das erste Bild aus dieser Liste als Standardvorschaubild verwendet.                                                                                                                                                        | nein         |
| **Standard-Artikelvorschaubilder** | Das Hauptbild des Artikels (wird in den Kategorien angezeigt)                                                                                                                                                                                                                                         | nein         |
| **Artikelvorschaubilder**          | Da ein Artikel im Shop an vielen Stellen unterschiedlich präsentiert werden kann, ist hier die Möglichkeit geboten, die jeweiligen Vorschaubilder definieren zu können. Ist hier kein Bild für die passende Vorschaugröße definiert, so wird das erste Bild aus den Artikelvorschaubildern verwendet. | nein         |
| **Artikeldokumente**               | Hier werden die zum Artikel passenden Dokumente zugewiesen (z. B Benutzerhandbuch, technische Beschreibung usw.).                                                                                                                                                                                     | nein         |
| **Erstellt am**                    | Erstellungsdatum / Anlagedatum                                                                                                                                                                                                                                                                        | nein         |
| **Aktiv**                          | Inaktive Artikel werden im Shop nicht angezeigt.                                                                                                                                                                                                                                                      | ja           |
| **Tags / Schlagworte**             | Wird auf der Artikeldetailseite ausgegeben. Artikel mit gleichen Tags können so in einer Artikelliste ausgegeben werden.                                                                                                                                                                              | nein         |

`Beschreibung`

| Bezeichnung          | Beschreibung                                                                                                                                                                                                          | erforderlich |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Kurzbeschreibung** | Eine kurze Zusammenfassung, die den Artikel möglichst treffend beschreibt. Die Anzeige der Kurzbeschreibung ist abhängig vom gewählten Seitentemplate (View), gewöhnlich wird sie in der Artikelliste mit aufegführt. | nein         |
| **Beschreibung**     | Ausführliche Beschreibung des Artikels auf der Artikeldetailseite                                                                                                                                                     | nein         |

`Kategorie / Merkmale`

| Bezeichnung                           | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | erforderlich |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Hersteller / Marke**                | Artikelhersteller oder Marke                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | nein         |
| **Warengruppen**                      | Dienen der Gruppierung der Artikel. Warengruppen selbst können z.B. als Einschränkung bei Zahlmethoden verwendet werden. Die Zahlmethode wäre im Warenkorb nur dann verfügbar, wenn alle Artikel des Warenkorbes mindestens in einer Warengruppe sind.Warengruppen können entweder hier, direkt beim Artikel, angelegt werden oder über *Artikel → Warengruppen*, die Warengruppe wird dann beim Artikel verknüpft (AUSWÄHLEN).                                                                    | nein         |
| **Artikeltyp**                        | Ein Artikel kann einem oder mehreren frei definierbaren Artikeltypen zugewiesen werden (CD, Download, Produkt usw.). Artikeltypen können z.B. für Suchfilter sowie im Warenkorb zur Anwendung kommen (Downloads z.B. haben keine Versandkosten).                                                                                                                                                                                                                                                   | nein         |
| **Produktkategorien**                 | Jeder Artikel kann einer (oder auch mehreren) Kategorie(n) zugewiesen werden und wird dann in der Artikelliste der jeweiligen Kategorie angezeigt.                                                                                                                                                                                                                                                                                                                                                 | ja           |
| **Hauptkategorie des Artikels**       | Befindet man sich gerade nicht auf einer Kategorieseite, welcher der Artikel zugewiesen ist, so wird als Standard die Hauptkategorie zur Generierung der Artikel-URL verwendet.                                                                                                                                                                                                                                                                                                                    | nein         |
| **Artikelmerkmale**                   | Artikelmerkmale sind Beschreibungen, die den Artikeln zugefügt werden können. Diese Beschreibungen machen eine klare Aussage über den Artikel, z.B. “ist abwaschbar” oder „Blauer Engel“. Für jedes Merkmal kann ein Name, eine Beschreibung sowie ein Icon hinterlegt werden.                                                                                                                                                                                                                     | nein         |
| **Produktattribute**                  | Produktattribute sind Merkmale, denen unterschiedliche Werte zugewiesen werden können, z.B. “waschbar bei” + zugehöriger Wert “30°C”. Ohne Zuweisung eines Wertes ist dieses Attribut aussagelos.                                                                                                                                                                                                                                                                                                  | nein         |
| **Auf folgende Shops einschränken**   | Falls im System mehrere Shops existieren, kann hier eine Einschränkung der Artikelsichtbarkeit vorgenommen werden.                                                                                                                                                                                                                                                                                                                                                                                 | nein         |
| **Zum Arktikel beitragende Personen** | Hier werden Personen oder Firmen hinterlegt, die in die Produktion des Artikels involviert waren (z.B. als Autor oder Sprecher). Die Anzeige ist abhängig vom gewählten Seitentemplate.                                                                                                                                                                                                                                                                                                            | nein         |
| **Download-Datei**                    | Hier können Sie diesem Artikel einen Download aus der Dokumentenverwaltung zuweisen. Diese Datei kann vom User erst heruntergeladen werden, wenn der Artikel erfolgreich gekauft wurde. **Wichtig**:Da diese Funktion auch bei Produkten zur Verfügung steht, die nicht explizit als "Download" definiert wurden (z.B. über die Zuweisung eines Lagers namens "Download"), können hier auch sonstige für den Artikel relevanten Files hinterlegt werden - z.B. Firmware-Upgrades für Hardware etc. | nein         |

`Preis / Versand`

| Bezeichnung                       | Beschreibung                                                                                                                       | erforderlich |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Preis**                         | Artikel-Brutto-Preis                                                                                                               | ja           |
| **Vergleichspreis**               | Der Vergleichspreis (UVP) des Artikels (wird für gewöhnlich im Shop durchgestrichen angezeigt, da höher als der eigentliche Preis) | nein         |
| **Umsatzsteuergruppe**            | Zum Artikel passender Umsatzsteuersatz                                                                                             | nein         |
| **Artikel ist versandkostenfrei** | Identifiziert Artikel, die versandkostenfrei versendet werden.                                                                     | nein         |
| **keine Gutscheine zulassen**     | JA: im Warenkorb angewendeten Gutscheine wirken sich nicht auf dieses Produkt aus.                                                 | nein         |
| **keine Rabatte zulassen**        | JA: Rabatte werden nicht auf dieses Produkt angewendet.                                                                            | nein         |

`Inhalt / Maße / Gewicht`

Unter *Inhalt / Maße / Gewicht* können die entsprechenden Angaben zu den Dimensionen des Artikels angegeben werden.

Möchten Sie Grundpreise in Ihrem Shop angeben (z.B. 100g / 5,73 €), hinterlegen Sie die Angaben in den Feldern **Inhalt** (Mengenangabe) und **Maßeinheit des Inhalts** (kg, g, l, ml, usw.).

Die Maßeinheiten selbst können über das CMS erweitert werden (sh. Kapitel **3.4 Maßeinheiten**).

`Varianten`

Varianten eines Artikels, wie z.B. verschiedene Größen und/oder Farben bei Bekleidung, können mithilfe des Variantengenerators erzeugt werden, sh. Kapitel [Artikelvarianten](/shop/produktinformation/artikelvarianten).

`Lager`

| Bezeichnung                          | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                  | erforderlich |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Lagerbestand**                     | Auf Lager, verfügbare Artikelanzahl                                                                                                                                                                                                                                                                                                                                                           | nein         |
| **Bei 0 Bestand Vormerken anbieten** | Sinkt der Bestand auf „0“, wird ein Formular zum Vormerken des Artikels auf der Artikeldetailseite angezeigt.                                                                                                                                                                                                                                                                                 | nein         |
| **Lieferstatus**                     | Ein meist vom Shopbetreiber vorgegebener Status wie „nicht lieferbar“ oder „sofort lieferbar“, der auf der Artikeldetailseite angezeigt werden kann. Im Datensatz des Lieferstatus (Lagerbestandsmeldung) kann definiert werden, ob der Artikel automatisch deaktiviert werden soll, wenn der Bestand 0 ist. Bei NEIN ist der Artikel also immer noch sichtbar, auch wenn der Bestand ≤0 ist. | nein         |

`Cross Selling`

Im Bereich Cross Selling können mit dem Artikel verwandte Artikel (ähnliche Artikel) verknüpft werden und das Zubehör des Artikels zugewiesen werden. Diese Verknüpfungen werden je nach Shop-Design zur Verkaufsförderung verwendet und werden bei der Ansicht des Artikels mit angezeigt (sh. auch Kapitel **4.9 Produktlisten**).

`SEO / Meta`

| Bezeichnung              | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                      | erforderlich |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **SEO Pattern**          | Durch die Definition des SEO-Patterns kann genau gesteuert werden, wie der Titel der Artikelseite aussehen soll. **Zur Verfügung stehen**: \[{PORTAL\_NAME}] - Name des Portals; \[{CATEGORY\_NAME}] – Kategorie-Name; \[{MANUFACTURER\_NAME}] – Hersteller-Name; \[{ARTICLE\_NAME}] - Artikelbezeichnung; \[{SHOW}] – zeigt alle Möglichkeiten an; *Wird hier nichts eingetragen, greifen die allgemeinen Einstellungen unter Portale/Webseiten* | nein         |
| **Meta-Schlüsselwörter** | Hier werden die Suchmaschinen-relevanten Meta-Schlüsselwörter (meta keywords) hinterlegt.Wird dieses Feld leer gelassen, verwendet der Shop die Kurzbeschreibung des Artikels.                                                                                                                                                                                                                                                                    | nein         |
| **Meta-Description**     | Optionale Meta-Beschreibung (description) für die Artikelseite. Wird kein Wert hinterlegt, erstellt das System eine Meta-Beschreibung auf Basis der Artikeldaten. Die Description wird als erläuternder Text bei den trefferlisten in Suchmaschinen angezeigt.                                                                                                                                                                                    | nein         |

Unter „Metadaten“ können die Metadaten speziell für dieses Produkt überschrieben werden.

`Suche`

| Bezeichnung                 | Beschreibung                                                                                                                                                    | erforderlich |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Gewichtung des Artikels** | Zahl, über die der Rang des Produktes in den Listen gesteuert werden kann.                                                                                      | nein         |
| **Virtueller Artikel**      | Identifiziert den Artikel als virtuell (real nicht verfügbar). Ein Beispiel für einen virtuellen Artikel könnte ein eBook-Download beim Kauf eines Buches sein. | nein         |
| **Ist suchbar**             | Definiert, ob der Artikel in den Suchindex aufgenommen wird.                                                                                                    | nein         |
| **Als neu kennzeichnen**    | Optionale Einstellung, die im Design ausgewiesen wird.                                                                                                          | nein         |

`Bewertungen`

| Bezeichnung           | Beschreibung                                                         | erforderlich |
| --------------------- | -------------------------------------------------------------------- | ------------ |
| **Anzahl Sterne**     | Gibt die durchschnittliche Benutzerbewertung des Produktes an        | nein         |
| **Kundenrezessionen** | Alle von den Kunden geschriebenen Rezensionen. Je nach Konfiguration | nein         |

`Bundle`

| Bezeichnung                               | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | erforderlich |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Ist ein Bundle**                        | Bundles werden als echtes Produkt im Shop geführt. Hier muss also eine eigene Beschreibung, eigene Bilder, ein eigener Preis, usw. hinterlegt werden. Um das Bundle als solches zu erkennen, wird das Produkt über „Ist ein Bundle“ als Bundle markiert. Zusätzlich werden alle zu dem Bundle gehörenden Produkte dem Bundle zugewiesen. Bei der Zuweisung jedes Artikels kann die Stückzahl mit angegeben werden. Im Warenkorb und bei allen Berechnungen wird das Bundle ebenfalls als ein Produkt behandelt. | nein         |
| **Artikel, die zu diesem Bundle gehören** | Wenn es sich um ein Bundle handelt, können hier die zu dem Bundle gehörenden Produkte hinterlegt werden. **Wichtig**: Alle dem Bundle zugewiesenen Produkte werden dabei ignoriert. Rabatte, Gutscheine, Zahlmethoden, Versandkosten und Mehrwertsteuerregeln gelten also nie für die einzelnen Produkte in dem Bundle, sondern immer nur für das Bundle-Produkt.                                                                                                                                               | nein         |

`Stats`

![](https://github.com/esono-ag/chameleon-documentation-de/tree/5b0a385112ca4bca11418aab4404f78598f48ec6/bild%20air.png)

Liefert eine statistische Kurzübersicht über den Artikel (Verkäufe, Detailaufrufe, durchschnittliche Bewertung, Anzahl der Bewertungen).

Ihre Eingaben speichern Sie über den SPEICHERN-Button oberhalb des Datensatzes oder auch noch bequemer, über Rechtsklick an jeder beliebigen Stelle im Datensatz erreichen Sie das Kontextmenü, welches Ihnen die wichtigsten Editierfunktionen.

| Bezeichnung          | Beschreibung                                                                                                                                                                                                                                                                                                 |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Speichern**        | Nach erfolgreicher Plausibilitätsprüfung wird der Artikel gespeichert                                                                                                                                                                                                                                        |
| **Kopieren**         | Kopiert die Artikeldaten und erstellt einen neuen Artikel                                                                                                                                                                                                                                                    |
| **Neu**              | Erstellt einen neuen leeren Artikel                                                                                                                                                                                                                                                                          |
| **Löschen**          | Löscht den Artikel                                                                                                                                                                                                                                                                                           |
| **Sprache kopieren** | Felder, die in der aktuellen Sprache nicht übersetzt sind, können aus einer anderen Sprache kopiert werden. Wenn man sich z.B. in der Editiersprache Englisch befindet, kann man so den deutschen Text erst einmal in dieses Feld kopieren, um es zum jetzigen (oder auch späteren) Zeitpunkt zu übersetzen. |
| **Menü abschalten**  | Schaltet bis zum nächsten Seiten-Reload das CHAMELEON-Kontextmenü auf dem rechten Mausklick ab, damit das Standardmenü des Browsers durch Rechtsklick verwendet werden kann.                                                                                                                                 |


# Artikelkategorien

{% hint style="success" %}
Artikel → Artikelkategorien
{% endhint %}

Die Shop-Kategorien sind Präsentationsflächen Ihres Shops. Die Kategorien selbst können beliebig viele Unterkategorien haben. Beim Anlegen der Kategorien ist grundsätzlich zu beachten „Versetzen Sie sich in Ihre Käufer“ und erstellen Sie eine Reihe von Kategorien, mit deren Hilfe Käufer schnellstens zu den gewünschten Artikeln gelangen.

Will man eine „Root-Kategorie“ (Kategorie der obersten Ebene) anlegen, klickt man auf `Neu` in der Kategorie-Übersicht. Unterkategorien werden innerhalb einer Hauptkategorie angelegt. Die Reihenfolge der Kategorien kann über den Button `Position` per Drag\&Drop angepasst werden.

Jede Kategorie kann mit einem eigenen Bild versehen und in der Navigation farblich hervorgehoben werden. Weiterhin kann für jede Kategorie eine eigene Detailseite gewählt werden (die anstelle der Standard-Detailseite angezeigt wird). So können Sie Haupt- von Unterkategorien optisch ganz einfach trennen oder bestimmte Rubriken individuell gestalten, um enthaltene Produkte auf besondere Art hervorzuheben (*Vorlage*).

Ein Produkt kann mehreren Kategorien zugeordnet werden.

Damit die Produktkategorien in der Hauptnavigation des Shops erscheinen, müssen sie unter der `Shop-Hauptnavigation` mit einem Navigationspunkt verknüpft werden (`Navigation aus`: Artikelkategorien).


# Artikeltypen

{% hint style="success" %}
Artikel → Artikeltypen
{% endhint %}

Hier können Artikeltypen definiert werden. Im Gegensatz zu Warengruppen, die abstrakt sein können (z.B. Warengruppe X mit Versandkosten Y und Steuersatz Z), definieren Artikeltypen ganz konkrete Eigenschaften einzelner Artikel.

Beispiel: Artikeltypen können zur Kategorisierung von Artikeln verwendet werden, indem man die Typen Buch, CD, DVD usw. definiert.

Die Artikeltypen werden im Artikel im Tab `Kategorie/Merkmale` mit dem Artikel verknüpft.


# Beitragende Personen

{% hint style="success" %}
Artikel → Beitragende Personen (z.B. Autoren für Artikel)
{% endhint %}

Hier werden Personen oder Ähnliches (z.B. Firmen) hinterlegt, die in die Produktion des Artikels involviert waren (z.B. als Autor oder Sprecher). Die Personen werden im Artikel im Tab `Kategorie/Merkmale` mit dem Artikel verknüpft.


# Hersteller / Marke

{% hint style="success" %}
Artikel → Hersteller/Marke
{% endhint %}

Hersteller bzw. Marken werden hier zentral verwaltet. Jeder Artikel kann einem Hersteller bzw. Marke zugewiesen werden. Bei der Selektion der Artikel werden Hersteller/Marken als zusätzlicher Filter dargestellt und ermöglichen dem Kunden bei der Suche somit eine einfache Filterung der Artikel.

Außerdem kann über ein Modul auf einer Seite eine Herstellerliste zur Auswahl angeboten werden. Die Auswahl eines Herstellers führt zur Detailseite des Herstellers. Hier wird der Name sowie die optionale Beschreibung des Herstellers angezeigt sowie sämtliche Produkte des Herstellers. Für jeden Hersteller können folgende Daten hinterlegt werden: Name, Logo/Bild, Beschreibung, Größentabelle.


# Produktattribute

{% hint style="success" %}
Artikel → Produktattribute
{% endhint %}

Hier können artikelbeschreibende Merkmale =Wertpaare hinterlegt werden, die den Artikel möglichst genau beschreiben, z.B. „waschbar bei“ (Attribut) + „30 Grad“ (Wert). Ohne Zuweisung eines Wertes ist das Attribut aussagelos. Die Produktattribute können im Artikel im Tab `Kategorie/Merkmale` mit dem Artikel verknüpft werden.

Nach Produktattributen kann im Shop gefiltert werden. Ist ein Produktvergleichsmodul integriert, so werden diese für den Produktvergleich einbezogen.


# Artikelmerkmale

{% hint style="success" %}
Artikel → Shop-Artikelmerkmale
{% endhint %}

Für jedes Merkmal kann Name Beschreibung sowie Icon hinterlegt werden. Hierbei handelt es sich nicht um Produktattribute, d.h. es können keine Werte je Merkmal pro Artikel zugewiesen werden. Artikelmerkmale sind z.B. CE-geprüft, TÜV-geprüft, spülmaschinenfest, Batterien incl., Full-HD usw\..

Die Artikelmerkmale können im Artikel im Tab Kategorie/Merkmale mit dem Artikel verknüpft werden und werden im Shop auf der Artikeldetailseite angezeigt.


# Artikelvarianten

Varianten eines Artikels, wie z.B. verschiedene Größen und/oder Farben bei Bekleidung, können im Chameleon Backend mithilfe des **Variantengenerators** erzeugt werden.

Dafür wird zunächst ein generisches **Variantenset** erzeugt (z.B. *Größe und Farbe*), welches für alle Artikel des gleichen Produkttyps verwendet werden kann. Mithilfe des intelligenten **Generators** können dann mögliche Varianten vorgeschlagen und automatisch erzeugt, z.B. T-Shirt gelb S, gelb M, gelb L, rot S, rot M, rot L usw\..

Zur Veranschaulichung dieser Dokumentation wird dieses [Produkt](https://demo.chameleon-system.de/testmarke-11/schmuck/armband-colour-armbaender_pid_832_7079.html?_ref=spot3\&url=%2FProdukte%2FSchmuck%2FArmbaender%2F) aus dem Chameleon Demoshop in verschiedenen **Größen und Farben** verwendet.

## Variantenset

Ein `Variantenset` ist eine Kombination aus einem oder mehreren `Variantenarten` eines Produktes. Jede Variantenart verfügt wiederum über entsprechende `Variantenwerte`.

Das Variantenset unseres Beispiels sieht folgendermaßen aus:

**Variantenset:** Größe und Farbe (= Name/Bezeichnung)

**Variantenarten:** 1. Größe 2. Farbe

**Variantenwerte:** Jede Variantenart hat entsprechende Werte

* Variantenart *Größe* hat die Werte S, M, L
* Variantenart *Farbe* hat die Werte schnee, neon grün, grau marmor, nuss anthrazit, weinrot pink, petrol violet


# Variantenset anlegen

{% hint style="success" %}
Shop-Einstellungen → Varianten: Sets
{% endhint %}

Legen Sie zunächst ein neues Variantenset an.

![](/files/-LIut7Nh3BvRTFQMMI4Q)

#### Füllen Sie die Felder wie folgt aus:

* `Name` des Variantensets: Vergeben Sie hier einen Namen, der die entsprechenden Varianten widerspiegelt, also z.B. *Merino: Farbe, Größe*
* `Felder der Variante, deren Inhalt vom Hauptartikel abweichen darf`: Setzen Sie bei denjenigen Feldern, die variantenspezifisch sein dürfen, ein Häkchen. Die Werte dieser Felder dürfen also von denen des Parent-Artikels (=Hauptartikel) abweichen.

  ![](/files/-LIut7NjkRszCkIL2aCo)
* `Anzeigemanager` für die Variantenauswahl im Shop: bestimmt, wie die Variantenarten und –werte im Shop angezeigt werden. Momentan verfügbar: *Selectboxen*

  ![](/files/-LIut7NlCQbsLJORbbF6)

`SPEICHERN` Sie zunächst, bevor Sie die Variantenarten anlegen.

* `Variantenarten des Variantensets`: Legen Sie hier die verschiedenen Variantenarten des Artikels mit den zur Verfügung stehenden Werten fest. In unserem Beispiel gibt es die 2 Variantenarten *Größe* und *Farbe*.

Klicken Sie auf `Neu` – Sie gelangen nun in eine neue Maske, sh. nächster Abschnitt.

![](/files/-LIut7NncT3L0TcMfvim)


# Variantenarten anlegen

Mit Klick auf `Neu` verlassen Sie das angelegte Variantenset und gelangen zu einer neuen Maske. Die Zugehörigkeit zum Set *Merino: Farbe, Größe* wird in der ersten Zeile angezeigt.

![](/files/-LIut4o3C11IQvUXeNSB)

Füllen Sie zunächst die Pflichtfelder (durch \* gekennzeichnet) aus:

* `Name` der Variantenart: Tragen Sie hier den Namen der Variantenart ein, wie es im Onlineshop auf der Produktdetailseite angezeigt werden soll (*Größe*)
* `Kennzeichner` der Variantenart: Dieser Wert wird vom System benötigt. Tragen Sie hier den englischen Name der Variantenart ein, dieser Begriff muss eindeutig sein.&#x20;

  Hinweis: Die Begriffe *size* und *color* werden vom System auch für den Filter verwendet. Soll nach Größen und Farben gefiltert werden, verwenden Sie für den Kennzeichener der Variantenart diese Begriffe.&#x20;

`SPEICHERN`

* `Verfügbare Variantenwerte:` Erstellen Sie hier die Werte der Variante, in diesem Beispiel alle Größen und Farben, in denen die Mütze verkäuflich sein soll, sh. nächster Abschnitt.


# Variantenwerte anlegen

Mit Klick auf `Neu` verlassen Sie jetzt die angelegte Variantenart und gelangen zu einer neuen Maske. Die Zugehörigkeit zur Variantenart *Farbe* wird in der ersten Zeile angezeigt.

* `Name` des Variantenwerts: Tragen Sie den Wert der Variante ein, z.B. bei Farben den Wert *petrol violet*

Die weiteren Felder in dieser Maske wie z.B. `Preisauf-/abschlag` füllen Sie nach Bedarf aus.

![](/files/-LIut7x-ujByPudCR0A7)

\
&#x20;Wenn Sie einen Variantenwert gespeichert haben, können Sie gleich mit Klick auf `Neu` den nächsten Wert anlegen, Sie müssen nicht zurück in die Maske *Variantenart* gehen.

![](/files/-LIut7x1gvIl8l95el-4)

\
&#x20;Die Variantenwerte können mit einem Namen, einem Bild, und einem Farbwert versehen werden.

Legen Sie so alle benötigten Variantenarten mit den dazugehörigen Variantenwerten an. Angelegte Variantenarten mit den dazugehörigen Werten werden automatisch unter `Artikel → Shop-Artikelvarianten` abgelegt.

Beachten Sie, dass die bei den Variantenarten hinterlegten Werte je Variantenset unabhängig voneinander sind, da die Werte einer Variantenart oder eines Sets im System eindeutig zuordenbar sein müssen. Wenn Sie z.B. 10 Farben bereits für eine Variantenart verwendet haben, müssen Sie diese Farben für ein weiteres Variantenset neu anlegen (dabei dürfen Sie natürlich die gleichen Farben verwenden).


# Varianten generieren

Nachdem Sie das Variantenset erstellt haben, können Sie nun die einzelnen Varianten des Hauptartikels (Parent) mithilfe des Variantengenerators anlegen. Gehen Sie beim Parent-Artikel (`Artikel → Artikel`) zum Tab `Varianten` und wählen Sie dort das entsprechende Variantenset aus dem Dropdown-Menü aus.

Unter `Variantenwerte` erhalten Sie nun eine Matrix mit allen möglichen Kombinationen, die sich aus den Variantenarten und –werten ergeben. Hier können Sie bereits vorauswählen, welche Varianten überhaupt zur Verfügung stehen sollen. (Das ist vor allem dann sinnvoll, wenn Sie ein Variantenset erstellen wollen, welches für möglichst viele Artikel gilt, wie z.B. Basic T-Shirts in 30 verschiedenen Farben und 6 Größen.)

![](/files/-LIut4X5LrGgCJdbEOoo)

Mit Klick auf den Button `Mögliche Varianten` anzeigen werden nun die ausgewählten Werte generiert. Hier können Sie bei Bedarf unterschiedliche Preise angeben.

![](/files/-LIut4X7mKsmTRlRT-PL)

Die erzeugten Varianten werden Ihnen sowohl in der Artikelübersicht (`Artikel → Artikel`) angezeigt als auch direkt beim Parent-Artikel im Tab `Varianten → Artikelvarianten`.

![](/files/-LIut4X9YEqhvWByC8Xf)

Im Frontend wird der Artikel auf der [Produktdetailseite mit den auswählbaren Varianten](https://demo.chameleon-system.de/testmarke-3/gehaekeltes/merino-muetze-muetzen_pid_820_6702.html?_ref=spot3\&url=%2FProdukte%2FGehaekeltes%2FMuetzen%2F) angezeigt:

![](/files/-LIut4XB9sF5WRLW8NZE)

Hinweis: Der Hauptartikel eines Variantensets kann nicht gekauft werden – ein Kunde muss also immer eine Variante wählen. Um Sortierung nach Preisen, Beliebtheit usw. sinnvoll durchführen zu können, werden folgende Felder der Varianten vom System automatisch summiert und beim Hauptartikel hinterlegt: 1. Preis 2. Lagerbestand

Sobald eine Variante aktiviert wird, wird automatisch auch der Parentartikel aktiv geschalten (sofern dieser vorher inaktiv war).


# Produktlisten

Durch die automatischen Artikellisten von Chameleon lassen sich viele Schritte einer erfolgreichen Produktpräsentation automatisieren. Beispielsweise können Sie Artikel mit besserer Conversion-Rate automatisch prominenter platzieren lassen.

Produktlisten können wahlweise vom Anwender manuell angelegt oder mit geeigneten Filterkriterien automatisch erzeugt werden.

![](/files/-LIut4_tToq_VuceMT9g)


# Automatische Artikelliste anlegen (Modul Produktliste)

Legen Sie auf der Seite, auf der die automatische Artikelliste erscheinen soll, das Modul `Produkt-Liste` an.

`Basisdaten`

| Bezeichnung                        | Beschreibung                                                                                                                                                                                                                   |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Titel / Überschrift**            | Der Titel wird über der Liste angezeigt.                                                                                                                                                                                       |
| **Icon**                           | Das Icon wird über dem Titel angezeigt.                                                                                                                                                                                        |
| **Filter / Inhalt**                | Hier wird der Filter für die anzuzeigende Liste ausgewählt. Sie haben die Möglichkeit, aus vielen vorkonfigurierten Filtern auszuwählen. Bei manueller Selektion werden die Artikel im 2. Tab „Alternativselektion…“ bestimmt. |
| **Sortierung**                     | Hier wird die Sortierung bestimmt, anhand derer die Artikel beim Aufruf der Seite angezeigt werden.                                                                                                                            |
| **Verfügbare Sortierungen**        | Hier kann ausgewählt werden, welche Sortierungen bei der Anzeige überhaupt zur Verfügung stehen sollen.                                                                                                                        |
| **Beschränkung der Artikelanzahl** | Über dieses Feld kann festgelegt werden, wie viele Artikel insgesamt angezeigt werden dürfen. Um alle Artikel anzuzeigen muss hier -1 hinterlegt werden.                                                                       |
| **Anzahl der Artikel pro Seite**   | Über dieses Feld lässt sich die Seitengröße bestimmen. Um alle Artikel auf einer Seite darzustellen, kann hier einfach -1 hinterlegt werden.                                                                                   |
| **Einleitungstext**                | Der optionale Einleitungstext wird gewöhnlich am Anfang der Liste, direkt nach der Überschrift angezeigt.                                                                                                                      |
| **Abschlusstext**                  | Der optionale Abschlusstext wird gewöhnlich am Ende der Liste angezeigt.                                                                                                                                                       |

![](/files/-LIut4Xoqzgx85CMrSIT)

Möchten Sie manuell ausgewählte Produkte anzeigen lassen, wählen Sie bei `Filter/Inhalt` `Manuelle Selektion`. Im Tab `Über die Alternativselektion kann definiert werden, wie sich die Liste verhalten soll, wenn der gewählte Filter keine Ergebnisse bringt` können Sie entweder Artikel aus bestimmten Warengruppen oder Produktkategorien anzeigen lassen oder auch einzeln selektierte Artikel. Diese Auswahl können Sie auch treffen, wenn Sie z.B. eine Filter gewählt haben, der keine Ergebnisse bringt wie „Zuletzt angeschaut“.

Im Tab `Filter` kann bestimmt werden, ob die Artikelliste durch einen Shop-Listenfilter weiter eingeschränkt werden soll (anzulegen in einem 2. Steckplatz auf der Seite). Es kann immer nur eine Liste auf der Seite für diesen Filter freigegeben werden.


# Artikellisten mit dem Multimodul anlegen

![](/files/-LIut4JtX8XTOkZ_FNCj)

Mit dem Multimodul können in einem Steckplatz mehrere Module platziert und somit Modul-Kollektionen vorkonfiguriert werden, die auf beliebigen Seiten einsetzbar sind. So können z.B. mehrere Artikellisten an einer Stelle auf der Seite platziert werden, die durch umschaltbare Tabs erreichbar sind.

In den `Multimodul-Sets` sind bereits angelegte Listen verfügbar (Cross-Selling auf der Produktdetailseite und auf Kategorieseiten sowie auf der Startseite). Hier können auch neue Sets angelegt oder bestehenden Sets weitere Tabs hinzugefügt werden.

Möchten Sie z.B. auf der Produktdetailseite weitere Listen wie „Dazu passt“ oder „Zubehör“ anzeigen lassen, dann fügen Sie im Multimodul-Set „Cross-Selling Produktdetailseite“ ein `Set bestehend aus folgenden Modulen` hinzu. Wählen Sie über `Modul anlegen / bearbeiten` das Modul `Produktliste (standard)` aus. Die Filtereinstellungen können Sie nun über `Editieren` bearbeiten.

![](/files/-LIut4JvI1cd1BWnMSJ_)

{% hint style="info" %}
Die Artikel, die in den Cross-Selling-Listen Zubehör und Ähnliche Artikel („Dazu passt“) erscheinen sollen, werden beim Artikel selbst im Tab Cross Selling hinterlegt.
{% endhint %}

Die Reihenfolge der umschaltbaren Tabs wird über den Button `Sortierung` im Multimodul-Set gesteuert.

![](/files/-LIut4JxRZfUooQUOIdQ)


# Presenter mit verlinkbaren Hotspots (Modul)

Mit individuellen Banner-Präsentationen haben Sie die Möglichkeit, besondere Artikel auf besondere Art und Weise zu präsentieren. Im Chameleon Shop ist dieses Modul in der Regel auf der Startseite eingefügt, aber natürlich kann es an jeder anderen Stelle platziert werden.

Der Presenter kann eine beliebige Anzahl an Bildern enthalten, die nach einer festgelegten Zeitspanne wechseln sowie über die Blätterfunktion ansteuerbar sind.

In jedem Bild können beliebig viele Hotspots positioniert und mit einem Artikel, einer Artikelkategorie oder einer Seite verknüpft werden.

Die Hotspots sind mit kleinen Symbolen (z.B. einem Pluszeichen) auf dem Bild markiert. Bei Mouseover über einen Hotspot erscheinen Informationen zum Artikel (Artikelname und Preis), zur Kategorie oder zur verlinkten Seite. Mit Klick auf den Hotspot gelangt man zur jeweiligen Seite.

![](/files/-LIut4oi-_j6ygmTvExX)

Weiterhin lassen sich verlinkte Polygonflächen auf dem Bild einfügen (es ist dann kein Hotspot-Symbol sichtbar), die auf Mouseover reagieren. Bei Klick auf die verlinkte Fläche (wird durch Koordinaten eingegeben) gelangt man wie beim Hotspot zum Artikel, zur Kategorie oder auf eine Seite. Zusätzlich lässt sich noch einstellen, ob beim Mouseover über die Polygonfläche ein Info-Layover eingeblendet werden soll.


# Kundeninformation

Informationen Kunden betreffend finden sich im Hauptmenü unter

{% hint style="success" %}
Shopkunden / Benutzer
{% endhint %}


# Kunden

{% hint style="success" %}
Shopkunden / Benutzer → Kunden
{% endhint %}

Unter Kunden werden alle im Shop registrierten Kunden aufgelistet. In der Kundenmaske können alle Kundendaten und Aktionen wie z.B. Rechnungs-/Lieferadressen, gekaufte Gutscheine, Produkte auf dem Merkzettel, Rezensionen usw. eingesehen bzw. auch abgeändert werden.


# Kundengruppen

{% hint style="success" %}
Shopkunden / Benutzer → Kundengruppen
{% endhint %}

Kundengruppen können in CHAMELEON frei definiert werden und finden ihre Anwendung in den verschiedensten Bereichen des CMS/Shops. Im Backend können Gruppen z.B. zur Zugangsbeschränkung oder bei der User-Auswahl im Newsletter-Modul verwendet werden. Im Shop dagegen können Kunden nach Ihrem Bestellverhalten automatisch den Kundengruppen zugewiesen werden. Des Weiteren können im Shop die Zahlmethoden, Versandkosten usw. unter Verwendung der Kundengruppen genauestens konfiguriert werden.

| Bezeichnung                       | Beschreibung                                                                                                                                                                                                                                           |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**                          | Bezeichnung der Kundengruppe                                                                                                                                                                                                                           |
| **Autozuweisung aktiv**           | Gibt an, ob die Kundengruppe anhand der Einstellungen automatisch zugewiesen bzw. die Zuweisung automatisch wieder aufgehoben werden soll.                                                                                                             |
| **Autozuweisung ab Bestellwert**  | Kundengruppe wird dem Benutzer automatisch zugewiesen, wenn die Bestellung des Kunden einen definierten Wert überschreitet                                                                                                                             |
| **Autozuweisung bis Bestellwert** | Erreicht der Kunde diesen Bestellwert, dann wird er automatisch aus der Gruppe genommen (die Gruppe greift also nur für Kunden mit Bestellungen UNTER diesem Betrag). Wird hier 0 angegeben, dann gilt die Gruppe bis zu einem beliebigen Bestellwert. |

Kunden können nicht nur automatisch einer Kundengruppe zugewiesen werden, sondern auch direkt im Kundendatensatz:

{% hint style="success" %}
Kunde → Basisdaten → Kundengruppen → Haken bei entsprechender Kundengruppe setzen
{% endhint %}

## Zugriffsbeschränkung

Außerdem kann der Zugriff auf eine Seite auf bestimmte Kundengruppen eingeschränkt werden. Hierfür in den Seiten-Einstellungen `Zugriff einschränken` aktivieren, dann können nur angemeldete Benutzer die Seite sehen. Dies kann zusätzlich auf einzelne Kundengruppen eingeschränkt werden, indem man beim Feld *Auf folgende Extranet-Gruppen einschränken* einen Haken bei der gewünschten Kundengruppe setzt.

![](https://github.com/esono-ag/chameleon-documentation-de/tree/5b0a385112ca4bca11418aab4404f78598f48ec6/assets/2017-01-17%2015_21_39-Fotos.png)

sh. auch [Zugriff auf eine Seite einschränken](/inhalte/seitenverwaltung/zugriff-auf-eine-seite-einschranken)


# Kundenrezensionen

{% hint style="success" %}
Shopkunden / Benutzer → Kundenrezensionen der Produkte
{% endhint %}

Kunden können für Produkte eigene Rezensionen erstellen. Über das entsprechende Modul auf der Produktdetailseite (`Artikelkommentare`) können im Backend die Bewertungen konfiguriert werden:

* Rezensionen nur für angemeldete Benutzer
* Automatische Veröffentlichung (`Rezensionen Verwalten`)
* Bewerten/Melden/Kommentieren von Rezensionen
* Anzahl der Bewertungspunkte und der angezeigten Rezensionen pro Artikel
* Name des Autors

| Bezeichnung                                           | Beschreibung                                                                                                                                                                                                                                              |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Gehört zum Artikel**                                | Artikelbezeichnung des bewerteten Artikels                                                                                                                                                                                                                |
| **Geschrieben von**                                   | Falls die Rezension durch einen registrierten Kunden erfolgte, befindet sich hier ein Verweis auf den registrierten Kunden. Bei nicht registrierten Kunden ist dieses Feld nicht gefüllt.                                                                 |
| **Veröffentlicht**                                    | Markiert eine Rezension als veröffentlicht. Auf der Webseite werden nur veröffentlichte Rezensionen angezeigt.                                                                                                                                            |
| **Autor**                                             | Name bzw. Alias des Kunden, der die Rezension geschrieben hat.                                                                                                                                                                                            |
| **Kommentartitel**                                    | Titel/Überschrift der Rezension.                                                                                                                                                                                                                          |
| **Email-Adresse des Autors**                          | E-Mail-Adresse des Autors, der die Rezension verfasst hat.                                                                                                                                                                                                |
| **Autorbenachrichtigung bei Kommentierung erwünscht** | Ist diese Option aktiviert, möchte der Autor eine Benachrichtigung erhalten, wenn seine Rezension kommentiert wird. Damit dies erfolgen kann, muss die Rezension eine gültige „E-Mail Adresse des Autors“ enthalten oder mit einem Kunden verbunden sein. |
| **Bewertung**                                         | Bewertung des Produktes ( ein Wert von 0 - 5 )                                                                                                                                                                                                            |
| **Rezension hilfreich**                               | Positive Bewertungen dieser Rezension durch andere Kunden.                                                                                                                                                                                                |
| **Rezension nicht hilfreich**                         | Negative Bewertungen dieser Rezension durch andere Kunden.                                                                                                                                                                                                |
| **Rezension**                                         | Die Rezension des Kunden für diesen Artikel                                                                                                                                                                                                               |
| **Erstellt am**                                       | Erstellungsdatum der Rezension                                                                                                                                                                                                                            |

Rezensionen sind direkt mit dem Kunden (Rezensionen) als auch dem Produkt (`Bewertungen → Kundenrezensionen`) verknüpft.


# Artikelempfehlung von Kunden

{% hint style="success" %}
Shopkunden / Benutzer → Artikelempfehlungen von Kunden
{% endhint %}

Hier werden alle Produktempfehlungen gespeichert, die über den Shop versendet wurden. Ob die Daten mitgeschrieben werden, können Sie über die `Shopeinstellungen → Shops Konfiguration` festlegen.


# Bestellinformation


# Bestellungen

{% hint style="success" %}
Bestellungen → Bestellungen
{% endhint %}

Dies ist die zentrale Stelle für alle im System durchgeführten Bestellungen. In der Bestellung selbst sind alle die mit ihr zusammenhängenden Parameter hinterlegt:

* `Basisdaten`, wie z.B. Bestellnummer, Artikel, Kundennummer, Kunden-Email etc.
* Die bei dieser Bestellung hinterlegte `Rechnungs- und Lieferadresse`
* `Zahl- und Lieferart`, wie z.B. Versandkostengruppe, Bezahlmethode, Artikel- und Gesamtwert, Währung, Verpackungskosten, angewendete Gutscheine und Rabatte, wurde die Bestellung bezahlt, wurde die Bestellung storniert, Affiliate-Code (falls der Kunde über einen Affiliate-Partner kommt, Bestellstatus usw.
* Wurde der `Newsletter` abonniert?
* `IPN` und `Finanztransaktionen:` Wurde eine Bezahlmethode verwendet, die über einen externen Zahlungsanbieter wie z.B. PAYONE läuft, wird von diesem Anbieter Rückmeldung an den CHAMELEON Shop über stattgefundene Finanztransaktionen gegeben. Dies geschieht durch die Instant Payment Notification (IPN) und Finanztransaktionen (wie Zahlung, Gutschrift, Rücklastschrift). Diese Informationen finden sich einerseits gesammelt in den Bestellprozess-Einstellungen wie auch direkt bei der Bestellung.&#x20;
* `Shop-Bewertungen`: Wie hat der Kunde Ihren Shop bewertet, welcher Bewertungsservice wurde dafür verwendet, wurde vom Shop eine Bewertungsaufforderung versendet etc.


# Bestellprozess-Einstellungen

Damit im Shop überhaupt bestellt werden kann, müssen zahlreiche Einstellungen vorgenommen werden.


# Bestellschritte (Checkout)

{% hint style="success" %}
Bestellprozess-Einstellungen → Bestellschritte
{% endhint %}

Während der Bestellung durchläuft der Käufer alle zur Bestellung nötigen Schritte. In den Bestellschritten werden alle für einen erfolgreichen Abschluss der Bestellung benötigten Daten zusammengestellt.

Die Bestellschritte können Sie je nach Anforderung Ihres Shops selbst definieren. Beispiel eines Bestellprozesses (auch Checkout genannt):

#### Darstellung im Frontend:

![](/files/-LIut4PJqBku-7loqRoG)

#### Einstellung im Backend:

![](/files/-LIut4PLOSb2DLNIm_t_)

Für die einzelnen Schritte können Sie einen Namen und eine Beschreibung und festlegen, ob die Schritte in der Navigationsleiste auf der Seite angezeigt werden sollen (sh. Abbildung oben Frontend). Sie können auch eine bestimmte Vorlage für die Ansicht im Frontend hinterlegen.

| Bezeichnung          | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Warenkorb**        | Erster Schritt, in welchem der Kunde die Möglichkeit hat, den zusammengestellten Warenkorb zu prüfen und zu ergänzen.                                                                                                                                                                                                                                                                                               |
| **1. Anmeldung**     | In diesem Schritt hat der Kunde die Möglichkeit, sich als Neukunde zu registrieren oder sich im Shop anzumelden (falls bereits registriert) oder auch als Gast zu bestellen (optional).                                                                                                                                                                                                                             |
| **2. Adressauswahl** | In diesem Schritt kann der Kunde eine von der Rechnungsanschrift abweichende Lieferanschrift oder auch eine neue Rechnungsadresse angeben. Weiterhin ist hier die Auswahl eine Packstation möglich.                                                                                                                                                                                                                 |
| **3. Zahlungsart**   | Auswahl der Zahlungs- und Versandart                                                                                                                                                                                                                                                                                                                                                                                |
| **4. Prüfung**       | In diesem Schritt hat der Kunde die Möglichkeit, alle von ihm eingegebenen Daten noch einmal zu prüfen und muss diese durch die Annahme der Allgemeinen Geschäftsbedingungen und der Datenschutzerklärung zu bestätigen. Nach dem Klick auf „Jetzt kaufen“ ist die Bestellung verbindlich und wird im System erstellt. Optional hat der Kunde in diesem Schritt auch die Möglichkeit, den Newsletter zu abonnieren. |
| **Bestätigung**      | Im Bestätigungsschritt bekommt der Kunde (je nach Shop-Design) weitere Informationen zu der Bestellung und hat die Möglichkeit, diese auszudrucken.                                                                                                                                                                                                                                                                 |


# Versandkostenart

{% hint style="success" %}
Bestellprozess-Einstellungen → Versandkostenart
{% endhint %}

Bei jeder Versandkostenart kann festgelegt werden, für welche Warengruppe, Kategorie, Artikel, Benutzergruppe, Benutzer oder Lieferland die Versandkostenart wirksam sein soll.

Eine Versandkostenart kann auf die Anzahl Artikel, eine Gewicht- oder Größenspanne oder einen Warenwert eingeschränkt sein. Sollte bei der Versandkostenart festgelegt worden sein, dass diese nur auf bestimmte Artikel wirken soll (entweder über die Angabe der Kategorien oder Warengruppen oder durch die Angabe eines oder mehrerer Artikel), dann kann zusätzlich festgelegt werden, ob sich die Angaben von Menge, Gewicht, Größe oder Preis nur auf die Summe aller Artikel beziehen soll, auf die Summe der für diese Versandkostenart relevanten Artikel oder einzeln auf jeden für diese Versandkostenart relevanten Artikel.

Da manche Artikel immer versandkostenfrei behandelt werden müssen (wie z.B. ein Hörbuchdownload), besteht außerdem die Möglichkeit, einen Artikel von der Berechnung auszuschließen. Hierfür muss bei dem Artikel ein entsprechendes Häkchen gesetzt werden.

Sollte die Versandkostenart nicht nur bei dem Kauf bestimmter Artikel gelten, kann festgelegt werden, ob die Berechnung je Artikel im Warenkorb gilt oder für die Summe der Artikel im Warenkorb.

Um die Versandkostenberechnung auch bei nicht angemeldeten Benutzern (bei welchen das Lieferland nicht bekannt ist) zuzulassen, kann zusätzlich zu der Länderdefinition festgelegt werden, ob die Versandkostenart auch bei nicht angemeldeten Benutzern aktiv sein soll. In diesem Fall werden die Länder-, Benutzer- und Benutzergruppen-Einstellungen für diese Versandkostenart bei nicht angemeldeten Benutzern ignoriert.

Generell gilt, dass kein Artikel bei der Versandkostenberechnung mehr als einmal verwendet wird. Um eine Mehrfachberechnung zu verhindern, arbeitet der Shop die Versandkostenarten nacheinander ab (sortiert wird nach Wert „teuerste Versandkostenart zuerst“ - diese Sortierung lässt sich aber beeinflussen).

Alle Artikel, die bei der Berechnung einer Versandkostenart einbezogen wurden, werden bei der nächsten nicht mehr berücksichtigt. Sollte also z.B. die teuerste Versandkostenart auf den gesamten Warenkorb wirken (weil z.B. keine Artikeleinschränkungen bei dieser Versandkostenart hinterlegt wurden), dann werden alle weiteren Versandkostenarten ignoriert. Es ist möglich, dieses Verhalten für einzelne Versandkostenarten zu deaktivieren.

Versandkostenarten können über eine Checkbox aktiviert/deaktiviert werden. Es besteht ebenfalls die Möglichkeit, eine Versandkostenart „zeitgesteuert“ nur für eine bestimmte Zeitspanne zu aktiveren. Für jede Versandkostenart kann festgelegt werden, ob es sich bei den Versandkosten um einen absoluten oder um einen prozentualen Wert handelt. Handelt es sich um eine prozentuale Angabe, bezieht sich diese immer auf die von der Versandkostenart betroffenen Artikel (also nur dann auf den ganzen Warenkorb, wenn sich die Versandkostenart auf den ganzen Warenkorb bezog).


# Versandkostengruppen

{% hint style="success" %}
Bestellprozess-Einstellungen → Versandkostenart
{% endhint %}

Da die Versandkostenarten und die angebotenen Bezahlarten (z.B. bei Nachname) vom Logistik-Unternehmen abhängig sein können, werden Versandarten und Bezahlmethoden in so genannte Versandkostengruppen unterteilt. Versandkostengruppen können auf bestimmte Benutzer oder Benutzergruppen eingeschränkt, über eine Checkbox aktiviert oder deaktiviert und über eine Zeitsteuerung für einen bestimmten Zeitraum (oder ab bzw. bis zu einem bestimmten Zeitpunkt) automatisch vom System freigeschaltet werden.

Ist für einen Benutzer nur eine Versandkostengruppe verfügbar, wird diese vom System automatisch ausgewählt; stehen mehr als eine zur Auswahl, muss der Benutzer bei den Versandangaben entscheiden, welche Versandkostengruppe er verwenden möchte. Nur die der aktuell ausgewählten Versandkostengruppe zugewiesenen Versandkostenarten werden für die Berechnung der Versandkosten für den aktuellen Warenkorb verwendet. Ist eine Versandkostenberechnung auch für nicht angemeldete Benutzer gewünscht, muss eine der Versandkostengruppe, in der eine für nicht angemeldete Benutzer verwendbare Versandkostenart definiert wurde, als Standardversandkostengruppe markiert werden. Da für unterschiedliche Versandkostengruppen unter Umständen unterschiedliche Lieferangaben benötigt werden (z.B. Auswahl des Buchhändlers bei Abholung, Angabe einer Lieferadresse bei allen anderen), muss bei jeder Versandkostengruppe noch die Informationsart ausgewählt werden. Standardmäßig ist nur die Option „Lieferadresse“ verfügbar. Für entsprechende Shops wird die Auswahl um die Option „Auswahl Buchhändler“ hinzugefügt.


# Zahlmethoden

{% hint style="success" %}
Bestellprozess-Einstellungen → Zahlungsanbieter
{% endhint %}

Im Shop können beliebige Bezahlmethoden hinterlegt werden. Über eine Checkbox können einzelne Bezahlmethoden jederzeit aktiviert/deaktiviert werden. Die Bezahlmethoden können generell auf ein oder mehrere Lieferländer eingeschränkt werden sowie auf Benutzergruppen oder einzelne Benutzer. Für jede Bezahlmethode muss zusätzlich ein vom System vorgegebenes Zahlungsmodul gewählt werden. Das Zahlungsmodul sorgt dafür, dass notwendige Zahlungsdaten vom Kunden entgegengenommen, geprüft und die Zahlung korrekt ausgeführt wird.


# Rabatte und Gutscheine

Mit Chameleon können beliebig viele Gutschein- und Rabattaktionen gleichzeitig und automatisiert durchgeführt werden.


# Gutscheine erstellen

{% hint style="success" %}
Rabatte & Gutscheine → Gutscheinserien
{% endhint %}

Gutscheine können entweder einen absoluten oder einen prozentualen Wert zur Nachlassgewährung haben. Prozentuale Nachlässe beziehen sich immer auf den Gesamtwert des Warenkorbes (Bruttosumme der Produkte).

Es wird zwischen Aktionsgutscheinen und gesponserten Gutscheinen (= Kaufgutschein, d.h. jemand hat für den Gutschein gezahlt) unterschieden. Bei Aktionsgutscheinen wird der Gutscheinwert von der Bruttosumme des Warenwertes abgezogen, dementsprechend reduziert sich die berechnete Mehrwertsteuer.

![](/files/-LIutANp-sAdvK9QmUqg)

Gesponserte Gutscheine hingegen werden wie ein Zahlungsmittel verwendet, werden also nach der Steuer abgezogen und wirken sich daher **nicht** auf die berechnete MwSt. aus. Diese Option sollte also für Gutscheine verwendet werden, für die ein Kunde oder Partner tatsächlich bezahlt hat (wie z.B. ein Kaufgutschein, sh. auch [Gutscheinsponsoren](/shop/rabatte_und_gutscheine/gutscheinsponsoren)).

Geldwert-Gutscheine (gesponsert) erscheinen im Warenkorb unterhalb der Produktbruttosumme mit Namen und Wert.

![](/files/-LIutANr4fQirzRze9eb)

Der Gutscheinwert selbst wird immer aus der Gutscheinserie genommen (verändert man diesen Wert, verändert sich auch automatisch der Gutscheinwert).

Artikel können von der Verwendung von Aktionsgutscheinen ausgeschlossen werden: `Artikel → Preis/Versand → keine Gutscheine zulassen`. Gesponserte Gutscheinen hingegen können auch für Artikel verwendet werden, bei denen sonst keine Gutscheine zugelassen sind.

Zusätzlich kann bei einem Gutschein ein Gratisartikel hinterlegt werden (wenn das entsprechende Modul installiert ist). Wird ein solcher Gutschein mit Gratisartikel eingelöst, legt das System den Artikel mit einem Wert von 0,- € in den Warenkorb. Es erscheint der Hinweis, über welchen Gutschein der Artikel in den Warenkorb gelegt wurde.

Folgende weitere Einstellungen und Einschränkungen sind möglich:

* Über ein Start- und Enddatum kann ein Gutschein auf eine Zeitspanne eingeschränkt werden.
* Es kann ein Mindestbestellwert definiert werden, der überschritten werden muss, bevor der Gutschein akzeptiert wird.
* Ob der Gutschein mit einem anderen Gutschein der gleichen Gutscheinserie verwendet werden kann.
* Ob der Gutschein mit anderen Gutscheinen (egal von welcher Gutscheinserie) verwendet werden kann.
* Ob ein Kunde Gutscheine dieser Gutscheinserie generell nur einmal verwenden darf (also auch nicht bei zwei getrennten Bestellungen).
* Ob der Gutschein nur bei der ersten Bestellung des Benutzers verwendet werden kann.
* Ob der Gutschein die Versandkosten aufheben soll.
* Es ist möglich, den Gutschein als einen „gesponserten“ Gutschein zu markieren. Zusätzlich können der Name des Sponsors, ein Bild und ein Logo hinterlegt werden. „Gesponserte“ Gutscheine ignorieren die Einstellung „keine Gutscheine zulassen“ der Warenkorbartikel im Warenkorb.
* Gutscheine können eingeschränkt werden auf bestimmte Kunden, Kundengruppen, einzelne Produkte, Hersteller, Artikelgruppen, Produktekategorien

### Gutscheine anlegen

Gutscheine werden generell in Gutscheinserien angelegt. Alle Einstellungen (sh. oben) beziehen sich auf die Gutscheinserie und damit auf alle Gutscheine in dieser Serie. Für eine Gutscheinserie können automatisch Gutscheine generiert werden. Hier kann entweder ein fester Gutscheincode angegeben werden oder ein vom System automatisch generierter Code verwendet werden.

Gutscheine zur Serie werden über den Button `Gutscheine erstellen` generiert. ![](/files/-LIutANuH-N4771C8XnA)

Bei der Generierung muss die Anzahl der Gutscheine, die erstellt werden soll sowie der Gutschein-Code angegeben werden. Soll jeder Gutschein dieser Serie den gleichen Code besitzen, wie z.B. "Frühlingsaktion", dann geben Sie dies in den Pop-Up-Dialog ein.

![](/files/-LIutANwwarUp96SpH3t)

![](/files/-LIutANyLMXAKXzU8Flv)

Wird kein Gutschein-Code angegeben, wird für jeden Gutschein vom System ein eineindeutiger Code generiert. Bei jeder Verwendung eines Gutscheins wird das Datum, der Benutzer sowie der Verbrauchswert beim Gutschein in der Gutscheinverwendungsliste hinterlegt. Sobald der Gutschein komplett verbraucht ist, wird das Verbrauchsdatum hinterlegt und der Gutschein als verbraucht markiert.

![](/files/-LIutAO-a_n9HjPn11tA)

Innerhalb einer Gutscheinserie darf ein Gutscheincode mehr als einmal vorkommen, ein Gutscheincode darf aber nie in mehr als einer Gutscheinserie verwendet werden. Bei jedem Gutschein wird ein Erstellungsdatum hinterlegt.

### Gutscheine exportieren

Die Gutscheine einer Gutscheinserie können als CSV-Datei exportiert werden. ![](/files/-LIutAO1EiA224XrARxo)

Für jeden Gutschein werden folgende Daten exportiert:

* Code: Identifikationscode des Gutscheins
* Datum: Erstellungsdatum
* Verbraucht (Ja / Nein)
* Verbrauchsdatum: wird hinterlegt, sobald ein Gutschein komplett verbraucht wurde
* Restwert: möglicher unverbrauchter Restwert des Gutscheines


# Gutscheinsponsoren

{% hint style="success" %}
Rabatte & Gutscheine → Gutscheinsponsoren
{% endhint %}

Gutscheine können einen Gutscheinsponsor haben, der für den Gutschein gezahlt hat. Gutscheinsponsoren können zusätzlich zur Gutscheininformation auf der Webseite mit Name und Bild angezeigt werden.

Gesponserte Gutscheine werden wie ein Zahlungsmittel verwendet und **wirken sich daher nicht auf die berechnete Mehrwertsteuer aus**. Diese Option sollte also für Gutscheine verwendet werden, für die ein Kunde oder Partner tatsächlich bezahlt hat (wie z.B. bei einem Kaufgutschein).

[Beispiel gesponserter Gutschein im CHAMELEON Demoshop](https://demo.chameleon-system.de/testmarke-4/beispielprodukte/artikel-mit-kaufgutschein_pid_839_6993.html)

![](/files/-LIutAJHekftoX2LaNa9)


# Rabatte

{% hint style="success" %}
Rabatte & Gutscheine → Rabatte
{% endhint %}

Im System können Rabatte definiert werden, die sich auf den Warenkorb oder auf Teile des Warenkorbs auswirken.

Rabatte können über eine Checkbox aktiviert und deaktiviert oder automatisch über das System für einen bestimmten Zeitraum aktiviert werden. Bei einem Rabatt kann festgelegt werden, ab welcher Einkaufsmenge oder ab welchem Einkaufswert dieser aktiviert werden soll.

Generell können Rabatte als [absoluter Wert](https://demo.chameleon-system.de/testmarke-4/beispielprodukte/artikel-mit-rabatt-absolut_pid_839_6992.html?_ref=spot2\&url=%2FTestbereich%2FBeispielprodukte%2F) oder als [prozentualer Wert](https://demo.chameleon-system.de/testmarke-4/beispielprodukte/artikel-mit-rabatt-prozentual_pid_839_6995.html?_ref=spot2\&url=%2FTestbereich%2FBeispielprodukte%2F) angegeben werden. Die prozentuale Angabe bezieht sich auf die für den Rabatt relevanten Artikel. Hier muss also nicht unbedingt der ganze Warenkorb betroffen sein.

Zusätzlich zu der prozentualen oder absoluten Angabe kann ein Gratisartikel bei einem Rabatt hinterlegt werden. Wird ein Rabatt mit einem Gratisartikel angewendet, so wird der Gratisartikel automatisch mit einem 0,- € Wert in den Warenkorb gelegt.

Wird ein Rabatt auf den aktiven Warenkorb oder einen Teil des Warenkorbs mit einem positiven berechneten Wert größer 0 angewendet, so wird der Rabatt unterhalb der Bruttoproduktsumme mit Namen und Wert aufgeführt.

### Einschränkungen

Es kann festgelegt werden, ob der Rabatt generell für alle Artikel oder nur für bestimmte Artikel oder Produktkategorien gelten soll.

Gilt der Rabatt nur für bestimmte Artikel oder Kategorien, beziehen sich die Einkaufsmengen- und Wertangaben immer auf die Summe der Artikel im Warenkorb, die für diesen Rabatt gelten.

Rabatte können außerdem auf bestimmte Benutzergruppen oder Benutzer sowie bestimmte Länder eingeschränkt werden. Hier ist zu beachten, dass so eingeschränkte Rabatte erst zur Anwendung kommen, nachdem sich der Benutzer angemeldet bzw. sein Lieferland gewählt hat.

Bei den Einschränkungen kann weiterhin hinterlegt werden, wie bzw. ob sich der Rabatt auswirken soll, wenn die Einschränkungsliste wider Erwarten leer sein sollte.

Wenn der Rabatt eingeschränkt wird, z.B. auf ein bestimmtes Produkt, dieses Produkt jedoch z.B. durch einen späteren Produktimport gelöscht wird, wird das Produkt aus der Liste automatisch entfernt. Das hat zur Folge, dass es keine Einschränkung mehr gibt und der Rabatt somit für alle Produkte im Shop gilt. Ist dies nicht gewünscht, muss das Häkchen bei `Bei leerer Liste Datensatz sperren` gesetzt werden. Dadurch bleibt die Rabatteinschränkung bestehen, selbst wenn das betreffende Produkt nicht mehr existiert; somit gilt der Rabatt zu diesem Zeitpunkt für kein Produkt.

| Bezeichnung                                                             | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                                                                | Bezeichnung des Rabattes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Wert**                                                                | Der Wert des Rabattes, der als Absolut- oder Prozentangabe konfiguriert werden kann. Handelt es sich um eine Prozentangabe (siehe Wertart), so bezieht sich die Angabe auf die Summe aller betroffenen Artikel. Absolutwerte werden nicht auf den gesamten Warenkorb verteilt, sondern absteigend auf die Artikel im Warenkorb. Bei einem Rabatt von 10,- € und zwei Artikeln im Warenkorb würde das System versuchen, die 10,- € zuerst auf den ersten Artikel anzuwenden. Sollte es danach einen Restwert geben, wird dieser auf den zweiten Artikel angewendet. |
| **Wertart**                                                             | Definiert,  ob es sich bei der Wertangabe um einen Absolutbetrag handelt oder um eine Prozentangabe                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Prozentuale Rabatte auf der Produktdetailseite anzeigen**             | Prozentuale Rabatte, die nicht auf Warenkorb-Werte (ab X € usw. ...) eingeschränkt sind, können bereits auf der Produktdetailseite berechnet werden und dort als reduzierter Preis angezeigt werden (Anzeige wie bei Verwendung von Vergleichspreisen). Somit können bestimmten Kundengruppen für bestimmte Waren im Shop andere Preise (Rabatte) angezeigt werden, sobald sie eingeloggt sind. WICHTIG: Funktioniert nur, wenn der Rabatt prozentual berechnet wird.                                                                                              |
| **Gratisartikel\***                                                     | Ein optionaler Gratisartikel, der bei diesem Rabatt automatisch in den Warenkorb gelegt wird.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Aktiv**                                                               | Aktivierung / Deaktivierung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Gültig ab**                                                           | Ab welchem Zeitpunkt der Rabatt zugelassen ist                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Gültig bis**                                                          | Bis zu welchem Zeitpunkt der Rabatt zugelassen ist.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Sortierung**                                                          | Die Rabatte werden in der hier definierten Reihenfolge auf den Warenkorb angewendet.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Mindestanzahl betroffener Artikel**                                   | Ab welcher Anzahl betroffener Artikel der Rabatt greifen soll.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Maximalanzahl betroffener Artikel**                                   | Bis zu welcher Anzahl betroffener Artikel der Rabatt greifen soll.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Mindestwert der betroffenen Artikel (Euro)**                          | Ab welchem Warenwert der betroffenen Artikel der Rabatt greifen soll. Hinweis: Als Basis für den Warenwert wird die Produktsumme ohne die Anwendung anderer Rabatte verwendet.                                                                                                                                                                                                                                                                                                                                                                                     |
| **Maximalwert der betroffenen Artikel (Euro)**                          | Bis zu welchem Warenwert der betroffenen Artikel der Rabatt greifen soll Hinweis: Als Basis für den Warenwert wird die Produktsumme ohne die Anwendung anderer Rabatte verwendet.                                                                                                                                                                                                                                                                                                                                                                                  |
| **Auf folgende Produktkategorien einschränken**                         | Filter                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Auf folgende Artikel einschränken**                                   | Filter                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Auf folgende Kundengruppen einschränken**                             | Filter                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Auf folgende Kunden einschränken**                                    | Filter                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Auf folgende Lieferländer einschränken**                              | Filter                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Beschreibung**                                                        | Beschreibender Text, wird auf der Produktdetailseite angezeigt                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Wann wurde der Cache der betroffenen Artikel zuletzt zurückgesetzt?** | Da Rabatte zeitabhängig aktiviert/deaktiviert werden können, die Rabattinformation bei Artikeln aber gecached werden kann, läuft für diesen Zweck im System ein Cronjob. Jedes Mal, wenn der Cache der Artikel (entweder durch den Cronjob oder durch Speichern des Rabatts) zurückgesetzt wurde, aktualisiert das System hier den Wert. Dadurch kann der Cronjob entscheiden, für welche Rabatte ein Zurücksetzen des Caches notwendig wird.                                                                                                                   |

\*nur verfügbar, wenn das Modul `Gratisartikel` freigeschaltet ist.


# Suche

Der Shop verfügt über zwei unterschiedliche Suchen. In der einfachen Suche gibt der Kunde einen Suchbegriff ein, zu dem das System versucht, möglichst gute Treffer anhand der Eingabe zu produzieren. In der erweiterten Suche kann der Kunde nach bestimmten Werten in vordefinierten Feldern (z.B. Titel, Kategorie usw.) suchen.

Die Suche nutzt ein gewichtetes Teilindex-System, welches auch bei hoher Belastung schnelle und zuverlässige Suchtreffer ermöglicht. Das System ermöglicht eine Gewichtung einzelner Felder, einer Gewichtung von Ganzwörtern im Vergleich zu Teilwörtern sowie einer Klangsuche (so werden auch ähnlich klingende Worte gefunden). Über eine Rechtschreibkorrektur werden außerdem die meisten Rechtschreibfehler berichtigt und Korrekturvorschläge angezeigt.

Standardmäßig wird das Suchergebnis nach der Treffgenauigkeit sortiert. Die Suchergebnisse können nachträglich nach Preis, Artikelname oder Produktbewertung sortiert werden.

Über eine „Ignore-Liste“ können bestimmte Wörter, wie z.B. „der“, „die“, „das“ usw. bei Suchen ignoriert werden. Die Ignore-Liste muss von Hand gepflegt werden und wirkt sich nur auf die Benutzer-Anfrage aus, nicht auf den generierten Index.

Alle Suchanfragen werden im System gespeichert (Suchbegriff, Anzahl Ergebnisse und ein Time-Stamp).

Um die Suche manuell beeinflussen zu können, besteht die Möglichkeit, im System für bestimmte Suchwörter Artikel zu hinterlegen. Diese werden mit einer entsprechend höheren Gewichtung an die Anfrage eines Suchergebnisses gehängt, wenn nach einem solchen Wort gesucht wird.

Neben dem Suchergebnis werden alle Kategorien aufgeführt, in denen die gefundenen Artikel enthalten sind. Neben jeder Kategorie steht, wie viele Treffer in einer Kategorie enthalten sind.

Diese Sucheinstellungen werden in `Shop-Einstellungen → Shops` im Tab `Sucheinstellungen` vorgenommen.

Es besteht die Möglichkeit, Chameleon an externe Suchen anzubinden, wie z.B. die extrem performante Volltextsuche *Elasticsearch* (besonders geeignet für große Artikelbestände ab 10.000 Stk. aufwärts) oder der ausgelagerten Such- und Navigationsmaschine *FACT-Finder®*.


# Artikelsuchindex

{% hint style="success" %}
Suche → Artikelsuchindex
{% endhint %}

Durch die Ausführung der Artikelindizierung werden alle Artikel des Shops durchgegangen und die unterschiedlich langen Teilwort-Suchindexe zwischengespeichert. Die Indizierung der Suche kann je nach Artikelanzahl und System-Performance unterschiedlich lang dauern.

Die Indizierung erfolgt nach den im CMS definierten Feldern, die durchsucht werden sollen und deren Relevanz (Gewichtung von 0 bis 1). Für jedes Feld werden automatisch mehrere Teilwort-Pools angelegt, aus welchen die Suche später ein möglichst optimales Suchergebnis generiert.

Die Texte werden vor der Indizierung umlautbereinigt (aus ä wird ae usw.). Die Suchergebnisse enthalten dann natürlich nach wie vor die Original-Umlaute. Es handelt sich lediglich um einen internen Abgleich zur Optimierung der Suchergebnisqualität.

Des Weiteren werden die Artikel auch nach dem Soundex (Klangcode)-Algorithmus indiziert. Dieser ermöglicht die Ermittlung der ähnlich klingenden Suchergebnisse.

Wird ein Artikel nach der durchgeführten Indizierung geändert, so wird der Index für diesen Artikel frisch reindiziert.


# Suchwortwolke

{% hint style="success" %}
Suche → Worte für die Suchwortwolke
{% endhint %}

In den Einstellungen der Suchwolke hat man die Möglichkeit, Wörter, die in der Suchwortwolke im Frontend angezeigt werden sollen, frei zu definieren.

| Bezeichnung                                                  | Beschreibung                                                                   |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| **Wort**                                                     | Das in der Suchwolke angezeigte Wort.                                          |
| **Prozentuale Gewichtung relativ zu den echten Suchwörtern** | Prozentuale Gewichtung des einzelnen Suchwortes relativ zu echten Suchwörtern. |


# Auswertungen / Statistik


# Auswertung (Chameleon intern)

{% hint style="success" %}
Artikel → Auswertung
{% endhint %}

Die CHAMELEON-interne Auswertung zeigt eine Grobübersicht aller Bestellungen im Shop. Dabei hat man die Möglichkeit, die Auswertungen nach Jahr, Tag, Monat oder Woche zu gruppieren oder durch einen Zeitraum zu beschränken. Außerdem kann die Auswertung selbst in einer Tabellenansicht (s.u.) oder als Balkendiagramm ausgegeben werden.

Bei eingeschalteter `Veränderung anzeigen` -Option enthält die Auswertung eine weitere Spalte, die durch das Symbol „Δ“ im Spaltenkopf dargestellt ist. Diese Spalte zeigt die jeweilige Veränderung zur ausgewählten Vor-Zeitperiode.

Des Weiteren bietet die CHAMELEON-interne Auswertung alle wichtigen Daten einer Auswertung auch als CSV-Datei zum Download an und ermöglicht somit die Weiterverarbeitung dieser.

Eine Druckfunktion zur Ausgabe der im Browser sichtbaren Auswertungen ist ebenfalls vorhanden. Weiterhin können Sie sich die gesamte Statistik oder die Top 50 Artikel als csv-Datei downloaden.

![](/files/-LIut4sntij29JaaSTfu)


# Externe Webstatistik-Dienste

{% hint style="success" %}
CMS / Portal-Einstellungen → Externe Webstatistik-Dienste
{% endhint %}

Über das Modul „Externe Webstatistik-Dienste“ besteht die Möglichkeit, alle gängigen und verfügbaren Dienste externer Anbieter (proprietäre Software) an das System anzubinden.

Derzeit werden folgende Dienste unterstützt:

* Google Analytics

\
&#x20;Da die „Externen Webstatistik-Dienste“ als separate Module im System eingebunden werden, ist die Entwicklung neuer Module und dadurch die Anbindung neuer externer Dienste jederzeit möglich.


# Changelog

{% hint style="success" %}
CMS Admin → CMS Changelog
{% endhint %}

### Zweck / Nutzen

Änderungen im CMS werden protokolliert.

### Verwendung

Das Changelog kann pro Tabelle (= ein Menüpunkt oder Menüunterpunkt im CMS) aktiviert werden. Die Aktivierung wird vom CMS-Administrator (in der Regel Ihr technischer Ansprechpartner) in den Tabelleneinstellungen vorgenommen.

Es werden folgende Änderungsarten unterschieden:

* neu (insert)
* geändert (update)
* gelöscht (delete)&#x20;

Die Änderungen können an 3 Stellen eingesehen werden:

1. Im Datensatz selbst – klicken Sie hier auf den Button „Änderungen anzeigen“ oberhalb des Datensatzes. Es werden alle Änderungen angezeigt, die diesen Datensatz betreffen.&#x20;
2. Beim Menüpunkt, auch hier gibt es den Button „Änderungen anzeigen“. Die Changelog-Liste zeigt hier alle Änderungen, die zu diesem Menüpunkt gehören.&#x20;
3. Beim Menüpunkt „CMS Changelog“ (unter CMS Admin). Hier werden alle Änderungen, die im gesamten CMS vorgenommen wurden und für die das Changelog aktiviert wurde, angezeigt.&#x20;

Die Änderungen werden als Liste angezeigt, innerhalb dieser jede Änderung als einzelner Datensatz mit Detailinformationen aufrufbar ist. <br>

#### Liste (Übersicht)

![](/files/-LIut2e3wyhvf436iLo6)

#### Datensatz

Im Datensatz werden diese Änderungsinformationen angezeigt:

* Änderungsdatum
* Benutzer, der die Änderung durchgeführt hat
* Haupttabelle, die geändert wurde
* ID des veränderten Datensatzes
* Name des veränderten Datensatzes
* Art der Änderung (neu, geändert, gelöscht)
* Was wurde geändert (alter Wert / neuer Wert)&#x20;

![](/files/-LIut2e56JY0PTKtVlXW)

#### CSV-Datei

Das Changelog kann außerdem auch in eine CSV-Datei exportiert werden. Rufen Sie hierfür im Hauptmenü den Menüpunkt `Generischer Tabellen-Export → ExportChangelog` auf und betätigen den Button `Export als Download ausführen`.


# E-Mail-Vorlagen

{% hint style="success" %}
CMS Admin → E-Mail-Vorlagen
{% endhint %}

Aus dem Backend heraus werden für diverse Aktionen E-Mails versendet.

Eine Ausnahme hiervon ist die E-Mail-Einstellung für die „Passwort vergessen“-Funktionalität welche, sich unter `CMS / Portal-Einstellungen → Extranet Konfiguration → Konfiguration: Passwort vergessen` befindet.

Eine E-Mail-Vorlage wird zentral verwaltet und kann an vielen Stellen im System über den Identifier ***ID-Code*** einfach verwendet werden. Es ist darauf zu achten, dass der ID-Code nicht ohne wichtigen Grund geändert wird.

Alle E-Mail-Vorlagen werden in zwei Formaten *Html* und *Text* gepflegt. Im Shop kann der Kunde wählen, ob er Html- oder Text-E-Mails empfangen möchte. Ist der Hmtl-Inhalt einer Vorlage nicht gefüllt, so wird automatisch eine Text-E-Mail erstellt und versendet.

| Bezeichnung                              | Beschreibung                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ID-Code**                              | eindeutig identifizierbarer Code (wird vom Entwickler benötigt, um die E-Mail-Vorlage eindeutig identifizieren zu können). Der ID-Code sollte nicht ohne wichtigen Grund und Systemkenntnis geändert werden, da dies zu Fehlern führen kann bzw. dazu, dass keine E-Mails mehr versendet werden.                                                |
| **Name**                                 | Bezeichnung der E-Mail-Vorlage                                                                                                                                                                                                                                                                                                                  |
| **Betreff**                              | Betreff der E-Mail (erscheint im Mailprogramm des Kunden)                                                                                                                                                                                                                                                                                       |
| **To**                                   | Gültige E-Mail-Adresse des Empfängers (falls es eine E-Mailvorlage ist wie die „Bestellbestätigung“, wird die jeweilige E-Mail-Adresse des Kunden zur Laufzeit – also in dem Moment, in dem der Kunde die Bestellung absendet – vom System hinzugefügt. In dem Fall muss das Feld beim Formular leer bleiben.)                                  |
| **To (Name)**                            | Name des Kunden (auch hier muss das Feld leer bleiben, wenn es eine E-Mailvorlage ist und die Empfänger während der Laufzeit vom System automatisch hinzugefügt werden).                                                                                                                                                                        |
| **Absender**                             | E-Mail-Adresse des Absenders (diese E-Mail-Adresse sollte existieren, da der Empfänger diese in seinem E-Mail-Programm sieht um darauf antworten zu können).                                                                                                                                                                                    |
| **Absender (Name)**                      | Name des Absenders (z.B. Name des Shops)                                                                                                                                                                                                                                                                                                        |
| **BBC**                                  | „BCC“ (Blindkopie) sollte grundsätzlich dann verwendet werden, wenn eine E-Mail an weitere Adressen als Kopie versendet werden soll, ohne dass der Empfänger sehen kann, welche das sind. Alle unter „BCC“ aufgenommenen Empfänger bleiben für sämtliche weitere Empfänger unsichtbar.                                                          |
| **Body**                                 | Inhalt der Html-E-Mail                                                                                                                                                                                                                                                                                                                          |
| **Body (Text)**                          | Inhalt der Text-E-Mail                                                                                                                                                                                                                                                                                                                          |
| **Folgende Dateien der E-Mail beifügen** | Dateien, die  hier hinzugefügt wurden, werden automatisch der E-Mail angehängt und mit versendet.                                                                                                                                                                                                                                               |
| **Vorlage**                              | die Html-Vorlage (in der Vorlage sind meistens Teile der E-Mail umgesetzt, die bei den meisten Mails des Systems gleich bleiben sollen/müssen, weil sie der CI des Unternehmens entsprechen. Diese „statischen“ Teile der E-Mail sind „Header“ – Kopf der E-Mail oder der „Footer“ – Fußbereich in welchen meist Zusatzangaben definiert sind). |
| **Text-Vorlage**                         | Entspricht der „Vorlage“, formatiert als reiner Text                                                                                                                                                                                                                                                                                            |

Hinweis für Entwickler: Um während der Entwicklung der E-Mail-Vorlagen alle in der E-Mail möglichen Platzhalter erhalten zu können, muss der spezielle Platzhalter \[{\_\_FIELDS}] hinzugefügt werden. Alle E-Mails laufen im Testsystem automatisch *an den Entwickler*.


# Interface / Interface Manager

{% hint style="success" %}
CMS Admin → CMS Interface-Manager (Im- und Export)
{% endhint %}

Das Interface („Schnittstelle“) ist die zentrale Stelle im CMS, an welcher der Benutzer die Möglichkeit hat, manuell Prozesse zur Kommunikation/Datenaustausch mit externen Systemen zu starten. Neue Schnittstellen sollten grundsätzlich nur von Entwicklern eingerichtet werden, da hierfür unter anderem Datenbankzugriffe korrekt konfiguriert werden müssen.

Alle vorhandenen Interfaces, welche im System hinterlegt sind, können auch automatisch über einen sogenannten `Cronjob`, einem zeitgesteuerten System-Dienst (ähnlich dem Windows-Scheduler) ausgeführt werden. Damit ein Interface zeitgesteuert und automatisch aufgerufen wird, muss dafür zuerst ein Cronjob eingerichtet werden.

Neue Interfaces werden zentral (durch einen Entwickler) über den CMS Interface Manager definiert. Interfaces können für die verschiedensten Aufgaben im System definiert werden, die typischen Aufgaben eines Interfaces sind Wartungs- /Datenpflegeaufgaben, wie z.B. „Import der Artikeldaten“ oder „Import der Bestell-Statusinformationen“. Diese Daten stammen meist aus externen Datenquellen, wie z.B. der Warenwirtschaft des Kunden.

| Bezeichnung               | Beschreibung                                                                                |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| **Name**                  | beschreibender Name des Interfaces im Manager                                               |
| **Systemname**            | über diesen Namen kann das Interface eindeutig identifiziert werden                         |
| **Die verwendete Klasse** | Dateiname der Interface-Klasse                                                              |
| **Klassenart**            | Definition, von welchem Typ die verwendete Klasse ist                                       |
| **Klassenunterart**       | Das Verzeichnis, in welchem sich die Klasse befindet (relativ zum *./classes/* Verzeichnis) |
| **Beschreibung**          | ausführliche Beschreibung des Interfaces mit allen benötigten Parametern                    |
| **Parameter**             | Liste aller Parameter, welche für das Interface benötigt werden                             |


# Systemnachrichten / Fehlercodes-Typen

{% hint style="success" %}
CMS / Portal-Einstellungen → Portale / Webseiten
{% endhint %}

Alle im System vorhandenen Meldungen und Fehlercodes werden zentral an dieser Stelle gepflegt. Sollte eine der Meldungen dem System noch nicht bekannt sein, wird eine Meldung *„Unbekannter Fehler:* *\[ERROR-IDENTIFIER]“* angezeigt.

Bei unbekannten Meldungen wird der Identifizierungs-Code *„ERROR-IDENTIFIER“* und die Meldung, die angezeigt wurde, zugleich unter `Systemmeldungen / Fehlercodes` eingetragen. Im Feld `Beschreibung der Meldung` wird bei unbekannter Meldung die technische Information hinterlegt, an welcher Stelle im System die Meldung generiert wurde, sowie eine Auflistung aller verfügbaren Parameter. Treten solche unbekannten Fehler auf, sollten diese sinnvoll für den Portalbesucher umgeschrieben werden.

| Bezeichnung                  | Beschreibung                                                                                                                                                                                                                                                                                                                        |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Gehört zu Portal**         | eindeutige Zugehörigkeit zum Portal                                                                                                                                                                                                                                                                                                 |
| **Code**                     | dieser Code wird vom System verwendet, um die Meldung zu identifizieren (sollte nicht geändert werden)                                                                                                                                                                                                                              |
| **Meldungsart**              | typisiert die Meldung (wird für die Darstellung verwendet)                                                                                                                                                                                                                                                                          |
| **Beschreibung der Meldung** | Erklärung, wann die Meldung generiert wird und genaue Beschreibung, welche Parameter in der Meldung verwendet werden können                                                                                                                                                                                                         |
| **Meldung**                  | der Meldungstext mit allen verwendeten Parametern (wird dem Besucher angezeigt)                                                                                                                                                                                                                                                     |
| **Art**                      | gibt an, zu welchem Quellcode-Bereich der Applikation die Meldung gehört bzw. aus welchem Quellcode-Bereich die zur Darstellung verwendete Ansicht (View) verwendet werden soll. Beim Quellcode-Bereich “Core” stammt die Meldung aus dem CHAMELEON-Standardcode, beim Bereich “Customer” aus einer kundenspezifischen Entwicklung. |
| **View**                     | Die Ansicht der Meldung (wird für die Darstellung verwendet)                                                                                                                                                                                                                                                                        |


# Formulare

Mit dem Modul `Konfigurierbares Formular` ist es möglich, Anfrage-Formulare frei zu gestalten. Die Ergebnisse werden per E-Mail an einen frei konfigurierbaren Empfänger verschickt. Das Modul eignet sich zum Aufbau von einfachen Anmelde-Formularen, Kontakt-Formularen und Ähnlichem.

Das Modul kann von ESONO auch so erweitert werden, dass man damit ebenfalls Umfragen mit Erweiterungen erstellen könnte.


# Newsletter

Benutzer können sich auf dem Portal für einen Newsletter anmelden. Bei der Registrierung erhält der Benutzer eine Bestätigungs-E-Mail, in der er seine Registrierung durch den Aufruf des Bestätigungslinks bestätigen muss (Double-Opt-In).

Zusätzlich wird eine Seite angeboten, auf der sich ein Newsletter-Benutzer auch wieder aus dem Newsletter austragen lassen kann. Um das Löschen zu bestätigen, erhält der Benutzer eine E-Mail mit einem Bestätigungslink (Double-Opt-Out).

Außerdem enthält jeder Newsletter einen Link, mit dem sich seine Benutzer vom Abo abmelden können.

Newsletter können entweder über das CMS direkt versandt werden oder die Newsletter-Abonnenten werden exportiert und an einen externen Dienstleister weitergereicht.


# Newsletter-Elemente

![](/files/-LIut6A9SJaY0UsPrsAP)

### Blacklisted Benutzer

{% hint style="success" %}
Newsletter → Blacklisted Benutzer
{% endhint %}

Die Liste der `Blacklisted Benutzer` ist eine Schutzliste mit den E-Mail-Adressen der Personen, die keine unaufgeforderte Werbung erhalten wollen. Sie dienen dem Kundenschutz vor unerwünschter Werbung. Seriöse Unternehmen verpflichten sich, dem Wunsch ihrer registrierten Kunden nach Werbefreiheit nachzukommen und sie nicht weiter zu kommerziellen Zwecken per E-Mail zu kontaktieren. Die in der Liste hinterlegten E-Mail-Adressen werden beim Newsletter-Versand ausgeschlossen.

### Newsletter-Abonnenten

{% hint style="success" %}
Newsletter → Newsletter-Abonennten
{% endhint %}

Hier werden die Abonnenten, die sich über das Anmeldeformular angemeldet haben, aufgelistet (auch diejenigen, deren Anmeldung noch nicht über den zugesandten Link bestätigt wurde; diese sind durch den Eintrag `Anmeldung wurde bestätigt: NEIN` zu erkennen). Jede Anmeldung ist einem bestimmten Kunden zugewiesen und kann eindeutig identifiziert werden. Der exakte Zeitpunkt der Anmeldung und die der Bestätigung kann hier ebenfalls abgelesen werden.

| **Name**                           | Beschreibung                                                          |
| ---------------------------------- | --------------------------------------------------------------------- |
| **Gehört zum Kunden**              | gibt an, zu welchem Kunden diese Newsletter-Anmeldung gehört          |
| **Abonennten der Empfängerlisten** | eine Liste der Empfängerlisten, in welche der Kunde aufgenommen wurde |
| **Anmeldebestätigungen**           | Liste der Newsletter, bei welchen der Kunde angemeldet ist            |
| **E-Mail-Adresse**                 | E-Mail-Adresse, an die der Newsletter versendet werden soll           |
| **Anmeldedatum**                   | Zeitpunkt, zu dem die Newsletter-Anmeldung erfolgte                   |
| **Anmelde Code**                   | interner Code zur Realisierung des Double-Opt-In-Verfahrens           |
| **Anmeldung wurde bestätigt**      | wird auf JA gesetzt, wenn der Kunde die Anmeldung bestätigt hat       |
| **Datum der Anmeldebestätigung**   | Zeitpunkt, wann die Anmeldung bestätigt wurde                         |
| **Abmelde-Code**                   | interner Code zur Realisierung des Double-Opt-Out-Verfahrens          |

### Empfängerlisten

{% hint style="success" %}
Newsletter → Newsletter-Empfängerlisten / Konfiguration
{% endhint %}

Eine Empfängerliste definiert sozusagen die Grundeinstellungen eines Versandes. Hier wird u.a. festgelegt, welche E-Mail-Adresse und welcher Name als Absender des Newsletters angegeben werden und an welche E-Mail-Adresse Antworten des Abonnenten gelangen.

Es sind unterschiedliche Empfängerlisten möglich. Durch die Anmeldeseite wird dem Newsletter-Benutzer eine bestimmte Empfängerliste zugeteilt oder der Benutzer darf selbst auswählen, welche(n) Newsletter er erhalten will.

### Kampagnen

{% hint style="success" %}
Newsletter → Newsletter-Kampagnen
{% endhint %}

Dies ist die zentrale Stelle, an welcher alle beteiligten Komponenten für den Versand eines Newsletters zusammen kommen. Eine Kampagne ist die Konfiguration mit allen benötigten Einstellungen für den Newsletter-Versand: Die Zuteilung des zu versendenden Newsletters und die restlichen Angaben werden durch Zuteilung der Empfängerliste zugeschrieben. <br>

`Basisdaten`

| Name                                         | Beschreibung                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Titel des Newsletters**                    | Titel zur internen Identifizierung des Newsletters                                                                                                                                                                                                                                                                                                                             |
| **Betreff**                                  | Betreff des Newsletters (wird als E-Mail-Betreff verwendet)                                                                                                                                                                                                                                                                                                                    |
| **Inhalt Text**                              | Inhalt für Plain-Text-E-Mails                                                                                                                                                                                                                                                                                                                                                  |
| **Portal**                                   | Zugehörigkeit des Newsletters zu einem Portal                                                                                                                                                                                                                                                                                                                                  |
| **gewünschter Versand-Zeitpunkt**            | Zeitpunkt, an dem der Newsletter-Versand gestartet werden soll                                                                                                                                                                                                                                                                                                                 |
| **Newsletter-Templateseite**                 | die gestaltete Newsletter-Vorlage wird hier zugewiesen                                                                                                                                                                                                                                                                                                                         |
| **Newsletter-Versand aktiv**                 | JA markiert den Newsletter als versandfertig                                                                                                                                                                                                                                                                                                                                   |
| **Benutzer-abhängige Newsletter generieren** | Wenn ja, wird für jede E-Mailadresse an die der Newsletter gesendet wird, ein personalisierter Newsletter generiert. Dass bedeutet, der Newsletter wird für jede E-Mailadresse neu generiert, was massiv die Performance beeinflusst. Wenn nein, wird der Newsletter nur einmal generiert und einzelne Texte wie z. B. Name oder Anrede werden für jede E-Mailadresse ersetzt. |
| **Empfängerliste**                           | alle Empfängerlisten für diesen Newsletter                                                                                                                                                                                                                                                                                                                                     |

\
&#x20;`Kampagnenstatus`

| Name                    | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Warteschlangen-Einträge | In den Warteschlangen-Einträgen landet jede einzelne E-Mail, die bereits versendet wurde oder bereits zum Absenden bereit ist und nur noch auf den auszuführenden Cronjob wartet. Sie listet also jede tatsächlich zu versendende E-Mail auf, die einem bestimmten Abonnenten zugewiesen wurde. Anhand der Spalte ‘Versendet’ kann man ablesen, ob und wann der Newsletter versendet wurde. |
| Sendestatus             | Hier wird der Sendestatus der Kampagne angezeigt                                                                                                                                                                                                                                                                                                                                            |
| Versandbeginn           | Startzeitpunkt des Newsletter-Versands                                                                                                                                                                                                                                                                                                                                                      |
| Versandende             | Endzeitpunkt des Newsletter-Versands                                                                                                                                                                                                                                                                                                                                                        |


# Grundkonfiguration

## Empfängerliste einrichten

{% hint style="success" %}
Newsletter → Newsletter-Empfängerlisten / Konfiguration
{% endhint %}

Richten Sie zuerst eine Empfängerliste ein. Sie dient dazu, dass ihre zukünftigen Abonnenten in einen Verteiler geschrieben werden. Sie können auch mehrere Empfängerlisten einrichten und somit unterschiedliche Newsletter beispielsweise an unterschiedliche Interessengruppen versenden. Wichtig bei der Konfiguration der Empfängerliste ist, dass Sie ihr entsprechendes Portal angeben. Außerdem sollten Sie immer eine Reply- und Absender-E-Mail Adresse angeben. <br>

`Basisdaten`

![](/files/-LIut7OJScyT230vLTK9)

\
&#x20;Zusätzlich können in der Empfängerliste individuelle Versandeinstellungen vorgenommen werden:

![](/files/-LIut7OLhMr_H3C1OL8x)

\
&#x20;`Empfänger definieren`

| Name                                                                                      | Beschreibung                                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **An alle Newsletter-Benutzer senden**                                                    | Hier können Sie auf einen Schlag alle Newsletter-Abonnenten dieser Empfängerliste zuweisen.                                                                                                                                                                                                         |
| **Newsletter-Benutzer, bei denen keine Zuweisung zu einer Empfängerliste hinterlegt ist** | Bei den Newsletter-Benutzern hat man die Möglichkeit, eine oder mehrere Empfängerlisten auszuwählen. Diese Benutzer werden den entsprechenden Empfängerlisten immer zugewiesen. Über diesen Schalter lassen sich die Newsletter-Benutzer zuweisen, bei denen keine Empfängerliste hinterlegt wurde. |
| **Alle Newsletter-Benutzer OHNE Extranet-Konto in die Liste aufnehmen**                   | Fügt alle Newsletter-Benutzer der Empfängerliste bei, die kein Extranet-Konto, also kein Kundenkonto, haben.                                                                                                                                                                                        |
| **An Benutzer mit folgenden Extranet-Benutzergruppen senden**                             | Alle Newsletter-Benutzer, die auch ein Extranet-Konto (also Kundenkonto) besitzen und bei denen eine Kundengruppe hinterlegt ist, werden der entsprechenden Empfängerliste hinzugefügt.![](/files/-LIut7ONzTPVKjM1K9fM)                                                                             |

## Zum Newsletter anmelden

Um Ihren Kunden einen Newsletter anbieten zu können, muss es für diese möglich sein, sich für ein Newsletter-Abo anzumelden. Richten Sie daher einen Navigationspunkt “Newsletter” ein (z.B. in der Top-Navigation). Verknüpfen Sie mit diesem Navigationspunkt die Systemseite `Newsletter Anmelden` (Rechtsklick auf den eben angelegten Navigationspunkt `Newsletter → Verbundene Seiten → Neu → Seite „Newsletter Anmelden` aus der Liste auswählen und `JA` bei Seitenverbindung aktiv).

![](/files/-LIut7OPur3FULLdhXEd)

Über `Seite editieren` können Sie den Anmeldevorgang im Steckplatz `Newsletter Signup` in seinen einzelnen Schritten beschriften.

Wichtig ist, dass Sie auf der Anmeldeseite beim Feld `Anmeldung möglich für` angeben, für welchen Newsletter die Anmeldung möglich ist (also die Empfängerliste auswählen, auf die die Abonnenten nach ihrer Anmeldung geschrieben werden sollen).

Außerdem sollte das Feld `DoubleOptIn-Verfahren benutzen` unbedingt auf `JA` eingestellt sein, da dies von der derzeitigen Rechtslage vorgeschrieben ist. Dieses Verfahren sorgt dafür, dass der Benutzer nach Ausfüllen des Anmeldeformulars zunächst eine E-Mail zugesandt bekommt, in der ihm ein Link zur endgültigen Anmeldung zur Verfügung steht. Es verhindert beispielsweise, dass jemand fremde E-Mail-Adressen auf den Newsletter-Verteiler setzt. Die Option Double-Opt-In auszuschalten ist somit nur für den internen Gebrauch bestimmt.

![](/files/-LIut7ORLsw5t-qoskmC)

### Ansicht der Newsletter-Anmeldeseite im Frontend:

![](/files/-LIut7OT2Q1Tknq7EB6G)

## Newsletter in verschiedenen Sprachen verschicken

Wenn Sie Newsletter in unterschiedlichen Sprachen versenden möchten (z.B. bei einer mehrsprachigen Webseite), müssen Sie pro Sprache eine Empfängerliste erstellen und diese auf der Anmelde-Seite unter `Anmeldung möglich für` anwählen. Im Frontend kann der Benutzer nun wählen, ob er sich z.B. für den deutschen und/oder englischen Newsletter anmelden möchte.

## Vom Newsletter abmelden

Die Abmeldeseite `Newsletter Abmelden` ist ebenfalls bereits als Systemseite eingerichtet. Die Texte können Sie selbst nach Ihren Wünschen eingeben.

Wenn diese Grundeinstellungen vorgenommen sind, kann nun ein Newsletter erstellt und versendet werden.


# Newsletter erstellen und versenden

## Newsletter-Seite erstellen

![](/files/-LIutBHkpaPTbMmf9NrY)

Der Newsletter wird als Seite im Backend angelegt. Sie können die Newsletter z.B. unter dem Menüpunkt `Newsletter` als versteckte Seiten anlegen (versteckt, damit sie nicht verlinkt auf Ihrer Website erscheinen). Sie können aber auch einen eigenen Navigationspunkt `Newsletter` unter dem Hauptportal anlegen und darunter die einzelnen Newsletter-Seiten hängen (in diesem Fall muss auch der oberste Navigationspunkt versteckt sein).

Für ein einheitliches CI empfiehlt es sich, vorab eine Seitenvorlage für den Newsletter zu erstellen, die Sie dann einfach bei jeder Newsletter-Seite verwenden können (`Navigation editieren → Seiten/Layouts`).

Auf der angelegten Seite können Sie nun die dynamischen Steckplätze editieren. Durch Eingabe des Pfades in die Adressleiste Ihres Browsers können Sie den erstellten Newsletter abrufen, oder nutzen Sie die Vorschau-Funktion im Backend.

## Kampagne anlegen

{% hint style="success" %}
Newsletter → Newsletter-Kampagnen
{% endhint %}

Nachdem Sie Ihren Newsletter fertig bearbeitet haben, erstellen Sie eine neue Kampagne. Diese dient dazu, den jeweiligen Newsletter einer Empfängerliste zuzuweisen und das Versenden vorzubereiten.

`Basidaten`

Hier ist es wichtig, dass Sie das entsprechende Portal auswählen, die im vorherigen Schritt erstellte Newsletter-Templateseite durch `Ast zuweisen` und die Empfängerliste durch `Auswählen` hinzufügen.

![](/files/-LIutBHnzBqQATYYyQ9D)

\
&#x20;Durch das *Aktiv*-Setzen des *Newsletter-Versands* werden die zugehörigen Abonnenten nach erstmaligem Abspeichern aus der `Empfängerliste` in die `Warteschlangen-Einträge` (Tab `Kampagnenstatus`) geladen. Hier können Sie die der Empfängerliste zugeordneten Email-Adressen sehen.

Durch ein zweites Abspeichern wird der auf der Templateseite hinzugefügte Newsletter den in der Warteschlange stehenden Abonnenten zugewiesen. Das Versenden erfolgt nun automatisch durch den dafür zuständigen Cronjob (der Cronjob prüft automatisch, ob Newsletter zum Versenden bereit sind).

Es empfiehlt sich, vor dem Senden des Newsletters zuerst einen Test-Newsletter zu versenden, damit Sie noch einmal überprüfen können, ob alles stimmt, wie der Newsletter im Email-Programm aussieht usw. Dafür legen Sie eine Test-Empfängerliste mit Ihrer Emailadresse und ggf. weiteren Adressen an und verknüpfen zunächst nur diese Empfängerliste mit der Kampagne.

Wenn der Test erfolgreich war, verknüpfen Sie nun die richtige Empfängerliste mit der Kampagne, und löschen außerdem die Warteschlangen-Einträge ![](/files/-LIutBHpnAZdJ5GmQuel) des Testversands (ansonsten wird der Newsletter trotz Aktiv-Schaltung nicht versendet, da das System bei Einträgen davon ausgeht, dass der Job schon erledigt wurde). Speziell dafür gibt es den Button am oberen Rand des Datensatzes.

Hinweis: Um Änderungen an den Warteschlangen-Einträgen zu sehen, müssen Sie die Kampagne neu aufrufen.

Um Text-Newsletter ebenfalls zu ermöglichen, besteht die Möglichkeit, zu jedem Newsletter eine Nur-Textversion der Inhalte über das Textfeld `Inhaltstext` (sh. `Basidaten`) zu hinterlegen. Da die meisten Mailprogramme nur stark eingeschränktes HTML zulassen, kann eine spezielle Seitenvorlage für den Newsletter erstellt werden. Hierbei kann auf alle Funktionen des CMS zurückgegriffen werden. Jeder Newsletter ist auch über die Webseite selbst erreichbar und enthält automatisch einen Link auf die entsprechende Seite. Dadurch kann man Kunden, bei denen der Newsletter nicht richtig dargestellt wird oder welche nur Textmails empfangen können, durch Zusenden dieses Links im Text-Newsletter den Newsletter so anzeigen, wie er ursprünglich vom Designer entworfen wurde.

## Cronjob Newsletter versenden

Sobald der Cronjob `Newsletter versenden` ausgeführt wird, werden die Newsletterkampagnen ausgeführt und somit der zugewiesene Newsletter an die Abonnenten aus der Warteschlange vesandt. Dies kann eventuell ein paar Minuten dauern, je nachdem in welchem Abstand dieser Cronjob ausgeführt wird (in der Regel alle 5 min).

Der Cronjob ist bereits entsprechend eingestellt, wenn das Newsletter-Modul installiert ist.


