Erweiterung:InputBox
InputBox Freigabestatus: stabil |
|
---|---|
Einbindung | Tag , Seitenaktivität , Suche |
Beschreibung | Erlaubt Benutzern vorgefertigte HTML-Formulare in Wiki-Seiten einzubauen |
Autor(en) |
|
Letzte Version | Continuous updates |
MediaWiki | >= 1.43 |
Datenbankänderungen | Nein |
Lizenz | MIT-Lizenz |
Herunterladen | |
|
|
Quarterly downloads | 250 (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 Ordnerextensions/
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>
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=
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 |
|
<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 " |
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 " |
search, fulltext | ? | <inputbox>
type=search
namespaces=Main**,Help
</inputbox>
|
||
prefix= |
Remark: underscores aren't recognized as spaces. |
search, fulltext, create | ? | <inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox>
|
The button below prefixes the name with | |
placeholder= | Define placeholder text that will display in the input box when it is empty. | Alle Arten |
|
<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 |
|
<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 |
|
<inputbox>
type=create
preload=Log
preloadparams[]=param1
preloadparams[]=param2
</inputbox>
|
||
searchfilter= | Specify parameters to append to the search | search, fulltext |
|
<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
Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet: Dies ist keine maßgebliche Liste. Softwarepakete und/oder Wiki-Farmen, bzw. Wiki-Hoster nutzen diese Erweiterung ggf., obwohl sie nicht in dieser Liste enthalten sind. Prüfe daher stets die Nutzung im verwendeten Softwarepaket und/oder bei der Wiki-Farm, bzw. dem Wiki-Hoster. |