NGG Smart Image Search (Intelligente Bildersuche)

FAQ

Wie funktioniert eine Suche?

Es gibt drei Möglichkeiten, um eine Suche nach Bildern durchzuführen:

(1) über ein dynamisches Suchfeld in einem Widget.
Das Plugin stellt ein Widget ‚NGG Smart Image Search‘ zr Verfügung. Dieses Widget stellt ein Suchfeld bereit, dass in der Seitenleiste oder einem entsprechenden Bereich im Footer oder Header angezeigt wird. Texteingabe in dieses Feld sendet die Eingabe einschließlich vordefinierter Sucheinstellungen an die automatisch generierte Suchergebnis-Anzeigeseite. Diese Suchergebnis-Anzeigeseite wird auf der Einstellungsseite des Plugins beschrieben. Man kann diese Suchergebnisseite frei an eigene Vorstellungen anpassen.
Die Suchergebnisseite verwendet den Shortcode [hr_SIS_display_images], um die Suche durchzuführen und das Ergebnis anzuzeigen.

(2) über ein dynamisches Suchfeld, das vom Shortcode [hr_SIS_nextgen_searchbox] bereit gestellt wird.
Dieses Shortcode Suchfeld kann auf jeder beliebigen Seite oder Beitrag eingefügt werden (auch auf der automatisch generierten Suchergebnisseite).
Bei Texteingabe in diesem Suchfeld wird die Eingabe einschließlich vordefinierter Sucheinstellungen an den Shortcode [hr_SIS_display_images] weitergereicht, der sich auf der gleichen Seite befinden muss. Ansonsten würde kein Suchergebnis angezeigt werden können. Der Shortcode [hr_SIS_display_images] führt die Suche durch und zeigt das Ergebnis an.

(3) über eine vordefinierte statische Suchabfrage, deren Suchtext als Parameter zum Shortcode [hr_SIS_display_images] eingegeben wird.

In diesem Fall zeigt der Shortcode [hr_SIS_display_images] nur das Ergebnis der statischen Suchabfrage an und ignoriert alle anderen dynamischen Sucheingaben.

Wie kann eine Suche angepasst werden?

Man kann den Suchbereich für eine Bildersuche frei wählen. Dazu listet man eine beliebige Anzahl von ein- oder ausgeschlossenen Galerien und/oder Alben.
Man kann auch die Liste der Metadatenfelder angeben, in denen nach dem Suchtext gesucht werden soll.

Man kann dies getrennt für öfentliche Benutzer und für angemeldete Benutzer durchführen.

Wenn dies über das Such-Widget erfolgt, kann man getrennte Widgets für öffentliche Besucher und für angemeldete Benutzer definieren. Benutzer sehen nur das Suchfeld des für sie relevanten Widgets.

Wenn man einen Suchfeld-Shortcode [hr_SIS_nextgen_searchbox] verwendet, gibt man seine Sucheinstellungen über Parameter an (siehe screenshots für eine vollständige Liste der Parameter).
Die Parameter werden dabei per Default unterschiedlich für öffentliche Benutzer und für angemeldete Benutzer definiert (siehe entsprechende screenshots).
Man kann diese Default-Einstellungen durch explizite Angabe der Parameter im Shortcode überschreiben.
Z.B. listet der Parameter list_descr=1 die Bildbeschreibungen in der Ergebnisliste für alle Benutzer. Wenn man dies nur für öffentliche Benutzer definieren möchte, verwendet man den Präfix ‚pu_‘ für den Parameternamen, z.B. pu_list_desr=1. Wenn man dies nur für angemeldete Benutzer definieren möchte, verwendet man analg den Präfix ‚lo_‘, z.B. lo_list_descr=1.

Wie kann die Suchergebnisliste angepasst werden?

Die Suchergebnisliste wird vom Shortcode [hr_SIS_display_images] erzeugt. Dieser Shortcode akzeptiert einen display Parameter zur Auswahl der Anzeigeart für die Ergebnisanzeige.
Es sind mehrere Anzeigearten verfügbar:

(1) verwende eine beliebige NextGEN Galerie
Der einfachste Weg zur Verwendung einer NextGEN Galerieanzeige für das Suchergebnis ist es, zuerst eine Anzeige für eine beliebige NextGEN Galerie auf einem Beitrag oder einer Seite zu definieren. Dann wechselt man im Editor in den Textmodus und ersetzt den generierten Shortcode Namen ’ngg‘ durch ‚hr_SIS_display_images‘. Dieser Shortcode Name wird durch das plugin NGG Smart Image Search zur Verfügung gestellt. Dieser Shortcode generiert die Suchergebnisliste. Er ruft dann dynamisch den NextGEN Galerie Shortcode auf und übergibt diesem alle benötigten Parameter.
Man kann folgende Kurzformen zur Anzeigedefinition nutzen:

