Inhaltsverzeichnis 1 Beschreibung 2 Verwendung 3 Standardverwendung 4 Parameter 5 Spezial Anwendung 6 Ähnliches

[bearbeiten] Beschreibung

Dieser Template Tag kann ab WordPress 2.3 für die integrierte Taggingfunktion genutzt werden und zeigt eine Tagcloud an. Die Funktion kann auch außerhalb des Loops benutzt werden.

Die Tags werden verlinkt ausgegeben und führen zum jeweiligen Tag-Archiv (im Sinne von tagging; nicht der Wochentag). Je nach Häufigkeit der Verwendung des Tags wird er größer relativ zu anderen Tags ausgegeben.

[bearbeiten] Verwendung

<?php wp_tag_cloud('arguments'); ?>

[bearbeiten] Standardverwendung

<?php wp_tag_cloud(); ?>

Das Ergibt dann z.B. folgende Ausgabe:

<a href='http://example.org/?tag=tag1' class='tag-link-5' title='1 topics' style='font-size: 8pt;'>Tag1</a>
<a href='http://example.org/?tag=tag2' class='tag-link-6' title='1 topics' style='font-size: 12pt;'>Tag2</a>
<a href='http://example.org/?tag=tag3' class='tag-link-3' title='2 topics' style='font-size: 22pt;'>Tag3</a>

In der Standardverwendung werden alle default Werte verwendet, was folgender Anwendung mit allen Parametern entspricht:

<?php wp_tag_cloud('smallest=8&largest=22&unit=pt&number=45&format=flat&orderby=name&order=ASC&exclude=&include='); ?>

Dieses führt ebenso zu oben stehender Ausgabe.

[bearbeiten] Parameter

smallest 

(integer) Kleinste Schriftgröße für den am wenigsten verwendeten Tag. Standardwert: 8

largest 

(intger) Größte Schriftgröße für den am meisten verwendeten Tag. Standardwert: 22

unit

(string) Einheit für die Schriftgröße.

• pt (Standard)
• px
• em
• ex

number

(integer) Maximale Anzahl an gezeigten Tags. Standardwert: 45

format

(string) Ausgabeart für Wolke.

• flat (Standard)
• list
• array

orderby

(string) Ordnungsschema; Nach Name oder Anzahl der Beiträge.

• name (Standard)
• count

order

(string) Sortierschema; Aufsteigend oder Absteigend.

• ASC (Standard)
• DESC
• RAND Zufällige Reihenfolge (ab Version 2.5)

exclude

(string) Tags die nicht angezeigt werden sollen. Es müssen die Tag-IDs, von einem Komma (ohne Leerzeichen) getrennt, in aufsteigender Reihenfolge angegeben werden.

include

(string) Nur diese Tags sollen angezeigt werden. Es müssen die Tag-IDs, von einem Komma (ohne Leerzeichen) getrennt, in aufsteigender Reihenfolge angegeben werden.

[bearbeiten] Spezial Anwendung

Sicherlich lassen sich die Tags auch als Text ohne Link ausgeben.

<?php $tag = wp_tag_cloud('format=array' ); ?>
<?php while (list (, $value) = each ($tag)) { echo strip_tags($value).", ";	} ?>"

Zuerst wird die Cloud in ein Array gelegt, um dieses weiter bearbeiten zu können. Im zweiten Schritt, wird dieses Array Schritt für Schritt durchgegangen und der HTML Code gelöscht und ausgegeben. Natürlich kann man damit auch andere Dinge dann machen. z.B. Highlighting auf der Homepage der Wörter.

[bearbeiten] Ähnliches

wp_list_categories
the_tags
get_the_tag_list