Thomas: 1 versie geïmporteerd

2019-09-25T12:46:14Z

1 versie geïmporteerd

← Oudere versie	Versie van 25 sep 2019 14:46
(geen verschil)

interwiki>FWDekker op 18 jul 2019 om 17:49

2019-07-18T17:49:48Z

Nieuwe pagina

<languages />
{{bundled|1.21}}
{{Extension
|name = InputBox
|status = stable
|type1 = tag
|type2 = page action
|type3 = search
|hook1 = ParserFirstCallInit
|hook2 = MediaWikiPerformAction
|hook3 = SpecialPageBeforeExecute
|username =
|author = * Erik Möller
* Leonardo Pimenta
* Rob Church
* Trevor Parscal
* Daniel Schuba
|description = <translate> Allows users to add predefined HTML forms to wiki pages</translate>
|image = Simple_Input_Form.png
|imagesize = border{{!}}325
|version = Continuous updates
|update =
|mediawiki = 1.30+
|license = MIT
|download = {{WikimediaDownload}}
|needs-updatephp = No
|readme =
|changelog =
|parameters =
|tags = * <inputbox>
|rights =
|example =
|compatibility =
|phabricator = MediaWiki-extensions-InputBox
|pagedrive1 = true
}}

<translate>

The '''InputBox''' extension adds already created [[w:HTML form|HTML forms]] to wiki pages.</translate>
<translate>

Users can "complete" a form (entering text, selecting menu items, etc.) by entering text into the box.


InputBox was originally created by <tvar|user>[[User:Eloquence|Erik Möller]]</> for the purpose of adding a <tvar|create-article>''{{int|Articleplaceholder-abouttopic-create-article-button}}''</> box to [[m:Wikinews|Wikinews]].

== Installation == 
</translate>
{{ExtensionInstall
|repo-name=InputBox
|registration=yes
}}

<translate>
== Example == 


Box for starting a new article.

===Wiki code=== 
</translate>

<pre><inputbox>
type=create
break=no
</inputbox>
</pre>

<translate>
===Result=== 
</translate>
<div style="float:{{dir|{{pagelang}}|right|left}};">
<inputbox>
type=create
break=no
</inputbox>
</div>
{{clr}}

<translate>
== General syntax == 


Input boxes are constructed like this:
</translate>

{| cellspacing="5" bgcolor="#ffffff" rules="all" cellpadding="5" border="0"
|<source lang="html"><inputbox>
type=
bgcolor=
width=
page=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
break=
namespaces=
prefix=
placeholder=
preloadparams[]=
</inputbox>
</source>
|}

<translate>

The <tvar|type>''type''</> parameter is mandatory.</translate>
<translate>

All other parameters are optional.</translate>
<translate>

<tvar|preloadparams>''preloadparams[]''</> can appear more than once.

== Box types == 


The default location of the “<tvar|submit>{{int|Htmlform-submit}}</>” button(s) is below the input box.


The “<tvar|submit>{{int|Htmlform-submit}}</>” button can be moved to the right by using the line break parameter to eliminate the line break between the box and the button: <tvar|break><code>break=no</code></>.


Having the “<tvar|submit>{{int|Htmlform-submit}}</>” button to the right is useful for search boxes when search suggestions would otherwise cover up a search button below the search box.
</translate>

{| class="wikitable"
! <translate> Type</translate>
! <translate> Example</translate>
! <translate> Description</translate>
|-
| type=search
|
<inputbox>
type=search
</inputbox>
| <translate> Creates a search box which has a default width of 50 characters.</translate> <translate> Information added in the text box is searched for.</translate>
|-
| type=create
|
<inputbox>
type=create
</inputbox>
| <translate> Creates a new page.</translate> <translate> Information added in the text box is the name of the page which is edited.</translate>
|-
| type=comment
|
<inputbox>
type=comment
</inputbox>
| <translate> Adds a new section to the bottom of the page specified in the text box.</translate>
|-
| type=commenttitle
|
<inputbox>
type=commenttitle
page={{TALKPAGENAME}}
</inputbox>
| <translate> Adds a new section with the section header typed into the text box.</translate> <translate> The title can be specified with <tvar|default><code>default=</code></> parameter. The page has to be specified with <tvar|page><code>page=</code></> parameter.</translate> {{introduced-inline|[[rev:47203]]}}
|-
| type=fulltext
|
<inputbox>
type=fulltext
</inputbox>
| <translate> Search only with the fulltext search button, without the “<tvar|go>{{int|Go}}</>” button.</translate> {{introduced-inline|[[rev:45269]]}}
|-
| type=move
|
<inputbox>
type=move
page={{PAGENAME}}
</inputbox>
| <translate> Move a page to a different name.</translate> {{introduced-inline|[[gerrit:97559]]}}
|}

