osCommerce est une des applications les plus connues pour l'installation de boutiques en ligne.

Il est prudent d'avoir une base de données (avec utilisateur et mot de passe) dédiée à osCommerce. Soyons originaux, appelons-la shop.

Si vous ne savez pas créer une base de données, je vous invite à vous laisser guider par ce tutorial.

Ici, deux choix s'offrent à vous. Par souci de “propreté”, vous êtes avisé de placer osCommerce dans un répertoire au sein du sous-domaine www (www.exemple.com/shop), ou dans un sous-domaine spécifique (shop.exemple.com - c'est cette option que nous allons suivre dans ce tutoriel, mais rien ne vous y oblige!).

Si vous préférez simplement placer osCommerce dans un répertoire:

Facile! Créez un répertoire dédié dans l'emplacement souhaité (dans htdocs par exemple, pour obtenir www.exemple.com/shop)

Si vous voulez attribuer un sous-domaine spécifique à osCommerce du type shop.exemple.com:

Deux opérations à faire:

• Configurer votre serveur pour ce sous-domaine, comme vous l'explique ce tutorial
• Configurer votre sous-domaine pour pointer vers le serveur que vous venez de configurer, comme vous l'explique ce tutorial

Pour commencer, il va falloir que vous vous enregistriez sur le site officiel francophone pour osCommerce. Une fois que ce sera fait, rendez vous dans la section Téléchargements situé dans le menu de gauche. Dans la catégorie OSCOMMERCE MS2, cliquez sur LA VERSION MS2, puis sur le fichier .zip qui est mis à votre disposition. Au moment de l'écriture de ce tutorial, la version la plus récente était la 2.2.

Maintenant que le fichier est sur votre disque dur préféré, décompressez-le. Vous voici avec un répertoire (renommons le shop) contenant tout les fichiers.

