Erweiterung:InputBox

Diese Erweiterung ist in MediaWiki 1.21 und darüber enthalten. Daher muss sie nicht erneut heruntergeladen werden. Allerdings müssen die folgenden Anweisungen trotzdem beachtet werden.

MediaWiki-Erweiterungen

InputBox Freigabestatus: stabil
Einbindung	Tag , Seitenaktivität , Suche
Beschreibung	Erlaubt Benutzern vorgefertigte HTML-Formulare in Wiki-Seiten einzubauen
Autor(en)	Erik Möller Leonardo Pimenta Rob Church Trevor Parscal Daniel Schuba
Letzte Version	Continuous updates
MediaWiki	>= 1.43
Datenbankänderungen	Nein
Lizenz	MIT-Lizenz
Herunterladen	Erweiterung herunterladen Git [?]: Git master herunterladen Repository durchsuchen (Phabricator · GitHub) Ergänzungen und Änderungen Repository-Mitwirkende (GitHub) Code-Review
Tags <inputbox>
Verwendete Hooks MediaWikiPerformAction ParserFirstCallInit SpecialPageBeforeExecute
Quarterly downloads	235 (Ranked 24th)
Public wikis using	10,897 (Ranked 10th)
Übersetze die InputBox-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme	Offene Aufgaben · Einen Fehler melden

Die Erweiterung InputBox fügt vorprogrammierte HTML-Formularfelder in Wikiseiten ein. Benutzer können mit diesen Formularfeldern interagieren (z.B. durch Schreiben von Text, Auswahl von Menüpunkten, usw.); Dies kann z.B. durch Texteingabe geschehen.

InputBox was originally created by Erik Möller for the purpose of adding a Einen Artikel erstellen box to Wikinews.

Installation

• Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens InputBox im Ordner extensions/ ablegen.
  Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/InputBox
• Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:

  wfLoadExtension( 'InputBox' );
  

•  Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.

Beispiel

Box für das Erstellen eines neuen Artikels

Wiki Quelltext

<inputbox>
type=create
width=30
break=no
</inputbox>

Allgemeine Syntax

InputBoxen sind folgendermaßen konstruiert:

<inputbox>
type=
bgcolor=
width=
page=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
fulltextbutton=
labeltext=
break=
namespaces=
prefix=
placeholder=
minor=
nosummary=
summary=
id=
inline=
dir=
preloadparams[]=
searchfilter=
useve=
usedt=
arialabel=
</inputbox>

The type parameter is mandatory. Alle restlichen Parameter sind optional. preloadparams[] können auch mehrmals erscheinen.

Arten der Boxen

Standardmäßig werden die "Absenden"-Knöpfe unterhalb des Eingabefeldes angezeigt.

Der "Absenden"-Knopf kann auch auf die rechte Seite des Eingabefeldes verschoben werden. Dies ist mit dem Zeilenumbruch-Parameter break=no möglich, der den Zeilenumbruch zwischen dem Eingabefeld und dem Knopf entfernt.

Beispielsweise ist es in Suchfeldern sehr nützlich den "Absenden"-Knopf auf der rechten Seite des Eingabefeldes zu positionieren, da sonst das Roll-Down-Menü mit entsprechenden Suchvorschlägen den Knopf unterhalb des Feldes überdeckt.

