Remarque : La mention www.monsite/vbrannuaire fait référence au répertoire où est installé VBRAnnuaire.

Configuration nécessaire à VBRAnnuaire

  • VBRAnnuaire fonctionne sous PHP 5.1.3 et MySQL 4.0.4 minimum (la version 4.1 et les versions supérieures sont recommandées pour MySQL).
  • Les extensions mbstring, PDO, PDO MySQL et SimpleXML doivent être disponibles.
  • Il doit en être de même pour certaines fonctions.
  • Le répertoire conf/ doit être accessible en écriture.

Même si vous oubliez de vérifier ces points, VBRAnnuaire le fait lors de l'installation. ;)

Transfert des fichiers sur le serveur

Extraction de l'archive

Après avoir téléchargé VBRAnnuaire, il faut extraire l'archive sur votre ordinateur : un répertoire nommé vbrannuaire apparaît.

Transfert

Utilisez n'importe quel client FTP (FileZilla, par exemple). Saisissez le nom du serveur FTP, votre nom d'utilisateur et votre mot de passe (ils vous ont été transmis par votre hébergeur) ; puis, sélectionnez le répertoire vbrannuaire de votre ordinateur et transférez-le.

VBRAnnuaire peut être installé à n'importe quel répertoire de votre site et le dossier qui le contient peut être renommé à votre guise. Ainsi, collez tous les fichiers et sous-dossiers (en gros, vous dépouillez le dossier vbrannuaire) à la racine du site si vous voulez que VBRAnnuaire soit directement accessible à l'adresse www.monsite/ ; ou bien renommez le dossier vbrannuaire en annuaire, par exemple, si vous voulez que VBRAnnuaire soit accessible à l'adresse www.monsite/annuaire. Mais, si vous n'êtes pas à l'aise dans la gestion de sites, je vous conseille de coller le dossier tel quel à la racine du site, de façon à obtenir l'adresse www.monsite/vbrannuaire.

Installation pas à pas

Où se rendre ?

Une fois VBRAnnuaire installé sur le serveur, avec votre navigateur préféré, allez à l'adresse www.monsite/vbrannuaire/install/ (ou www.monsite/annuaire/install ou www.monsite/install/, c'est selon).

Langue

L'assistant d'installation se lance en vous demandant de choisir la langue dans laquelle sera installé VBRAnnuaire. Ce sera celle de l'annuaire.

Vérifications

Des vérifications sont effectuées afin de déterminer si VBRAnnuaire peut être installé sur votre site. Si un des points de la configuration PHP et MySQL ne passe pas, veuillez consulter votre hébergeur. Si le répertoire conf/ n'est pas accessible en écriture, modifiez-en les permissions à l'aide de votre client FTP.

Paramètres de la base de données

Une fois les vérifications menées avec succès, vous devez renseigner les paramètres de la base de données et, par conséquent, avoir en possession les informations suivantes :

  • le nom du serveur hébergeant la base de données (il vous est donné par votre hébergeur),
  • votre identifiant de connexion à la base de données (il vous est donné par votre hébergeur),
  • votre mot de passe de connexion à la base de données,
  • le nom de la base de données dont se servira VBRAnnuaire,
  • le préfixe des tables (laissez la valeur par défaut si vous ne savez pas de quoi il s'agit).

Attention ! la base de données doit déjà exister. Si ce n'est pas le cas et que vous avez la possibilité d'en créer une, faites-le avant de valider (consultez votre hébergeur pour les démarches à suivre).

Lorsque vous cliquez sur le bouton Continuer, VBRAnnuaire vérifie la validité des paramètres. Si vous les avez correctement indiqués, VBRAnnuaire vérifie la version de MySQL utilisée par le serveur. Si la version est au moins égale à 4.0.4, le bouton Créer les tables apparaît.

Une fois ce dernier cliqué, le déroulement de l'opération est récapitulé (en même temps que les tables, le fichier de configuration de VBRAnnuaire est créé).

Inscription du premier membre

Le premier membre inscrit sera administrateur. Vous devez obligatoirement fournir un identifiant (qui vous permettra de vous connecter), un mot de passe et une adresse électronique (vérifiez qu'elle est valable). Le remplissage des champs restants est laissé à votre appréciation.

Une fois validé, le formulaire d'inscription laisse place à un message confirmant l'inscription du premier membre.

Configuration de l'annuaire

À moins de savoir ce que vous faites, laissez la valeur par défaut de l'emplacement de VBRAnnuaire.

Donnez un nom à votre annuaire.

Vous devez choisir entre deux formats d'URL. Le format « Get » donne des URLs de type www.monsite/vbrannuaire/?site=1 et www.monsite/vbrannuaire/?categorie=categorie/sous-categorie, le format « Rewrite » des URLs de type www.monsite/vbrannuaire/site-1.html et www.monsite/vbrannuaire/categorie/sous-categorie.

Attention ! le format « Rewrite » ne peut être utilisé que si le module d'Apache mod_rewrite est disponible sur le serveur. En outre, le format « Rewrite » exige que, dans le fichier .htaccess situé à la racine de VBRAnnuaire, les lignes contenant les règles de réécriture d'URL soient décommentées.

Une fois la configuration enregistrée, un message confirmant la mise à jour du fichier de configuration apparaît.

Fin de l'installation

En cliquant sur Administrer l'annuaire, vous serez automatiquement redirigé vers l'interface d'administration. Retenez son adresse (www.monsite/vbrannuaire/admin/, par exemple) : c'est de là que vous administrerez votre annuaire.

Votre annuaire est prêt à se remplir de catégories et de sites.