{{tag>Logiciel}}
====== addnewpage : Ajouter une nouvelle page ======
Ce plugin permet d'ajouter des formulaires de nouvelle page dans les pages du wiki pour que les utilisateurs puissent entrer le titre d'une nouvelle page et aller directement l'éditer.
L'espace de noms pour la nouvelle page peut :
* être sélectionné dans une liste déroulante du formulaire de nouvelle page
* ou spécifié dans la syntaxe du formulaire.
Seuls les espaces de noms dans lesquels l'utilisateur est autorisé à écrire sont affichés.
Le bouton d'envoi du formulaire est désactivé si le champ titre est vide.
===== Pré-requis =====
===== Installation =====
Recherchez et installez le plugin **addnewpage** à l'aide du gestionnaire d'extensions.
===== Configuration =====
Vous pouvez configurer le plugin dans le gestionnaire de configuration de DokuWiki. Il existe quatre paramètres :
; Excluded namespaces
: Une liste d'espaces de noms, séparés par des points-virgules, à exclure de la liste de sélection des espaces de noms.
: Par défaut : wiki;playground.
; Show root namespace
: Indique s'il faut afficher l'espace de noms racine du wiki dans la liste de sélection des espaces de noms.
: Par défaut : true.
; Hide namespace selection
: Masquer la liste de sélection d'espace de noms. Ne s'applique que si un espace de noms est donné (voir ci-dessus).
: Par défaut : true.
; Hide “access denied” message
: Ne pas afficher le message «Vous n'êtes pas autorisé à ajouter des pages» lorsque l'utilisateur n'est pas autorisé à créer des pages.
: Par défaut : false (c'est à dire montre le message)..
===== Utilisation =====
Placez {{NEWPAGE}} n'importe où dans une page wiki pour obtenir une zone de saisie de titre de nouvelle page et un menu déroulant de sélection d'espace de noms.
==== Captures d'écran ====
| {{ logiciel:internet:dokuwiki:plugins:addnewpage:addnewpage-01.png }} | Formulaire par défaut : une liste déroulante avec tous les espaces de noms du wiki et un champ pour le nom de page. |
| {{ logiciel:internet:dokuwiki:plugins:addnewpage:addnewpage-02.png }} | %%{{NEWPAGE> test}}%% avec l'option de configuration «Masquer la sélection de l'espace de noms» activée. |
| {{ logiciel:internet:dokuwiki:plugins:addnewpage:addnewpage-03.png |}} | %%{{NEWPAGE>test}}%% avec l'option de configuration «Masquer la sélection de l'espace de noms» désactivée. |
| {{ logiciel:internet:dokuwiki:plugins:addnewpage:addnewpage-04.png |}} | Les espaces de noms parents sont grisés là où l'utilisateur n'a pas accès pour ajouter des pages. |
==== Syntaxe ====
=== Basique ===
La syntaxe de base est :
{{NEWPAGE}}
Ou, pour spécifier un espace de noms :
{{NEWPAGE>namespace}}
Où namespace est l'espace de noms cible pour la nouvelle page.
Quand c'est spécifié, la zone de sélection d'espace de noms peut être :
* soit masquée (par défaut),
* soit définie pour afficher uniquement les sous-espaces de noms de celui donné.
Ceci est configuré dans le gestionnaire de configuration principal du wiki. Si @PAGE@ (ou @NS@) est donné, l'ID de page actuel (ou son espace de noms) sera utilisé (par exemple pour une utilisation dans les modèles d'espace de noms ; voir ci-dessous).
=== New-page templates ===
Ce plugin est également compatible avec le plugin Nouveau modèle de page (notez qu'il s'agit d'une fonctionnalité distincte des modèles d'espace de noms décrits ci-dessous).
Pour spécifier un modèle à utiliser avec la nouvelle page, utilisez l'une des syntaxes suivantes :
| %%{{NEWPAGE#newtpl}}%% | Utilisez le modèle newtpl |
| %%{{NEWPAGE#newtpl1,newtpl2}}%% | Présente une liste déroulante de newtpl1 et newtpl2, permettant à l'utilisateur d'en choisir une |
| %%{{NEWPAGE#newtpl1|Title One,newtpl2|Title Two}}%% | Comme ci-dessus, mais avec de plus beaux titres |
Dans tous ces cas, la syntaxe de l'espace de noms de base > peut être incluse avant le caractère dièse #.
=== Occurrences multiples ===
La syntaxe %%{{NEWPAGE}}%% peut être ajoutée plusieurs fois sur la même page.
=== Modèles de site ===
Pour inclure un formulaire d'ajout de nouvelle page dans un modèle de site, utilisez la ligne suivante :