AdminModules

Les Modules


Table des matières

    Menu Général des Modules
    Désignation des colonnes
    Options par module
    Installer un nouveau module
    Mettre à jour un module
    Supprimer un module
    Création de module...


Menu Général des Modules

1

  • Voir permet d'afficher la liste des modules connus du système. La liste n'affichera pas des modules récemment enregistrés si une regénération n'a pas été faite suite à l'envoi du ou des nouveaux modules dans le répertoire modules du système.
  • Regénérer permet de mettre à jour la liste des modules en vérifiant le contenu du répertoire modules de PostNuke. Cette action doit être faite après l'ajout d'un ou plusieurs modules. Elle permet aussi de déterminer si une nouvelle version d'un module est disponible (quand les fichiers du modules ont été mis à jour). Et finalement, elle désigne des modules dont les fichiers ont pu être effacés.
  • Modifier la configuration offre la possibilité de déterminer le nombre de modules s'affichant par page... et offre aussi (tout comme dans les préférences du site), l'activation ou désactivation du support des modules anciens.

Désignation des colonnes

  • Nom du module : Nom réel du module (comme le nom du répertoire, exemple pnWiki)
  • Nom Affiché : Par défaut, c'est le nom réel mais ce nom peut être modifié afin que les modules conforme à l'API de PostNuke affiche un nom différent dans la barre d'adresse par exemple.
  • Description : Texte court généralement inscrit dans le fichier pnversion.php du module ou lors de l'installation de PostNuke pour les modules livrés avec le pack.
  • Répertoire : Nom du répertoire contenant les fichiers du module. Ce répertoire est placé dans le répertoire modules du système.
  • Version : Numéro de version généralement inscrit dans le fichier pnversion.php du module. Lors d'une mise à jour du module, le système compare ce numéro avec le numéro du nouveau fichier pnversion et inscrit dans l'état du module "Mise à jour disponible" et active le lien Mettre à jour dans les actions.
  • Etat : Affiche Actif, Inactif ou non-initialisé selon l'état du module. Un module conforme pourrait ne pas fonctionner si son état n'est pas "Actif".
  • Actions : Les actions possibles pour chacun des modules selon son état. (Voir les options par module)

Options par module

2

  • Initialiser : Permet d'exécuter le contenu du fichier pninit.php du module qui généralement s'occupe de la création de table, de l'inscription de variables relatives à ce module, etc. Lorsque l'initialisation se passe avec succès, le lien Initialiser devient Activer.
  • Activer : Permet de rendre actif un module. Si un module est inactif, le système pourrait refuser de le faire fonctionner.
  • Désactiver : Permet de rendre inactif un module.
  • Retirer : Supprime un module inactif et non-initialisé de la liste des modules. Les fichiers du modules doivent être supprimés du système, sinon, le module réapparaîtra à chaque regénération de la liste.
  • Extensions : Affiche la page des extensions disponibles du système. Ces extensions peuvent être de plusieurs type et si le module est programmé pour pouvoir utiliser des extensions, ces dernières peuvent être activées pour le module. (lien vers la doc extensions).
  • Admin : Lien vers l'administration du module. (NOTE : Un module n'a pas necéssairement d'administration, le fichier pnversion.php indique généralement 1 ou 0 selon le cas.) (Lien vers la création de module, section fichier pnversion).
  • Modifier : Permet de changer le nom affiché et la description du module.

Installer un nouveau module

Après avoir téléchargé un module, il faut le copier (ou l'envoyer par ftp) dans le répertoire modules du système. Pour l'exemple, téléchargez le module suivant : http://www.postnuke-france.org/divers/Example_0750.zip

Ce module a pour nom Example et sert de module de base et d'exemple pour les développeurs.

Le zip contient une structure de répertoire mais celle-ci n'est pas standardisée. Les développeurs leur façon de faire. Le zip est constitué comme suit :

  • html
    • modules
      • Example
        • pnblocks / etc...
        • pndocs / etc...
        • pnimages / etc...
        • pnlang / etc...
        • pntempaltes / etc...
        • index.html
        • pnadmin.php
        • pnadminapi.php
        • pninit.php
        • pntables.php
        • pnuser.php
        • pnuserapi.php
        • pnversion.php

Dans la structure ci-haut, c'est le répertoire Example lui-même qui doit être copié dans le répertoire module sur votre ordinateur ou votre hébergement.

Une fois copié, rendez-vous dans l'administration des modules.

Régénérez la liste en cliquant sur le lien Regénérer

Le module Example devrait normalement apparaître dans la liste comme étant non-initialisé. (Si les modules sont filtrés par lettre ou par un filtre quelconque, changez le filtre afin de pouvoir le voir).

Dans les actions possibles de la colonne Actions, vous pourrez Initialiser ce module.

Certains modules ont une installation interactive et peuvent afficher des informations ou poser des questions lors de l'initialisation.

Si l'option d'activer le module n'a pas encore été donnée, le lien Activer sera disponibles dans les actions. Activez-le.

Terminé ! Vous pouvez maintenant utiliser le module, le modifier, l'administrer, etc...


Mettre à jour un module

Un module pouvant évidemment changer au cours de son développement, des mises à jour sont souvent disponibles si la version du module que vous utilisez n'est pas la dernière.

Téléchargez cette mise à jour et remplacez les fichiers et répertoires correspondant sur votre installation.

Regénérez la liste des modules, l'état de celui-ci devrait normalement changer pour Nouvelle version installée et la colonne Actions affichera un lien Mettre à jour

Cliquez sur le lien Mettre à jour, en cas de succès, le module sera mis à jour mais désactivé.

Cliquez ensuite sur Activer


Supprimer un module

Pour supprimer un module, il faut d'abord le désactiver, cliquez sur Désactiver dans la colonne Action.

Cliquez ensuite sur Supprimer ou Retirer, toujours dans la colonne Actions et vis-àvis le module en question.

Supprimez ensuite le module du répertoire modules du système.


Création de module...


créer un module