.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../../../Includes.txt


.. _users_plugins_form:

.. index::
  ! Form
  pair: Form; Plugin
  single: Form; Area
  single: Form; Decennium
  single: Form; Month
  single: Form; Period
  single: Form; Scope
  single: Form; Year


Form
====


.. only:: html

	:Name:
		xBlog Form
			
	:Description:
		Individual search form. For the list view. Needs a main or a mini xBlog. If you need a simple search form only, please use +xBlog Search.
			
	:Type:
		extension plugin

	:Views:
		list

	:Conditions:
		xBlog Main is set up. TypoScript for xBlog form is included.


What does it do?
----------------

The xBlog plugin Form enables you, to create a form by a web interface.


Tables
------

You can use any main table and its related tables.


Type of fields
-------------- 

* Button: magnifier, reset or send
* Checkbox
* Placeholder: only for layout
* Radiobuttons
* Search Word: full text search
* Select
* Select (Period): month, year, decennium
* Select (Scope)


Period
------

Type "Select (Period)" delivers three modes. See below.

Condition: Field must be a timestamp.

month
'''''

This is a  list of twelve months.

The website visitor can search for records of a month of the current year. 

Example for an item: February


year
''''

This is a  list of years.

The website visitor can search for records of a selected year.

You can control the start and the amount of the years. 

Example for an item: 1999


decennium
'''''''''

This is a  list of decenniums.

The website visitor can search for records of a selected decennium.

You can control the start and the amount of the decenniums. 

Example for an item: 1970-1980


Scope
-----

Condition: Field must be an integer.

Visitors of your website can filter scopes (areas) like range of prices (squaremeters, kilowatts and so on).

Example:

* ... - 10.000 EUR
* 10.000 - 20.000 EUR
* 20.000 - 30.000 EUR
* 30.000 - 40.000 EUR
* 40.000 EUR - ...


Screenshots
-----------

* :ref:`Backend <introduction_screenshots_backend_plugins_form>`
* :ref:`Frontend <introduction_screenshots_frontend_list_form>`