<we:captcha />
Generiert ein Captcha-Bild.
ab Version | 4.0.0.0 |
Endtag erforderlich | nein |
Pflichtattribute |
Attribute
- width
- height
- maxlength
- path
- subset
- skip
- fontcolor
- fontsize
- bgcolor
- transparent
- style
- stylecolor
- angle
- align
- valign
- font
- fontpath
- case
- type
- stylenumber
- pass_*
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 |
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 |
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 |
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 | - |
Durch dieses Attribut kannst Du den Zeichenvorrat bestimmen, welcher für die Generierung eines zufälligen Codes benutzt werden soll.
Wert | Bedeutung |
---|---|
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 |
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 |
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 |
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 |
Die hier definierte Farbe wird als Hintergrundfarbe verwendet.
ab Version | 4.0.0.0 |
Typ | string |
Standardwert | #ffffff |
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 |
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 | - |
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 |
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 |
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 |
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 |
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 | - |
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 | - |
Mit der Angabe dieses Attributes kannst Du bestimmen, ob nur kleingeschriebene Zeichen (lower), nur großgeschriebene Zeichen (upper) oder beides (mix) verwendet werden sollen.
Wert | Bedeutung |
---|---|
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 |
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 |
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 |
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
<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
<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.