logo phpwebgallery
"simplement puissant"
Dernière version:
1.7.2 - 24 juillet 2008
PhpWebGallery
 Documentation
 
Piste: » Installer un mod
Table des matières

Installer un mod

Un mod est composé généralement de plusieurs fichiers et d’un fichier install.txt, le tout dans une archive au format zip.

  1. La première chose à faire avant d’installer le mod est de faire une sauvegarde de votre site et de votre base.
    • Pour la base MySQL, voir ce message du forum dans le topic de migration qui explique comment faire avec une interface phpMyAdmin.
    • Pour le site, télécharger l’ensemble du site (sauf le dossier galleries) en local dans un dossier bien à part.
  2. La deuxième chose à faire est de décompresser l’archive dans un dossier dédié.
  3. La troisième chose à faire est d’ouvrir le fichier install.txt avec un éditeur de texte (wordpad, vi,...).

En-tête du fichier install.txt

Le début du fichier install décrit le mod, donne sa version, l’auteur, le niveau (level) d’installation requis (donc la complexité) et le temps approximatif pour effectuer l’installation.

Pour le mod News 3, cela donne: 

############################################################## 
## MOD Title: Mod News 3
## MOD Autheur: DPDev < http://www.damienpitard.com/dpdev > Auteur original du mod news
## MOD Autheur: Cestludovic : < http://cestludovic.free.fr > Intégration phpwebgallery 1.5.0 et option de diffusion
## MOD Description: - ce MOD vous permet de publier des news en plusieurs langues sur votre site PWG
##              vous pouvez également choisir le type de diffusion des news.
## MOD Version: 3
## 
## Installation Level: Advanced
## Installation Time: 30 Minutes

1. Les fichiers à modifier

Ensuite vous allez trouver ceci : 

## Files To Edit:
##    include/config_default.inc.php
##    include/constants.php
##    include/functions_html.inc.php
##    include/functions_category.inc.php
##    language/en_UK.iso-8859-1/common.lang.php
##    language/fr_FR.iso-8859-1/common.lang.php
##    template/yoga/admin.tpl
##    template/yoga/category.tpl
##    template/yoga/default-colors.css
##    template/yoga/default-layout.css
##    template/yoga-dark/admin.tpl
##    template/yoga-dark/category.tpl
##    template/yoga-dark/default-colors.css
##    template/yoga-dark/default-layout.css
##    admin.php
##    category.php

Ce sont tous les fichiers que vous devrez modifier, les modifications pour chaque fichier étant indiquées plus bas dans le fichier install (voir plus loin)

2. La copie des fichiers

Ensuite vous allez trouver ceci : 

## Included Files:
##    admin/news_group_list.php
##    admin/news_group_perm.php
##    admin/include/function.php
##    include/bbcode.php
##    include/functions_news.inc.php
##    template/yoga/bbcode.tpl
##    template/yoga/news.tpl
##    template/yoga/admin/news_group_list.tpl
##    template/yoga/admin/news_group_perm.tpl
##    template/yoga/theme/traduire.png
##    template/yoga-dark/bbcode.tpl
##    template/yoga-dark/news.tpl
##    template/yoga-dark/admin/news_group_list.tpl
##    template/yoga-dark/admin/news_group_perm.tpl
##    template/yoga-dark/theme/traduire.png
##    news.php

Là ce sont les nouveaux fichiers ajoutés par le MOD. Il n’y a donc aucune modification à leur apporter. La liste ci-dessus indique le chemin et le nom du fichier. En général les fichiers du mod sont livrés avec leur arborescence afin de faciliter la démarche de recopie.

Copiez les fichiers du mod sur votre site via votre client FTP (Filezilla par exemple) sur votre site sauf le fichier install.txt.
Si les fichiers sont livrés avec leur arborescence, il suffit de faire une copie du contenu du dossier racine dans le dossier de PhpWebGallery.

3. Les instructions SQL

Dans certains mod (pas tous, ici c’est le cas avec le mod news 3), dans le fichier install vous allez trouver une partie nommée SQL : 

# 
#-----[ SQL ]------------------------------------------ 
#

Ceci indique qu’il va falloir créer des tables SQL pour que le mod fonctionne. Pour ça vous devez aller chez votre hébergeur pour accéder à l’administration de votre base. Pour free.fr, c’est sur http://sql.free.fr/phpMyAdmin).
Vous entrez votre nom d’utilisateur et votre mot de passe (fournis pas votre hébergeur).
Vous allez dans la partie SQL ou créer une requete SQL.

Maintenant retournons dans le fichier install afin de récupérer le code SQL. Donc vous sélectionnez les lignes du début SQL à la FIN SQL. Soit pour le mod news: 

# 
#-----[ SQL ]------------------------------------------ 
#
-- 
-- Structure de la table `phpwebgallery_news`
-- 
 
