PostNuke - install

Benjamin Prevot

Ce tutoriel a pour objectif de décrire l'installation du portail PostNuke ainsi que celle d'un module.

- Titre : PostNuke - install

- Auteur : Benjamin Prevot

- Parution : 28 mars 2006

- Mise à jour : 20 décembre 2019

- Licence : Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright ® 2013 Benjamin Prevot. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Installation de PostNuke

- I-A. Avant-propos

- I-A-1. Téléchargement

- I-A-2. Environnement

- I-B. Préparation de PostNuke

- I-C. Installation

- I-C-1. Étape 1 : lancement de l'installation

- I-C-2. Étape 2 : choix de la langue

- I-C-3. Étape 3 : licence

- I-C-4. Étape 4 : droits d'accès

- I-C-5. Étape 5 : saisie des paramètres

- I-C-6. Étape 6 : type d'installation

- I-C-7. Étape 7 : début de l'installation

- I-C-8. Étape 8 : résumé des tables créées

- I-C-9. Étape 9 : informations de l'administrateur

- I-C-10. Étape 10 : résumé

- I-C-11. Étape 11 : fin de l'installation

- I-D. Derniers réglages

- II. Installation d'un module

- II-A. Avant-propos

- II-A-1. Qu'est-ce qu'un module ?

- II-A-2. Où trouver des modules ?

- II-B. Installation

- II-B-1. Décompression de l'archive

- II-B-2. Initialisation du module

- II-B-3. Activation de l'extension

- II-C. Exemples

- II-C-1. BBsmile

- II-C-2. Autolinks

- II-C-3. AutoTheme

I - Installation de PostNuke

I-A - Avant-propos

I-A-1 - Téléchargement

Vous pouvez télécharger le portail PostNuke sur le site officiel : http://www.postnuke.org/. La version actuelle est la 0.762. N'oubliez pas de télécharger aussi le Pack français.

I-A-2 - Environnement

L'installation a été réalisée en local dans le répertoire www/monsite qui est accessible dans un navigateur Internet à l'adresse http://localhost/monsite. En parallèle, l'installation a été faite sur un compte Free ; nous supposerons que l'installation de PostNuke se fera à la racine de votre espace Free et que vous accédez à cet espace par l'adresse http://monsite.free.fr/. Les exemples donnés feront référence à ces deux installations.

I-B - Préparation de PostNuke

L'archive de PostNuke et le Pack français, une fois décompressés, se présentent comme suit :

Local

Copiez les fichiers (et répertoires) situés dans HTML de l'archive PostNuke dans le répertoire www/monsite. Faites de même pour le Pack français. Si vous avez des messages vous indiquant que certains fichiers existent déjà, écrasez-les.

Free

Copiez les fichiers (et répertoires) situés dans HTML de l'archive PostNuke à la racine de votre espace Free. Faites de même pour le Pack français. Si vous avez des messages vous indiquant que certains fichiers existent déjà, écrasez-les.

I-C - Installation

L'installation n'est pas compliquée, un fichier permet de la réaliser automatiquement, vous n'avez plus qu'à saisir les bons paramètres.

I-C-1 - Étape 1 : lancement de l'installation

Pour lancer l'installation, il suffit de faire appel au fichier install.php présent à la racine du portail. Pour cela, lancez votre navigateur Web.

Local

Dans la barre d'adresse, saisissez http://localhost/monsite/install.php, puis validez.

Free

Dans la barre d'adresse, saisissez http://monsite.free.fr/install.php, puis validez.

I-C-2 - Étape 2 : choix de la langue

Vous accédez alors à l'écran suivant :

Dans la liste déroulante, vous pouvez choisir la langue que vous souhaitez utiliser. Dans notre cas, nous choisissons Français. Cliquez ensuite sur le bouton Langue.

I-C-3 - Étape 3 : licence

L'écran suivant affiche simplement la licence d'utilisation. Après l'avoir lue, vous pouvez cliquer sur le bouton Suite.

I-C-4 - Étape 4 : droits d'accès

Le script d'installation vérifie qu'il possède les droits d'accès suffisants aux fichiers et répertoires suivants : config.php, config-old.php, pnTemp/pnRender_compiled, pnTemp/pnRender_cache, pnTemp/Xanthia_compiled, pnTemp/Xanthia_cache, pnTemp/Xanthia_Config. Vous devez obtenir des lignes comme celle de la figure ci-dessus.

Pour en savoir plus sur les droits d'accès, vous pouvez vous référer à ce tutoriel : Droits d'accès aux fichiers.

