bx:websearch
InhaltDieses Tag ermöglicht die Darstellung von Suchergebnissen der Webseite. Die Suche ist über die Funktionen des Jakarta Lucene Projektes realisiert worden. Das Web muss vorher indiziert worden sein.
Zum Ausklammern von Bereichen aus der Suche verwendet man bx:scanner
Funktionen:
Eingabefeld
<bx:websearch.input />
Es wird geladen…ein Text-Inputfeld erzeugt, welches in Suchformularen verwendet werden kann. Falls schon eine Suche stattgefunden hat, enthält das Feld den Suchtext.
Hauptschleife
<bx:websearch [max="{n}"] [maxparam="{paramname}"] [indexparam="index"]> Inhalt </bx:websearch>
Dieses Tag bildet die Hauptschleife um die Suchergebnisse.
Zur Verwendung im Inhalt stehen die nun folgenden Tags bereit.
Bisher mußte der Blätterparameter „index“ heißen. Und bei den Containerfiltern (Teasern) in der Seite mußte man indexparam auf etwas anderes setzen. Nun kann der Parametername selbst definiert werden.
bx:websearch.previous|next|firstshown|lastshown lesen den neuen Parameter von der bx:websearch-Schleife und verlinken jetzt mit diesen Namen.
| max |
maximale Anzahl an Ausgaben |
| maxparam |
Request-Parameter, der den Zahlenwert für den Überlauf enthält
* (ab Version 2.5.9)* |
| indexparam |
Name des Blätterparameters |
websearch.title
<bx:websearch.title/>
gibt den Titel der Seite (
<ins class="diffmod"> HTML-Tag) oder, falls dieser nicht existiert, "<ohne Titel>" aus
</ins><h2 id="bkmrk-websearch.rank"><ins class="diffmod">websearch.rank</ins></h2><ins class="diffmod">
</ins><pre><code class="language-xml"><ins class="diffmod"><bx:websearch.rank/>
</ins></code></pre><ins class="diffmod">
</ins><p><ins class="diffmod">Rangfolge des Ergebnisses, beginnend mit 1</ins></p><ins class="diffmod">
</ins><pre><code><ins class="diffmod">
</ins></code></pre><ins class="diffmod">
</ins><h2 id="bkmrk-websearch.score"><ins class="diffmod">websearch.score</ins></h2><ins class="diffmod">
</ins><pre><code class="language-xml"><ins class="diffmod"><bx:websearch.score/>
</ins></code></pre><ins class="diffmod">
</ins><p><ins class="diffmod">die Wertung des Suchergebnisses als Gleitkommazahl</ins></p><ins class="diffmod">
</ins><h2 id="bkmrk-websearch.relevanz"><ins class="diffmod">websearch.relevanz</ins></h2><ins class="diffmod">
</ins><pre><code class="language-xml"><ins class="diffmod"><bx:websearch.relevanz/>
</ins></code></pre><ins class="diffmod">
</ins><p><ins class="diffmod">eine Wertung des Ergebnisses als Ganzzahl mit Prozentzeichen</ins></p><ins class="diffmod">
</ins><h2 id="bkmrk-websearch.stars"><ins class="diffmod">websearch.stars</ins></h2><ins class="diffmod">
</ins><pre><code class="language-xml"><ins class="diffmod"><bx:websearch.stars [max="<n>"]> Inhalt </bx:websearch.stars>
</ins></code></pre><ins class="diffmod">
</ins><p><ins class="diffmod">Symbole als Relevanzanzeige ausgeben</ins></p><ins class="diffmod">
</ins><table><ins class="diffmod">
</ins><thead><ins class="diffmod">
</ins><tr><ins class="diffmod">
</ins><th><ins class="diffmod">max</ins></th><ins class="diffmod">
</ins><th><ins class="diffmod">maximale Anzahl an Symbolen (Standard: 5)</ins><br><ins class="diffmod">Der Inhalt bestimmt das Symbol, er kann z.B. ein</ins><br><a href="http://wiki.batix.net/index.php/Bx:bild" target="_blank"><ins class="diffmod">bx:bild</ins></a><br><ins class="diffmod">-Tag enthalten</ins></th><ins class="diffmod">
</ins></tr><ins class="diffmod">
</ins></thead><ins class="diffmod">
</ins></table><ins class="diffmod">
</ins><h2 id="bkmrk-websearch.link"><ins class="diffmod">websearch.link</ins></h2><ins class="diffmod">
</ins><pre><code class="language-xml"><ins class="diffmod"><bx:websearch.link> Inhalt </bx:websearch.link>
<bx:websearch.link />
</ins></code></pre><ins class="diffmod">
</ins><p><ins class="diffmod">verlinkt den Inhalt mit der Fundstelle. Als geschlossenes Tag wird die URL verlinkt </ins><em><ins class="diffmod">(ab Version 2.5.9)</ins></em></p>
<h2 id="bkmrk-websearch.url"><ins class="diffins">websearch.url</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.url/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">gibt die URL der Fundstelle an. </ins><em><ins class="diffins">ab Version 2.5.8</ins></em></p><ins class="diffins">
</ins><h2 id="bkmrk-websearch.path"><ins class="diffins">websearch.path</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.path/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">gibt den Pfad zur Fundstelle an. Es handelt sich um die URL, deren Hostname abgeschnitten wurde. </ins><em><ins class="diffins">ab Version 2.5.9</ins></em></p><ins class="diffins">
</ins><h2 id="bkmrk-websearch.descriptio"><ins class="diffins">websearch.description</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.description/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">die Beschreibung des Dokuments (HTML </ins><meta><ins class="diffins"> Wert "description")</ins></p><ins class="diffins">
</ins><pre><code><ins class="diffins">
</ins></code></pre><ins class="diffins">
</ins><h2 id="bkmrk-websearch.navname"><ins class="diffins">websearch.navname</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.navname/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">der Name des entsprechenden Navigationspunktes</ins></p><ins class="diffins">
</ins><h2 id="bkmrk-websearch.navid"><ins class="diffins">websearch.navid</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.navid/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">die ID des entsprechenden Navigationspunktes</ins></p><ins class="diffins">
</ins><h2 id="bkmrk-websearch.previous"><ins class="diffins">websearch.previous</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.previous [hide] [url="{link}"] />
<bx:websearch.previous [hide] [url="{link}"]> Linktext </bx:websearch.previous>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">(steht außerhalb der Schleife) einen Link zur vorigen Ergebnisseite generieren</ins></p><ins class="diffins">
</ins><table><ins class="diffins">
</ins><thead><ins class="diffins">
</ins><tr><ins class="diffins">
</ins><th><ins class="diffins">hide</ins></th><ins class="diffins">
</ins><th><ins class="diffins">es wird nichts ausgegeben wird, wenn es keine nächste Seite gibt</ins></th><ins class="diffins">
</ins></tr><ins class="diffins">
</ins></thead><ins class="diffins">
</ins><tbody><ins class="diffins">
</ins><tr><ins class="diffins">
</ins><td><ins class="diffins">url</ins></td><ins class="diffins">
</ins><td><ins class="diffins">Ziel-Dateiname festlegen (Standard ist die aktuelle Seite)</ins></td><ins class="diffins">
</ins></tr><ins class="diffins">
</ins><tr><ins class="diffins">
</ins><td><ins class="diffins">Linktext</ins></td><ins class="diffins">
</ins><td><ins class="diffins">Ein Linktext kann als Tag-Inhalt angegeben werden (Standard: "weiter >>").</ins></td><ins class="diffins">
</ins></tr><ins class="diffins">
</ins></tbody><ins class="diffins">
</ins></table><ins class="diffins">
</ins><h2 id="bkmrk-websearch.next"><ins class="diffins">websearch.next</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.next [hide] [url="{link}"] />
<bx:websearch.next [hide] [url="{link}"]> Linktext </bx:websearch.next>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">(steht außerhalb der Schleife) einen Link zur nächsten Ergebnisseite generieren
</ins><strong><ins class="diffins">Parameter: siehe unter websearch.previous</ins></strong></p><ins class="diffins">
</ins><h2 id="bkmrk-websearch.totalhits"><ins class="diffins">websearch.totalhits</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.totalhits/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">(steht außerhalb der Schleife) Gesamtzahl der Ergebnisse</ins></p><ins class="diffins">
</ins><h2 id="bkmrk-websearch.firstshown"><ins class="diffins">websearch.firstshown</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.firstshown/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">(steht außerhalb der Schleife) Nummer des ersten Ergebnisses auf der Seite</ins></p><ins class="diffins">
</ins><h2 id="bkmrk-websearch.lastshown"><ins class="diffins">websearch.lastshown</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.lastshown/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">(steht außerhalb der Schleife) Nummer des letzten Ergebnisses auf der Seite</ins></p><ins class="diffins">
</ins><h2 id="bkmrk-websearch.query"><ins class="diffins">websearch.query</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.query encode="typ"/>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">(steht außerhalb der Schleife) der Begriff/Text, nach dem gesucht wurde</ins></p><ins class="diffins">
</ins><table><ins class="diffins">
</ins><thead><ins class="diffins">
</ins><tr><ins class="diffins">
</ins><th><ins class="diffins">encode</ins></th><ins class="diffins">
</ins><th><ins class="diffins">Hiermit kann der ausgegebene Text für verschiedene Formate kodiert werden:</ins><br><ins class="diffins">- html - javascript - sql (zur Verwendung in SQL für Strings) - sql-like (zur Verwendung in SQL mit LIKE) - sql-rlike (zur Verwendung in SQL mit RLIKE und REGEXP) - url - xml</ins></th><ins class="diffins">
</ins></tr><ins class="diffins">
</ins></thead><ins class="diffins">
</ins></table><ins class="diffins">
</ins><h2 id="bkmrk-websearch.if"><ins class="diffins">websearch.if</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.if [not] [empty | scrollable | morethan="<n>" | lessthan="<n>"] > Inhalt </bx:websearch.if>
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">(steht außerhalb der Schleife) zeigt Inhalt nur unter bestimmten Bedingungen an. Nur, wenn Suche bereits stattgefunden hat:
(Falls keiner der vier Parameter angegeben wurde, erfolgt die Ausgabe nur, wenn bereits eine Suche erfolgt ist (oder auch nich, bei </ins><code><ins class="diffins">not</ins></code><ins class="diffins">). )</ins></p><ins class="diffins">
</ins><table><ins class="diffins">
</ins><thead><ins class="diffins">
</ins><tr><ins class="diffins">
</ins><th><ins class="diffins">empty</ins></th><ins class="diffins">
</ins><th><ins class="diffins">es wurden keine Suchergebnisse gefunden</ins><br><ins class="diffins">darf auch innerhalb der Schleife verwendet werden. Um das Gegenteil abzufragen, wird</ins><br><code><ins class="diffins">not</ins></code><br><ins class="diffins">verwendet.</ins></th><ins class="diffins">
</ins></tr><ins class="diffins">
</ins></thead><ins class="diffins">
</ins><tbody><ins class="diffins">
</ins><tr><ins class="diffins">
</ins><td><ins class="diffins">scrollable</ins></td><ins class="diffins">
</ins><td><ins class="diffins">es sind mehr Seiten vorhanden (Anzahl Ergebnisse ></ins><br><code><ins class="diffins">max</ins></code><br><ins class="diffins">)</ins></td><ins class="diffins">
</ins></tr><ins class="diffins">
</ins><tr><ins class="diffins">
</ins><td><ins class="diffins">morethan</ins><br><ins class="diffins">lessthan</ins></td><ins class="diffins">
</ins><td><ins class="diffins">es wurden mehr als</ins><br><code><ins class="diffins"><n></ins></code><br><ins class="diffins">Ergebnisse gefunden</ins><br><ins class="diffins">es wurden weniger als</ins><br><code><ins class="diffins"><n></ins></code><br><ins class="diffins">Ergebnisse gefunden</ins></td><ins class="diffins">
</ins></tr><ins class="diffins">
</ins></tbody><ins class="diffins">
</ins></table><ins class="diffins">
</ins><h2 id="bkmrk-eingabefeld-1"><ins class="diffins">Eingabefeld</ins></h2><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:websearch.input />
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">Es wird ein Text-Inputfeld erzeugt, welches in Suchformularen verwendet werden kann. Falls schon eine Suche stattgefunden hat, enthält das Feld den Suchtext.</ins></p><ins class="diffins">
</ins><h3 id="bkmrk-beispiele"><ins class="diffins">Beispiele</ins></h3><ins class="diffins">
</ins><p><strong><ins class="diffins">Beispiel Titel</ins></strong></p><ins class="diffins">
</ins><pre><code class="language-xml"><ins class="diffins"><bx:tag.feature param="value" />
</ins></code></pre><ins class="diffins">
</ins><p><ins class="diffins">Weitere Beispiele unter </ins><a href="/books/cms-handbuch-entwickler/page/websuche"><ins class="diffins">Snippets/Websuche</ins></a><ins class="diffins">.</ins></p><ins class="diffins">
</ins>
