direkt zum Inhalt springen zur Schnellnavigation zur Navigationshilfe

<we:captcha />

ab Version: 4.0.0.0 | Endtag erforderlich: nein

Beschreibung

Dieses Tag dient dazu, ein Captcha-Bild zu generieren.

Attribute

  • width

    Typ: number | Standardwert: 100 | Pflichtfeld: ja

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

    Typ: number | Standardwert: 25 | Pflichtfeld: ja

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

    Typ: number | Standardwert: 5 | Pflichtfeld: 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

    Typ: string | Standardwert: - | Pflichtfeld: 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

    ab Version: 0.0 | Typ: string | mögliche Werte: alphanum, alpha, num | Standardwert: alphanum | Pflichtfeld: nein

    Durch dieses Attribut können Sie 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

  • skip

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

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

    Typ: string | Standardwert: #000000 | Pflichtfeld: 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.
  • fontsize

    Typ: number | Standardwert: 14 | Pflichtfeld: 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 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.
  • bgcolor

    Typ: boolean | mögliche Werte: true, false | Standardwert: false | Pflichtfeld: nein

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

    Typ: boolean | mögliche Werte: true, false | Standardwert: false | Pflichtfeld: nein

    Wenn Sie den Wert dieses Attributs auf "true" setzen, wird der Hintergrund des Bildes transparent. Wenn Sie den Wert dieses Attributs auf "true" setzen oder das Attribut nicht setzen, wird die durch das Attribut "bgcolor" definierte Farbe als Hintergrund verwendet.
  • style

    ab Version: 0.0 | Typ: string | mögliche Werte: strikeout, fullcircle, fullrectangle, outlinecircle, outlinerectangle | Standardwert: - | Pflichtfeld: 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.
  • stylecolor

    ab Version: 0.0 | Typ: string | Standardwert: #cccccc | Pflichtfeld: 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.
  • angle

    Typ: string | Standardwert: 0 | Pflichtfeld: 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 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.
  • align

    Typ: string | mögliche Werte: random, center, left, right | Standardwert: random | Pflichtfeld: nein

    Bei diesem Attribut geben Sie als Wert die horizontale Ausrichtung des Textes innerhalb des Bildes an.
  • valign

    Typ: string | mögliche Werte: random, top, middle, bottom | Standardwert: random | Pflichtfeld: nein

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

    Typ: string | Standardwert: - | Pflichtfeld: 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

    Typ: string | Standardwert: - | Pflichtfeld: 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

    Typ: string | mögliche Werte: mix, upper, lower | Standardwert: mix | Pflichtfeld: nein

    Mit der Angabe dieses Attributes können Sie 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
  • type

    Typ: string | mögliche Werte: gif, jpg, png | Standardwert: gif | Pflichtfeld: 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.
  • stylenumber

    ab Version: 0.0 | Typ: string | Standardwert: 5,10 | Pflichtfeld: nein

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

Syntax

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

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:

Bitte helfen Sie mit

Haben Sie eine Ergänzung für die Tag-Referenz, dann werden Sie 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.
zum Seitenanfang