Index

M3.2.b Ferme : les éléments configurables

Création de comptes super admin pour administrer des wikis hébergés

Activable dans "Fichier de conf"
  • ajouter un super administrateur à chaque wiki afin de passer outre ou palier le compte administrateur de ce wiki ;
  • de supprimer, pour chaque wiki le compte superadmin.
Pour ce faire deux solutions
  • La première, aller dans "gestion du site" / "Fichier de conf" / Ferme. Entrez un "Login du super admin" et un "Pass du super admin" puis cliquer sur "Valider"
  • La seconde manière consiste à ajouter les deux lignes suivantes à wakka.config.php
'yeswiki-farm-admin-name' => 'NomWikidusuperadmin',
'yeswiki-farm-admin-pass' => 'votremotdepasse',

Ceci fait apparaître un bouton "ajouter le compte" en regard de chaque wiki dans la page d'administration des wikis. Une fois qu'on s'est créé un compte super admin pour un wiki, le bouton en regard du wiki dans la page d'administration des wikis devient rouge avec le libellé "supprimer le compte". Appuyer sur ce bouton ne supprime le compte super administrateur que sur le wiki en question.

Dossier de stockage des wikis

Activable dans "Fichier de conf"
Par défaut, lorsqu'un wiki est créé dans la ferme, les fichiers de ce wikis sont placés dans un dossier portant le nom du wiki et placé à la racine du wiki de la ferme. Si vous souhaitez que les dossiers de vos wikis ne soient pas mélés à ceux qui sont nécessaires à la ferme, vous pouvez paramétrer le comportement de votre ferme à cet égard. Il est nécessaire de jouer sur deux paramètres :
  • le nom du dossier de stockage des wikis,
  • l'url de base des wikis de la ferme.
warning, ce dossier devra être créé sur votre serveur
Le nom du dossier
On utilise à cet effet le paramètre yeswiki-farm-root-folder. Il s'agit en fait du chemin relatif du dossier de stockage des wikis. Si vous voulez que vos wikis soient créés dans le sous-dossier wikis du dossier de votre ferme, vous devez le préciser dans "Fichier de conf" ou en ajoutant au wakka.config.php une ligne contenant :
'yeswiki-farm-root-folder' => 'wikis',

Par défaut, ce paramètre vaut 'yeswiki-farm-root-folder' => '.',

L'url de base des wikis
On utilise à cet effet le paramètre yeswiki-farm-root-url. Si l'adresse de ma ferme est https://ma.ferme.url/ et que vous voulez que vos wikis soient créés dans le sous-dossier wikis de cette ferme, vous devez préciser dans "Fichier de conf" ou en ajoutant au wakka.config.php une ligne contenant :
'yeswiki-farm-root-url' => 'https://ma.ferme.url/wikis/',

Par défaut, ce paramètre n'est pas présent.

Attention — Ces deux paramètres doivent être en cohérence l'un avec l'autre. Si, dans le cas de notre exemple, vous saisissez 'yeswiki-farm-root-folder' => 'wikis', tout en n'ajoutant pas 'yeswiki-farm-root-url' => 'https://ma.ferme.url/wikis/', vous ne pourrez jamais accéder aux wikis créés.

Thèmes activables

Activable dans "Fichier de conf" thèmes supplémentaires (doivent être présents dans le dossier thèmes du wiki source)
'yeswiki-farm-extra-themes' => ['bootstrap3'],


Interface de sélection des thèmes activables

Activable uniquement dans "wakka.config.php" tableau des choix de themes (ne s'affiche pas si un seul choix possible)
'yeswiki-farm-themes' => [
    [
      'label' => 'Margot (thème par défaut de YesWiki)', //nom du thème à l'écran
      'screenshot' => 'https://ferme.yeswiki.net/tools/ferme/screenshots/margot.jpg', (screenshot du theme dans tools/ferme/screenshots)
      'theme' => 'margot', //nom de theme
      'squelette' => '1col.tpl.html', //squelette par defaut
      'style' => 'margot.css' //style par defaut
    ],
    [
      'label' => 'Bootstrap (très simple)', //nom du thème à l'écran
      'screenshot' => 'https://ferme.yeswiki.net/tools/ferme/screenshots/bootstrap.jpg', //screenshot du theme dans tools/ferme/screenshots
      'theme' => 'bootstrap3', //nom de theme
      'squelette' => '1col.tpl.html', //squelette par defaut
      'style' => 'bootstrap.min.css' //style par defaut
    ],
    [
      'label' => 'Paper (material design de google)', //nom du thème à l'écran
      'screenshot' => 'https://ferme.yeswiki.net/tools/ferme/screenshots/paper.jpg', //screenshot du theme dans tools/ferme/screenshots
      'theme' => 'bootstrap3', //nom de theme
      'squelette' => '1col.tpl.html', //squelette par defaut
      'style' => 'paper.bootstrap.min.css' //style par defaut
    ],
    [
      'label' => 'Cyborg (theme sombre, fond noir)', //nom du thème à l'écran
      'screenshot' => 'https://ferme.yeswiki.net/tools/ferme/screenshots/cyborg.jpg', //screenshot du theme dans tools/ferme/screenshots
      'theme' => 'bootstrap3', //nom de theme
      'squelette' => '1col.tpl.html', //squelette par defaut
      'style' => 'cyborg.bootstrap.min.css' //style par defaut
    ],
  ],

Tools activables

Activable uniquement dans "wakka.config.php" tools supplémentaires (doivent etre présents dans le dossier tools du wiki source)
'yeswiki-farm-extra-tools' => [],


Droits d'accès

Activable uniquement dans "wakka.config.php" Proposer de sélectionner les droits d'accès (ne s'affiche pas si qu'un choix possible)
  • 'yeswiki-farm-acls' => [
        [
          'label'    => 'Wiki ouvert', //Description des droits d'acces
          'read'     => '*', // lecture
          'write'    => '*', // ecriture
          'comments' => '*' // commentaires
        ],
        [
          'label'    => 'Wiki protégé par un identifiant / mot de passe unique', //Description des droits d'acces
          'read'     => '{{user}}', // lecture
          'write'    => '{{user}}', // ecriture
          'comments' => '{{user}}',  // commentaires
          'create_user' => true
        ]
      ],
    

Nom de la page principale

Activable uniquement dans "wakka.config.php"
  • nom de la page d'accueil par défaut
'yeswiki-farm-homepage' => 'PagePrincipale',

Et pour la mention

options d'ajout sur certaines pages
'yeswiki-farm-options' => [
    [
      'label'    => 'Je souhaite intégrer un pad dans mon wiki', //Description de l'ajout
      'checked'  => false, // coche par defaut ?
      'page'    => 'PageMenuHaut', // Page
      'content' => " - [[EtherPad Pad]]\n" // Contenu en syntaxe wiki de l'ajout
    ],
    [
      'label'    => 'Je souhaite recevoir les informations sur mon wiki des autres projets', //Description de l'ajout
      'checked'  => true, // coche par defaut ?
      'page'    => 'PageMenuHaut', // Page
      'content' => " - [[InfosMutualisees Infos mutualisées]]\n" // Contenu en syntaxe wiki de l'ajout
    ]
  ],


cas spécifique ou l'on veut créer un user sur le wiki source
'yeswiki-farm-create-user' => false,

ajouter des valeurs dans le fichier de configuration des wikis créés
'yeswiki-farm-extra-config' => ['BAZ_ADRESSE_MAIL_ADMIN' => 'admin@yeswiki.test'],


image de fond par défaut des wikis créés
'yeswiki-farm-bg-img' => '',