<translate>

For <tvar|search2><code>type=search2</code></>, the default location for the search button is to the right.</translate>
<translate>

Currently, it does not seem to be possible to add other parameters to this type of input box.</translate>
<translate>

This search box searches the entire wiki that it is placed on.
</translate>

{| class="wikitable"
! <translate> Type</translate>
! <translate> Example</translate>
|-
| type=search2
|
<inputbox>
type=search2
</inputbox>
|}
<div style="clear:both;"></div>

<translate>
== Parameters == 
</translate>

{| class="wikitable"
! <translate> Parameter</translate>
! <translate> Description</translate>
! <translate> Scope</translate>
! <translate> Compatibility</translate>
! <translate> Example</translate>
! <translate> Result</translate>
|-
|'''bgcolor='''
| <translate> Sets the table background color (HTML color values).</translate> <translate> Do not use quotes.</translate>
| <translate> All types</translate>
|''?''
|<pre><inputbox>
type=search
bgcolor=#eeeeff
</inputbox></pre>
|<inputbox>
type=search
bgcolor=#eeeeff
</inputbox>
|-
|'''width='''
| <translate> Sets the width of the InputBox in characters.</translate>
| <translate> All types</translate>
|''?''
|<pre><inputbox>
type=create
width=24
</inputbox></pre>
|<inputbox>
type=create
width=24
</inputbox>
|-
|'''default='''
| <translate> Default text to put in the InputBox.</translate>
| <translate> All types</translate>
|''?''
|<pre><inputbox>
type=comment
default=User talk:Eloquence
</inputbox></pre>
|<inputbox>
type=comment
default=User talk:Eloquence
</inputbox>
|-
|'''preload='''
| <translate> The page under this title will be preloaded (see <tvar|1>{{ll|Manual:Creating pages with preloaded text}}</>) into the blank editbox when a new page is created.</translate>
| create, comment, commenttitle
|''?''
|<pre><inputbox>
type=create
preload=Log
</inputbox></pre>
|<inputbox>
type=create
preload=Log
</inputbox>
|-
| colspan="6" | <translate> Enter the title of a non-existent page in the example InputBox above or below, and click "<tvar|create>{{int|inputbox-createarticle}}</>" or "<tvar|new>{{int|inputbox-postcomment}}</>" respectively to test this effect.</translate>
|-
|'''editintro='''
| <translate> The page which is given under this parameter will be shown, as instructions, ''above'' the editing window.</translate>
| create, comment
|''?''
|<pre><inputbox>
type=comment
editintro=MediaWiki:Missingcommenttext
</inputbox></pre>
|<inputbox>
type=comment
editintro=Mediawiki:Missingcommenttext
</inputbox>
|-
|'''buttonlabel='''
| <translate> This label will be used for the main button of the form.</translate>
| <translate> All types</translate>
|''?''
|<pre><inputbox>
type=comment
buttonlabel=Add new rumor
</inputbox></pre>
|<inputbox>
type=comment
buttonlabel=Add new rumor
</inputbox>
|-
|'''hidden='''
| <translate>
This specifies that there is no InputBox.


It is used with parameter "<tvar|default>default</>", now not being a default, but the fixed value of the name of the page.</translate>
|create, comment
|''?''
|<pre><inputbox>
type=comment
editintro=Extension:InputBox/editintro comment
preload=Extension:InputBox/preload
hidden=yes
default=Extension talk:InputBox
buttonlabel=<translate> Post a comment on the talk page</translate>
</inputbox></pre>
|<inputbox>
type=comment
editintro=Extension:InputBox/editintro comment
preload=Extension:InputBox/preload
hidden=yes
default=Extension talk:InputBox
buttonlabel=<translate> Post a comment on the talk page</translate>
</inputbox>
|-
|'''searchbuttonlabel='''
| <translate> This label will be used for the "Search full text" button of the search form.</translate>
| search, fulltext
|''?''
|<pre><inputbox>
type=search
searchbuttonlabel=<translate> Dig deeper</translate>
</inputbox></pre>
|<inputbox>
type=search
searchbuttonlabel=<translate> Dig deeper</translate>
</inputbox>
|-
|'''fulltextbutton='''
| <translate> Show the full text search button on search2 form</translate>
|search2
|''?''
|<pre><inputbox>
type=search2
searchbuttonlabel=<translate> Dig deeper</translate>
fulltextbutton=true
</inputbox></pre>
|<inputbox>
type=search
searchbuttonlabel=<translate> Dig deeper</translate>
fulltextbutton=true
</inputbox>
|-
|'''labeltext='''
| <translate> Text to print beside the button</translate>
|search2
|''?''
|<pre><inputbox>
type=search2
searchbuttonlabel=<translate> Dig deeper</translate>
labeltext=<translate> Look for:</translate>
</inputbox></pre>
|<inputbox>
type=search2
searchbuttonlabel=<translate> Dig deeper</translate>
labeltext=<translate> Look for:</translate>
</inputbox>
|-
|'''break='''
| <translate> Whether or not to insert a line break between the input box and the button(s).</translate> <translate> Defaults to <tvar|yes>'''yes'''</> (use a line break).</translate>
| <translate> All types</translate>
|''?''
|<pre><inputbox>
type=create
width=24
break=no
</inputbox></pre>
|<inputbox>
type=create
width=24
break=no
</inputbox>
|-
|'''namespaces='''
| <translate>
Support for namespace checkboxes in fulltext search.


With "<tvar|main><code>Main'''**'''</code></>", main article namespace is checked by default.</translate>
| search, fulltext
|''?''
|<pre><inputbox>
type=search
namespaces=Main**,Help
</inputbox></pre>
|<inputbox>
type=search
namespaces=Main**,Help
</inputbox>
|-
|'''prefix='''
|
<translate>

* Narrow down search to pages beginning with certain prefix.</translate> <translate> Note this only works with certain search back-ends, currently only <tvar|ext>{{ll|Extension:CirrusSearch}}</>.</translate> <translate> Defaults to empty string (search all pages).</translate>
<translate>

* Create new page beginning with a certain prefix.</translate>
<translate>

* In <tvar|tmove>type=move</>, the prefix is prepended to the default parameter.


Remark: underscores aren't recognized as spaces.
</translate>
|search, fulltext, create
|''?''
|<pre><inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox></pre>
|<inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox>

<translate> The button below prefixes the name with <tvar|mypage>''<code>Special:Mypage/</code>''</>.</translate>
<inputbox>
type=create
preload=Template:Article wizard/userpageskeleton
default=new article name here
prefix=Special:Mypage/
editintro=Wikipedia:Article wizard/Wizard-New edit instructions userdraft
buttonlabel=<translate> Create a userspace draft</translate>
width=50
</inputbox>
|-
|'''placeholder='''
| <translate> Define placeholder text that will display in the input box when it is empty.</translate>
| <translate> All types</translate>
|1.19+
|<pre><inputbox>
type=search
placeholder=<translate> Search this Wiki</translate>
</inputbox></pre>
|<inputbox>
type=search
placeholder=<translate> Search this Wiki</translate>
</inputbox>
|-
|'''page='''
| <translate> Page to posts comment to, or page to move.</translate>
| comment, move
|
|<pre><inputbox>
type=comment
page=Project:Sandbox
</inputbox></pre>
|<inputbox>
type=comment
page=Project:Sandbox
</inputbox>
|-
|'''minor='''
| <translate> Minor edit.</translate>
| comment, create
|
|<pre><inputbox>
type=comment
page=Project:Sandbox
minor=true
</inputbox></pre>
|<inputbox>
type=comment
page=Project:Sandbox
minor=true
</inputbox>
|-
|'''nosummary='''
| <translate> Edit summary (headline) not required for new comment.</translate>
|comment
|
|<pre><inputbox>
type=comment
page=Project:Sandbox
nosummary=true
</inputbox></pre>
|<inputbox>
type=create
page=Project:Sandbox
nosummary=true
</inputbox>
|-
|'''summary='''
| <translate> Edit summary or move reason.</translate>
| create, move
|
|<pre><inputbox>
type=create
default=Special:Mypage/inputbox test
summary=Foo
</inputbox></pre>
|<inputbox>
type=create
default=Special:Mypage/inputbox test
summary=Foo
</inputbox>
|-
|'''id='''
| <translate> id attribute for <tvar|form><form></>.</translate>
| <translate> All types</translate>
| <translate> 1.23 for some types</translate>
|<pre><inputbox>
type=comment
page=Project:Sandbox
summary=Foo
id=bar
</inputbox></pre>
|<inputbox>
type=comment
page=Project:Sandbox
summary=Foo
id=bar
</inputbox>
|-
|'''inline='''
| <translate> Make the InputBox be an inline element (no line break at beginning).</translate>
| search2
|
|<pre><translate> Text here:</translate> <inputbox>
type=search2
inline=true
width=10
</inputbox></pre>
| <translate> Text here:</translate> <inputbox>
type=search2
inline=true
width=10
</inputbox>
|-
|'''dir='''
| <translate> Right to left (rtl) or left to right (ltr).</translate> <translate> Defaults to directionality of the page's language.</translate>
| <translate> All types</translate>
|
|<pre><inputbox>
dir=rtl
type=comment
page=Project:Sandbox
summary=Foo
</inputbox></pre>
|<inputbox>
dir=rtl
type=comment
page=Project:Sandbox
summary=Foo
</inputbox>
|-
| id="preloadparams" |'''preloadparams[]='''
| <translate> Specify parameters to the preload text.</translate> <translate> See [[<tvar|man>Manual:Creating pages with preloaded text#Using parameters</>|Creating pages with preloaded text]].</translate>
| create, comment, commenttitle
|1.25+
|<pre><inputbox>
type=create
preload=Log
preloadparams[]=param1
preloadparams[]=param2
</inputbox></pre>
|<inputbox>
type=create
preload=Log
preloadparams[]=param1
preloadparams[]=param2
</inputbox>
|-
|'''searchfilter='''
|<translate> Specify parameters to append to the search</translate>
|search
|1.30+
|<pre><inputbox>
type=search
searchfilter=insource:foo
</inputbox></pre>
|<inputbox>
type=search
searchfilter=insource:foo
</inputbox>
|-
|'''useve='''
| <translate> When creating a page the input box will use the new visual editor, if the extension is installed, and this parameter is set to true.</translate>
| create, comment
|
|<pre><inputbox>
type=create
break=no
useve=true
</inputbox></pre>
|<inputbox>
type=create
break=no
useve=true
</inputbox>
|}

<translate>

Applying <tvar|create>''create''</> to an existing page simply gives the edit page.</translate>
<translate>

In that case <tvar|preload><code>preload</code></> is ignored.</translate>
<translate>

Applying <tvar|comment>''comment''</> for a new page works.


The texts taken from the <tvar|mediawiki><code>MediaWiki:</code></> namespace are of course only examples, any existing page can be used for <tvar|editintro><code>editintro</code></> or <tvar|preload><code>preload</code></>.</translate>
<translate>

Unfortunately <tvar|preload><code>preload</code></> does not yet work for the [[<tvar|special>Special:Upload</>|Upload]] summary.

== Alignment == 


If you want to create an inputbox on the right side of the page, do something like:
</translate>

<syntaxhighlight lang="html">
<div style="float:{{dir|{{pagelang}}|left|right}}; width:42em">
<inputbox>
type=create
</inputbox>
</div>
</syntaxhighlight>

<div style="float:{{dir|{{pagelang}}|left|right}}; width:42em">
<inputbox>
type=create
</inputbox>
</div>
{{clear}}

<translate>
== Parser function == 


Using InputBox in a template


In order to create many similar input boxes, InputBox can be used in a template.</translate>
<translate>

However, passing template parameters to InputBox parameters only works if the <tvar|inputbox><code><nowiki><inputbox>...</inputbox></nowiki></code></> tag is written as <tvar|inputbox2><code><nowiki>{{#tag:inputbox | ...}}</nowiki></code></> inside the template.


The following example is a template to create a new wiki page from a named template:
</translate>

<source lang=moin>
{{#tag:inputbox |
type=create
buttonlabel=<translate> Create new {{{1|article}}}</translate>
preload={{{2|Template:Article}}} }}
</source>

<translate>

When instantiating the template, the first parameter gives the item that is created (default: <tvar|article><code>article</code></>) as spelled out in the button, the second parameter gives the name of the template used to create the item (default: <tvar|template><code>Template:Article</code></>).


E.g., the code for an input box to create a new project from a project template might look like this:
</translate>

<source lang=moin>
{{Template:CreateNew|project|Template:Project}}
</source>

<translate>
== See also == 
</translate>
*{{ll|Extension:Create Page}}

{{OnWikimedia}}

[[Category:Form extensions{{#translation:}}]]
[[Category:Page creation extensions{{#translation:}}]]
[[Category:Search widget extensions{{#translation:}}]]
[[Category:Edit box extensions{{#translation:}}]]

Extension:InputBox - Bewerkingsoverzicht

Thomas: 1 versie geïmporteerd

interwiki>FWDekker op 18 jul 2019 om 17:49