Admin at 13:49, 13 August 2006

Admin — Sun, 13 Aug 2006 13:49:32 GMT

New page

{{H:h|editor toc}}
The '''inputbox''' extension is a [[m:MediaWiki|MediaWiki]] extension by Erik Möller to add predefined HTML forms to wiki pages. It was originally created for the purpose of adding a ''Create an article'' box to [[m:Wikinews|Wikinews]]. It requires MediaWiki 1.5 and an extensions script (see ''Installation'' below).

== General syntax ==

Inputboxes are constructed like this:

<pre>
<inputbox>
type=box type
parameter1=value
parameter2=value
</inputbox>
</pre>

The ''type'' parameter is mandatory. All other parameters are optional.

== Box types ==

{| border="1" cellspacing="5" cellpadding="5" bgcolor="white" width="79%"
!Type
!Example
|-
! type=search
|
<inputbox>
type=search
</inputbox>
|-
| colspan="2" | Generates a search box with a default width of 50 characters. The button labels can be specified, see below; defaults [[MediaWiki:Tryexact]] and [[MediaWiki:Searchfulltext]]. The text field specifies the search criteria.
|-
! type=create
|
<inputbox>
type=create
</inputbox>
|-
| colspan="2" | Allows creating a new page. The button label can be specified, see below; default [[MediaWiki:Createarticle]]. The text field specifies which page is to be edited.
|-
! type=comment
|
<inputbox>
type=comment
</inputbox>
|-
| colspan="2" | Add one or more sections to an existing page, or create a page, with an edit summary that is automatically the same as the (first) new section header. The button label can be specified, see below; default [[MediaWiki:Postcomment]] also used in the sidebar of the "Standard" skin. The text field specifies which page is to be edited.
|}

== Parameters ==

{| border="1" cellspacing="5" cellpadding="5" frames="border" rules="all" bgcolor="#ffffff"
!Parameter ''Scope''
!Description
!Example
|---
|
'''bgcolor=''' 
''All types''
|width="30%"|Sets the table background color (HTML color values). Do not use quotes.
|
<pre>
<inputbox>
type=search
bgcolor=#eeeeff
</inputbox>
</pre>

''produces:''

<inputbox>
type=search
bgcolor=#eeeeff
</inputbox>
|---
|
'''width=''' 
''All types''
|width="30%"|Sets the width of the inputbox in characters, '''required''' for old browsers (see above).
|
<pre>
<inputbox>
type=create
width=6
</inputbox>
</pre>

''produces:''

<inputbox>
type=create
width=6
</inputbox>
|---
|
'''default=''' 
''All types''
|width="30%"|Default text to put in the inputbox.
|
<pre>
<inputbox>
type=comment
default=User talk:Eloquence
</inputbox>
</pre>

''produces:''

<inputbox>
type=comment
default=User talk:Eloquence
</inputbox>
|---
|'''preload=''' 
''comment'', ''create''

|width="30%"|The text of the page under this title will be loaded into the blank editbox when a new page is created. Enter the title of a non-existent page in the example inputbox, and click "Create" to test this effect.
|
<pre>
<inputbox>
type=create
width=20
preload=MediaWiki:Editthispage
</inputbox>
</pre>

''produces:''

<inputbox>
type=create
width=20
preload=MediaWiki:Editthispage
</inputbox>
|---
|'''editintro=''' ''comment'', ''create''
|width="30%"|The text of the page under this title will be added, as instructions, ''before'' the submission form for '''new''' pages. Enter the title of a non-existent page in the example inputbox, and click "Create" to test this effect.
|
<pre>
<inputbox>
type=comment
width=20
editintro=MediaWiki:Missingcommenttext
</inputbox>
</pre>

''produces:''

<inputbox>
type=comment
width=20
editintro=Mediawiki:Missingcommenttext
</inputbox>
|---
|'''buttonlabel=''' ''All types''
|width="30%"|This label will be used for the main button of the form.
|
<pre>
<inputbox>
type=comment
buttonlabel=Add new rumor
</inputbox>
</pre>

''produces:''

<inputbox>
type=comment
buttonlabel=Add new rumor
</inputbox>
|---
|'''searchbuttonlabel=''' ''search''
|width="30%"|This label will be used for the "Search full text" button of the search form.
|
<pre>
<inputbox>
type=search
searchbuttonlabel=Dig deeper
</inputbox>
</pre>

''produces:''

<inputbox>
type=search
searchbuttonlabel=Dig deeper
</inputbox>
|---
|'''break=''' ''yes''
|width="30%"|Whether or not to insert a line break between the input box and the button(s). Defaults to using the line break unless set to '''no'''.
|
<pre>
<inputbox>
type=create
break=no
</inputbox>
</pre>

''produces:''

<inputbox>
type=create
break=no
</inputbox>
|}

Applying ''create '' to an existing page simply gives the edit page. In that case <tt>editintro</tt> and <tt>preload</tt> are ignored.
Applying ''comment '' for a new page works, if the page already exists <tt>editintro</tt> is ignored.

The texts taken from the <tt>MediaWiki:</tt> namespace are of course only examples, any existing page can be used for <tt>editintro</tt> or <tt>preload</tt>.
Unfortunately <tt>preload</tt> does not yet work for the [[Special:Upload]] summary.

==Caveats==
* Variables, parameters, and templates are not allowed in values of parameters of inputbox; see [[Template talk:Inputbox demo]].

==Installation==
#Download and save the file [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/inputbox/inputbox.php inputbox.php] to the ''extensions'' folder of your MediaWiki installation. Make sure you use this link to download the extension, as the latest version in CVS does not work with the current MediaWiki release branch.
#Open and edit the [[LocalSettings.php]] file by adding the following line near the bottom:
<pre>require_once("extensions/inputbox.php");</pre>
NOTE: Make sure that it is still above the closing php tag so that it looks like this:
<pre>
require_once("extensions/inputbox.php");
?>
</pre>


==Examples==
*[[Template talk:New city in Morocco]].
*[[w:Wikipedia:Village pump (proposals)#User talk inputbox]]

{{h:f|langs=|enname=Inputbox}}

Help:Inputbox - Revision history

Admin at 13:49, 13 August 2006