Benutzer Manual

1. Erzeugen Sie 2 versteckte Elemente (hidden fields) deren Bezeichnungen Sie folgendermaßen festlegen: MeinVersstecktesElement_selected und MeinVerstecktesElement_total
2. Der Inhalt des Elements MeinVerstecktesElement_total MUSS die Ziffer "0" enthalten.
3. Erzeugen Sie in Ihrer Checkboxgruppe oder bei mehreren Checkboxgruppen die zusammen ausgewertet werden sollen in jeder einzelnen ein ActionScript und fügen Sie den Funktionsaufruf des Checkbox Limiter Scripts ein:

wst_selectionlimiter(element,action,max,"MeinVerstecktesElement",separator (optional - default = "-"), marked (optional - default = false))

Dabei lassen Sie "element" und "action" so stehen und ersetzen "max" durch die maximale wählbare Anzahl der Optionen.

Beispiel mit maximal 3 wählbaren Optionen:

function ff_mylist_action(element, action)
{
  switch (action) {
    case 'change':
      wst_selectionlimiter(element,action,3,'MeinVerstecktesElement');
      break;
    default:;
  } // switch
} // ff_mylist_action 

Optionaler Separator

Da der Standard Separator der die gewählten Optionen im Element "MeinVerstecktesElement_selected" voneinander trennt ein "-" ist, darf dieses Minuszeichen nicht in Ihren Values der Checkboxgruppe vorkommen.

Wenn Ihre Gruppe also z.B. diese Werte hätte...

0;Option A-C;A-C
0;Option D-H;D-H
0;Option I-Q;I-Q

... müssten Sie den Standard Separator so abändern (hier eine Pipe | ) -> wst_selectionlimiter(element,action,3,'MeinVerstecktesElement','|');

Optionaler Markierungsrahmen

Falls Sie <DIV> oder <IMG> in Ihrer Optionsliste verwenden, können Sie die gewählten Objekte automatisch mit einem farblichen Markierungsrahmen versehen.

Dazu muss allerdings eine Klasse in Ihre Custom-CSS Dateien eingefügt werden. Da dies abhängig von Ihrem Template ist lesen Sie dazu bitte die technischen Details Ihres Templates. Bei vielen Templates wird die Datei im Template Ordner des jeweiligen Templates abgelegt und erhält den Namen des Templates mit dem Zusatz "Custom" also z.B. MeinTemplateName-custom.css. Aber wie gesagt, jedes Template ist unterschiedlich.

Fügen Sie folgende Klasse ein:

.marked {
   border: #ff0000 solid 3px;
}

Die Farbe (hier ROT) kann natürlich entsprechend Ihrer Bedürfnisse angepasst werden.

Im Funktionsaufruf muss jetzt die Markierung eingeschaltet werden (true), welche standardmäßig abgeschaltet ist (default = false):

wst_selectionlimiter(element, action, 3, 'MeinVerstecktesElement', '|', true);

Außerdem muss das Script erkennen können welches <DIV> oder <IMG> zu welcher Option gehört, daher ist es nötig den Wert (value) der Option als ID jeweils hinzuzufügen. So sähe die obige Checkboxliste mit markierbaren Bildern aus:

0;Option A-C <img id="A-C" src="/images/myImage1.jpg" />;A-C
0;Option D-H <img id="D-H" src="/images/myImage2.jpg" />;D-H
0;Option I-Q <img id="I-Q" src="/images/myImage3.jpg" />;I-Q