{{indexmenu_n>310}}

====== Suche ======

Der CP Suche ist eine einfache Lösung um FE-Benutzern das Suchen auf der gesamte Seite oder einzelnen Seitenbereichen zu ermöglichen. \\
Einzelne Artikel können in deren Kopfelement für die Suchfunktion als unsichtbar markiert werden. 

Docu: [[http://www.phpwcms-docu.de/content_part_suche.phtml]]

Forum: [[http://forum.phpwcms.org/viewtopic.php?t=20375]] \\
Forum: [[http://forum.phpwcms.org/viewtopic.php?t=13858]]


Dabei gibt der CP zunächst nur ein Suchformular aus. Nach der Suche gibt der gleiche CP das Suchformular und die Ergebnisse aus.

==== Vorgehensweise: ====
  * CP einfügen
  * Anzahl der Treffer je Seite eintragen
  * zu durchsuchende Seitenbereiche markieren (Mehrfachauswahl möglich)
  * Suchformular-Texte anpassen
  * ggf. Suchnavi einstellen. 


==== Suchnavi: ====

Mit Hilfe der Suchnavi lassen sich die Suchergebnisse paginieren. Dafür stehen verschiedene Tags zur Verfügung, die in der Suchnavi kombiniert werden können.


   * **{PREV:Zurück}**: Link zur vorherigen Seite mit Suchergebnissen
   * **Seite #/##**: gibt an, welche Seite der Suchergebnisse angezeigt wird
   * **Ergebnis #**#**#-#**#**#**: gibt an, welche der gefundenen Treffer angezeigt werden
   * **{NAVI:123}**: gibt Links auf die einzelnen Seiten mit Suchergebnissen aus
   * **{NAVI:1-3}**: gibt ebenfalls Links auf die einzelnen Seiten mit Suchergebnissen aus, jedoch als Nummer der Treffer
   * **{NEXT:Vorwärts}**: Link zur nächsten Seite mit Suchergebnissen

Beispiel: Eine Suche gibt 10 Trefferseiten aus, es werden 2 Treffer je Seite angezeigt.\\
  {PREV:<< Zurück} | Seite # von **#**# | Ergebnis #**#**#-#**#**# | {NAVI:1-3} | {NEXT:Vorwärts >>}\\
ergibt\\
 << Zurück | Seite 1 von 5 | Ergebnis 1-2 | 1 2 3 4 5 | Vorwärts >>\\
\\
  {PREV:<< Zurück} | Seite # von **#**# | Ergebnis #**#**#-#**#**# | {NAVI:123} | {NEXT:Vorwärts >>}\\
ergibt\\
 << Zurück | Seite 1 von 5 | Ergebnis 1-2 | 1-2 3-4 5-6 7-8 9-10 | Vorwärts >>\\

==== Suchformular im Template ====
Soll ein Suchformular im Webseiten-Template vorgesehen werden, ist für die Ergebnisseite zunächst ein Artikel mit einem CP "Suche" einzurichten. Dessen URL im FE lautet z.B. http://www.example.com/index.php?seachpage. Im Template wird an geeigneter Stelle ein Formular eingebaut, dessen "action"-Eigenschaft auf die Surch-URL zeigt. Zum Beispiel:
  <div class="searchbox">
      <form method="post" id="searchform" action="/index.php?searchpage">
          <label for="s">Suche:</label>
          <input id="search_input_field" type="text" value="" maxlength="200" size="14" >
          <input id="search_submit_button" type="submit" value="Los" name="submit">
      </form>
  </div>

Auf den Submit-Button kann auch komplett verzichtet werden, die Suche startet dann nach Betätigen der Eingabe-Taste.

==== Aufforderungstext Anzeigen/Ausblenden ====
Soll der Benutzer per Text im Suchfeld zum Nutzen der Suchfunktion aufgefordert werden, lässt sich das Eingabefeld mit Javascript-Eigenschaften austatten:
  <input id="search_input_field" type="text" value="suchen ..." maxlength="200" size="14" name="search_input_field" onfocus="if(this.value==this.defaultValue) this.value='';" onblur="if(this.value=='') this.value=this.defaultValue;">