PREVIOUS

NEXT

Technologies Internet et Education, © TECFA
2. Introduction

2. Introduction

Postnuke = portail communautaire, architecture assez modulaire.
Un module c'est:

une application qui augmente les fonctionalités du portail et qui s'intègre facilement dans sa structure de base (ex: forum, Top10).
un répertoire qui contient des fichiers avec des fonctions

Un module peut être:

soit indépendant (ex: forum) qui exécute des tâches indépendamment des autres tâches du portail et qui utilise le portail comme un berceau d'affichage (et qui partage le système des utilisateurs et le système des permissions)
soit dépendant des autres modules (ex: Top10) et qui utilise le contenu des autres modules (du portail) et qui fait des opérations dessus

Un module peut s'afficher:

soit dans un "block"
soit dans la place d'affichage centrale du portail

Un module le plus souvent a deux interfaces:

interface administrateur pour gérer le module et qui s'intègre dans l'outil d'administration du système
interface utilisateur

2.1 "Tout est dans la doc ou presque :)"

Depuis le début vous avez besoin de:

d'installer un portail test (fort risque de détruire votre portail en production)
chercher et imprimer toute la doc (versions les plus récentes):

chercher ici:

Voici la documentation la plus importante:

2.2 Etapes à suivre

Imprimez la doc et lisez-la!!!
S'inspirer des autres modules (proprement programmés)
Décidez des fonctionalités de votre module et vérifiez qu'il n'existe pas déjà!
Donnez un nom (court, tout en minuscules et qui fait du sens) et enregistrez-le dans le site officiel de postnuke pour éviter des conflits de nom avec d'autres modules
Décidez du type de votre module: "item" ou "utility"

item = modules indépendants possédant leur propre contenu à manipuler (ex: news, FAQ, downloads)
utility= modules qui manipulent le contenu des autres modules (ex: comments, ratings) et qui utilisent souvent des "hooks" (interactions parmi modules)

Faites le "design" de votre module

séparer bien les fonctions "user" et "admin"
séparer bien les fonctions "GUI" et "API" (affichage et opérations)
décidez si vous voulez avoir des "blocks"

Réfléchissez bien pour la structure des tableaux dans la base de données si votre module en a besoin
Programmez (selon la doc officielle et nos conseils :)
Demandez de l'aide ( Module Support Forums )
Testez et debogguez, documentez (!), faites un "package" de votre module (zip, tar)

PREVIOUS

NEXT

-- TIE