Wird aufgerufen, wenn ein Benutzer die Such-Funktion in
seinem Account verwendet. In $query wird der Suchbegriff übergeben.
Die Funktion muss ein Array mit Such-Kategorien und
enthaltenen Ergebnissen zurückliefern, dass folgendes Format aufweist:
Quellcode
Darstellung:
Array
(
[0] => Array
(
[title] => Kategorie-Titel
[name] => Bezeichner/Name der Kategorie (wie auch in GetSearchCategories() verwendet)
[icon] => Kategorie-Symbol im images/li/-Verzeichnis (.png wird automatisch angehängt)
[results] => Array
(
[0] => Array
(
[icon] => Ergebnis-Symbol im images/li/-Verzeichnis (.png wird automatisch angehängt)
[title] => Ergebnis-Titel
[link] => Ergebnis-Link (&sid=[session-id] wird automatisch angehängt)
[date] => Datum des Ergebnisses, falls sinnvoll
[size] => Größe des Ergebnisses, falls sinnvoll
[id] => ID des Ergebnisses (wird z.B. an HandleSearchMassAction() übergeben)
[bold] => true, wenn Ergebnis fett dargestellt werden soll
[strike] => true, wenn Ergebnis durchgestrichen werden soll
)
...
)
[massActions] => Array
(
[aktionname] => Aktion-Titel, z.B.:
[delete] => Löschen
...
)
)
...
)
Blau dargestellte Elemente wurden in b1gMail 7.2 eingeführt
und werden von älteren Versionen ignoriert.
Falls kein Datum (date) oder keine Größe (size) oder keine
ID (id) zu einem Eintrag angegeben werden können (z.B. weil eine solche Angabe
für den Ergebnistyp nicht sinnvoll ist), wird der entsprechende Wert im Array
einfach nicht gesetzt.
Wird kein Ergebnis erzielt, muss ein leeres Array
zurückgegeben werden.