Guide d'installation de Phenix

Principes de base

Pour créer ou mettre à jour les tables nécessaires au bon fonctionnement de Phenix, vous devez utiliser le script install.php du répertoire "install".

Il est important que l'utilisateur MySQL avec lequel vous faites votre installation ait les droits classiques (SELECT/INSERT/UPDATE/DELETE) mais également les droits pour créer ou modifier une table (CREATE et ALTER) sans quoi la création ou la mise à jour ne pourra pas se faire.
De plus vous devez définir des droits en écriture sur le sous-répertoire inc/ afin que le script d'installation puisse modifier votre fichier de configuration.


Si vous n'avez pas accès à ces options, téléchargez le fichier suivant qui contient tous les scripts SQL pour procéder à l'installation ou la mise à jour de Phenix de façon manuelle. Tous les détails sont expliqués dans ce topic.

Installer Phenix pour la première fois

"Dézippez" l'archive phenix.zip, téléchargée sur le site, dans le répertoire racine de votre serveur HTTP. Cela a pour effet de créer un nouveau répertoire phenix contenant les fichiers nécessaires au bon fonctionnement de Phenix.

Cette application utilise les sessions de php4 (si disponible), si vous êtes chez Free ou chez Online.net (Proxad), pensez à créer un répertoire "sessions" à la racine de votre site.

Lancez le script d'installation, en appelant depuis votre navigateur
http://adresse_serveur_web/phenix/install/install.php

Sélectionnez alors "Installer Phenix pour la première fois" dans le menu déroulant puis dans la page suivante indiquez les informations nécessaires à la connexion à votre base de données. Pour le reste laissez vous guidez, les options du fichier de configuration sont expliquées plus bas...

Mettre à jour une version antérieure de Phenix

Si votre répertoire actuel de Phenix se nomme "phenix", renommez-le pour sauvegarder temporairement vos fichiers (exemple appelez le phenix_avant_MAJ).

Effectuez une sauvegarde de votre base de données soit avec un script tel que phpMyAdmin ou bien à partir du script d'installation comme détaillé dans le chapitre suivant.

"Dézippez" l'archive phenix.zip, téléchargée sur le site dans le répertoire racine de votre serveur HTTP. Cela a pour effet de créer un nouveau répertoire phenix contenant les fichiers de la nouvelle version.

Copiez le fichier phenix_avant_MAJ/inc/conf.inc.php dans le répertoire phenix/inc afin de ne pas avoir à ressaisir vos identifiants de connexions et également pour conserver vos options d'environnement de Phenix (durée de sessions, cookies...).

Copiez également le fichier phenix_avant_MAJ/inc/couleur.inc.php dans le répertoire phenix/inc pour conserver vos couleurs associées aux notes, si vous les avez personnalisées.

Si vous avez sauvegardé votre base de données, vous êtes maintenant prêt à lancer le script d'installation, en appelant depuis votre navigateur
http://adresse_serveur_web/phenix/install/install.php

Sélectionnez alors "Mettre à jour votre version de Phenix" dans le menu déroulant puis dans la page suivante indiquez la version de Phenix que vous utilisiez jusqu'à présent. Pour le reste laissez vous guidez, les options du fichier de configuration sont expliquées plus bas...

Une fois l'installation terminée et après s'être assuré que la nouvelle version fonctionne bien, vous pouvez supprimer le répertoire phenix_avant_MAJ.

Sauvegarde de la base de données

Pour sauvegarder vos données avec le script d'installation, sélectionnez "Sauvegarder la base de données" dans la liste déroulante. Les informations de connexions sont normalement récupérées à partir de votre fichier de configuration, il ne vous reste alors plus qu'à choisir les tables concernées, les options d'export (généralement celles par défaut conviennent très bien) et à cliquer sur le bouton Sauver pour créer votre fichier de sauvegarde.

Options du fichier de configuration

Le fichier inc/conf.inc.php est généré par le script d'installation. Il contient différents paramètres nécessaires pour assurer le bon fonctionnement de l'agenda :

   $cfgHote = Adresse du serveur MySQL
   $cfgUser = Nom de l'utilisateur
   $cfgPass = Mot de passe
   $cfgBase = Nom de la base sous MySQL

