PragmaMx | France

Nous allons étudier ici l'installation puis la suppression d'un module pragmamx.
En effet, bon nombre d'utilisateurs ne respectent pas (Par méconnaissance) les principes fondamentaux nécessaires à la bonne installation des modules additionnels.

Voici le déroulement de ce tutorial:

• Rappel sur l'arborescence de pragmaMx
• Installation des fichiers d'un module
• Installation d'un module dans la base de données
• Cas particuliers des modules php-nuke
• Supression d'un module
  

Rappel sur l'arborescence de pragmaMx:

Voici une arborescence type des fichiers et répertoires de pragmaMx.

    Une fois votre pragmaMx sur votre serveur ou en local, voici en image l'arborescence du CMS
    (Cliquer sur l'image pour agrandir)



    Rappel: Une fois pragmaMx correctement installé et fonctionnel supprimer absolument le répertoire /install/









Il s'agit d'une aborescence pour une installation standart.

Remarque: Vous pouvez également supprimer le répertoire /upgade/  ainsi que le fichier upgrade.php à la racine.
Conserver précieusement ce répertoire et ce fichier qu'il faudra réenvoyer sur votre serveur avant les mises à jour de pragmaMx.

Ainsi, même après l'ajout de modules, blocs, etc... vous ne devez pas avoir à la racine de votre site:

• De fichiers .txt mis à part robots.txt
• De fichiers .html (Sauf cas très particuliers)
  

Les seuls fichiers qui sont rajoutés à la racine sont :
- Des fichiers .php de certains modules additionels.
- Des répertoires peuvent êtres ajoutés par des modules additionnels (ex: Coppermine = création d'un répertoire /album/)


Installation des fichiers d'un module:

Rappelez-vous que chaque module à une procédure d'installation spécifique, pour cela, lisez attentivement les informations d'installation dans les packs modules. Généralement il s'agit de  fichiers .txt ou .html, ceux-ci peuvent êtres en Français, Anglais, Allemand ou autres mais sont relativement simples à comprendre et vous donnent la marche à suivre pour installer le module.
--> Ces fichiers NE SONT PAS à envoyer sur votre serveur.

Prenons un exemple, j'ai choisi le "Sommaire paramétrable".

- 1 ère étape:   Décompression du pack "Sommaire paramétrable"
- 2 ème étape:  Lecture attentive du fichier d'installation readme-fr.txt inclu dans le pack (Tout est indiqué)
- 3 ème étape:  Visualiser l'arborescence contenu dans le répertoire "html"

  
   Voici l'ensemble des fichiers et répertoires à envoyer sur votre serveur






Transfert des fichiers sur le serveur:


  --------------------->>>>>>>>

- 4 ème étape: Certains modules nécessitent l'ajout de définitions de langage (Code) aux fichiers langages de pragmaMx. Reportez-vous aux informations d'installation du module. Ces ajouts de définitions sont génélarement des fichiers french.txt à rajouter à un fichier lang-french.php

- 5 ème étape: Les CHMOD à appliquer sur des dossiers ou répertoires. Ceux-ci sont généralement indiquées dans les informations d'installation citées supra.



Installation d'un module dans la bases de données:

3 Possibilités:

1.  Le module ne nécessite pas de base de données
2.  Le module dispose d'un installateur pour la base de données
3.  Le module dispose d'un fichier .sql pour la base de données
   

Cas 1: Le module ne nécessite pas de base de données

Une fois votre module transféré, c'est fini. Logguez-vous en administrateur et activer le module dans votre panneau d'administration>>Modules

Cas 2: Le module dispose d'un installateur pour la base de données

C'est le cas de notre exemple où le fichier install-sommaire.php fait office d'installateur. Logguez-vous en administrateur sur pragmaMx et lancer la procédure d'installation en saisissant l'adresse suivante dans votre navigateur: http://www.VOTRE_DOMAINE.com/install-sommaire.php
Suivez ensuite la procédure le cas échéant.

REMARQUE: Supprimer absolument le fichier d'installation une fois le module installé. Dans notre exemple: Supprimez install-sommaire.php
Cette remarque est valable pour tous les modules possédant un installateur placé à la racine

C'est fini. Logguez-vous en administrateur et activer le module dans votre panneau d'administration>>Modules

Dans certains modules (Ex: Mx-Coppermine) le fichier d'installation ne se trouve pas à la racine mais dans un sous-répertoire du module. Comme d'habitude la procédure est pleinement expliquée dans le pack --> lisez_moi-pragmaMx.html

Cas 3: Le module dispose d'un fichier .sql pour la base de données

C'est le genre de modules qui font peur (A tord) car on doit faire appel à phpmyadmin. Dans certains cas, ce code sql se trouve à l'intérieur des readme.txt

Nous allons donc voir en détails comment procéder.

Rendez-vous dans phpmyadmin, normalement accessible en ligne sur votre compte gestion de votre hébergement



   <--- Vue générale de phpmyadmin qui peut être différente selon votre version (Cliquer sur l'image pour agrandir).
           Je vous  invite à vous familiariser à phpmyadmin en cliquant sur les différents onglets.       






Nous allons maintenant ajouter les tables du module:

- 1 ère étape: Vous devez changer le préfixe des tables du fichier .sql

En effet, lors de son installation, pragmaMx génère un préfixe aléatoire pour les tables, généralement de la forme : mx123456

Pour connaitre le préfixe de vos tables celui-ci est indiqué devant chaque tables visibles dans phpmyadmin ou bien vous pouvez le voir dans votre panneau administration>>préférences>> Tout en bas des préférences dans les réglages de la base de données.

- Ouvrir votre fichier.sql avec votre éditeur
- Prenons comme exemple le fichier pragmaMx-sommairev3.0b1.sql dans le pack  sommaire paramétrable. Note: Seulement si vous n'avez pas utilisé l'installateur
- Regardez au début du fichier sql : CREATE TABLE IF NOT EXISTS `mx_sommaire` ( 
  En fait on crée la table  mx_sommaire si elle n'existe pas avec le préfixe mx_
- Il va donc falloir changer ce préfixe mx_ par notre propre préfixe (Exemple: mx123456_)
- Avec votre éditeur, utiliser la fonction remplacer et remplacer toutes les occurences mx_  par mx_123456 pour notre exemple
- Voila c'est fini pour la modification du fichier sql

- 2 ème étape: Insertion dans phpmyadmin

Rendez vous dans phpmyadmin

---> Soit vous cliquez sur l'onglet SQL


 



 Et vous collez la totalité du code sql modifié puis vous cliquez sur exécuter.








---> Soit vous faites importer >>parcourir >>et vous allez chercher le fichier.sql modifié


Voila c'est fini le module est installé dans la base de données, vous pouvez vérifier que les tables ont bien été installées en cliquant sur
l'onglet structure.




   
   <--- Nos tables ont bien été rajoutées






Logguez-vous en administrateur et activer le module dans votre panneau d'administration>>Modules


Cas particuliers des modules php-nuke

Pour les modules php-nuke la procédure est exactement la même.

 ---> Soit vous avez un installateur
 ---> Soit vous avez un fichier .sql dans ce cas il faudra remplacer les préfixes avec une petite différence car dans les fichiers .sql non modifiés,  les préfixe sont indiqués nuke_ qu'il faudra remplacer par exemple en mx123456_


Supression d'un module


Pour faire simple, je dirais que la supression est l'inverse de l'installation :-)

Cependant nous allons voir comment effectuer une supression "propre" et sans danger.

Revoyons notre arboresence du pack sommaire paramétrable


 -->> Ouvrir le répertoire /admin/ pour voir quels fichiers ont été installés

Ouvrir le répertoire /case/  -->>



Voila, en fait le module a installé le fichier case.sommaire.php dans le répertoire /admin/case/ de votre pragmaMx :)
Regardez ensuite pour les autres répertoires ce qui a été rajouté à votre pragmaMx

Ca y est, vous avez compris, vous n'avez plus qu'a supprimez seulement les fichiers, images ou répertoires qui ont été installés par le module.

Pour bien faire, gardez visuellement sur votre ordinateur l'arborescence du module et supprimer au fur et à mesure les fichiers et répertoires sur votre serveur.
Cette opération peut être fastidieuse mais vous appendrez vite à connaitre pragmaMx et a savoir ce qui a été rajouté et ce qui peut être enlevé.

Les modules additionnels obéissent généralement tous à la même logique
- Fichiers -->/admin/
- Blocs -->/blocks/
- Images -->/images/
- Nom du module -->/modules/

Dans le cas de certains modules vous pouvez supprimer complètement le répertoire du module ajouté dans les modules
Exemple : /modules/nom_du_nouveau_module/


Pour la supression des tables c'est beaucoup plus simple:

Rendez-vous dans phpmyadmin (Cliquez pour agrandir l'image)



  - Cocher les tables qui ont été installées par le module (mx...sommaire pour notre exemple)
  - Faites ensuite >>Pour la sélection >> Supprimer 








Pour finir, si votre modules nécessitait l'ajout de définitions de langage, supprimez simplement le code que vous aviez rajouté.

C'est terminé, votre pragmaMx est aussi "propre" qu'avant l'installation du module


Voila pour ce nouveau tutorial, j'espère avoir été assé clair. Si vous voyez des précisions à rajouter, modifier, faites nous en part sur le forum.