Das Modul "Search" stellt die ConPresso-Suchfunktion bereit. Dabei findet dieses Modul sowohl im ConPresso-Backend als auch im ConPresso-Frontend Verwendung.
Redaktionell arbeitenden Benutzern stellt das Modul im Backend eine umfangreiche Recherchemöglichkeit nach Artikeln bereit, über die gezielt nach Inhalten gesucht werden kann. Im Frontend haben Besucher des ConPresso-Projekts die Möglichkeit, nach Suchbegriffen in zuvor definierten Bereichen des Projekts zu suchen.
Da es sich bei der Suchfunktion um eine Basisfunktionalität des ConPresso-Backends handelt, ist das Suchmodul seit Version 4.0.5 Bestandteil der Basisinstallation von ConPresso. Das Modul kann jedoch auch manuell nachinstalliert werden (z.B. bei den Versionen ConPresso 4.0.0 bis 4.0.4). Es steht auf der ConPresso-Website zum Download zur Verfügung. Informationen zur Installation erhalten Sie in Abschnitt 2.1, "Installation des Moduls".
Die Suchfunktion in ConPresso ist bewusst als Modul realisiert, da sie auf diese Weise innerhalb des Frontends eines ConPresso-Projekts mehrfach Verwendung finden kann. Unterschiedliche Installationen des Moduls können dabei in Funktion und Erscheinung unterschiedlich konfiguriert werden. Das ist beispielsweise dann notwendig, wenn im ConPresso-Frontend neben einer Standardsuche eine zusätzliche Suchfunktion integriert werden soll, die ausschließlich einen bestimmten Teilbereich des ConPresso-Projekts (z.B. die FAQs) durchsucht.
![[Anmerkung]](images/note.jpg) | Anmerkung |
|---|---|
Eine Registrierung dieses Moduls ist nicht vorgesehen. Das Modul ist sowohl für den nicht-kommeziellen als auch für den kommerziellen Einsatz im Rahmen einer kommerziellen ConPresso-Installation kostenlos verfügbar. Bitte beachten Sie, dass andere Module zum Teil einer Registrierung bedürfen und für den kommerziellen der Erwerb einer "Lizenz zur kommerziellen Nutzung" erforderlich ist. |
Das Modul "Search" ist Bestandteil der Basisinstallation von ConPresso (seit Version 4.0.5). Möchten Sie das Modul bei Verwendung einer älteren ConPresso-Version nachinstallieren, finden Sie hier die wichtigsten Instruktionen zu Modulinstallation.
Auch für den Fall, dass Sie mehrere Suchfunktionen im Frontend eines Projekts anbieten möchten, ist eine Mehrfachinstallation des Moduls notwendig. Um die Installation durchzuführen, gehen Sie in folgenden Schritten vor.
Bitte laden Sie von der ConPresso-Website die aktuelle Version des Moduls herunter und speichern Sie das Archiv lokal.
Nach dem Download entpacken Sie das Archiv bitte lokal auf Ihrem Rechner und kopieren anschließend das Modulverzeichnis per FTP unter dem gewünschte Namen (z.B. "mod_search", "mod_search_faq", etc.) in das ConPresso-Verzeichnis Ihres Projekts.
| Anmerkung |
|---|---|
Sofern Sie bereits eine Version ab 4.0.5 verwenden und eine zusätzliche Installation des Moduls durchführen, können Sie auch das vorhandene Modulverzeichnis Ihres ConPresso-Projekts herunterladen und eine Kopie unter einem neuem Namen im ConPresso-Verzeichnis verfügbar machen. |
Wechseln Sie nun im ConPresso-Backend in die Ansicht "Module verwalten", die Sie über den Eintrag "" im Menü "" erreichen.
Installieren Sie das Modul durch einen Klick auf die Schaltfläche Installieren in der Spalte "Bearbeiten". Im nächsten Schritt aktivieren Sie das Modul duch Anklicken der Schaltfläche Modul aktivieren in der Spalte "Bearbeiten". Weitere Informationen zur Installation, Aktivierung und zur Deinstallation eines Moduls erhalten Sie Abschnitt 1, "Module verwalten".
Nach der Installation des Moduls steht im Backend der Eintrag "" in der Navigation bereit, über den redaktionell arbeitende Benutzer die Suchfunktion des Backends erreichen können.
Das Suchmodul kann für seine Verwendung im ConPresso-Frontend konfiguriert werden. So kann beispielsweise festgelegt werden, in welchen Rubriken die Suchfunktion suchen soll, wie viele Treffer je Ausgabeseite angezeigt werden sollen und wie die Ausgabe des Suchergebnisses formatiert sein soll.
Die Konfiguration des Moduls findet in der Ansicht "Moduleinstellungen bearbeiten" statt, die Sie erreichen, indem Sie im Menü "" den Eintrag "" auswählen und anschließend in der Spalte "Bearbeiten" auf die Schaltfläche Moduleinstellungen bearbeiten klicken.
| "Rubrikeneinschränkung" | Über die Einstellung "Rubrikeneinschränkung" können Sie die Suche auf bestimmte Rubriken beschränken. Dies ist sinnvoll, wenn Inhalte bestimmter Rubriken in der Suchfunktion nicht berücksichtigt werden sollen. Über die Auswahl der Option "einschließen", schließen Sie die unter "Rubriken" ausgewählten Rubriken in die Suchfunktion ein. Über die Auswahl der Option "ausschließen", schließen Sie die unter "Rubriken" ausgewählten Rubriken aus der Suchfunktion aus. | ||||||||||||||||||||||||||||||||||
| "Rubriken" | Die Einstellung "Rubriken" steht in direktem Zusammenhang zur Einstellung "Rubrikeneinschränkung", in der Sie bestimmen können, ob Sie Rubriken für die Suchfunktion ein- oder ausschliessen wollen. Markieren Sie daher hier die ein- bzw. auszuschliessenden Rubriken. Eine Mehrfachauswahl erreichen Sie, indem Sie unter Verwendung der Shift- bzw. Steuerungstaste nacheinander mehrere Einträge durch Anklicken auswählen. | ||||||||||||||||||||||||||||||||||
| "Suchoptionen" | Soll die Suchfunktion um die Suche nach dem Namen des Autors eines Artikels, nach Links, Bildern oder Dateien erweitert werden, so aktivieren Sie bitte die entsprechenden Optionen.
| ||||||||||||||||||||||||||||||||||
| "Anzahl Treffer je Seite" | Über die Einstellung "Anzahl Treffer je Seite" geben Sie an, wie viele Treffer je Ausgabeseite ausgegeben werden sollen. | ||||||||||||||||||||||||||||||||||
| "Zeichenmenge" | Die Suche zeigt den eigentlichen Treffer hervorgehoben in seinem textlichen Zusammenhang an. Den Umfang des dargestellten Textes definieren Sie über die Einstellung "Zeichenmenge". Angegeben wird dieser Wert in Anzahl der Zeichen (z.B. 50). | ||||||||||||||||||||||||||||||||||
| "Datumsformat" | Über die Einstellung "Datumsformat" wird die Ausgabe des Publikationsdatums formatiert, sofern dies als zusätzliche beschreibende Information zusammen mit dem Suchergebnis ausgegeben wird. | ||||||||||||||||||||||||||||||||||
| "Template" | Über das Template formatieren Sie die Ein- und Ausgabe der Suche. Es stehen die folgenden Platzhalter zur Verfügung.
| ||||||||||||||||||||||||||||||||||
| "Hervorhebungs-CSS" | Geben Sie hier die Klasse an, die die Formatierungsanweisungen für die Hervorhebung des Suchgegriffs in den Suchergebnissen enthält. | ||||||||||||||||||||||||||||||||||
| "Meldung 'kein Suchbegriff'" | Geben Sie hier den Meldungstext an, der ausgegeben werden soll, sofern eine Suche ohne Angabe eines Suchbegriffs gestartet wurde. | ||||||||||||||||||||||||||||||||||
| "Meldung 'keine Treffer'" | Geben Sie hier den Meldungstext an, der ausgegeben werden soll, sofern eine Suche kein Suchergebnis geliefert hat. | ||||||||||||||||||||||||||||||||||
| "Meldung 'Treffer'" | Geben Sie hier den Meldungstext an, der der Ausgabe der Suchergebnisse vorangestellt werden soll. Um die Anzahl der Treffer ausgeben zu lassen, verwenden Sie bitte den Platzhalter "%s" an beliebiger Position in der Meldung. |
Die Einbindung des Suchmoduls in das ConPresso-Frontend kann auf zwei Arten erfolgen.
Leiten Sie den Besucher des Frontends auf die Eingabeseite des Suchmoduls. Hierzu integrieren Sie einen Link - sei es bei der Anpassung innerhalb einer Header- oder Footer-Datei oder innerhalb eines Artikels - über den der Besucher die Eingabeseite des Moduls erreichen kann.
Für den Fall, dass Sie ConPresso im Verzeichnis
conpresso Ihres
Webservers mit der Domain "http://www.example.com" installiert haben und das
Modul im Standardverzeichnis mod_search
vorhanden ist, verwenden Sie die folgende URL oder passen diese entsprechend
an: http://www.example.com/conpresso/mod_search/index.php
Es ist selbstverständlich auch möglich, die Eingabeseite des Suchmoduls in die Navigation des ConPresso-Projektes zu integrieren. Hierzu erzeugen Sie an gewünschter Position in der Navigation ein neues Navigationselement und geben als "externen Link" die oben genannte URL zur Eingabeseite des Suchmoduls ein. Details zur Bearbeitung der Navigation erfahren Sie in Abschnitt 5, "Navigation bearbeiten".
Die grafische Anpassung des Suchfeldes erfolgt - genau wie die Anpassung der Suchausgabe - über die Einstellungen des Moduls unter „Moduleinstellungen bearbeiten“.
Sie integrieren ein Suchfeld durch Einfügen des folgenden Codes in eine der Header- oder Footerdateien. Verwenden Sie dazu einen globalen Header oder Footer, so ist das Suchfeld auf allen durch ConPresso bereitgestellten Seiten verfügbar. Weitere Informationen zu Header- und Footer-Dateien erhalten Sie in Abschnitt 2.1, "Anpassung von Header- und Footer-Dateien".
Beispiel 13.1. Suchformular für das Backend
<form method="get" action="../mod_search/index.php" >
<input type="hidden" name="action" value="search" />
<input type="hidden" name="rubric" value="<?php echo $cpoRubric['id']; ?>" />
Bitte geben Sie Ihren Suchbegriff ein:<br />
<input type="text" name="q" value="" />
<input type="submit" value="Suche">
</form>
| Anmerkung |
|---|---|
Bitte beachten Sie, dass in der ersten "<form>"-Zeile eventuell der Pfad zur Index-Datei des jeweiligen Suchmoduls angepasst werden muss. |
Sie erreichen die Suche, indem Sie den Eintrag "" in der ConPresso-Navigation anklicken. ConPresso öffnet daraufhin die Ansicht "Suche" im ConPresso-Arbeitsbereich. Über die Suche können Sie komfortabel Inhalte nach diversen Kriterien suchen, die im Folgenden beschrieben werden sollen.
| "Suchbegriff" | Geben Sie hier den Suchbegriff an, nach dem Sie suchen möchten. | ||||||||||||||||||||
| "Suchoptionen" | Wählen Sie in den Suchoptionen aus, in welchen Elementen Sie suchen möchten.
|
Die Suchausgabe besteht aus einer Meldung, die die Anzahl der gefundenen Treffer ausgibt und einer Listenansicht, die die gefundenen Treffer (Artikel) enthält. Diese Ansicht ist ähnlich zu den in anderen Bereichen bekannten Ansichten zur Auflistung von Artikeln. Über die Listenansicht können Sie die Ansicht "Artikel bearbeiten" der Rubriken öffnen, in deren Artikel der von Ihnen eingegebene Suchbegriff gefunden wurde. Die Listenansicht enthält die folgenden Spalten.
| "Titel/Autor" | Die Spalte "Titel/Autor" der Suchausgabe gibt den Titel des Artikels sowie den Namen des Autors und den Namen des Benutzers wieder, der zuletzt an dem Artikel gearbeitet hat. Vor dem Titel befindet sich außerdem entweder ein grünes oder ein orangenes Quadrat. Die Farbe des Quadrats zeigt eindeutig an, ob der Artikel im Frontend des Projekts zu sehen ist oder nicht. |
| "Rubrik" | Die Spalte "Rubrik" der Suchausgabe zeigt Ihnen, in welcher Rubrik sich der Artikel befindet. Wollen Sie eines der gefundenen Artikel bearbeiten, so müssen Sie zunächst diese Rubrik auswählen. |
| "Status" | Die Spalte "Status" der Suchausgabe zeigt den Freigabestatus der Artikel an. Informationen zum Freigabestatus erhalten Sie in Abschnitt 2.1, "ConPresso-Freigabeprozess", wo der ConPresso Freigabeprozess ausführlich beschrieben wird. |
| "Publikation" | Die Spalte "Publikation" der Suchausgabe zeigt den Publikationszeitraum des Artikels an. Weitere Informationen zum Publikationszeitraum von Artikeln erhalten Sie in Abschnitt 2.2, "Publikationszeitraum". |
| "Fundstelle" | Die Spalte "Fundstelle" zeigt den Suchbegriff (Treffer) in seinem Zusammenhang an. |
Im Frontend eines ConPresso-Projekts wird über das Modul "Search" ein Eingabefeld bereitgestellt, das Besuchern des Projektes die Eingabe eines Suchbegriffs ermöglicht. Je nach Konfiguration des Moduls unter „Moduleinstellungen bearbeiten“ werden die Suchergebnisse anschließend ausgegeben.
Weitere Informationen darüber, wie Sie die Suchfunktion im ConPresso-Frontend verfügbar machen, erhalten Sie unter „Einbindung des Moduls in das ConPresso-Frontend“.
| Anmerkung |
|---|---|
Die Suchfunktion des ConPresso-Frontends berücksichtigt geschlossene Benutzerbereiche und die ConPresso-Personalisierung. Hierdurch ist sichergestellt, dass Benutzern des Frontends auch über die Suche nur die für Sie bereitgestellten Inhalte ausgegeben werden und nicht etwa Informationen aus geschlossenen Benutzerbereichen, für die der Benutzer keine Zugriffsberechtigung besitzt. Dies führt dazu, dass Besuchern des Frontends mit unterschiedlichen Rechten auch unterschiedliche Inhalte ausgegeben werden können. Weitere Informationenen erhalten Sie unter Abschnitt 16, "Geschlossene Benutzerbereiche und Personalisierung". |