Typ	Beispiel	Beschreibung
search		Erzeugt ein Suchfeld mit 50 Zeichen Standardbreite. Der im Suchfeld eingegebene Inhalt wird nach dem genauen Seitentitel (erste Schaltfläche) oder dem Text in den Artikeln (zweite Schaltfläche) durchsucht.
create		Erzeugt eine neue Seite. Eingegebene Informationen werden als Seitentitel der neuen Seite übernommen. Der im Suchfeld eingegebene Inhalt ist der Name der zu erstellenden Seite (oder der zu bearbeitenden Seite, falls sie bereits existiert).
comment		Fügt einen neuen Abschnitt am unteren Ende der im Eingabefeld angegebenen Seite ein (erstellt die Seite, wenn sie neu ist).
commenttitle		Fügt einen neuen Abschnitt mit der, im Textfeld eingegebenen, Abschnitts-Überschrift ein. Der Titel kann mittels des Parameters default= definiert werden. Die Seite muss mit dem Parameter page= definiert werden. For some reason this does NOT work when using the extension by invoking it with {{#tag}}, only when using ‎<inputbox>. (eingeführt in rev:47203)
fulltext		Ausschließlich Suchfunktion mit Volltextsuche-Knopf, ohne den Ausführen Knopf. (eingeführt in rev:45269)
move		Verschieben einer Seite zu einem anderen Begriff. This also doesn't work when creating it by invoking a tag. (eingeführt in gerrit:97559)

Im Falle von type=search2 befindet sich der Knopf standartmäßig auf der rechten Seite. Zur Zeit ist es leider nicht möglich weitere Parameter in derartige Eingabefelder hinzuzufügen. Dieses Suchfeld durchsucht das gesamte Wiki auf dessen Seiten es platziert wurde.

Typ	Beispiel
search2

Parameter

Parameter	Beschreibung	Bereich	Kompatibilität	Beispiel	Ergebnis
arialabel=	Supply the aria-label attribute to the inputbox to allow generated markup be accessible to screen readers	Alle Arten	≥ 1.35 Gerrit change 572050	<inputbox> type=search arialabel=Search the Wiki </inputbox>
bgcolor=	Definiert die Hintergrundfarbe der Tabelle (HTML Farbwerte). Verwende keine Fußnoten.	Alle Arten	?	<inputbox> type=search bgcolor=#eeeeff </inputbox>
width=	Definiert die Länge des Eingabefeldes gemessen in Zeichen.	Alle Arten	?	<inputbox> type=create width=24 </inputbox>
default=	Standardmäßiger Text, der im Eingabefeld erscheint.	Alle Arten	?	<inputbox> type=comment default=User talk:Eloquence </inputbox>
preload=	Die Seite unterhalb dieses Titels wird bereits in das leere Eingabefeld vorausberechnet (vergleiche Manual:Creating pages with preloaded text ), wenn eine neue Seite erstellt werden soll.	create, comment, commenttitle	?	<inputbox> type=create preload=Log </inputbox>
Füge den Namen einer noch nicht existierenden Seite in dieses als Beispiel dienende Eingabefeld, und klicke auf "Seite erstellen" oder "Neuer Abschnitt" um einen Test durchzuführen.
editintro=	Die Seite, welche unterhalb dieses Parameters angegeben ist, wird angezeigt, wenn die Definition oberhalb dieses Bearbeitungsfeldes dies bestimmt.	create, comment	?	<inputbox> type=comment editintro=MediaWiki:Missingcommenttext </inputbox>
buttonlabel=	Dieses Label wird vom Zentralen Knopf des Formulars verwendet.	Alle Arten	?	<inputbox> type=comment buttonlabel=Füge einen neuen Abschnitt hinzu </inputbox>
hidden=	Dies bewirkt, dass kein Eingabefeld angezeigt wird. Er wird mit dem Parameter "default" verwendet, der hier nun kein Standard, sondern ein fester Wert des Seitentitels der Seite ist. Any value means yes/true.	create, comment	?	<inputbox> type=comment editintro=Extension:InputBox/editintro comment preload=Extension:InputBox/preload hidden=yes default=Extension talk:InputBox buttonlabel=Füge einen Kommentar auf der Diskussionsseite hinzu </inputbox>
searchbuttonlabel=	Dieses Label wird für den Knopf "Gesamten Text durchsuchen" des Suchformulars verwendet.	search, fulltext	?	<inputbox> type=search searchbuttonlabel=Genauere Suche </inputbox>
fulltextbutton=	Zeige den gesamten Text des Suchknopfes im search2 Formular	search2	?	<inputbox> type=search2 searchbuttonlabel=Genauere Suche fulltextbutton=true </inputbox>
labeltext=	Text, der neben dem Knopf gedruckt wird	search2	?	<inputbox> type=search2 searchbuttonlabel=Genauere Suche labeltext=Suche nach: </inputbox>	Suche nach:
break=	Entweder wird eine Linie zwischen dem Eingabefeld und dem Knopf beziehungsweise den Knöpfen angezeigt, oder nicht. Standardmäßig wird hier yes verwendet (also ein Zeilenumbruch mit Trennlinie).	Alle Arten	?	<inputbox> type=create width=24 break=no </inputbox>
namespaces=	Hilfe für Kontrollkästchen für Namensräume in der Volltextsuche. Mittels "Main**", wird der standardmäßige Artikelnamensraum geprüft.	search, fulltext	?	<inputbox> type=search namespaces=Main**,Help </inputbox>	Main Help
prefix=	Narrow down search to pages beginning with certain prefix. Note this only works with certain search back-ends, currently only Extension:CirrusSearch/de . Defaults to empty string (search all pages). Create new page beginning with a certain prefix. In type=move, the prefix is prepended to the default parameter. Remark: underscores aren't recognized as spaces.	search, fulltext, create	?	<inputbox> type=search prefix={{FULLPAGENAME}}/Archive </inputbox>	The button below prefixes the name with Special:Mypage/.
placeholder=	Define placeholder text that will display in the input box when it is empty.	Alle Arten	≥ 1.19	<inputbox> type=search placeholder=Durchsuche dieses Wiki </inputbox>
page=	Page to posts comment to, or page to move.	comment, move		<inputbox> type=comment page=Project:Sandbox </inputbox>
minor=	Kleine Änderung.	comment, create		<inputbox> type=comment page=Project:Sandbox minor=true </inputbox>
nosummary=	Bearbeitungszusammenfassung (Überschrift) ist nicht erforderlich für einen neuen Kommentar.	comment		<inputbox> type=commenttitle page=Special:Mypage/inputbox test nosummary=true </inputbox>
summary=	Bearbeitungszusammenfassung oder Verschiebungsgrund.	create, move		<inputbox> type=create default=Special:Mypage/inputbox test summary=Foo </inputbox>
id=	id attribute for <form>.	Alle Arten	≥ 1.23 for some types	<inputbox> type=comment page=Project:Sandbox summary=Foo id=bar </inputbox>
inline=	Make the InputBox be an inline element (no line break at beginning). Any value means yes/true.	search2		Text hier: <inputbox> type=search2 inline=true width=10 </inputbox>	Text hier:
dir=	Von Rechts nach links (rtl) oder von links nach rechts (ltr). Defaults to directionality of the page's language.	Alle Arten		<inputbox> dir=rtl type=comment page=Project:Sandbox summary=Foo </inputbox>
preloadparams[]=	Specify parameters to the preload text. See Creating pages with preloaded text.	create, comment, commenttitle	≥ 1.25	<inputbox> type=create preload=Log preloadparams[]=param1 preloadparams[]=param2 </inputbox>
searchfilter=	Specify parameters to append to the search	search, fulltext	≥ 1.30	<inputbox> type=search searchfilter=insource:foo </inputbox>
useve=	When creating a page the input box will use the new visual editor, if the extension is installed, and this parameter is set to any value.	create, comment		<inputbox> type=create break=no useve=true </inputbox>
usedt=	When adding a new section, the input box will open the DiscussionTools new topic tool, if the extension is installed, and this parameter is set to any value.	comment, commenttitle		<inputbox> type=commenttitle page=Project:Sandbox usedt=true </inputbox>

Applying create to an existing page simply gives the edit page. In that case preload is ignored. Applying comment for a new page works.

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

Ausrichtung

Wenn Sie ein rechtsbündiges Eingabefeld erzeugen wollen, dann machen Sie so etwas, wie:

<div style="float:right; width:42em">
<inputbox>
type=create
</inputbox>
</div>

Gives:

Parser Funktion

Verwendung der InputBox in einer Vorlage

In order to create many similar input boxes, InputBox can be used in a template. However, passing template parameters to InputBox parameters only works if the ‎<inputbox>...‎</inputbox> tag is written as {{#tag:inputbox | ...}} inside the template.

The following example is a template to create a new wiki page from a named template:

{{#tag:inputbox |
type=create
buttonlabel=Create new {{{1|article}}}
preload={{{2|Template:Article}}} }}

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

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

{{Template:CreateNew|project|Template:Project}}

Siehe auch

• Extension:Create Page