we:DevEdge

the webEdition code base

we:Tag-Referenz

we:Tags-Auswahl
we:Tags-Suche



<we:captcha>
Ab Version: 4.0

Endtag erforderlich: nein

Beschreibung:

Dieses Tag dient dazu, ein Bild mit einem Zufallscode zu generieren.

Attribute:

width
Standardwert: 100 | ab Version: 4.0 | Erforderlich: ja

Bei diesem Attribut geben Sie als Wert die Breite des Captcha-Bildes in Pixeln an.

height
Standardwert: 25 | ab Version: 4.0 | Erforderlich: ja

Bei diesem Attribut geben Sie als Wert die Höhe des Captcha-Bildes in Pixeln an.

maxlength
Standardwert: 5 | ab Version: 4.0 | Erforderlich: nein

Durch die Angabe dieses Attributes bestimmen Sie 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.

path
Standardwert: / | ab Version: 4.0 | Erforderlich: nein

Mit diesem Attribut geben Sie den Pfad ab Ihrem Document Root Verzeichnis an, in welches das Captcha Bild gespeichert werden soll. Wird dieses Attribut nicht gesetzt, wird das Captcha Bild in Ihrem Document Root Verzeichnis abgespeichert.

subset
Standardwert: alphanum | ab Version: 4.0 | Erforderlich: nein

Durch dieses Attribut können Sie den Zeichnvorrat bestimmen, welcher für die Generierung eines zufälligen Codes benutzt werden soll. Folgende Werte sind zulässig: alphanum: A-Z,a-z,0-9 alpha: A-Z,a-z num: 0-9

Erlaubte WerteAb VersionBeschreibung
alphanum4.0 
alpha4.0 
num4.0 

skip
Standardwert: i,I,l,L,0,o,O,1,g,9 | ab Version: 4.0 | Erforderlich: nein

Durch die Angabe einer kommaseparierten Liste können Sie bestimmte Zeichen von der Generierung des Codes ausschliessen.

fontcolor
Standardwert: #000000 | ab Version: 4.0 | Erforderlich: nein

Durch die Verwendung dieses Attributs können Sie festlegen, welche Schriftfarben für den Code verwendet werden sollen. Bitte geben Sie alle zulässigen Farben im HEX-Code kommasepariert ein.

Erlaubte WerteAb VersionBeschreibung
#0000004.0 
#ffffff4.0 
#ff00004.0 
#00ff004.0 
#0000ff4.0 
#ffff004.0 
#ff00ff4.0 
#00ffff- 

fontsize
Standardwert: 14 | ab Version: 4.0 | Erforderlich: nein

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

bgcolor
Standardwert: #ffffff | ab Version: 4.0 | Erforderlich: nein

Bie diesem Attribut geben Sie als Wert die Hintergrundfarbe als HEX-Code an.

Erlaubte WerteAb VersionBeschreibung
#ffffff4.0 
#cccccc4.0 
#8888884.0 

transparent
Standardwert: false | ab Version: 4.0 | Erforderlich: nein

Setzen Sie dieses Attribut auf true, wird der Hintergrund des Bildes transparent. Wird dieses Attribut auf false oder garnicht gesetzt, wird die durch das Attribut "bgcolor" definierte Farbe als Hintergrund verwendet.

Erlaubte WerteAb VersionBeschreibung
false4.0 
true4.0 

style
Standardwert: - | ab Version: 4.0 | Erforderlich: nein

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

Erlaubte WerteAb VersionBeschreibung
strikeout4.0 
fullcircle4.0 
fullrectangle4.0 
outlinecircle4.0 
outlinerectangle4.0 

stylecolor
Standardwert: #cccccc | ab Version: 4.0 | Erforderlich: nein

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

Erlaubte WerteAb VersionBeschreibung
#cccccc4.0 
#ff00004.0 
#00ff004.0 
#0000ff4.0 
#00ffff4.0 
#ff00ff4.0 
#ffff004.0 

angle
Standardwert: 0 | ab Version: 4.0 | Erforderlich: nein

Durch dieses Attribut können Sie die zufällige Neigung der einzelnen Zeichen beeinflussen. Geben Sie nur einen Wert an, wird dieser Winkel als Neigung nach links und rechts verwendet. Geben Sie jedoch 2 Werte, durch ein Komma voneinander getrennt, ein, variert der Winkel von Zeichen zu Zeichen innerhalb der angegebenen Größen.

align
Standardwert: random | ab Version: 4.0 | Erforderlich: nein

Erlaubte WerteAb VersionBeschreibung
random4.0 
center4.0 
left4.0 
right4.0 

valign
Standardwert: random | ab Version: 4.0 | Erforderlich: nein

Bei diesem Attribut geben Sie als Wert die vertikale Ausrichtung des Textes innerhalb des Bildes an.

Erlaubte WerteAb VersionBeschreibung
random4.0 
top4.0 
middle4.0 
bottom4.0 

font
Standardwert: - | ab Version: 4.0 | Erforderlich: nein

Bei diesem Attribut geben Sie als Wert kommasepariert die 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.

fontpath
Standardwert: - | ab Version: 4.0 | Erforderlich: nein

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.

case
Standardwert: mix | ab Version: 4.0 | Erforderlich: nein

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

Erlaubte WerteAb VersionBeschreibung
mix4.0 
upper4.0 
lower4.0 

type
Standardwert: gif | ab Version: 4.0 | Erforderlich: nein

Durch die Angabe dieses Attributes können Sie festlegen welche Art von Grafik erzeugt werden soll. Wird dieses Attribut nicht angegeben, wird eine GIF-Grafik erzeugt.

Erlaubte WerteAb VersionBeschreibung
gif4.0 
jpg4.0 
png4.0 

stylenumber
Standardwert: 5,10 | ab Version: 4.0 | Erforderlich: nein

Durch die Angabe dieses Attributes könnnen Sie die Anzahl der Objekte beeinflussen, welche über das Attribut "style" angegeben wurden. Geben Sie 2 Werte, durch ein Komma voneinander getrennt ein, variert die Anzahl der Objekte innerhalb der angegebenen Größen.

Syntax:

<we:captcha width="attribute" height="attribute" [maxlength="attribute"] [path="attribute"] [subset="alphanum|alpha|num"] [skip="attribute"] [fontcolor="#000000|#ffffff|#ff0000|#00ff00|#0000ff|#ffff00|#ff00ff|#00ffff"] [fontsize="attribute"] [bgcolor="#ffffff|#cccccc|#888888"] [transparent="false|true"] [style="strikeout|fullcircle|fullrectangle|outlinecircle|outlinerectangle"] [stylecolor="#cccccc|#ff0000|#00ff00|#0000ff|#00ffff|#ff00ff|#ffff00"] [angle="attribute"] [align="random|center|left|right"] [valign="random|top|middle|bottom"] [font="attribute"] [fontpath="attribute"] [case="mix|upper|lower"] [type="gif|jpg|png"] [stylenumber="attribute"] />

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" />
Beispiel 2<we:captcha width="100" height="25" maxlength="8" font="Times" fontsize="15" fontcolor="#000000" case="lower" subset="num" style="strikeout" angle="15" />

Kommentare (0)

Kommentar hinzufügen
Um selber einen Kommentar schreiben zu können müssen Sie sich registrieren und einloggen.



we:Samples NEU: Navigations-Tool in webEdition 4 - Und hier das passende Beispiel!

Kommentare schreiben und Newsletter bestellen - Einfach registrieren!

we:Tags - Gewußt wie! - Wie geht das? So!