<we:captcha  />

Generiert ein Captcha-Bild.

ab Version 4.0.0.0
Endtag erforderlich nein
Pflichtattribute

Attribute

width Pflichtfeld: ja

Bei diesem Attribut gibst Du als Wert die Breite des Captcha-Bildes in Pixeln an.

ab Version 4.0.0.0
Typ number
Standardwert 100
height Pflichtfeld: ja

Bei diesem Attribut gibst Du als Wert die Höhe des Captcha-Bildes in Pixel an.

ab Version 4.0.0.0
Typ number
Standardwert 25
maxlength Pflichtfeld: nein

Durch die Angabe dieses Attributes bestimmst Du die maximale Länge des generierten Zufallcodes. Tatsächlich dargestellt werden so viele Zeichen wie möglich (bis Bildbreite erreicht), jedoch maximal die hier angegebene Anzahl.

ab Version 4.0.0.0
Typ number
Standardwert 5
path Pflichtfeld: nein
deprecated

Mit diesem Attribut gibst Du den Pfad ab Deinem Document-Root-Verzeichnis an, in welches das Captcha-Bild gespeichert werden soll. Wird dieses Attribut nicht gesetzt, wird das Captcha Bild in Deinem Document-Root-Verzeichnis abgespeichert.

ab Version 4.0.0.0
Typ string
Standardwert -
subset Pflichtfeld: nein

Durch dieses Attribut kannst Du den Zeichenvorrat bestimmen, welcher für die Generierung eines zufälligen Codes benutzt werden soll.

WertBedeutung
alphanum A-Z, a-z, 0-9
alpha A-Z, a-z
num 0-9
ab Version 4.0.0.0
Typ string
mögliche Werte alphanum, alpha, num
Standardwert alphanum
skip Pflichtfeld: nein

Durch die Angabe einer kommaseparierten Liste kannst Du bestimmte Zeichen von der Generierung des Codes ausschliessen.

ab Version 4.0.0.0
Typ string
Standardwert i,I,l,L,0,o,O,1,g,9
fontcolor Pflichtfeld: nein

Durch die Verwendung dieses Attributs kannst Du festlegen, welche Schriftfarben für den Code verwendet werden sollen. Bitte gib alle zulässigen Farben im HEX-Code kommasepariert ein.

ab Version 4.0.0.0
Typ string
Standardwert #000000
fontsize Pflichtfeld: nein

Durch die Angabe dieses Attributes kannst Du die Schriftgröße beeinflussen. Geben Sie nur eine Zahl ein, wird diese Schriftgröße verwendet. Gibst Du jedoch zwei Werte, durch ein Komma voneinander getrennt, ein, variert die Schriftgröße von Zeichen zu Zeichen innerhalb der angegebenen Größen.

Achtung: dieses Attribut wirkt nur, wenn entweder das Attribut fontpath angegeben wurde oder es sich um einen Windows-Server handelt.

ab Version 4.0.0.0
Typ number
Standardwert 14
bgcolor Pflichtfeld: nein

Die hier definierte Farbe wird als Hintergrundfarbe verwendet.

ab Version 4.0.0.0
Typ string
Standardwert #ffffff
transparent Pflichtfeld: nein

Wenn Du den Wert dieses Attributs auf "true" setzt, wird der Hintergrund des Bildes transparent. Wenn Du den Wert dieses Attributs auf "false" oder nicht setzt, wird die durch das Attribut "bgcolor" definierte Farbe als Hintergrund verwendet.

ab Version 4.0.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
style Pflichtfeld: nein

Durch dieses Attribut kannst Du festlegen welche Arten verwendet werden sollen, um den Code unleserlicher zu machen. Wird dieses Attribut nicht gesetzt, werden keine "Störer" verwendet.

ab Version 4.0.0.0
Typ string
mögliche Werte strikeout, fullcircle, fullrectangle, outlinecircle, outlinerectangle
Standardwert -
stylecolor Pflichtfeld: nein

Durch die Verwendung dieses Attributs kannst Du festlegen, welche Farben für die über das Attribut "style" angegebenen Störer verwendet werden sollen. Bitte gib alle zulässigen Farben im HEX-Code kommasepariert ein.

ab Version 4.0.0.0
Typ string
Standardwert #cccccc
angle Pflichtfeld: nein

Durch dieses Attribut kannst Du die zufällige Neigung der einzelnen Zeichen beeinflussen. Gibst Du nur einen Wert an, wird dieser Winkel als Neigung nach links und rechts verwendet. Gibst Du jedoch zwei Werte, durch ein Komma voneinander getrennt, ein, variieren der Winkel von Zeichen zu Zeichen innerhalb der angegebenen Größen. Achtung: dieses Attribut wirkt nur, wenn entweder das Attribut "fontpath" angegeben wurde oder es sich um einen Windows-Server handelt.