CREATE TABLE `phpwebgallery_news` (
  `id` smallint(5) UNSIGNED NOT NULL AUTO_INCREMENT,
  `date` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
  `author` varchar(255) DEFAULT NULL,
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM
 
-- --------------------------------------------------------
-- 
-- Structure de la table `phpwebgallery_news_group_access`
-- 
 
CREATE TABLE `phpwebgallery_news_group_access` (
  `group_id` smallint(5) UNSIGNED NOT NULL DEFAULT '0',
  `new_id` smallint(5) UNSIGNED NOT NULL DEFAULT '0',
  PRIMARY KEY  (`group_id`,`new_id`)
) ENGINE=MyISAM
 
-- --------------------------------------------------------
 
-- 
-- Structure de la table `phpwebgallery_news_translation`
-- 
 
CREATE TABLE `phpwebgallery_news_translation` (
  `id` smallint(6) UNSIGNED NOT NULL AUTO_INCREMENT,
  `news_id` smallint(5) UNSIGNED NOT NULL DEFAULT '0',
  `language` varchar(50) NOT NULL DEFAULT 'fr_FR.iso-8859-1',
  `title` varchar(75) DEFAULT NULL,
  `content` longtext,
  `status` enum('public','private') DEFAULT 'public',
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM 
 
-- --------------------------------------------------------
 
-- 
-- Insertion des données`
-- 
 
INSERT INTO `phpwebgallery_news` ( `id` , `date` , `author` ) VALUES ('1', NOW(), 'DPDev');
 
INSERT INTO `phpwebgallery_news_translation` ( `news_id` , `language` , `title` , `content`, `status`  ) 
VALUES ('1', 'en_UK.iso-8859-1', 'PWG News system installed', 'Congratulation ! The news system for PWG has been installed!', 'public');
 
INSERT INTO `phpwebgallery_news_translation` ( `news_id` , `language` , `title` , `content`, `status` ) 
VALUES ('1', 'fr_FR.iso-8859-1', 'Système de News PWG installé', 'Félicitation ! Le système de News pour PWG a été installé!', 'public');
 
# 
#-----[ SQL FIN]------------------------------------------

Alors vous copiez le code SQL ci dessus, vous retournez sur la page SQL de votre hébergeur, vous le collez dans la fenêtre et vous faites exécuter.

Normalement, il vous indique que les tables ont bien été créées.

4. Les modifications de fichiers

Vous reprenez votre fichier install et après le code SQL vous trouvez ceci : 

############################################################## 
# 
#-----[ OPEN ]------------------------------------------ 
#

include/config_default.inc.php
(Pour information dans le code ci-dessous, vous pouvez changer la valeur par défaut
du nombre de news afficher par défault ['nb_news_homepage'] sur la page d'acceuil)

Ceci indique que vous devez ouvrir (OPEN) le fichier de votre site, ici le fichier est situé dans le dossier include et s’appelle config_default.inc.php.

Vous téléchargez le fichier demandé en local, puis vous l’éditez avec un éditeur de texte ou de programmation 1). Lors du téléchargement, je conseille de reproduire là aussi l’arborescence de votre site, la mise à jour en sera facilitée. Dans cet exemple, créer un dossier include afin d’y télécharger le fichier config_default.inc.php.

La suite du fichier install indique: 

# 
#-----[ FIND ]------------------------------------------ 
#

?>

Ceci indique que vous devez trouver (FIND) les caractères suivants soit ici : ?> dans le fichier include/config_default.inc.php.

Une fois localisé le texte, vous retournez dans le fichier install et lisez la suite: 

# 
#-----[ BEFORE, ADD ]------------------------------------------ 
#

Ceci indique que vous devez ajouter avant (BEFORE,ADD) le ?> les données citées soit : 

// +-----------------------------------------------------------------------+
// |                                News                                   |
// +-----------------------------------------------------------------------+
 
// BEGIN News MOD
// nb_news_homepage : default number of news to display on homepage
$conf['nb_news_homepage'] = 3;
 
// nb_news_page : default number of news to display on news page, please choose a value of 'nb_news_page_option' array
$conf['nb_news_page'] = 10;
 
// nb_news_page_option : options for X number of news to display on news page
$conf['nb_news_page_option'] = array(1,5,10,25,50,100);
 
// news_bbcode_enabled : enable use of bbcode in news
$conf['news_bbcode_enabled']=true;
// END News MOD

Ces étapes se reproduisent pour chaque fichier à modifier. La liste de ces fichiers est fournie au début du fichier install.txt.

Une fois la modification de tous les fichiers effectuée, il ne reste plus qu’à les remettre à leur place avec votre client FTP. Si vous avez reproduit l’arborescence, il suffit de copier le contenu du dossier racine, sinon il faut replacer les fichiers à leur emplacement d’origine un par un.

C’est fini!!!

Pour la modification des fichiers, on a vu la description de :

  • OPEN –> ouvrir le fichier désigné
  • FIND –> trouver le ou les caractère(s) suivant dans le fichier ouvert
  • BEFORE,ADD –> Ajouter les lignes avant les caractères spécifiés

Mais vous allez trouver aussi :

  • AFTER,ADD –> Ajouter les lignes après les caractères spécifiés

Conclusion

Si vous suivez bien la démarche du fichier install, tout devrait bien se passer.

FAITES BIEN ATTENTION AUX BEFORE ET AFTER, beaucoup de problèmes viennent d’une modification mal faite.

Et merci à cestludovic pour cette procédure.

Retour

1) Notepad, wordpad, vi sont des éditeurs de texte; ils sont suffisants mais limités. Les éditeurs de programmation comme Notepad++, PSPad, SciTe représentent le contenu avec des couleurs et des fonctions ce qui est plus pratique. Leur installation est à prévoir en cas de modification de fichiers php notamment
 
fr/utiliser/installer_un_mod.txt · Dernière modification: 2008.05.16 00:21
 
Driven by DokuWiki - RSS notification feed