Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

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

Formulaire par défaut : une liste déroulante avec tous les espaces de noms du wiki et un champ pour le nom de page.
{{NEWPAGE> test}} avec l'option de configuration «Masquer la sélection de l'espace de noms» activée.
{{NEWPAGE>test}} avec l'option de configuration «Masquer la sélection de l'espace de noms» désactivée.
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 :

<?php echo p_render('xhtml',p_get_instructions('{{NEWPAGE}}'),$info) ?>
Modèles d'espace de noms

Des formulaires d'ajout de nouvelle page peuvent également être ajoutés aux modèles d'espace de noms.

Les modèles de remplacement @ID@ et @NS@ peuvent être utilisés dans le paramètre d'espace de noms du plugin.

Désinstallation

Voir aussi


Basé sur « Add New Page Plugin » par Benjamin Santalucia, Sam Wilson, Michael Braun, Gerrit Uitslag, Albert Chern.