<we:href  />

Gibt dem Redakteur die Möglichkeit, eine URL auszuwählen.

ab Version 1.3.0.0
Endtag erforderlich nein
Pflichtattribute

Attribute

name Pflichtfeld: ja

Bei diesem Attribut gibst Du als Wert einen eindeutigen Namen an.

ab Version 2.0.0.0
Typ string
Standardwert -
size Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert eine Zahl an, die die Breite des Eingabefeldes definiert.

ab Version 1.3.0.0
Typ number
Standardwert -
type Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert an, welche Art von URLs der Redakteur einfügen darf. Wenn Du als Wert dieses Attributs "all" angibst, dann kann der Redakteur sowohl eine URL zu einem webEdition-Dokument als auch eine beliebige URL angeben. Wenn Du als Wert dieses Attributs "int" angibst, dann kann der Redakteur einen URL zu einem webEdition-Dokument angeben. Wenn Du als Wert dieses Attributs "ext" angibst, dann kann der Redakteur eine beliebige URL angeben.

ab Version 1.3.0.0
Typ string
mögliche Werte all, int, ext
Standardwert -
include Pflichtfeld: nein

Wenn Du als Wert dieses Attributs "true" angibst, so wird das webEdition-Dokument eingefügt, auf welches der interne URL zeigt. Das Einfügen (Includieren) von dynamisch generierten webEdition-Seiten ist nicht möglich.

ab Version 1.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
file Pflichtfeld: nein

Setze dieses Attribut auf "true" oder nicht, so können Sie als Linkziel Dateien auswählen. Setze das Attribut auf "false" können keine Dateien als Linkziel festgelegt werden.

ab Version 3.1.0.0
Typ boolean
mögliche Werte true, false
Standardwert true
directory Pflichtfeld: nein

Setzt Du dieses Attribut auf "true" oder nicht, so kannst Du als Linkziel Verzeichnisse auswählen. Setzt Du das Attribut auf "false", können keine Verzeichnisse als Linkziel festgelegt werden.

ab Version 3.1.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
doctypeIDs Pflichtfeld: nein
Gib hier alle IDs der Dokumenttypen an, für die das Tag gilt.
ab Version 9.0.3 (Barrhorn)
Typ number_list
Standardwert 0
reload Pflichtfeld: nein

Setze dieses Attribut auf "true", um nach einer Änderung des Wertes einen Reload der Seite auszuführen. Ist das Attribut auf "false" oder nicht gesetzt, wird kein Reload durchgeführt.

ab Version 3.1.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
user Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert Benutzernamen kommasepariert an, um nur diesen Benutzern Änderungen zu gestatten. Dazu benötigst Du die Benutzerverwaltung.

ab Version 1.3.0.0
Typ string
Standardwert -
cfilter Pflichtfeld: nein
Dieses Attribut gibt an, ob die auf dem Dokument/ Objekt eingestellten Kundenfilter angewendet werden sollen.
ab Version 6.3.0.0
Typ string
mögliche Werte true, false
Standardwert true
rootdir Pflichtfeld: nein

Durch die Angabe dieses Attributes kannst Du das Startverzeichnis für die internen und externen Links wählen. Als Wert für dieses Attribut kann die Id des Verzeichnisses oder der komplette Verzeichnispfad angegeben werden. Wird dieses Attribut nicht gesetzt sind alle Verzeichnisse durchsuchbar.

ab Version 4.0.0.0
Typ number
Standardwert -
to Pflichtfeld: nein

Bestimmt wie / wohin die Ausgabe erfolgt. Dabei wird der Code, der sonst auf der Seite ausgegeben würde, in exakt derselben Weise an die auszuwählende Variable übergeben. Dies ist eine praktische Alternative zu <we:setVar>, bitte vergleiche und entnimm weitere Details zu den einzelnen möglichen Werten dort.

Ab webEdition 6.1.0.2: post, get

Ab webEdition 9.0.8: local: Erlaubt den Wert einer lokalen Variable zuzuordnen und dann im Tag attribut="$name" zu nutzen.

ab Version 6.1.0.0
Typ string
mögliche Werte screen, request, post, get, global, local, session, top, self, sessionfield
Standardwert screen
nameto Pflichtfeld: nein

Name der Variable, in die die Ausgabe erfolgt.

Ab webEdition 6.3.7 können auch Arrays mit folgender Syntax geschrieben werden werden:

  • <we:xxxx to="global" nameto="meinArray[abc]"/> oder
  • <we:xxxx to="global" nameto="meinArray[]"/> oder
  • <we:xxxx to="global" nameto="meinArray[][def]"/>.

Wichtig ist hierbei, dass innerhalb der eckigen Klammern keine Hochkommata oder Anführungszeichen genutzt werden!

ab Version 6.1.0.0
Typ string
Standardwert -
startid Pflichtfeld: nein

Durch dieses Attribut legst Du das Startverzeichnis beim ersten Öffnen des we:href fest.

ab Version 1.3.0.0
Typ number
mögliche Werte 0
Standardwert -
only Pflichtfeld: nein
  • id: liefert die Id des href
  • path: liefert den aktuellen Pfad aus dem System.
ab Version 6.4.0.0
Typ string
mögliche Werte id, path
Standardwert -
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 -
rootdirID Pflichtfeld: nein

Durch die Angabe dieses Attributes kannst Du das Startverzeichnis für die vom Redakteur bei gesetztem Attribut "name" auszuwählenden Dateien wählen. Wird dieses Attribut nicht gesetzt sind alle Verzeichnisse durchsuchbar.

ab Version
Typ number
Standardwert 0

Syntax

<we:href name="" size="" type="all|int|ext" include="true|false" file="true|false" directory="true|false" doctypeIDs="" reload="true|false" user="" cfilter="true|false" rootdir="" to="screen|request|post|get|global|local|session|top|self|sessionfield" nameto="" startid="0" only="id|path" pass_*="" rootdirID=""/>						

Beispiele

Beispiel #1 - Bild auswählen

Code
<we:ifEditmode>
 Datei: <we:href name="meinbild"/><br/>
<we:else/>
 <img src="<we:href name="meinbild"/>"/>
</we:ifEditmode>

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