Cette partie du tutoriel Magento fournira des informations détaillées concernant la structure par défaut des fichiers et répertoires de Magento. Cela peut vous servir, notament si vous venez de compléter un upload et que certains fichiers manquent – pensez à verifier qu’il ne vous manque pas simplement un répertoire, ou un fichier dans un répertoire. Assurez-vous d’avoir une sauvegarde avant toute modification.
Les fichiers importants sont dupliqués avec NOMDEFICHIER.EXTENSION.sample, essayer de toujours avoir une sauvegarde de ces fichiers, en cas de pépin vous n’aurez pas à réinstaller tout le site !
Les fichiers et répertoires inclus dans le répertoire principal sont les suivants :
- .htaccess – il contient les règles de mod_rewrite qui sont essentielles pour les URLs optimisées pour les moteurs de recherche. Vous pouvez également accéder ici aux directives du serveur web et de php, qui peuvent améliorer les performances de votre site web.
- .htaccess.sample – est un backup du fichier .htaccess. Lorsque .htaccess est modifié, ce fichier peut servir à retrouver les paramètres par défaut.
- 404 (répertoire) – Ce répertoire contient le template et le skin par défaut du 404 de Magento
- app (répertoire) – Ce dossier contient les modules, thèmes, configuration et fichiers de traduction. Il y a également un fichier template par défaut pour l’installation et l’administration.
- cron.php – une tâche cron devrait être paramétrée pour ce fichier. L’exécution de ce fichier à une heure fixée permettra aux performances du site, de ne pas ête affectées par le système de cache complexe de Magento.
- downloader (répertoire) – c’est le répertoire d’arrivée de tous les fichiers récupérés sur le web. Ils sont utilisés pour installer et upgrader Magento à partir de votre navigateur.
- favicon.ico – le favicon par défaut de Magento. C’est une petite icone affichée dans la barre d’outils de votre navigateur lorsqu’une page du site est chargée.
- index.php – la page principale d’index pour Magento.
- index.php.sample – Une sauvegarde de la page d’index par défaut. Elle peut être utilisée pour restaurer le fichier index en cas de modification.
- js (répertoire) – contient les bibliothèques précompilées du code inclus dans Magento.
- lib (répertoire) – le code principal de Magento est situé dans ce répertoire. Il contient les librairies du logiciel en Php.
- LICENCE_AFL.txt – La Licence Académique Libre sous laquelle ce logiciel est distribué.
- LICENCE.txt – La Licence Open Source sous laquelle le logiciel Magento est distribué.
- media (répertoire) – C’est l’emplacement des fichiers media de Magento – images, thumbnails générés, images de produits uploadés. Le répertoire est aussi utilisé comme dossier de transit lorsque vous utilisez les outils d’importation/exportation de masse.
- mage (cet outil s’appelait pear dans les versions antérieures à la 1.4.2.0) – ce fichier contrôle la mise à jour automatique au travers du script de download et de SSH. Il gère l’update de chaque module séparé de Magento.
- php.ini.sample – ce fichier contient les règles php qui peuvent modifier votre configuration de php. Si vous souhaitez modifier la configuration par défaut de php, éditez ce fichier, puis renommez-le en php.ini.
- pkginfo (répertoire) – rassemble les fichiers contenant les changements apportés aux modules pendant les mises à jour.
- report (répertoire) – ce répertoire contient le skin utilisé pour les rapports d’erreur de Magento.
- skin (répertoire) – c’est ici que sont localisés les fichiers de thèmes – images, fichiers JavaScript, fichiers CSS, fichiers Flash. On y trouve aussi les fichiers de skin pour l’installation de skins et les gabarits d’administration.
- var (répertoire) – le cache, les sessions, les saugardes de la base de données, les données exportées et les rapports d’erreur en cache sont dans ce répertoire.
Si vous voulez modifier un gabarit existant ou en créer un nouveau, sachez que les fichiers templates sont séparés dans trois répertoires différents :
- /app/design/frontend/default/YOUR_TEMPLATE_NAME/layout/ – contient les fichiers .xml qui définissent quels modules doivent être chargés dans les zones définies par le site.
- /app/design/frontend/default/YOUR_TEMPLATE_NAME/template/ – contient les fichiers et sous-dossiers qui structurent l’affichage final aux utilisateurs, en utilisant les fonctions situées dans le répertoire layout
- /skin/frontend/default/YOUR_TEMPLATE_NAME/ – contient les CSS, images, JavaScript et fichiers Flash utilisés par le gabarit.