• display=’bt‘ (für eine Basic Thumbnail gallery)
• display=’pt‘ (für eine Pro Thumbnail Galerie)
• display=’ma‘ (für eine Pro Masonry Galerie)
• display=’mo‘ (für eine Pro Mosaic Galerie)

(2) display=“si“ oder display=“ngg_single_images“

Dies generiert eine detaillierte Ansicht der Suchergebnisbilder in Tabellenform mit beschreibenden Metadatenfeldern.
Die Bilder werden mit Hilfe des originalen NextGEN Gallery Shortcodes zur Einzelbidanzeige dargestellt.
Durch Klicken auf das Bild wird dieses in einer Lightbox entsprechend den Einstellungen auf der NextGEN Einstellungseite angezeigt. Es wird jeweils nur dieses eine Bild angezeigt. Es kann in der Lightbox nicht zum nächsten Bild übergegangen werden.

(3) display=“li“ oder display=“linked_images“

Dies zeigt die gleiche Ergebnisliste wie bei Anzeigeart (1) an.
Allerdings können hier alle Bilder in der Lightbox jetzt nacheinander angezeigt werden. Für diese Option muss die NextGEN Standard Lightbox auf der NextGEN Galerie Einstellungsseite so konfiguriert werden, dass sie auch für alle anderen verlinkten Bilder verwendet werden soll.

(4) display=“at“ oder display=“advanced_thumbnails“

Dies erzeugt ein Raster von proportionalen Vorschaubilder für das Suchergebnis. Zusätzlich wird zu jedem Vorschaubild der Bildtitel angezeigt. Die Ergenisliste besteht aus verlinkten Bildern. Wie für die Anzeigeart (2) sollte NextGEN Gallery so konfiguriert sein, dass die vorkonfigurierte Standard NextGEN Lightbox auch für alle anderen verlinkten Builder verwendet wird.

Zusätzlich kann man noch weitere Parameter angeben um die Ansicht der Suchergebnisliste festzulegen.Man kann eine Sortierreihenfolge angeben, eine Seitennummerierung und eine Begrenzung der Bildanzahl.

Welche Suchzeichenketten können eingegeben werden?

Man kann jeden sinnvollen Text eingeben.

Im Basis-Suchmodus ermittelt das Plugin zuerst alle Suchbegriffe in der Suchzeichenkette, die durch Leerzeichen getrennt sind. Es sucht dann nach allen Bildern, welche zumindest einen der Suchbegriffe in ausgewählten Meta-Datenfelder enthalten (im Sinne einer logischen ODER-Verknüpfung).

Im erweiterten Suchmodus interpretiert das Plugin die Suchzeichenkette unterschiedlich. Nun wird der ganze Text, einschließlich eingegebener Leerzeichen, für die Suche verwendet, es sei denn, er enthält vordefinierte Sonderzeichen.Diese Sonderzeichen unterteilen den Text wieder in separate Suchzeichenketten.

Für angemeldete Benutzer oder für statische Suchabfragen ist eine spezielle Such-Option verfügbar: g:<gallery id>.
Dies führt alle Bilder der Galerie mit ID g:<gallery id> auf.
Die Ergebisliste führt auch den Galerienamen und die Galerie ID auf mit unterlegten Links auf die entsprechenden Galerieseiten im Backend (Verwaltungsansicht) oder Frontend (wenn solch eine Seite mit der Galerie verlinkt ist).

Es sind weitere Suchoptionen verfügbar wie r:<nummer> zur Suche der neuesten Bilder oder l:<nummer> Zur Suche der zuletzt0 images.
Man kann auch mehrere Suchbegriffe auf einmal suchen wie „Sonne & Wolken& Urlaub“. Dies sucht nach allen Bildern, die alle drei Suchbedingungen gleichzeitig erfüllen
You can negate searchstrings by „&- searchstring“.
Man kann auch Suchbegriffe auf einzelne Metadaten Felder einschränken wie „&t Sonne &t Wolken“. Hier wird nur in den Schlagworten (tags) gesucht.

Eine Suchzeichenkette kann mit einem Escape Zeichen +/- beginnen um zwischen dem Basis-Suchmodus und dem erweiterten Suchmodus hin und her zu schalten. Die Suchzeichenkette kann mit einer Escape Option abschließen um den Anzeigemodus dynamisch zu ändern.

Für eine ausführlichere Dokumentation siehe qualified search examples.