Lancez votre client FTP préféré (Ah, vous aussi c'est FileZilla?), connectez-vous en temps qu'admin sur votre serveur, et rendez-vous sur le répertoire correspondant au virtual host que vous aviez défini initialement.

Dans l'exemple en cours, le chemin de mon FTP correspondra à ceci :

/srv/d_ma-gandi-ai/www/shop.tutorielgandi.net/htdocs/

…a moins que vous n'ayez changé la configuration initiale des fichiers web, mais si vous l'avez fait, j'assume que vous saviez ce que vous faisiez :)

A ce stade, nous allons donc pouvoir mettre les fichiers de osCommerce sur notre Gandi AI.

• Si vous avez créé un virtual host de type shop.mondomaine.com, vous allez vouloir que le forum démarre dés la première page : vous allez donc uploader le contenu (et non pas le répertoire en lui-même) du répertoire shop dans le répertoire htdocs de votre sous-domaine.
  
• Si vous n'avez que faire du sous-domaine et que vous préférez un bon vieux lien en mondomaine.com/shop alors il ne vous reste plus qu'à uploader le répertoire complet dans htdocs (ou dans un autre dossier si vous en avez décidé ainsi).

Pour que osCommerce puisse se configurer, il va avoir besoin de droits spécifiques sur certains dossiers/fichiers. Pour changer les droits sur un fichier via votre client FTP, dans la plupart des cas, il suffit de faire un click droit sur le fichier en question et chercher le bon terme dans le menu contextuel (Droits, Rights, CHMOD ou encore Propriétés). Puisque j'ai commencé à vanter les mérites de FileZilla, voyons comment faire avec ce client.

Pointez le fichier en question, faites un click-droit dessus et sélectionnez “Attributs du fichier…”. La fenêtre qui s'ouvre vous propose de changer les droits du fichier de 2 façons différentes : en droits à cocher ou en valeur numérique.

Le but du tutorial n'étant pas de vous initier aux valeurs numériques des droits sous UNIX, il est plus facile de vous dire que vous devez simplement remplacer la valeur numérique par 777.

Les répertoires qui nécessitent un changement de droits sont:

catalog/includes/configure.php
catalog/admin/includes/configure.php

D'autres fichiers et répertoire pourraient également nécessiter un changement de droits, selon le degré de personnalisation que vous souhaitez apporter à votre boutique. Ceux-ci vous seront indiqués par l'interface d'osCommerce, et le changement de droits s'y effectue de la même manière qu'ici.

Ça peut paraitre un peu intimidant dit comme ca, mais pas d'inquiétude, il s'agit d'une ou deux opérations très simples:

Pour qu'osCommerce puisse fonctionner sur votre serveur, il vous faudra faire les choses suivantes:

• Créer un nouveau fichier plain text (avec notepad ou un équivalent…) sur votre ordinateur.
• Y écrire la ligne qui suit:

php_flag register_globals on

• Sauvegardez le fichier et nommez le .htaccess (n'oubliez pas le “.” au début, et veuillez noter que ce fichier n'a aucune extension à la fin).
• Le charger dans le répertoire htdocs du sous-domaine hébergeant vos fichiers osCommerce. Dans notre cas, ce serait donc:

/srv/d_ma-gandi-ai/www/shop.tutorielgandi.net/htdocs/

A présent, vous pouvez utiliser votre navigateur internet préféré pour vous rendre dans le répertoire catalog dans le chemin de vos fichiers osCommerce (du type shop.votresite.com/catalog; %%www.votresite.com/shop/catalog%…).

A présent, nous allons vous guider à travers les diverses interfaces d'installation.

Choisissez le bouton Install et non pas Upgrade, car il s'agit bien d'une nouvelle installation.

Vous aurez le choix de cocher ou de ne pas cocher deux options:

Entrer les informations concernant votre base de données : laissez coché

Configuration Automatique : laissez coché

Puis vous pouvez cliquer sur Continuer

Il s'agira des informations concernant votre base de données. Remplissez les champ comme suit:

Serveur de Base de données : localhost

Nom d'utilisateur : Le nom d'utilisateur que vous avez créé en même temps que votre base de données dédiée à osCommerce.

Mot de passe : Le mot de passe associé à cet utilisateur.

Nom de la base de données : Dans notre cas, elle s'appelle shop.

Activer les accès fréquents : Ne cochez pas cette option.

Stockage de Session : osCommerce recommande que vous cochiez l'option base de données.

Ensuite osCommerce fera un test de connexion à la base de données qui sera - triomphe! - réussi.

Ensuite, osCommerce lancera l'importation de la base.

Cliquez sur Continuer

Gloire à vous! L'importation de la base de données a réussi! Cliquez sur Continuer.

osCommerce vous demandera les infos nécessaires relatives à votre serveur Web.

Il y aura des champs remplis par défaut qui correspondent à l'emplacement FTP d'osCommerce sur votre serveur. Vous pouvez donc laisser les champs affichés ci-dessous avec leurs valeurs par défaut:

• Adresse WWW

• Répertoire racine de votre serveur

• Domaine HTTP Cookie

• Chemin HTTP Cookie

• Selon vos besoins, vous aurez également le choix d'activer ou non les connexions SSL. Cependant, qui dit activation de cette option, dit: achat d'un certificat SSL pour son domaine, ce qui dit: activation du mode root sur votre serveur pour pouvoir ajouter ce certificat. En d'autres termes, l'ajout d'un certificat SSL est incompatible avec le mode Gandi AI.

osCommerce vous demandera de reconfirmer les informations concernant votre base de données - vous pouvez donc (relire ses informations si vous le souhaitez, et puis) cliquer sur Continuer.

Après un message de confirmation, vous serez tout de suite dirigé vers l'interface d'administration de votre magasin.

Pour finir, il vous faudra supprimer le répertoire /installation, et re-changer les droits des fichiers ci-dessous de 777 à 644:

catalog/includes/configure.php
catalog/admin/includes/configure.php

Félicitations, c'est fini. Si vous voulez des informations supplémentaires sur la configuration de votre osCommerce, veuillez consulter le portail francophone officiel.