$PREFIX_TABLE permet de définir un prefixe au nom des tables. Ainsi si vous ne disposez que d'une seule base de données, regroupant les tables de plusieurs applications, cela permet de personnaliser le nom des tables que Phenix utilise.

$AUTORISE_SUPPR permet d'autoriser ou non la suppression des notes affectées (true ou false) par les utilisateurs.

$DUREE_SESSION permet de définir la durée avant l'expiration d'une session. Cette durée s'exprime en seconde (défaut 300).

$COOKIE_AUTH permet d'autoriser ou non l'identification automatique via un cookie (true ou false).

$COOKIE_NOM permet de définir le nom du cookie permettant de conserver les identifiants des utilisateurs. Utilisée seulement si $COOKIE_AUTH=true.

$COOKIE_DUREE permet de définir la durée en nombre de jours pendant laquelle les identifiants sont conservés. Utilisée seulement si $COOKIE_AUTH=true.

$PUBLIC permet de définir si des nouveaux utilisateurs peuvent se créer librement un compte (true ou false).

$RELOAD_PLANNING permet de définir la durée avant laquelle les plannings se rechargent automatiquement. Cette durée s'exprime en seconde (O [zéro] permet de désactiver cette option).

$AUTO_UPPERCASE permet de définir si le nom des utilisateurs est automatiquement converti en majuscule ou non (true ou false).

$MODIF_PARTAGE permet d'autoriser ou non la modification des contacts/favoris/libellé partagés par d'autres utilisateurs (true ou false).

$AUTORISE_HTML permet d'autoriser ou non l'utilisation de balises HTML dans les champs de saisies pour mettre en forme du texte (faille de sécurité potentielle si TRUE) (true ou false).

$AUTORISE_FCKE permet d'autoriser ou non l'utilisation de l'éditeur HTML FCKEditor dans les champs de saisies pour mettre en forme du texte (true ou false) (nécessite $AUTORISE_HTML = true).

$FCKE_TOOLBAR permet de choisir la barre d'outil qui est affichée aux utilisateurs. 4 styles sont proposés : Basic, Intermed, Extend, Full (nécessite $AUTORISE_FCKE = true).

$FCKE_BASE permet de définir le répertoire de stockage des fichiers auxquels les utilisateurs ont accès si $FCKE_BROWSE = true ou $FCKE_UPLOAD = true (cf. ci-après) (/UserFiles/).

$FCKE_BROWSE permet d'autoriser les utilisateurs à accéder à des fichiers déposés dans le répertoire défini avec $FCKE_BASE (true ou false).

$FCKE_UPLOAD permet d'autoriser les utilisateurs à déposer des fichiers dans le répertoire défini avec $FCKE_BASE (true ou false).

$CHECK_VERSION permet d'autoriser ou non Phenix à se connecter sur le site principal pour vérifier si une nouvelle version est disponible (Aucune information vous concernant n'est transmise, seul un petit fichier de 3 octets est téléchargé à partir du site phenix.gapi.fr) (true ou false).

Ne paramétrez les options suivantes que si vous constatez que les alertes par mail ne fonctionnent pas
$SMTP_SERVER nom du serveur SMTP auquel Phenix doit se connecter (exemple smtp.wanadoo.fr).
$SMTP_PORT port de connexion au serveur SMTP (25 dans la grande majorité des cas).
$SMTP_LOGIN si votre serveur SMTP requiert une authentification, précisez ici votre identifiant.
$SMTP_PASSWORD si votre serveur SMTP requiert une authentification, précisez ici votre mot de passe.

Remarques

Phenix a été développé et testé avec Internet Explorer version 6.0 et ultérieure, Firefox 2.0 et Opéra 8.0. J'ai fait tout mon possible pour le rendre compatible avec d'autres navigateurs (JavaScript et feuille de style) mais sans en avoir la certitude, si vous rencontrez quelques incompatibilités, merci de m'en tenir informé. J'essaierais dans la mesure du possible de les corriger.


PS : si vous intégrez Phenix sur votre site, envoyez moi un petit mail pour mon livre d'or, merci.