I-C-5 - Étape 5 : saisie des paramètres

Dans cet écran, vous devez saisir les paramètres de connexion à la base de données.

Local :

- serveur hôte de la base : localhost ;

- utilisateur de la base : root (sauf si vous avez un autre accès en local ; dans ce cas, saisissez votre login) ;

- mot de passe de la base : votre_mot_de_passe ;

- nom de la base : mabase (nom de la base de données que vous utilisez pour créer votre portail) ;

- préfixe : pn (ce préfixe est utilisé pour la création des tables afin de les différencier de celles présentes ou à venir) ;

- type de base : MySQL (ne pas changer) ;

- type de table de base de données : MyISAM (ne pas changer).

Free :

- serveur hôte de la base : sql.free.fr ;

- utilisateur de la base : monsite ;

- mot de passe de la base : votre_mot_d;e_passe ;

- nom de la base : monsite ;

- préfixe : pn (ce préfixe est utilisé pour la création des tables afin de les différencier de celles présentes ou à venir) ;

- type de base : MySQL (ne pas changer) ;

- type de table de base de données : MyISAM (ne pas changer).

I-C-6 - Étape 6 : type d'installation

Dans cet écran, vous obtenez un résumé des informations que vous avez saisies ; vous pouvez les modifier en cas d'erreur.

Dans notre exemple, nous installons PostNuke pour la 1re fois. Cliquez donc sur Nouvelle installation.

I-C-7 - Étape 7 : début de l'installation

Cet écran affiche à nouveau les informations relatives à la connexion à la base de données, mais, cette fois, vous ne pouvez plus les modifier.

Local

Cochez la case Créer la base de données ; cette commande permet de créer la base automatiquement, vous n'aurez pas à le faire vous-même. Cliquez sur Commencer.

Free

Ne cochez pas la case Créer la base de données. Celle-ci est déjà créée puisque Free ne met à votre disposition qu'une seule base. Cliquez sur Commencer.

I-C-8 - Étape 8 : résumé des tables créées

Si tout s'est bien passé, vous obtenez la liste des tables qui ont été créées.

Local

La première ligne vous indique si la base de données a été créée correctement. Vous pouvez cliquer sur le bouton Continuer.

Free

La première ligne vous indique que la base de données n'a pas été créée, ce qui est normal. Vous pouvez cliquer sur le bouton Continuer.

I-C-9 - Étape 9 : informations de l'administrateur

Vous devez saisir les informations concernant l'administrateur du portail :

- identifiant de l'administrateur : Admin (cet identifiant vous servira de login pour vous connecter en tant qu'administrateur) ;

- nom de l'administrateur : Admin (il s'agit de votre « véritable « nom) ;

- mot de passe administrateur : votre_mot_de_passe (vous pouvez choisir un mot de passe) ;

- mot de passe administrateur (vérification) : votre_mot_de_passe (ressaisissez votre mot de passe) ;

- e-mail de l'administrateur : moi@ici.fr (votre adresse mail) ;

- URL de l'administrateur : http://moi.chezmoi.fr/ (l'adresse de votre site Internet).

Après avoir rempli tous les champs, vous pouvez cliquer sur Identification.

I-C-10 - Étape 10 : résumé

La liste de toutes les données envoyées s'affiche. Cliquez sur Terminer.

I-C-11 - Étape 11 : fin de l'installation

Le dernier écran regroupe une liste des personnes qui ont participé au projet PostNuke. Vous pouvez maintenant accéder au portail en cliquant sur le lien Accès à votre site PostNuke.

I-D - Derniers réglages

Avant de pouvoir profiter pleinement de votre portail, il reste encore une étape importante : supprimer les fichiers d'installation.

Local

Rendez-vous dans le répertoire www/monsite et supprimez le fichier install.php et le répertoire install.

Free

Rendez-vous à la racine de votre espace et supprimez le fichier install.php et le répertoire install.

II - Installation d'un module

II-A - Avant-propos

II-A-1 - Qu'est-ce qu'un module ?

Le portail PostNuke permet l'ajout ou l'extension de fonctionnalités grâce à des modules. Un module est constitué de fichiers définissant ses fonctions, son apparence, son administration…

II-A-2 - Où trouver des modules ?

Vous pouvez télécharger des modules sur de nombreux sites ; en voici deux :

- http://www.postnuke.com/ ;

- http://www.postnuke-france.org/.

Vous pouvez aussi effectuer une recherche sur Internet, il existe toutes sortes de sites en regroupant.

II-B - Installation

