Apri il menu principale
Gnome-help.svgSportello informazioni


Inputbox è un'estensione di MediaWiki sviluppata da Erik Möller per aggiungere form HTML predefiniti alle pagine wiki, inizialmente creata per lo scopo di aggiungere un box "Crea un articolo" a Wikinews. Richiede MediaWiki 1.5 e uno script per le estensioni (vedi la sezione Installazione).

StrutturaModifica

Gli Inputbox sono costruiti così:

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

Il parametro "type" è obbligatorio; tutti gli altri parametri sono opzionali.

SintassiModifica

Sintassi comprendente tutti i vari parametri impostabili:

<inputbox>
type=
bgcolor=
width=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
break=
namespaces=
prefix=
placeholder=
</inputbox>

Tipi di InputboxModifica

Tipo Descrizione Esempio
type=search

Genera un campo di ricerca con una larghezza di 50 caratteri. La denominazione dei bottoni può essere variata (vedi sotto); i nomi di default sono MediaWiki:Tryexact e MediaWiki:Searchfulltext. La casella di testo permette di specificare la parola da cercare.

type=create

Permette di creare una nuova pagina o di modificare una esistente. Guarda le opzioni preload= e editintro= sotto. L'etichetta del bottone può essere cambiata, guarda sotto; quella di default è MediaWiki:Createarticle. Il campo di testo permette di specificare quale pagina deve essere modificata.


type=comment

Aggiunge una o più sezioni ad una pagina esistente, o ne crea una nuova, con edit summary uguale al nome della sezione inserita. L'etichetta del bottone può essere cambiata, guarda sotto; quella di default è MediaWiki:Postcomment; nota che questo messaggio è usato anche nella sidebar della vecchia skin "Standard". La casella di testo specifica quale pagina deve essere modificata.


type=commenttitle

Aggiunge una nuova sezione con l'intestazione della sezione digitato nella casella di testo. La pagina deve essere specificata con page = parametro.


type=fulltext

Appare solo il pulsante Ricerca nel testo senza Cerca corrispondenza esatta.

ParametriModifica

Parametro
Funzione
Descrizione Esempio

bgcolor=
Tutti i tipi

Imposta il colore di sfondo (valori HTML). Non usare le virgolette.

<inputbox>
type=search
bgcolor=#eeeeff
</inputbox>

produce:

width=
Tutti i tipi

Imposta la larghezza della casella di testo in caratteri.

<inputbox>
type=create
width=6
</inputbox>

produce:


default=
Tutti i tipi

Permette di specificare il testo di default da mettere nel box.

<inputbox>
type=comment
default=Wikipedia:Bar
</inputbox>

produce:


preload=

comment, create

Quando si scrive nella casella di testo il nome di una pagina non esistente e si preme il pulsante, viene aperta la finestra di edit della relativa pagina con scritto il testo specificato dall'opzione. Scrivi il titolo di una pagina non esistente nel box di esempio per provare questa funzione.

<inputbox>
type=create
preload=Progetto:Cucina/Crea_una_nuova_voce/Gastronomia
</inputbox>

produce:


editintro=
comment, create

Quando si scrive nella casella di testo il nome di una pagina non esistente e si preme il pulsante, viene aperta la finestra di edit della relativa pagina. Il testo specificato in editintro apparirà sopra la casella di salvataggio, ma non verrà salvato.

<inputbox>
type=create
editintro=Wikipedia:Bot/Richieste/editintro
</inputbox>

produce:


buttonlabel=
Tutti i tipi

Questa opzione serve per cambiare l'etichetta del bottone principale.

<inputbox>
type=comment
buttonlabel=Aggiungi un nuovo commento
</inputbox>

produce:


</inputbox>

hidden=
create, comment

Questa opzione è usata per nascondere l'inputbox. È utilizzata assieme al parametro default, che ora non è più il valore predefinito ma è fisso.

<inputbox>
type=comment
buttonlabel=Aggiungi un commento nella pagina di discussione
hidden=yes
default=Discussioni aiuto:Inputbox
</inputbox>

produce:


searchbuttonlabel=
search

Questa opzione è usata per cambiare l'etichetta "Search full text" del relativo pulsante.

<inputbox>
type=search
searchbuttonlabel=Cercaaaa
</inputbox>

produce:

break=
search, create

Questa opzione serve per specificare se andare a capo tra il campo di testo e i bottoni. Il valore di default è yes.

<inputbox>
type=search
width=4
break=no
</inputbox>

produce:

namespaces=
search, fulltext

Questa opzione serve per far apparire i checkboxes dei namespace specificati, in modo da poterli includere o escludere dalla ricerca.
Con "Namespace**" esso è selezionato di default.

<inputbox>
type=search
namespaces=Aiuto**,Wikipedia
</inputbox>

produce:

prefix=
search, fulltext, create

Affina la ricerca alle pagine che iniziano con il prefisso dato. Il valore di default è una stringa vuota, ossia ricerca in tutte le pagine. Permette di creare una nuova pagina o di modificarne una esistente a partire da un dato prefisso. Nota:Gli underscores non sono riconosciuti come spazi.

<inputbox>
type=search
prefix=Wikipedia:Bar/Discussioni/
</inputbox>

produce:

placeholder=
Tutti i tipi

Questa funzione permette di far comparire nella casella di testo un testo segnaposto nel momento in cui non si ha digitato testo nella casella stessa.

<inputbox>
type=search
placeholder=Ricerca...
</inputbox>

produce:

Usare il pulsante "Crea" su di una pagina già esistente rimanda alla pagina di modifica della relativa pagina. In questo caso editintro e preload sono ignorati.

AvvertimentiModifica

  • Variabili (tipo {{CURRENTMONTH}}), parametri e template non sono ammessi come valori dei parametri di Inputbox; guarda m:Template talk:Inputbox demo, dove al posto del template immesso come valore di defaultvalue, l'Inputbox inserisce il suo contenuto.

InstallazioneModifica

  1. Scarica e salva il file inputbox.php nella cartella "extensions" della tua installazione di MediaWiki (il software di Wikipedia).
  2. Apri e modifica il file LocalSettings.php aggiungendo le seguenti righe vicino alla fine:
require_once("extensions/inputbox.php");

NOTA: Assicurati che essa stia sopra al tag php di chiusura in modo che risulti così:

require_once("extensions/inputbox.php");
?>

EsempiModifica