Schnipselmerkliste

Aufgaben der Schnipselmerkliste

Die Schnipselmerkliste ermöglicht es einem Nutzer sich Schnipsel einer anderen Area zu merken. Diese Merkliste ist nutzerspezifisch, kann allerdings auch öffentlich für den Gast-Nutzer verwendet werden.

Die Inhalte erscheinen in der Merkliste genauso wie im Original. Es wird keine Kopie der Inhalte erzeugt, sondern es werden immer die Originalinhalte angezeigt.

Ausgabe der Merkliste

Die Merkliste für einen Nutzer wird einfach mit dem Tag <ty:area noticelist=„true“/> ausgegeben. Mit dem Parameter shortlist=„true“ können gekürzte Schnipsel ausgegeben werden. Der Bereich im Schnipsel, welcher in der kurzen Liste nicht ausgegeben werden soll, muss mit dem Tag <ty-area:longversion> markiert sein (siehe Funktionen im Schnipsel). Der Parameter id ist bei der Merkliste optional, wird er nicht gesetzt wird als id der Wert default gesetzt. Die Verwendung einer id macht Sinn, wenn man mehrere Merklisten auf einer Webseite einsetzen möchte. Schnipsel sollte man dieser Area nicht zuweisen - tut man es trotzdem, werden sie einfach nicht ausgegeben.

Beispiele:

<ty:area noticelist="true"/> 
<ty:area noticelist="true" shortlist="true"/> 
<ty:area noticelist="true" shortlist="true" id="merkliste2"/>

Hinzufügen / Entfernen von der Merkliste

Mit folgendem Code werden zwei Buttons ausgegeben, einer zum Hinzufügen und einer zum Entfernen von der Merkliste. Das Tag <ty-area:snippetRelId/> gibt die ID des Schnipsel zurück, in dem man sich gerade befindet. Die Werte können auch alle in einem Link via GET übergeben werden. Der Wert listname ist optional, wird er nicht angegeben wird der Wert default angenommen.

Beispiel:

<form method="post" action="">  
<input type="hidden" name="listname" value="default"/>    
<input type="hidden" name="snippetid" value="<ty-area:snippetRelId/>"/>     
<input type="submit" name="addtonoticelist" value="aufdiemerkliste"/>     
<input type="submit" name="delfromnoticelist" value="löschenvondermerkliste"/> 
</form>

Beispiel 2:

<a href="IrgendeineSeiteMitRequesthandlern.html?addtonoticelist=true&snippetid=&lt;ty-area:snippetRelId/&gt;">Auf die Liste</a>

Funktionen im Schnipsel

Alle Tags können nur in einem Schnipsel innerhalb einer Area verwendet werden.

<ty-area:longversion>

Mit diesem Tag kann der Bereich markiert werden, der in der gekürzte Merkliste nicht erscheint.

Beispiel:

<h1>Schnipsel über PHP</h1> 
<ty-area:longversion><p>Langer Text</p></ty-area:longversion>

In einer kurzen Merkliste mit diesem Schnipsel wird nur die Überschrift angezeigt.

<ty-area:isnl> / <ty-area:isnonl>

Die Tags dienen zur Abfrage ob man sich gerade in einer Merkliste befindet oder nicht. Der Bereich innerhalb von <ty-area:isnl> wird nur ausgegeben, wenn man sich gerade in einer Merkliste befindet, <ty-area:isnonl> ist das entsprechende Gegenstück.

Beispiel:

<ty-area:isnl>Ich befinde mich in einer Merkliste</ty-area:isnl> 
<ty-area:isnonl>Ich befinde mich in einer normalen Area</ty-area:isnonl>

<ty-area:alreadyaddedtonl> / <ty-area:notyetonnl>

Mit diesem Tag kann abgefragt werden, ob der Nutzer das aktuelle Schnipsel schon auf einer Merkliste vermerkt hat oder nicht. Der Inhalt wird sowohl in Merkliste als auch in normalen Areas ausgegeben. Sinnvoll für Buttons zum Hinzufügen/Entfernen.

Beispiel:

<form method="post" action="">    
<input type="hidden" name="snippetid" value="<ty-area:snippetRelId/>"/>     
<ty-area:notyetonnl><input type="submit" name="addtonoticelist" 
value="aufdiemerkliste"/></ty-area:notyetonnl>         
<ty-area:alreadyaddedtonl><input type="submit" name="delfromnoticelist" 
value="löschenvondermerkliste"/></ty-area:alreadyaddedtonl> </form>

Hier wird ein Hinzufügen Button ausgegeben, wenn der Nutzer den Schnipsel noch nicht vermerkt hat und ein Löschen Button, falls der Schnipsel sich schon auf einer Merkliste befindet.

Komplexes Beispiel

Hier ein Beispiel, wie ein Snippet für die Merkliste aussehen könnte:

<ty:content id="text">Der TEXT</ty:content> 
<ty:siteroles mode="loggedin"> 
<form method="post" action=""> 
<input type="hidden" name="snippetid" value="<ty-area:snippetRelId/>"/> 
<ty-area:notyetonnl><input type="submit" name="addtonoticelist" 
value="aufdiemerkliste"/></ty-area:notyetonnl> 
<ty-area:alreadyaddedtonl>
<input type="submit" name="delfromnoticelist" value="löschenvondermerkliste"/>
</ty-area:alreadyaddedtonl> </form> 
</ty:siteroles> 
<ty-area:isnonl>Text der nicht in der Merkliste auftaucht</ty-area:isnonl> 
<ty-area:longversion>
Langer Text der nur in der langen Version ausgegeben wird</ty-area:longversion>