LogoLogo
Homepage
  • Documentations for PrestaShop 1.5
  • English documentation 1.5
    • About PrestaShop 1.5
    • New features in PrestaShop 1.5
    • Getting Started
      • What you need to get started
      • Installing PrestaShop
      • Installing PrestaShop using the command line
      • Updating & Uninstalling
      • Misc. information
    • Updating PrestaShop
      • Automatic update
      • Manual update
      • Making and restoring your own backup
      • In case of issues
    • User Guide
      • Training
      • Customizing your shop
      • Browsing the front-office
      • Connecting to the PrestaShop back-office
      • First steps with PrestaShop 1.5
      • Adding Products and Product Categories
      • A Look Inside the Catalog
      • Managing Orders
      • Managing Customers
      • Creating Price Rules and Vouchers
      • Managing Shipping
      • Understanding Local Settings
      • Managing Modules and Themes
      • Making the Native Modules Work
      • Understanding the Preferences
      • Understanding the Advanced Parameters
      • Administering the Back-Office
      • Understanding Statistics
      • Advanced Stock Management
      • Managing Multiple Shops
    • Developer Guide
      • Developer tutorials
        • Using the PrestaShop Web Service
          • Webservice one-page documentation
          • Chapter 1 - Creating Access to Back Office
          • Chapter 2 - Discovery - Testing access to the web service with the browser
          • Chapter 3 - First steps - Access the Web service and list client
          • Chapter 4 - Retrieve Data - Retrieving a Client
          • Chapter 5 - Modification - Update client
          • Chapter 6 - Creation - Remote Online Form
          • Chapter 7 - Removal - Remove customer accounts from the database
          • Chapter 8 - Advanced Use
          • Chapter 9 - Image management
          • Chapter 10 - Price management
          • Cheat-sheet - Concepts outlined in this tutorial
          • Web service reference
        • Helpers
          • HelperForm
          • HelperOptions
          • HelperList
          • Using helpers to overload a back-office template
        • New Developers Features In PrestaShop 1.5
        • Using the Context Object
        • DB class best practices
        • Public and overloadable methods
        • Overriding default behaviors
        • Using addJquery(), addJqueryPlugin() and addJqueryUI()
        • Handling special characters in links
        • Auto-updating modules
        • Front-Office Controllers
        • Controllers correspondence table
        • Specifics of multistore module development
        • Developer tips and tricks
        • PrestaShop's developer tools
        • Using the backward compatibility toolkit
      • Fundamentals
      • Coding Standards
      • Setting up your local development environment
      • Diving into PrestaShop Core development
      • Creating a PrestaShop module
      • Creating a front-office module
      • Creating a module with both front-end and back-end controllers
      • Hooks in PrestaShop 1.5
      • Translations in PrestaShop 1.5
      • How to use the Forge to contribute to PrestaShop
      • How to write a commit message
      • Contributing code to PrestaShop
    • Designer Guide
      • Theme development fundamentals
      • Integrating content in a page using hooks
      • Characteristics of a front-office theme
      • Characteristics of a back-office theme
      • Creating your own theme
      • Theme templates and Smarty
      • Using jQuery and Ajax
      • Best practices
      • Designer tutorials
        • Changes in version 1.5 which impact theme development
        • Changing a 1.4 theme to support gift products
        • Implementing layered navigation in a theme
    • System Administrator Guide
    • Merchant's Guide
      • Our advices
      • Sample price rules
    • FAQ
      • Using PrestaShop with WordPress
    • Troubleshooting
  • Documentation française 1.5
    • À propos de PrestaShop 1.5
    • Nouveautés de PrestaShop 1.5
    • Guide de démarrage
      • Ce dont vous avez besoin
      • Installer PrestaShop
      • Installer PrestaShop en ligne de commande
      • Mettre PrestaShop à jour
      • Informations diverses
    • Guide de mise à jour
      • Mise à jour automatique
      • Mise à jour manuelle
      • Faire une sauvegarde et la restaurer
      • En cas de problème
    • Guide de l'utilisateur
      • Formations
      • Personnaliser votre boutique
      • Parcourir le front-office
      • Se connecter au back-office de Prestashop
      • Premiers pas avec PrestaShop 1.5
      • Ajouter des produits et des catégories de produits
      • Un aperçu du catalogue
      • Gérer les commandes
      • Gérer les clients
      • Mettre en place des promotions
      • Gérer les transporteurs
      • Comprendre les réglages locaux
      • Gérer les modules et les thèmes
      • Configurer les modules natifs
      • Comprendre les préférences
      • Comprendre les paramètres avancés
      • Administrer le back-office
      • Comprendre les statistiques
      • Gestion avancée des stocks
      • Gérer plusieurs boutiques
    • Guide du développeur
      • Fondamentaux
      • Norme de développement
      • Mettre en place votre environnement de développement
      • Plonger dans le développement PrestaShop
      • Créer un module PrestaShop
      • Les hooks de PrestaShop 1.5
      • Les traductions dans PrestaShop 1.5
      • Comment utiliser la Forge pour contribuer à PrestaShop
      • Comment écrire un descriptif de modification
    • Guide de l'intégrateur
      • Fondamentaux de la création de thème
      • Intégrer du contenu dans une page à l'aide de hooks
      • Caractéristiques d'un thème front-office
      • Caractéristiques d'un thème back-office
      • Template de thème et Smarty
      • Utiliser jQuery et Ajax
      • Bonnes pratiques
    • Guide de l'administrateur système
    • Guide du vendeur
      • Exemples de promotions
      • Nos bons conseils
    • Questions fréquentes
    • Dépannage
  • Documentación española 1.5
    • Acerca de PrestaShop 1.5
    • Introducción
      • Lo que necesita para empezar
    • Guía del usuario
      • Formación
      • Personalización de su tienda
      • Exploración del front-office
      • Conexión al back-office de PrestaShop
      • Primeros pasos con PrestaShop 1.5
      • Añadir productos y categorías de productos
      • Una mirada interna al catálogo
      • Gestionar pedidos
      • Gestionar clientes
      • Crear reglas de precios y cupones
      • Gestionar el transporte
      • Comprender la Configuración Local
      • Gestionar módulos y temas
      • Configurar los Módulos Nativos
      • Comprender las Preferencias
      • Comprender los Parámetros avanzados
      • Administrar el Back-Office
      • Comprender las estadísticas
      • Gestión avanzada de stock
      • Gestionar varias tiendas
    • Guía del Desarrollador
      • Tutoriales para Desarrolladores
        • Uso del Web Service de Prestashop
          • Capítulo 1 - Creación de acceso al Back Office
  • Документация на русском языке 1.5
    • Информация о PrestaShop 1.5
    • Новые функции в PrestaShop 1.5
    • Приступая к работе
      • Что нужно чтобы приступить к работе
      • Установка PrestaShop
      • Установка PrestaShop при помощи командной строки
      • Обновление и удаление PrestaShop
      • Прочая информация
    • Руководство пользователя
      • Обучение
      • Настройка вашего магазина
      • Изучение публичной части сайта
      • Бэк-офис PrestaShop
      • Первые шаги в PrestaShop 1.5
      • Добавление товаров и товарных категорий
      • Внутри каталога
      • Управление заказами
      • Работа с клиентами
      • Создание правил ценообразования корзины и ваучеров
      • Управление доставкой
      • Ориентация в локальных настройках
      • Управление модулями и темами
      • Настойка встроенных модулей
      • Ориентация в настройках
      • Ориентация в расширенных параметрах
      • Администрирование Back-Office
      • Ориентация в статистике
      • Расширенное управление запасами
      • Управление мультимагазином
