====== Installer osCommerce sur Gandi AI ====== osCommerce est une des applications les plus connues pour l'installation de boutiques en ligne. ===== Créer une base de données dédiée à osCommerce ===== 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 **[[fr:hosting:gandi-ai:create-database|tutorial]]**. \\ ===== Prévoir un espace dédié à osCommerce ===== 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 [[:fr/hosting/gandi-ai/configure-virtualhosts|ce tutorial]] * Configurer votre sous-domaine pour pointer vers le serveur que vous venez de configurer, comme vous l'explique [[fr:hosting:manage-quota:attach-domain-screencast|ce tutorial]] \\ ===== Téléchargement de osCommerce ===== Pour commencer, il va falloir que vous vous enregistriez sur [[http://www.oscommerce-fr.info/portail/|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 [[http://www.filezilla.fr/|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). \\ ===== Préparer les fichiers osCommerce ===== 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. \\ ===== Adapter la configuration de votre serveur ===== Ç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/ Si vous utilisez Windows, vous remarquerez qu'on ne vous laisse pas appeler le fichier **.htaccess** parce que Windows lira le "**.**" du début comme marquant le début d'une extension (comme .doc, .txt, .gif...). Vous devrez donc charger le fichier sur votre serveur avec n'importe quel nom (du moment qu'il contienne uniquement la ligne nécessaire), puis le renommer "**.htaccess**" en faisant un clique-droit et le renommant dans votre client FTP. \\ ===== Installation de osCommerce ===== 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. ==== 1. Message de bienvenue ==== Choisissez le bouton **Install** et non pas **Upgrade**, car il s'agit bien d'une nouvelle installation. ==== 2. ==== 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** ==== 3. ==== 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. ==== 4. ==== 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** ==== 5. ==== Gloire à vous! L'importation de la base de données a réussi! Cliquez sur **Continuer**. ==== 6. ==== 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. ==== 7. ==== 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**. ==== 8. ==== 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 [[http://www.oscommerce-fr.info|le portail francophone officiel]].