Eigene Altersklassen hinterlegen: Unterschied zwischen den Versionen

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche
(Template anpassen)
 
(26 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 3: Zeile 3:
  
  
Standardmäßig enthält der Shop die [https://usk.de/die-usk-alterskennzeichen/ '''Altersfreigabeklassen der USK''']. Diese werden als Siegel in der Artikeldetailansicht im Shop dargestellt, wenn dem Artikel im Reiter ''Onlineshop'' der Artikelverwaltung ein korrespondierender Wert im Feld "Altersfreigabe" eingetragen wird.
+
Standardmäßig enthält der Shop die [https://usk.de/die-usk-alterskennzeichen/#altersfreigabe_anker '''Altersfreigabeklassen der USK''']. Diese werden als Siegel in der Artikeldetailansicht im Shop dargestellt, wenn dem Artikel im {{link|Artikelverwaltung - Reiter Onlineshop|Reiter ''Onlineshop''}} der Artikelverwaltung ein korrespondierender Wert im Feld "Altersfreigabe" eingetragen wird.
  
  
Zeile 11: Zeile 11:
  
  
Es kann aber auch vorkommen, dass andere Kennzeichen hinterlegt werden sollen, die nicht über bspw. das System der Energieeffizienzklassen gesteuert werden sollen.
+
Es kann aber auch vorkommen, dass andere Kennzeichen hinterlegt werden sollen, die nicht über bspw. das System der {{link|Konfiguration - Energieeffizienzklassen|Energieeffizienzklassen}} abgebildet werden können oder sollen.
  
 
Im Folgenden wird eine Einrichtung einer neuen Altersklasse anhand der Kennzeichnung der Spielzeugrichtlinie durchgeführt.
 
Im Folgenden wird eine Einrichtung einer neuen Altersklasse anhand der Kennzeichnung der Spielzeugrichtlinie durchgeführt.
  
  
<hr>
+
Die hier dargestellten Anpassungen sind bis auf Weiteres update-sicher, d.h. reguläre Template-Updates können weiterhin über das Shop-Management ausgeführt werden.
  
  
Zeile 31: Zeile 31:
 
==Template anpassen==
 
==Template anpassen==
  
Am Shop-Template müssen zwei Anpassungen vorgenommen werden. Dazu muss der aktuelle Template-Satz aus dem Shop-Management heruntergeladen werden. Dies ist im Shop-Management unter ''Shop-Design'' > ''Shop-Templates'' möglich.
+
Am Shop-Template müssen zwei Anpassungen vorgenommen werden, weshalb der aktuelle Template-Satz heruntergeladen werden muss. Dies ist im Shop-Management unter ''Shop-Design'' > ''Shop-Templates'' möglich.
  
Anschließend muss die geladene .zip-Datei entpackt werden, um den Template-Satz bearbeiten zu können.
+
Anschließend muss die geladene <code>.zip</code>-Datei entpackt werden, um den Template-Satz bearbeiten zu können.
  
  
Zeile 40: Zeile 40:
 
Im ersten Schritt muss im Template-Ordner<tt> \nav\icons </tt>die zu verwendende Grafik hinterlegt werden.
 
Im ersten Schritt muss im Template-Ordner<tt> \nav\icons </tt>die zu verwendende Grafik hinterlegt werden.
  
Diese sollte vom Dateityp PNG sein und die Abmaße 40 x 40 px haben, um sich in das bestehende Informationsgefüge der Artikeldetailansicht einzufügen.
+
Diese sollte vom Dateityp <code>.png</code> sein und die Abmaße 40 x 40 px haben, um sich in das bestehende Informationsgefüge der Artikeldetailansicht einzufügen.
  
  
In unserem Beispiel also diese:
+
Im vorliegenden Beispiel also diese:
  
 
:[[image:altersklassen-03.png|verweis=]]
 
:[[image:altersklassen-03.png|verweis=]]
Zeile 50: Zeile 50:
 
===Template-Datei erstellen===
 
===Template-Datei erstellen===
  
Im Ordner<tt> \templ </tt>des Template-Satzes finden sich mehrere Dateien, derenBezeichnung mit<tt> altersflag </tt>beginnt und die sich in drei Typen einteilen lassen:
+
Im Ordner <code>\templ</code>des Template-Satzes finden sich mehrere Dateien, deren Bezeichnung mit <code>altersflag</code> beginnt und die sich in drei Typen einteilen lassen:
 
*<tt>altersflag_n.htm</tt>
 
*<tt>altersflag_n.htm</tt>
 
*<tt>altersflag_s_n.htm</tt>
 
*<tt>altersflag_s_n.htm</tt>
 
*<tt>altersflag_s_json_n.htm</tt>
 
*<tt>altersflag_s_json_n.htm</tt>
  
Für den hier vorliegenden Fall sind nur die Dateien vom Typ<tt> altersflag_n.htm </tt>relevant. Bei diesen handelt es sich um kleine Code-Schnipsel, welche die Darstellung des Kennzeichens und des zugehörigen Textes in der Artikeldetailansicht steuern.
+
 
 +
(<code>n</code> ist ein Platzhalter für eine beliebige Zahl.)
 +
 
 +
Für den hier vorliegenden Fall sind nur die Dateien vom Typ <code>altersflag_n.htm</code> relevant. Bei diesen handelt es sich um kleine Code-Schnipsel, welche die Darstellung des Kennzeichens und des zugehörigen Textes in der Artikeldetailansicht steuern.
  
  
 
Die angehangenen Zahlen korrespondieren mit demjenigen Wert, der im Reiter ''Onlineshop'' der Artikelverwaltung als "Altersfreigabe" hinterlegt wurde.
 
Die angehangenen Zahlen korrespondieren mit demjenigen Wert, der im Reiter ''Onlineshop'' der Artikelverwaltung als "Altersfreigabe" hinterlegt wurde.
 +
Wird in diesem Feld somit bspw. eine <code>12</code> eingetragen, wird die Template-Datei <code>altersflag_12.htm</code> ausgespielt.
 +
 +
Der Shop prüft also bei einem vorhandenen Wert im Feld "Altersfreigabe", ob eine zugehörige Template-Datei vorhanden ist und spielt diese aus.
  
Wird in diesem Feld also bspw. eine<tt> 12 </tt>eingetragen, wird die Template-Datei<tt> altersflag_12.htm </tt>ausgespielt.
 
  
 +
Im vorliegenden Beispiel wird also eine Datei <code>altersflag_3.htm</code> erstellt und folgender Inhalt eingefügt:
  
Nun muss im Ordner<tt> \templ </tt>eine neue Datei erstellt werden.
+
<syntaxhighlight lang="html"><div class="agerating agerating_3" title="{s}Nicht f&uuml;r Kinder unter drei Jahren geeignet.{e}">
 +
  <span class="icon-spielzeug3"></span>
 +
  <div class="text font--small"><br>{s}Nicht f&uuml;r Kinder unter drei Jahren geeignet.{e}</div>
 +
</div>
 +
</syntaxhighlight>
  
  
Ordner:<tt> \templ</tt>
+
Hier sind mehrere Dinge wichtig:
 +
*In Zeile 1 wird gleichzeitig eine neue CSS-Klasse erstellt, die idealerweise auf dieselbe Zahl referenziert wie die Altersfreigabeklasse, hier also <code>agerating_3</code>. Diese Klasse werden wir später noch im CSS definieren.
 +
*In Zeile 2 wird ebenfalls eine CSS-Klasse erstellt (<code>icon-spielzeug3</code>). Diese Klasse enthält das auszuspielende Bild und wird ebenfalls später ausgestaltet.
 +
*Die Texte in den Zeilen 1 und 3 (hier "Nicht f&uuml;r Kinder unter drei Jahren geeignet.") sind frei definierbar.<br>Zu beachten ist allerdings:
 +
**Die Start- und Endpunkte <code>{s}</code> und <code>{e}</code> müssen unbedingt erhalten bleiben.
 +
**Sonderzeichen wie Umlaute, Ligaturen etc. müssen in ihrer HTML-Notation oder ihrer Entity-Darstellung hinterlegt werden.<br>Eine Übersicht findet sich bspw. [https://symbl.cc/en/unicode/blocks/latin-1-supplement/#subblock-00F8 '''auf dieser Seite''']. Ein <code>Ä</code> lässt sich also mittels <code>&amp;Auml;</code> oder <code>&amp;#196;</code> darstellen.
  
neue Datei:<tt> altersflag_3.htm</tt>
 
  
<syntaxhighlight lang="html"><div class="agerating agerating_3" title="{s}Nicht f&uuml;r Kinder unter drei Jahren geeignet.{e}">
+
===Template hochladen===
<span class="icon-spielzeug3"></span>
+
Wurden diese Anpassungen durchgeführt, kann das Template wieder gepackt und im Shop-Management unter ''Design und Darstellung'' > ''Shop-Templates'' hochgeladen werden.
<div class="text font--small"><br>
+
 
{s}Nicht f&uuml;r Kinder unter drei Jahren geeignet.{e}
 
</div>
 
</div></syntaxhighlight>
 
  
 
==CSS hinterlegen==
 
==CSS hinterlegen==
  
im Shop-Management unter ''Design und Darstellung'' > ''Shop-Design'' > ''Erweiterung durch individuelle CSS-Inhalte'' > ''CSS - Anfang''
+
Da neue CSS-Klassen angelegt wurden, müssen diese noch definiert werden. Im Shop-Management unter ''Design und Darstellung'' > ''Shop-Design'' > ''Erweiterung durch individuelle CSS-Inhalte'' > ''CSS - Anfang'' muss dazu der folgende Code hinterlegt werden:
 
 
  
 
<syntaxhighlight lang="css">.agerating_3 {
 
<syntaxhighlight lang="css">.agerating_3 {
   font-size:0.9em;
+
   font-size: 0.9em;
 +
  margin-bottom: 1em;
 
}
 
}
  
 
.agerating_3 .icon-spielzeug3 {
 
.agerating_3 .icon-spielzeug3 {
   background-image:url(../nav/icons/unter3.png);
+
   background-image: url(../nav/icons/unter3.png);
   background-repeat:no-repeat;
+
   background-repeat: no-repeat;
   width:40px;
+
   width: 40px;
   height:40px;
+
   height: 40px;
   display:block;
+
   display: block;
   background-position:0 0;
+
   background-position: 0 0;
 
}
 
}
  
 
.agerating_3 .text {
 
.agerating_3 .text {
   padding-left:44px;
+
   padding-left: 44px;
   margin-top:-40px;
+
   margin-top: -40px;
 
}</syntaxhighlight>
 
}</syntaxhighlight>
 +
 +
Hierbei ist wichtig, dass die Bezeichnungen der Klassen mit den vorher festgelegten übereinstimmen. In diesem Fall also <code>.agerating_3</code> und <code>.icon_spielzeug3</code>.
 +
 +
Außerdem muss der Dateiname des Bildes in der Style-Anweisung <code>background-image</code> mit dem im Ordner <code>\nav\icons</code> eingefügten identisch sein.

Aktuelle Version vom 25. Mai 2023, 16:05 Uhr

zum Anfang der Seite


Standardmäßig enthält der Shop die Altersfreigabeklassen der USK. Diese werden als Siegel in der Artikeldetailansicht im Shop dargestellt, wenn dem Artikel im Reiter Onlineshop der Artikelverwaltung ein korrespondierender Wert im Feld "Altersfreigabe" eingetragen wird.


Wird also der Altersfreigabewert von 16 hinterlegt, erscheint folgender Hinweis im Shop:

Altersklassen-01.png


Es kann aber auch vorkommen, dass andere Kennzeichen hinterlegt werden sollen, die nicht über bspw. das System der Energieeffizienzklassen abgebildet werden können oder sollen.

Im Folgenden wird eine Einrichtung einer neuen Altersklasse anhand der Kennzeichnung der Spielzeugrichtlinie durchgeführt.


Die hier dargestellten Anpassungen sind bis auf Weiteres update-sicher, d.h. reguläre Template-Updates können weiterhin über das Shop-Management ausgeführt werden.


Vorbemerkung

Die Richtlinie 2009/48/EG des Europäischen Parlaments und des Rates vom 18. Juni 2009 (auch "Spielzeugrichtlinie" genannt) fordert in Anhang V, Teil B eine Kennzeichnung für Spielzeug, welches nicht für Kinder bis zu einem Alter von 36 Monaten bestimmt ist.


Derartige Produkte müssen bspw. mit folgendem Kennzeichen versehen werden:

Altersklassen-02.png


Template anpassen

Am Shop-Template müssen zwei Anpassungen vorgenommen werden, weshalb der aktuelle Template-Satz heruntergeladen werden muss. Dies ist im Shop-Management unter Shop-Design > Shop-Templates möglich.

Anschließend muss die geladene .zip-Datei entpackt werden, um den Template-Satz bearbeiten zu können.


Grafik hinterlegen

Im ersten Schritt muss im Template-Ordner \nav\icons die zu verwendende Grafik hinterlegt werden.

Diese sollte vom Dateityp .png sein und die Abmaße 40 x 40 px haben, um sich in das bestehende Informationsgefüge der Artikeldetailansicht einzufügen.


Im vorliegenden Beispiel also diese:

Altersklassen-03.png


Template-Datei erstellen

Im Ordner \templdes Template-Satzes finden sich mehrere Dateien, deren Bezeichnung mit altersflag beginnt und die sich in drei Typen einteilen lassen:

  • altersflag_n.htm
  • altersflag_s_n.htm
  • altersflag_s_json_n.htm


(n ist ein Platzhalter für eine beliebige Zahl.)

Für den hier vorliegenden Fall sind nur die Dateien vom Typ altersflag_n.htm relevant. Bei diesen handelt es sich um kleine Code-Schnipsel, welche die Darstellung des Kennzeichens und des zugehörigen Textes in der Artikeldetailansicht steuern.


Die angehangenen Zahlen korrespondieren mit demjenigen Wert, der im Reiter Onlineshop der Artikelverwaltung als "Altersfreigabe" hinterlegt wurde. Wird in diesem Feld somit bspw. eine 12 eingetragen, wird die Template-Datei altersflag_12.htm ausgespielt.

Der Shop prüft also bei einem vorhandenen Wert im Feld "Altersfreigabe", ob eine zugehörige Template-Datei vorhanden ist und spielt diese aus.


Im vorliegenden Beispiel wird also eine Datei altersflag_3.htm erstellt und folgender Inhalt eingefügt:

<div class="agerating agerating_3" title="{s}Nicht f&uuml;r Kinder unter drei Jahren geeignet.{e}">
  <span class="icon-spielzeug3"></span>
  <div class="text font--small"><br>{s}Nicht f&uuml;r Kinder unter drei Jahren geeignet.{e}</div>
</div>


Hier sind mehrere Dinge wichtig:

  • In Zeile 1 wird gleichzeitig eine neue CSS-Klasse erstellt, die idealerweise auf dieselbe Zahl referenziert wie die Altersfreigabeklasse, hier also agerating_3. Diese Klasse werden wir später noch im CSS definieren.
  • In Zeile 2 wird ebenfalls eine CSS-Klasse erstellt (icon-spielzeug3). Diese Klasse enthält das auszuspielende Bild und wird ebenfalls später ausgestaltet.
  • Die Texte in den Zeilen 1 und 3 (hier "Nicht für Kinder unter drei Jahren geeignet.") sind frei definierbar.
    Zu beachten ist allerdings:
    • Die Start- und Endpunkte {s} und {e} müssen unbedingt erhalten bleiben.
    • Sonderzeichen wie Umlaute, Ligaturen etc. müssen in ihrer HTML-Notation oder ihrer Entity-Darstellung hinterlegt werden.
      Eine Übersicht findet sich bspw. auf dieser Seite. Ein Ä lässt sich also mittels &Auml; oder &#196; darstellen.


Template hochladen

Wurden diese Anpassungen durchgeführt, kann das Template wieder gepackt und im Shop-Management unter Design und Darstellung > Shop-Templates hochgeladen werden.


CSS hinterlegen

Da neue CSS-Klassen angelegt wurden, müssen diese noch definiert werden. Im Shop-Management unter Design und Darstellung > Shop-Design > Erweiterung durch individuelle CSS-Inhalte > CSS - Anfang muss dazu der folgende Code hinterlegt werden:

.agerating_3 {
  font-size: 0.9em;
  margin-bottom: 1em;
}

.agerating_3 .icon-spielzeug3 {
  background-image: url(../nav/icons/unter3.png);
  background-repeat: no-repeat;
  width: 40px;
  height: 40px;
  display: block;
  background-position: 0 0;
}

.agerating_3 .text {
  padding-left: 44px;
  margin-top: -40px;
}

Hierbei ist wichtig, dass die Bezeichnungen der Klassen mit den vorher festgelegten übereinstimmen. In diesem Fall also .agerating_3 und .icon_spielzeug3.

Außerdem muss der Dateiname des Bildes in der Style-Anweisung background-image mit dem im Ordner \nav\icons eingefügten identisch sein.