Powered by GitBook
On this page
  • Caractéristiques d'un thème front-office
  • Les dossiers du thème
  • Image de prévisualisation
  • Fichiers de traduction
  • Fichiers en cache
  • Fichiers image
  • Fichiers CSS
  • Fichiers JavaScript
  • Version mobile du thème
  • Remplacer les fichiers modèles des e-mails et PDF
  • Remplacer les templates d'un module

Was this helpful?

  1. Documentation française 1.5
  2. Guide de l'intégrateur

Caractéristiques d'un thème front-office

PreviousIntégrer du contenu dans une page à l'aide de hooksNextCaractéristiques d'un thème back-office

Last updated 4 years ago

Was this helpful?

Contenu

Caractéristiques d'un thème front-office

Les dossiers du thème

Un thème front-office pour PrestaShop est conçu avec les dossiers standards suivants, eux-mêmes contenus dans le dossier du thème :

  • /cache : contient les fichiers temporaires qui sont générés et utilisés pour soulager la charge du serveur.

  • /css : contient les feuilles de style.

  • /img : contient les images du thème.

  • /js : contient les fichiers JavaScript du thème.

  • /lang : contient des sous-dossiers, un pour chaque langue.

  • /mobile : contient la version mobile du thème. À noter : si vous n'avez pas le temps de construire une version mobile de votre thème, vous pouvez dans un premier temps utiliser celui du thème par défaut, en copiant son dossier /mobile dans le dossier de votre thème.