Cette présentation de l'installation d'un module décrit le cas général, il peut arriver que certains modules requièrent des manipulations supplémentaires (voire différentes) pour que l'installation soit complète. Pour cela, reportez-vous aux documents présents dans le répertoire docs ou pndocs du module.

II-B-1 - Décompression de l'archive

L'installation d'un module est très facile ; en effet, il suffit de décompresser les fichiers de l'archive dans le répertoire approprié et d'initialiser le module dans la partie administration de PostNuke.

Avant toute chose, il faut décompresser les fichiers du module. PostNuke regroupe tous ses modules dans le répertoire modules situé à la racine du portail. Ce répertoire contient d'autres répertoires qui contiennent les modules ; un répertoire par module.

Généralement, l'archive du module contient l'arborescence nécessaire pour n'avoir qu'à le dézipper dans le répertoire modules, sans autre manipulation. Sinon, créez un répertoire dans modules, donnez-lui le nom du module que vous souhaitez installer, et dézipper l'archive dans ce répertoire.

Votre module est maintenant prêt à être utilisé par PostNuke, il faut maintenant l'initialiser.

II-B-2 - Initialisation du module

Pour initialiser un module, il faut se rendre dans la console d'administration de PostNuke. Pour cela, identifiez-vous comme administrateur du portail.

Dans le menu principal apparaît le lien Administration. Cliquez dessus.

Vous obtenez alors l'ensemble des fonctions disponibles pour administrer votre portail. Vous êtes dans la catégorie Système. Cliquez sur Modules.

La liste des modules s'affiche. Pour que le module que vous venez d'installer soit pris en compte, cliquez sur Régénérer. Recherchez dans la liste le nom de votre module (il s'agit du nom du répertoire dans lequel il est installé). Cliquez alors sur Initialisation. Une fois que le rafraîchissement de la page est terminé, cliquez sur Activer à côté de votre module.

Voilà, votre module est prêt à être utilisé ; l'icône doit apparaître à côté du nom de votre module, sinon, recommencez l'installation depuis le début.

Pour pouvoir l'administrer, cliquez sur la catégorie Complémentaires, votre module est présent, vous pouvez l'administrer.

Pour connaître le fonctionnement du module que vous venez d'installer, référez-vous au site où vous l'avez téléchargé ou à la documentation fournie avec (dans le répertoire docs du module).

II-B-3 - Activation de l'extension

Certains modules peuvent n'être utilisés que dans d'autres modules ; ce sont des extensions. Pour pouvoir les utiliser, il faut préciser dans quels modules ils devront faire leur office. Pour cela, une fois que vous les avez installés comme indiqué ci-dessus, allez dans le gestionnaire de modules. Repérez dans la liste le module qui utilisera votre extension puis cliquez sur Extensions juste à côté.

Vous obtenez alors la liste des extensions que votre module peut utiliser.

Cochez les extensions désirées, puis cliquez sur le bouton Mettre à jour. Les extensions sont maintenant actives pour ce module. Répétez l'opération pour tous les modules pour lesquels vous souhaitez activer des extensions.

II-C - Exemples

II-C-1 - BBsmile

Ce module est installé avec PostNuke, il faudra l'activer pour pouvoir l'utiliser.

Si voulez insérer des smilies dans vos textes, c'est tout à fait possible. Il vous suffit de saisir des « smilies texte » pour afficher automatiquement à la place un smiley au format GIF, PNG… (vous pouvez utiliser des représentations texte telles que ;-) ou un texte alternatif comme icon_biggrin, comme dans un forum phpBB).

Pour utiliser les smilies dans les modules que vous désirez, il vous faudra activer l'extension comme indiqué plus haut.

II-C-2 - Autolinks

Ce module est installé avec PostNuke, il faudra l'activer pour pouvoir l'utiliser.

Si dans un texte, vous voulez remplacer automatiquement certains mots par des liens hypertextes, ce module est fait pour vous. Vous saisissez les mots que vous souhaitez remplacer et vous indiquez le texte de remplacement et le lien.

Pour utiliser les liens automatiques dans les modules que vous désirez, il vous faudra activer l'extension comme indiqué plus haut.

II-C-3 - AutoTheme

http://www.spidean.com/:

Vous pouvez gérer un calendrier avec divers événements. Ce module permet d'afficher le calendrier par jour, par semaine, par mois et par année. Il est aussi possible de gérer des événements qui se répètent chaque semaine, chaque mois… Vous pouvez définir vos propres catégories d'événements avec des icônes spécifiques.