====== datasearchform Plugin ======

---- plugin ----
description: Adds a special search form to search through the data entries of the Data Plugin
author     : Juergen_aus_Zuendorf
email      : H-J-Schuemmer@Web.de 
type       : syntax
lastupdate : 2018-02-06
compatible : Ponder Stibbons, Hrun, Frusterick Manners, Greebo, Hogfather
depends    : data
conflicts  : 
similar    : searchform
tags       : search, data
downloadurl: https://github.com/Juergen-aus-Koeln/dokuwiki_datasearchform/archive/master.zip
sourcerepo : https://github.com/Juergen-aus-Koeln/dokuwiki_datasearchform
bugtracker : https://github.com/Juergen-aus-Koeln/dokuwiki_datasearchform/issues
----

===== Installation =====

Install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually with download url above.


===== Syntax =====

To include a searchform in any page you add the syntax:
<code>
{datasearchform flt=<filter>}
</code>

It will show a search box that searches through the data entries, matching the column of the given filter. 

The entries are linked to a page named '..:datatable', using the given value as control filter. This page containing the 'datatable' command has to be in the same namespace as the page containing the datasearchform-command.

//Example://
<code>
{datasearchform flt=keywords}
</code>
The given input in the searchform will lead to a search through the database of the data plugin for matching entries in the data field "keywords". The result is displayed at the page called 'datatable' with the command ''%%---- datatable ----%%'' for displaying a datatable of the [[data#data_table_output|Data]] plugin.


===== Development =====

This plugin is copied and modified from the original plugin [[searchform]] by [[user>Klap-in]].