====== selectsearch Plugin ======

---- plugin ----
description: Provide a dropdown with namespaces to restrict the search in
author     : Frank Schiebel 
email      : frank@linuxmuster.net 
type       : action
lastupdate : 2012-11-06
compatible : 2012-10-13
depends    : 
conflicts  : 
similar    : fancysearch, nssearch
tags       : search, namespace, dropdown

downloadurl: https://github.com/ironiemix/dokuwiki-selectsearch/zipball/master
bugtracker : https://github.com/igittigitt/dokuwiki-plugin-selectsearch/issues
sourcerepo : https://github.com/ironiemix/dokuwiki-selectsearch
donationurl: https://openschulportfolio.de/about
----

[[https://openschulportfolio.de/|{{ https://openschulportfolio.de/_media/wiki:logo:logo.png?140x96&recache}}]]

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

The selectsearch plugin is a "non-fancy" copy of the fancysearch plugin. It is possible to define a list of namespaces in the plugin config (via the config manager) from which the user can choose when doing a search in the wiki. The results will be restricted to the chosen namespace.

{{https://openschulportfolio.de/_media/dokumentation:searchbox.png?recache|}}

To use the Plugin you have to include the searchbox in your template:

  $selectsearch = plugin_load('action', 'selectsearch');
    if (!is_null($selectsearch)) {
        $selectsearch->tpl_searchform();
    } else {
        tpl_searchform();
    }

===== Configuration and Settings =====

In the configuration manager you can define a list of namespaces to be selected by the user when doing a search. 

The syntax for the option is ''the:name:space>Text to display in dropdown''

The options are comma separated. For having an option to search the whole wiki, you have to add an empty namespace like this: ''>whole wiki</tt''

The default value gives a good impression how this works:

  $conf['searchnamespaces'] = ">All pages,portfolio>Portfolio,hilfe>Help";

=== Change Log ===

  * **2012-11-01**
    * Initial release

=== Known Bugs and Issues ===

not compatible 2009-12-25c "Lemming"


===== FAQ =====

//[discussions should ideally be deleted and turned into FAQ entries along the way]//

===== Discussion =====

  * The Quick result pop-up no longer appears when this plugin is activated. Is that intentional? 
  * Within what template file(s) would you add the searchbox syntax?

==== Vector template ====

Doesn't appear in the correct place in the vector template.  

==== language for search button ====

The parameter to change the language of the search-button is missing. As workaround it is possible to change line 55 in action.php to \\
''echo '<input class="button" type="submit" title="Search" value="Suche">';''\\
(example for the german language)

The better way would be to introduce a new parameter for the settings.php


==== set of namespaces ====

It would be great if the plugin would accept a set of namespaces as searchnamespace. Alternatively it would be helpful to exclude a certain namespace from the search.

 --- [[user>Juergen_aus_Zuendorf|Juergen_aus_Zuendorf]] //2015-03-11 15:30//

We are missing this too.