Erweiterung:InputBox

From mediawiki.org
This page is a translated version of the page Extension:InputBox and the translation is 76% complete.
Diese Erweiterung ist üblicherweise 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
OOjs UI icon advanced-invert.svg
InputBox
Freigabestatus: stabil
Simple Input Form.png
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.30+
Datenbankänderungen Nein
Lizenz MIT-Lizenz
Herunterladen
* <inputbox>
Ü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.
  • Folgenden Code am Ende deiner LocalSettings.php hinzufügen:
    wfLoadExtension( 'InputBox' );
    
  • Yes Erledigt – Zu Special:Version in dem Wiki (bei Einstellung auf deutsch nach Spezial:Version) navigieren, um die erfolgreiche Installierung der Erweiterung zu überprüfen.


Beispiel

Box für das Erstellen eines neuen Artikels

Wiki Quelltext

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

Ergebnis

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=
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.

Art Beispiel Beschreibung
type=search
Erzeugt ein Suchfeld mit 50 Zeichen Standardbreite. Eingegebener Inhalt im Suchfeld wird gesucht.
type=create

Erzeugt eine neue Seite. Eingegebene Informationen werden als Seitentitel der neuen Seite übernommen.
type=comment

Fügt einen neuen Abschnitt am Ende der Seite ein, die im Eingabefeld festgelegt wird.
type=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. (eingeführt in rev:47203)
type=fulltext
Ausschließlich Suchfunktion mit Volltextsuche-Knopf, ohne den Ausführen Knopf. (eingeführt in rev:45269)
type=move

Verschieben einer Seite zu einem anderen Begriff. (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.

Art Beispiel
type=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.

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>
 
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>
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). 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
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 true. create, comment
<inputbox>
type=create
break=no
useve=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>


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