Zusammenfassung der letzten Vorlesungen. - Ergänzungen zu Menüs /Sprachumschaltung. - indexed search

Transkript

1 Websiteentwicklung auf Basis vontypo3 Extensions -10- Zusammenfassung der letzten Vorlesungen - Ergänzungen zu Menüs /Sprachumschaltung - Extensions - indexed search 1

2 TYPO3 Entwicklung Footernavigation aus Submenü ausblenden TypoScript LEFTMENU { entrylevel = 1 excludeuidlist = 14,15,16 wrap = <ul> </>... TYPO3 Entwicklung Breadcrumb zweisprachig TypoScript BREADCRUMB { 10 = TEXT 10.value = Sie sind hier: 10.lang.en = You are here: 2

3 TYPO3 Entwicklung Footer zweisprachig TypoScript subparts { FOOTERTEXT = TEXT FOOTERTEXT.value = <p><strong>typo3 Vorlesung</strong></p><p>Fachhochschule Frankfurt am Main<br>Nibelungenplatz 1<br>60318 Frankfurt<br></p> FOOTERTEXT.lang.en = <p><strong>typo3 lecture</strong></p><p>university of Applied Sciences<br>Nibelungenplatz 1<br>60318 Frankfurt<br></p> } TYPO3 Repository 3

4 Extension Repository o Alle frei verfügbaren Erweiterungen befinden sich im Repository unter o Aktuell sind über Extensions verfügbar o Jede Extension hat einen eindeutigen Extension Key o Die Extension kann direkt heruntergeladen werden oder direkt über den Extension Manager installiert werden. o Modul - Erweiterungen für das Backend (z.b. phpmyadmin) o Plugin Frontenderweiterung (z.b. News Plugin) Extension Manager Installierte Extensions eindeutiger Key Install Icon 4

5 Extension Manager Bevor Extensions gesucht und installiert werden, sollte die Extension Liste aktualisiert werden. Diese wird lokal auf dem Server vorgehalten Anzahl der der zur Verfügung stehenden Extensions Indexed Search ist eine System Extension Wird von TYPO3 mitgeliefert aber nicht installiert. Muss manuell installiert werden. 5

6 Bei der Installation wird die Datenbank erweitert und die Extension wird in der localconf.php eingetragen. Nach der Installation kann die Grundkonfiguration der Extension erfolgen. Für eine Standardinstallation sind i.d.r. keine Anpassungen erforderlich. Um zusätzliche Dateiformate wie z.b. Word oder PDF-Dokumente zu durchsuchen, kann man hier die Pfade zu den entsprechenden Parsern angeben. 6

7 Die Systemextension befindet sich im Verzeichnis typo3/sysext/indexed_search Die wesentlichen Dateien sind (fast bei allen Extensions vorhanden): o ext_emconf.php Generelle Beschreibung, z.b. Autor, Bezeichnung, Funktion, Version etc. o ext_tables.php Erweitert die TYPO3 Konfiguration, Implementiert Extension o ext_tables.sql SQL-Dump. Die Tabellen werden bei Installation angelegt o tca.php Beschreibung der Eingabemasken im Backend (Table Configuration Array) o pi/indexed_search.tmpl Mitgelieferte Designvorlage für alle Ansichten o locallang.xml Sprachdateien Andere Extensions enthalten ggf. noch die Dateien o setup.txt und constants.txt die den Standard TypoScript Code enthält Indexed Search legt eine Reihe von zusätzlichen Datenbanktabellen an: o index_config, index_debug, index_fulltext, index_grlist, index_phash, index_rel, index_section, index_stat_search, index_stat_word, index_words Hier wird der Index angelegt. Ähnlich wie bei Google müssen die Seiten vorher erfasst werden. Dies erfolgt entweder durch Aufruf der Seiten im Frontend oder durch einen Crawler (z.b. zusätzliche Extension oder wget) der über einen Cronjob in regelmäßigen Abständen gestartet werden kann. wget ist ein freies Kommandozeilenprogramm zum Herunterladen von Dateien aus dem Internet. Um Indexed Search generell zu aktivieren, wird folgende Zeile in das Setup eingetragen. page. config.index_enable = 1 7

8 Im Modul Indexing erhält man allgemeine Informationen zum Status der Indizierung der Seiten Im Modul Info kann man den Index manuell löschen 8

9 Die Einbindung der Suche und Ergebnisseite erfolgt als Contentelement. Weitere Einstellungen sind nicht erforderlich. Designanpassungen erfolgen in der Designvorlage indexed_search.tmpl Es empfiehlt sich eine Kopie unter fileadmin anzulegen und diese zu bearbeiten. Diese muss dann unter Constants eingebunden werden: plugin.tx_indexedsearch.file.templatefile = fileadmin/templates/indexed_search.tmpl Hier können die einzelnen Subparts beliebig editiert werden. 9

10 Der Marker für das Suchfeld wird manuell mit dem benötigten Formular befüllt und das Stylesheet mit den erforderlichen Styles ergänzt. marks { SEARCH = COA SEARCH { 10 = TEXT 10.typolink.parameter = typolink.returnLast = url 10.wrap = <form action=" " method="post" id="indexedsearch"> 20 = TEXT 20.value = Suche 20.lang.en = Search 20.htmlSpecialChars = 1 20.wrap = <input name="tx_indexedsearch[sword]" class="searchbox-sword" value=" " type="text" 25 = TEXT 25.value = Suche 25.lang.en = Search 25.htmlSpecialChars = 1 25.wrap = onfocus="if(this.value==this.defaultvalue) this.value=''" onblur="if(this.value=='')this.value=' '"/> 30 = TEXT 30.value = <input name="search" src="fileadmin/images/search_button1.gif" class="searchboxbutton" value="search" type="image" /> 40 = TEXT 40.value = <input type="hidden" name="tx_indexedsearch[sections]" value="0" /> 50 = TEXT 50.value = <input name="tx_indexedsearch[submit_button]" value="search" type="hidden" /> wrap = </form> } } Der Marker für das Suchfeld wird manuell mit dem benötigten Formular befüllt und das Stylesheet mit den erforderlichen Styles ergänzt. <form action="index.php?id=17" method="post" id="indexedsearch"> <input name="tx_indexedsearch[sword]" class="searchbox-sword" value="suche" type="text" onfocus="if(this.value==this.defaultvalue) this.value=''" onblur="if(this.value=='')this.value='suche'"/> <input name="search" src="fileadmin/images/search_button1.gif" class="searchbox-button" value="search" type="image" /> <input type="hidden" name="tx_indexedsearch[sections]" value="0" /> <input name="tx_indexedsearch[submit_button]" value="search" type="hidden" /> </form> 10

11 Dazu wird ein COA Objekt verwendet. Zunächst wir in TYposcript 10 = TEXT 10.typolink.parameter = typolink.returnLast = url 10.wrap = <form action=" " method="post" id="indexedsearch"> folgender HTML-Code generiert. <form action="index.php?id=17" method="post" id="indexedsearch"> Es wird ein Formulartag erstellt. In action wird definiert, dass nach dem Abschicken die Seite mit der id= 17 aufgerufen wird, außerdem wird die Methode post (alternative wäre get ) und eine id definiert. Dann wird in Typoscript 20.value = Suche 20.lang.en = Search 20.htmlSpecialChars = 1 20.wrap = <input name="tx_indexedsearch[sword]" class="searchboxsword" value=" " type="text" der erste Teil des eigentlichen Eingabefeld in HTML erzeugt. <input name="tx_indexedsearch[sword]" class="searchbox-sword" value="suche" 11

12 Anschließend wird in Typoscript 25 = TEXT 25.value = Suche 25.lang.en = Search 25.htmlSpecialChars = 1 25.wrap = onfocus="if(this.value==this.defaultvalue) this.value=''" onblur="if(this.value=='')this.value=' '"/> ein Javascript snippet erstellt, das prüft, ob sich der Curser im Suchfeld befindet und ob eine Eingabe erfolgt ist. Ist einer der beiden Fälle eingetreten wird der Begriff Suche (im Englischen search ) ausgeblendet. Zusätzlich wird der Input Tag geschlossen. onfocus="if(this.value==this.defaultvalue) this.value=''" onblur="if(this.value=='')this.value='suche'"/> Anschließend wird der Submit Button erzeugt: Typoscript 30 = TEXT 30.value = <input name="search" src="fileadmin/images/search_button1.gif" class="searchbox-button" value="search" type="image" /> HTML <input name="search" src="fileadmin/images/search_button1.gif" class="searchbox-button" value="search" type="image" /> Dabei wird statt eines Standard Submit-Buttons ein Bild verwendet. 12

13 In 40 und 50 werden noch 2 weitere Formularelemete, sogenannte hidden Fields, eingebunden. Diese erhalten zusätzliche Informationen für die Suchextension. Das können z.b. Sprachparameter oder Benutzerrechte sein. Zusätzlich wird das Formular mit dem entsprechenden Tag geschlossen. Language Packages Für TYPO3 sind zahlreiche Sprachvarianten verfügbar. Die einzelnen Sprachpakete können auch im Extension Manager unter DEM Reiter Language Packages heruntergeladen werden. Es handelt sich dabei jeweils um XML-Dateien, die im Verzeichnis typo3conf\l10n abgelegt werden. 13

14 Language Packages Beispiel: indexed search. Ausschnitt aus englischem Teil: Ausschnitt aus deutschem Teil: Language Packages Einzelne Elemente können bei Bedarf überschrieben werden. Um Updatesicher zu bleiben sollte das in Typoscript erfolgen. Beispiel: Suche durch Finden auf dem Submitbutton plugin.tx_indexedsearch._local_lang.de.submit_button_label = Finden Zunächst wird das entsprechende Plugin aufgerufen, dann die Sprachdatei, dann die Sprache, dann den XML-Tag und dann der darzustellende Begriff. 14

15 Language Packages Alle für Redakteure relevanten Module im Backend sind in über 50 Sprachen übersetzt. Viele Extensions, die auch eine Ausgabe im Frontend haben, verfügen über entsprechende Übersetzungen, allerdings nicht in allen angezeigten Sprachen. Language Packages. 15

16 Language Packages Nachdem neue Extensions installiert wurden, sollte ein Update der Language Packs durchgeführt werden, da erst dann, falls verfügbar, die Sprachen nachgeladen werden. Vielen Dank für Ihre Aufmerksamkeit Diese Präsentation können Sie ab morgen unter: /fh-frankfurt herunterladen. Miklos Weiszhaupt 16