Integration der Tag-Cloud per XML

Die Begriffe für die Tag-Cloud können per XML-Schnittstelle abgefragt und anschließend in der entsprechenden Seite dargestellt werden.

Um die Begriffe abzufragen, rufen Sie bitte folgende URL auf

$stringEscapeUtils.escapeHtml($body)

Ersetzen Sie den Channel-Namen durch Ihren Channel. Falls Sie nicht die maximale Anzahl der Suchbegriffe anzeigen wollen, können Sie die Rückgabe mit dem Parameter wordCount beschränken. Folgender Aufruf würde nur maximal 30 Begriffe zurückliefern:

$stringEscapeUtils.escapeHtml($body)

Rückgabestruktur

Als Rückgabe der oberen URL erhalten Sie beispielsweise folgende Zeilen:

<tagCloud xsi:noNamespaceSchemaLocation="schema/7.2/fftagcloud.xsd">
  <entry nr="0" weight="0.409583306449226" searchCount="18">buzz</entry>
  <entry nr="1" weight="1.0" searchCount="42">call of duty</entry>
  <entry nr="2" weight="0.3697540052250177" searchCount="17">fallout 3</entry>
  <entry nr="3" weight="0.8527549493124068" searchCount="34">gta</entry>
  <entry nr="4" weight="0.06641433178656121" searchCount="11">harry potter</entry>
  ...
</tagCloud>

entry

In jedem entry-Tag steht ein Begriff der Tag-Cloud. Die einzelnen Attribute des Tags geben Informationen, die zur Darstellung verwendet werden können.

nr

Die fortlaufende Nummerierung der Begriffe in der Tag-Cloud. Die Nummerierung beginnt mit 0.

weight

Die Gewichtung des Begriffes. Aus diesem Wert können Sie z.B. die Schriftgröße des jeweiligen Begriffes festlegen. Es handelt sich hierbei um eine Kommazahl zwischen 0 und 1, wobei der Wert 1 für den wichtigsten Begriff steht.

Die Standardfunktion, die zur Berechnung der Schriftgröße verwendet wird lautet:

fontSize = minFontSize + Math.round((maxFontSize - minFontSize) * weight);

Die Werte für minFontSize und maxFontSize können je nach Geschmack angepasst werden.

searchCount

Anzahl, wie oft nach dem entsprechenden Begriff in dem Zeitraum gesucht wurde.

url

Dieses Attribut wird nur dann zurückgeliefert, wenn das Modul SEO-Enhancer aktiviert ist. Das Attribut enthält in diesem Fall den SEO-Pfad.

Beispiel eines entry-Elements in diesem Fall:

<entry nr="1" weight="1.0" searchCount="42" url="?seoPath=%2Fcall+of+duty%2Fq&channel=channelName">call of duty</entry>