L'action {{include page="PagePrincipale"}} (WikiNi >= 0.4.1) permet d'inclure dans une page une autre page du wiki (ici la page PagePrincipale). Cette action possède plusieurs applications :
  • Regrouper plusieurs pages en une seule et par exemple, cr√©er un document √† partir de diff√©rentes "sections" diss√©min√©es dans plusieurs pages ;
  • Commenter/critiquer une page en lecture seule
    • (en l'incluant dans le corps d'une autre page)
  • Constituer des blocs d'informations redondantes qui seront r√©p√©t√©s (incluses) dans plusieurs autres pages
    • (il peut s'agir d'un menu, d'une signature, d'une mention l√©gale, ou autre)
  • Configurer le menu de navigation de WikiNi
    • (en indiquant "navigation_links" => "{{include page=\"MenuDuHaut\"}}", dans le fichier wakka.config.php. La page MenuDuHaut, optionnellement prot√©g√©e en √©criture, contiendra le menu qui sera affich√©.)
  • R√©aliser une sorte de syndication
    • (en incluant des pages d'un autre WikiNi)

Paramètres

Cette action accepte deux paramètres :
  • page (param√®tre obligatoire) : d√©signe la page √† inclure. Ce param√®tre peut √™tre une page locale au WikiNi ou une page d'un autre WikiNi .
  • class (param√®tre optionnel) : d√©signant un ou plusieurs √©l√©ments de style qui seront combin√©s pour d√©terminer l'aspect que prendra la page incluse.

Le paramètre class liste un ou plusieurs éléments de style, séparés par des espaces. Les éléments possibles sont les suivants :
  • right : bloc flotant √† droite { float: right; width: 17%; }
  • left : bloc flotant √† gauche { float: left; width: 17%; }
  • solid_border : encadr√© noir { border: solid; padding: 2px; }
  • gray_background : fond gris { background-color: #DDDDDD; }
  • small_fonts : petites polices { font-size: 0.8em; }
  • big_fonts : grandes polces { font-size: 1.2em; }
  • height10em : boite d'une hauteur de 10 lignes de texte, avec ascenseur { height: 10em; overflow: scroll; }
  • height15em : boite d'une hauteur de 15 lignes de texte, avec ascenseur { height: 15em; overflow: scroll; }
  • height30em : boite d'une hauteur de 30 lignes de texte, avec ascenseur { height: 30em; overflow: scroll; }
  • height60em : boite d'une hauteur de 60 lignes de texte, avec ascenseur { height: 60em; overflow: scroll; }

Wikini propose par défaut les "actions" suivantes.

array(4) { [0]=> string(107) "ActionFindpage " [1]=> string(0) "" [2]=> string(14) "ActionFindpage" [3]=> string(14) "ActionFindpage" } array(4) { [0]=> string(109) "ActionMyChanges " [1]=> string(0) "" [2]=> string(15) "ActionMyChanges" [3]=> string(15) "ActionMyChanges" } array(4) { [0]=> string(105) "ActionMyPages " [1]=> string(0) "" [2]=> string(13) "ActionMyPages" [3]=> string(13) "ActionMyPages" } array(4) { [0]=> string(123) "ActionRecentChangesRSS " [1]=> string(0) "" [2]=> string(22) "ActionRecentChangesRSS" [3]=> string(22) "ActionRecentChangesRSS" } array(4) { [0]=> string(119) "ActionRecentComments " [1]=> string(0) "" [2]=> string(20) "ActionRecentComments" [3]=> string(20) "ActionRecentComments" } Le paramètre class liste des éléments de style qui seront combinés. Par exemple, si l'on souhaite obtenir une boite grise avec une bordure et de petits caractères, on écrira : {{include page="ListeDesActionsWikini" class="right height15em small_fonts solid_border gray_background"}} (voir le résultat dans le cadre ci-contre)

Si le paramètre class est absent, le texte inclus sera présenté de manière non différenciée par rapport au reste de la page.

Une page ne peut-√™tre inclue dans elle-m√™me. De m√™me, une cha√ģne d'inclusion ne peut contenir deux fois la m√™me page. Par ensmple, si la page Toto inclus la page Titi, et si la page Titi inclus la page Tata, alors ni la page Titi ni la page Tata ne peuvent inclure la page Toto, sans quoi une erreur sera produite.