Le dossier principal du thème doit avoir un nom unique. Il a doit être placé dans le dossier /themes de PrestaShop pour pouvoir fonctionner.

Les dossiers suivants ne sont pas des dossiers du thème, mais de PrestaShop. Il est important de les parcourir pour complètement personnaliser votre installation de PrestaShop.

  • /mails : vous devriez modifier les templates de mail, et les faire correspondre au style de votre thème.

  • /modules : vous pouvez changer les templates propres à vos modules, afin de mieux les fondre dans votre thème.

  • /pdf : vous devriez modifier les templates de facture, de bon d'achat, etc., afin qu'il qu'ils correspondent au style de votre thème.

Image de prévisualisation

Lorsque le back-office affiche la page de sélection de thème, situés dans la page de préférences "Thèmes", PrestaShop affiche une image précise. Les caractéristiques de fichier sont :

  • Nom du fichier : preview.jpg

  • Dimensions : 180*202 pixels

  • Format : JPEG (ne pas utiliser un gif ou un png).

Il faut vous efforcer de rendre cette image très facilement reconnaissable : la meilleure manière d'attirer le regard de l'administrateur consiste à faire une capture d'écran de la page d'accueil d'une boutique qui utilise ce thème.

Même le thème par défaut a sa propre image de prévisualisation.

Fichiers de traduction

Les fichiers de traduction sont stockés dans le dossier /lang.

Chaque fichier doit être nommé avec le code ISO 639-1 de sa langue : par exemple, pour le français, utiliser fr.php.

Gérer les traductions

Toutes les chaînes de texte de votre thème doivent être encapsulées dans une fonction Smarty, comme ceci :

{l s='My Text'}

Cela permettra à n'importe qui de traduire le thème dans sa propre langue, à l'aide de l'outil de traduction interne, qui se trouve dans la page "Traductions" du menu "Localisation". Dans la section "Modifier les traductions", choisissez "Traductions du front-office" dans le menu déroulant, puis cliquez sur le drapeau de la langue dans laquelle vous voulez traduire les chaînes de texte. Toutes les chaînes de texte du front-office s'afficheront alors.

Envoyer des données dans un thème PrestaShop

L'illustration suivante présente comment les données sont transmises depuis le coeur de PrestaShop à son thème. Il utilise la méthode l() pour présenter comment le thème affiche son texte dans la langue choisie, s'il a été traduit au préalable.

Fichiers en cache

L'outil CCC de PrestaShop met en cache les fichiers CSS et JavaScript du thème dans un dossier spécifique : /cache, directement dans le dossier principal du thème.

Les fichiers CSS mis en cache sont regroupés dans un même fichier par page et par média.

Fichiers image

Les images du thème sont stockées dans le dossier /img, situé dans le dossier principal du thème.

Dans l'optique d'améliorer la lisibilité, le dossier /img contient des sous-dossiers pour certains groupes d'images, comme /icons ou /jquery.

Fichiers CSS

