CB_TEMPLATE: sv

Mit dem Parameter sv (=search value) kann man bei Listen-Templates die Treffer filtern.

Mit dem "sv" Parameter (="search value") ist es möglich in Listen-Templates die Treffer zu filtern. Als Suchkriterium wird ein Array mit dem Feldname(n) und Wert angegeben.

Dem Wert voraus geht das doppelte Prozent-Zeichen %% das in der Abfrage automatisch ersetzt wird. Es handelt sich um eine SQL-Syntax, diese muss immer so aufgebaut sein.

Beispiel: Feld muss exakt WERT enthalten

  1. %%  = 'WERT'

Beispiel: Feld darf nicht WERT enthalten

  1. %% != 'WERT'

Beispiel: Feld muss mit WERT beginnen

  1. %% LIKE 'WERT%'

Beispiel: Inhalt des Feldes muss >=2 und kleiner als 10 sein

  1. %% >= 2 AND %% < 10

Es ist dringend anzuraten die Daten nicht einfach ohne Prüfung in dem Array einzufügen. Wir empfehlen die Daten mittels mysql_real_escape_string() zu säubern!

Beispiel:

  1. <?php
  2. $value = mysql_real_escape_string(WERT);
  3.  
  4. CB_TEMPLATE(array(
  5.   "template" => "listentemplate",
  6.   "query"    => "abfrage",
  7.   "sv"       => array("feldname" => "%% = '". $value ."'")
  8. ));
  9. ?>

Im folgenden finden Sie zwei Beispiele wie das in einer fertigen Abfrage aussehen würde.

Bsp. 1: Alle Artikel unterhalb des Artikel mit ID 10

  1. <?php
  2. CB_TEMPLATE(array(
  3.   "template" => "listentemplate",
  4.   "query"    => "abfrage",
  5.   "sv"       => array("cms_parent.id" => "%% = 10")
  6. ));
  7. ?>

Bsp. 2: Alle Artikel unterhalb des Artikel mit ID 10 und dem Titel "test" oder "hilfe".

  1. <?php
  2. CB_TEMPLATE(array(
  3.   "template" => "listentemplate",
  4.   "query"    => "abfrage",
  5.   "sv"       => array("cms_parent.id" => "%% = 10",
  6.                       "title"         => "%% = 'test' OR
  7.                                           %% = 'hilfe'")
  8. ));
  9. ?>

Sag' deine Meinung! Nichts gegen kurze Einschätzungen. Floskeln wie "sieht aus, als wärs vom Praktikanten" oder "Griff ins Klo" sollten allerdings im Sinne einer sachlich geführten Diskussion vermieden werden.




Kommentar:



Funktionsreferenz Neueste Blog-Artikel


Blog-Archiv Twitter

Folgt @cubecms auf Twitter und bleibt immer auf dem Laufenden was CUBE angeht. Hashtag: #cubecms