.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ====================== EXT: macina\_searchbox ====================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Wolfgang Becker :Changed: 2003-08-30T19:19:56 :Author: Wolfgang :Email: wb@macina.com :Info 3: :Info 4: .. _EXT-macina-searchbox: EXT: macina\_searchbox ====================== Extension Key: **macina\_searchbox** Copyright 2000-2002, Wolfgang, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **EXT: macina\_searchbox 1** **Introduction 1** What does it do? 1 Screenshots1 **Users manual 2** Installation 2 Add box as content element 2 Add box to all pages 2 **Configuration 2** General 2 TypoScript 3 HTML Template 3 Languages 3 **Known problems4** **Changelog4** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This Extension offers the possibility to add a searchbox to your Typo3 powered website which submits the searchvalue to the Indexed Search Engine plugin. The extension has a html template which is easy to modify and supports multiple languages. .. _Screenshots: Screenshots ^^^^^^^^^^^ Screenshot of the Output on the website |img-1| Screenshot of the HTMLtemplate from Dreamweaver |img-2| .. _Users-manual: Users manual ------------ .. _Installation: Installation ^^^^^^^^^^^^ To Use the Extension, get it from the EXTENSION REPOSITORY into your extension manager and install it.Its necessary to have the Indexed Search Engine installed because this box sends the results to it. .. _Add-box-as-content-element: Add box as content element ^^^^^^^^^^^^^^^^^^^^^^^^^^ Switch to your Typo3 Backend and point the page Modul to the page where you want to add the SearchBox.Klick “new content”.Choose Searchbox from the Plugins section: |img-3| Thats all you have to to, to insert the search box to your page. .. _Add-box-to-all-pages: Add box to all pages ^^^^^^^^^^^^^^^^^^^^ To add the box to all pages on your site, you have to create a marker: ###searchbox### in your html template. Then you have to add this code to your main TS Template to substitute the marker with the plugin: :: marks.searchbox > marks.searchbox < plugin.tx_macinasearchbox_pi1 .. _Configuration: Configuration ------------- .. _General: General ^^^^^^^ First of all you have to install the Indexed Search Engine and insert it on a page.Then you have to make one typoscript settiing: .. _generated: ((generated)) """"""""""""" .. _Example: Example ~~~~~~~ Typoscript setting you have to add to your template into the **setup** field:(replace 77 with the PID of your page with the index search engine plugin.) :: plugin.tx_macinasearchbox_pi1 { pidSearchpage = 77 } .. _TypoScript: TypoScript ^^^^^^^^^^ Reference (TypoScript) .. ### BEGIN~OF~TABLE ### .. _pidSearchpage: pidSearchpage """"""""""""" .. container:: table-row Property pidSearchpage Data type int Description Wraps the whole item Default .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type string Description Path to the template file Default EXT:macina\_searchbox/pi1/template.htm .. ###### END~OF~TABLE ###### [plugin.tx\_macinasearchbox\_pi1] .. _HTML-Template: HTML Template ^^^^^^^^^^^^^ The Template is found in the path of your Extensiondirectiory: typically” typo3conf/ext/macina\_searchbox/pi1/template.htm” To change the Layout of your Searchbox just open the Template with your favourite HTML editor, and modify it by your needs. - ((generated)) """"""""""""" Markers ~~~~~~~ The Markers (###MARKER###) are replaced by the plugin as following: - ###HEADLINE### Displays the Headline - ###ADVANCED### Advanced Search Link - ###SUBMIT### Alttext for the submit button - ###ACTLANG### UID of the actual language - ###SEARCHPID### PID of the Searchpage When editing the HTML file leave the markers in the HTML source to ensure the plugin's functionality. You can move them around as you like it, exept the markers ###ACTLANG### and ##SEARCHPID###. .. _Languages: Languages ^^^^^^^^^ Backend languages are English and German. To edit or add frontend languages to the plugin, edit the phpfile: :: typo3conf/ext/macina_searchbox/pi1/tlocallang.php To add new language you have to copy the labels of the default language into your desired one and translate them: :: $LOCAL_LANG = Array ( "default" => Array ( "headline" => "Search & Find", "advanced" => "advanced search", "submit" => "search", ), "dk" => Array ( [paste here for danish language] ), "de" => Array ( "headline" => "Suchen & Finden", "advanced" => "erweiterte Suche", "submit" => "suchen", ), "no" => Array ( ), "it" => Array ( ), "fr" => Array ( ), . . . .. _Known-problems: Known problems -------------- Currently no problems known. Feel free to report any bugs to `wb@macina.com `_ .. _Changelog: Changelog --------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _generated: ((generated)) """"""""""""" .. _18-Juli-2003: 18. Juli 2003 ~~~~~~~~~~~~~ Images “lupe” and “teaserheader” added. Filereferences in “template.htm” updated. ---------------------------------------------------------------------- ------------------ .. _21-Juli-2003: 21.Juli 2003 ~~~~~~~~~~~~ Language integration improved.. ( Thanx to Nico Ueckermann) class.tx\_macinasearchbox\_pi1.php updated. template.htm updated ---------------------------------------------------------------------- ------------------ .. _30-August-2003: 30.August 2003 ~~~~~~~~~~~~~~ Bugfix for “simultae static docs class.tx\_macinasearchbox\_pi1.php updated. |img-4| EXT: macina\_searchbox - 4 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.jpeg .. :align: left .. :border: 0 .. :height: 75 .. :id: Graphic4 .. :name: Graphic4 .. :width: 177 .. |img-2| image:: img-2.jpeg .. :align: left .. :border: 0 .. :height: 155 .. :id: Graphic5 .. :name: Graphic5 .. :width: 175 .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 66 .. :id: Graphic6 .. :name: Graphic6 .. :width: 240 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102