Tous les fichiers CSS du thème sont regroupés dans le dossier /css (sauf quand ils sont mis en cache).

Un thème dispose généralement d'un fichier CSS pour toutes les règles de style communes à toutes les pages. Ce fichier devrait être nommé global.css.

Chaque contrôleur dispose de son propre fichier CSS, qui contient les règles de style qui lui sont propres. Par exemple, pour la page produit, gérée par le contrôleur Product, le thème par défaut utilise le fichier product.css.

Fichiers JavaScript

Tous les fichiers JavaScript devraient être regroupés dans le dossier /js (sauf quand il est mis en cache).

Au contraire des règles CSS, il n'y a pas de fichier JavaScript commun.

Certains contrôleurs disposent de leurs propres fichiers JavaScript, mais pas tous. Chacun a ses propres besoins, et donc certains ont besoin d'un fichier CSS, d'autres non.

Version mobile du thème

Vous pouvez (et devriez) fournir une version mobile de votre thème. PrestaShop a été conçu pour automatiquement utiliser le thème contenu dans le sous-dossier /mobile du thème dans les situations où la boutique est affichée sur un support mobile.

Tous les fichiers du thème mobiles doivent être dans le dossier /mobile, lui-même situé dans le dossier du thème.

Le sous-dossier /mobile dispose de son propre jeu de fichiers CSS, JavaScript et image, respectivement stockés dans les dossiers /mobile/css, /mobile/js et /mobile/img.

Remplacer les fichiers modèles des e-mails et PDF

Vous devez vous efforcer de fournir vos propres modèles de mails et de fichiers PDF, et faire en sorte qu'ils correspondent au style du thème. C'est une forme de surcharge.

La manière la plus simple de se lancer consiste à reprendre le dossier /mails à la racine de PrestaShop, et de le copier en sous-dossier du thème que vous créez. Ceci fait, modifiez les fichiers pour qu'ils correspondent au style de votre thème. De la même manière, vous pouvez copier le dossier /pdf à la racine de PrestaShop dans le dossier du thème. Ceci fait, modifiez les fichiers pour qu'ils correspondent au style de votre thème. Notez que les fichiers de mails sont dupliqués sur autant de sous-dossiers qu'il y a de langues. La traduction doit se faire avec l'outil de traduction de PrestaShop.

Vous pouvez surcharger les modèles par défaut de manière sélective : si l'un des fichiers manque dans votre version du dossier /mails ou du dossier /pdf, PrestaShop utilisera son équivalent du dossier par défaut.

Remplacer les templates d'un module

Les modules de PrestaShop peuvent avoir leurs propres templates, dans leurs dossiers /views/templates/front, /views/templates/admin et /views/templates/hooks. Par exemple, le module Bankwire dispose des fichiers template suivants :

  • /modules/bankwire/views/templates/front/payment_execution.tpl

  • /modules/bankwire/views/templates/hook/payment.tpl

  • /modules/bankwire/views/templates/hook/payment_return.tpl

Pour surcharger le fichier template d'un module, votre thème doit avoir un fichier ayant exactement le même nom et ayant exactement le même chemin de fichier, mais dans son propre dossier. Par exemple, pour les trois fichiers du module Bankwire ci-dessus, les chemins des fichiers seraient :

  • /themes/my_theme/modules/bankwire/views/templates/front/payment_execution.tpl

  • /themes/my_theme/modules/bankwire/views/templates/hook/payment.tpl

  • /themes/my_theme/modules/bankwire/views/templates/hook/payment_return.tpl

Vous pouvez surcharger les fichiers template, les fichiers CSS et le fichiers JavaScript des modules installés en suivant ce principe : le même nom de fichier, le même chemin du fichier dans le dossier du thème.

Caractéristiques d'un thème front-office
Les dossiers du thème
Image de prévisualisation
Fichiers de traduction
Gérer les traductions
Envoyer des données dans un thème PrestaShop
Fichiers en cache
Fichiers image
Fichiers CSS
Fichiers JavaScript
Version mobile du thème
Remplacer les fichiers modèles des e-mails et PDF
Remplacer les templates d'un module