.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt .. role:: underline ========================================= EXT: Search form: Prefilled search phrase ========================================= :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Sven Burkert :Changed: 2009-07-21T08:49:49 :Classification: searchformprefilled :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: forAdmins, forBeginners :Author: Sven Burkert :Email: sventb@gmail.com :Info 4: :Language: en |img-1| |img-2| EXT: Search form: Prefilled search phrase - searchformprefilled .. _EXT-Search-form-Prefilled-search-phrase: EXT: Search form: Prefilled search phrase ========================================= Extension Key: searchformprefilled Language: en Keywords: forAdmins, forBeginners Copyright 2000-2008, Sven Burkert, 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.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: Search form: Prefilled search phrase 1 <#1.EXT:%20Search%20form:%20Prefilled%20search%20phrase|outline>`_ **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ **`Configuration 4 <#1.2.Configuration|outline>`_** `TS Setup 4 <#1.2.1.TS%20Setup|outline>`_ **`To-Do list 5 <#1.3.To-Do%20list|outline>`_** **`ChangeLog 6 <#1.4.ChangeLog|outline>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ Shows search results on your page for the search phrase the visitor looks for via google or yahoo. Ok, first things first, here's a concrete example: |img-3| User goes to google (or some other search engine) and searches for “sbtheke javascript”: Then the user clicks on one of these search results – but you have (re)moved this page or changed your speaking urls or whatever. The user is redirected to the page “404 – page not found”. That's really basic. |img-4| Now the magic: If your browser submits the HTTP\_REFERER, a search form is displayed and a search for the keywords you looked for in google is performed on your site: .. _Configuration: Configuration ------------- - After installing this extension you should add the template “Prefilled search form” in field “Include static (from extensions)” in your ROOT page. - Now add the plugin “Search (prefilled)” into a page (I suggest the 404 error page) - Don't forget to set the TypoScript property *:underline:`**pidSearchFormRedirect**`* ! .. _TS-Setup: TS Setup ^^^^^^^^ plugin.tx\_searchformprefilled\_pi1 .. ### BEGIN~OF~TABLE ### .. _httpReferer: httpReferer """"""""""" .. container:: table-row Property httpReferer Data type string Description If you want to test this plugin and display some search results, use this property Default .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type string Description Location of the template Default EXT:searchformprefilled/pi1/template.html .. _pidSearchFormRedirect: pidSearchFormRedirect """"""""""""""""""""" .. container:: table-row Property pidSearchFormRedirect Data type integer Description Page-ID of the page where you provide the search. It's highly recommended to set this property, because the user should be redirected to the page where your users usually perform searches, he really shouldn't do this on the 404 error page. Default .. _searchForm: searchForm """""""""" .. container:: table-row Property searchForm Data type string Description Your preferred search plugin. indexed\_search is recommended, but the default TYPO3 search form is also available (just type “default” or something else for this property). Default indexed\_search .. _alwaysDisplaySearchForm: alwaysDisplaySearchForm """"""""""""""""""""""" .. container:: table-row Property alwaysDisplaySearchForm Data type boolean Description The search form is always displayed, even if there's no HTTP\_REFERER Default 0 .. _defaultSearchForm: defaultSearchForm """"""""""""""""" .. container:: table-row Property defaultSearchForm Data type Description Configuration of default TYPO3 search form, if you use indexed\_search, you don't need this. Default .. _defaultSearchForm-scols: defaultSearchForm.scols """"""""""""""""""""""" .. container:: table-row Property defaultSearchForm.scols Data type string Description See TYPO3 manual Default pages.title-subtitle-keywords-description:tt\_content.header-bodytext- imagecaption .. _defaultSearchForm-stype: defaultSearchForm.stype """"""""""""""""""""""" .. container:: table-row Property defaultSearchForm.stype Data type string Description See TYPO3 manual Default L0 .. ###### END~OF~TABLE ###### **Usage:** If you want to overwrite the default settings, you can do this in TypoScript setup field. **Example:** plugin.tx\_searchformprefilled\_pi1 { searchForm = default httpReferer = http://www.google.de/search?q=sbtheke+javascript pidSearchFormRedirect = {$searchPagePID} } .. _To-Do-list: To-Do list ---------- Tell me what you miss .. _ChangeLog: ChangeLog --------- - 1.0.1: Manual updated - 1.0.0: Initial upload 6 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 228 .. :id: Grafik1 .. :name: Grafik1 .. :width: 576 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 222 .. :id: Grafik4 .. :name: Grafik4 .. :width: 437