ab Version 4.0.0.0
Typ string
Standardwert 0
align Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die horizontale Ausrichtung des Textes innerhalb des Bildes an.

ab Version 4.0.0.0
Typ string
mögliche Werte random, center, left, right
Standardwert random
valign Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die vertikale Ausrichtung des Textes innerhalb des Bildes an.

ab Version 4.0.0.0
Typ string
mögliche Werte random, top, middle, bottom
Standardwert random
font Pflichtfeld: nein
deprecated bis Version 8.1.1 (Ahlberg)

Bei diesem Attribut gibst Du als Wert kommasepariert jene Schriftarten an, welche für den zu generierenden Code verwendet werden sollen. Zusätzlich zu diesem Attribut muß über das Attribut "fontpath" der Pfad zu den .ttf Dateien angegeben werden.

ab Version 4.0.0.0
Typ string
Standardwert -
fontpath Pflichtfeld: nein
deprecated bis Version 8.1.1 (Ahlberg)

Durch die Angabe des Fontapth kann ein Pfad zu eigenen .ttf Dateien angeben werden. In diesem Verzeichnis wird dann nach der über das Attribut "font" definierten Schrift gesucht.

ab Version 4.0.0.0
Typ string
Standardwert -
case Pflichtfeld: nein

Mit der Angabe dieses Attributes kannst Du bestimmen, ob nur kleingeschriebene Zeichen (lower), nur großgeschriebene Zeichen (upper) oder beides (mix) verwendet werden sollen.

WertBedeutung
mix groß- und kleingeschriebene Zeichen
upper nur großgeschriebene Zeichen
lower nur kleingeschriebene Zeichen
ab Version 4.0.0.0
Typ string
mögliche Werte mix, upper, lower
Standardwert mix
type Pflichtfeld: nein

Durch die Angabe dieses Attributes kannst Du festlegen welche Art von Grafik erzeugt werden soll. Wird dieses Attribut nicht angegeben, wird eine GIF-Grafik erzeugt.

ab Version 4.0.0.0
Typ string
mögliche Werte gif, jpg, png
Standardwert gif
stylenumber Pflichtfeld: nein

Durch die Angabe dieses Attributes kannst Du die Anzahl der Objekte beeinflussen, welche über das Attribut "style" angegeben wurden. Gibst Du zwei Werte, durch ein Komma voneinander getrennt ein, variert die Anzahl der Objekte innerhalb der angegebenen Größen.

ab Version 4.0.0.0
Typ string
Standardwert 5,10
pass_* Pflichtfeld: nein

Für das * - also nach dem "_" (Unterstrich) - kann ein beliebiger Wert (HTML-Attribut) vergeben werden. Dieses wird dann so an die Ausgabe weritergegeben.

Zum Beispiel kann man dadurch einem Formular eine ID verpasst werden. Denn das Attribut "id" kann ja nicht verwendet werden, da dieses schon ein webEdition-Attribut ist. In einem solchen Fall kann man "pass_id" verwenden.

Dieses Attribut gibt es übrigens bei allen Tags die eine Ausgabe produzieren.

ab Version 3.2.0.0
Typ string
Standardwert -

Syntax

<we:captcha width="" height="" maxlength="" subset="alphanum|alpha|num" skip="" fontcolor="" fontsize="" bgcolor="" transparent="true|false" style="strikeout|fullcircle|fullrectangle|outlinecircle|outlinerectangle" stylecolor="" angle="" align="random|center|left|right" valign="random|top|middle|bottom" case="mix|upper|lower" type="gif|jpg|png" stylenumber="" pass_*=""/>						

Beispiele

Beispiel #1

Code
<we:captcha width="100" height="25" maxlength="7" font="Times,Arial,Verdana" fontsize="15" fontcolor="#000000,#232323" case="lower" subset="alphanum" skip="1,l,i,I,o,O,0" style="strikeout,circle,rectangle" stylecolor="#dedede,#a0a0a0,#e3e3e3,#c0c0c0" valign="middle" />
Ausgabe:

Beispiel #2

Code
<we:captcha width="100" height="25" maxlength="8" font="Times" fontsize="15" fontcolor="#000000" case="lower" subset="num" style="strikeout" angle="15" />
Ausgabe:

Hilf mit!

Hast Du eine Ergänzung für die Tag-Referenz, dann werde bitte aktiv.
Entweder über einen Eintrag unter qa.webedition.org oder einfach formlos per E-Mail an websites@webedition.org.

Fehler oder Erweiterungswünsche zu webEdition selbst bitte über qa.webedition.org melden.

powered by webEdition CMS