Passer au contenu principal
Version : 1.x

Modèles de Reçu

L'éditeur de modèle de reçu vous permet de personnaliser l'apparence et le contenu des reçus imprimés depuis votre système POS. Vous pouvez accéder à l'éditeur de modèle en naviguant vers : WP Admin > POS > Templates

Aperçu​

Le système de modèles fournit deux types de modèles :

  • Modèles par Défaut : Détectés automatiquement à partir de vos fichiers de plugin et de thème. Ceux-ci ne peuvent pas être supprimés mais peuvent être copiés pour créer des versions personnalisées.
  • Modèles Personnalisés : Modèles créés par l'utilisateur que vous pouvez entièrement personnaliser, éditer et gérer.

Accéder à l'Éditeur de Modèle​

  1. Accédez à votre tableau de bord WordPress Admin
  2. Allez à POS > Templates
  3. Vous verrez une liste de modèles disponibles organisés en deux sections :
    • Modèles par Défaut (à partir des fichiers de plugin/thème)
    • Modèles Personnalisés (vos créations personnalisées)

Modèles par Défaut​

Le système détecte automatiquement les modèles de reçus à partir de trois sources :

Sources de Modèle​

SourceDescriptionStatut
PluginModèle de reçu de base inclus avec WCPOSToujours disponible
Pro PluginModèle amélioré de WCPOS ProDisponible avec une licence active
ThèmeModèle personnalisé de votre thème actifDisponible si le thème inclut un modèle

Actions sur le Modèle​

Pour chaque modèle par défaut, vous pouvez :

  • Aperçu : Voir comment le modèle apparaît avec des données d'exemple
  • Copier : Créer une copie personnalisée que vous pouvez éditer
  • Activer : Définir comme le modèle actif pour votre POS

Création de Modèles Personnalisés​

Méthode 1 : Copier un Modèle par Défaut​

  1. Dans la section Modèles par Défaut, trouvez le modèle que vous souhaitez personnaliser
  2. Cliquez sur le bouton Copier
  3. Entrez un nom pour votre modèle personnalisé
  4. Cliquez sur Copier le Modèle
  5. Éditez le modèle personnalisé nouvellement créé

Méthode 2 : Créer à Partir de Zéro​

  1. Cliquez sur Ajouter un Nouveau Modèle en haut de la page
  2. Entrez un nom de modèle
  3. Sélectionnez Reçu comme type de modèle
  4. Commencez à coder votre modèle dans l'éditeur

Fonctionnalités de l'Éditeur de Modèle​

L'éditeur de modèle fournit :

Éditeur de Code​

  • Mise en Évidence de la Syntaxe : Mise en évidence de la syntaxe PHP pour une meilleure lisibilité du code
  • Numéros de Ligne : Navigation et débogage faciles
  • Édition en Plein Écran : Environnement d'édition sans distraction

Panneau de Paramètres de Modèle​

  • Langue : Définie sur PHP pour une mise en évidence correcte de la syntaxe
  • Type de Modèle : Choisissez entre les modèles de Reçu ou de Rapport
  • Statut : Gestion du statut Publié/Brouillon
  • Visibilité : Contrôlez la visibilité du modèle

Actions sur le Modèle​

  • Aperçu : Voir comment votre modèle se rend avec des données d'exemple
  • Définir comme Actif : Faire de ce modèle le modèle par défaut pour votre POS
  • Mettre à Jour : Enregistrez vos modifications
  • Déplacer vers la Corbeille : Supprimer les modèles personnalisés

Structure du Modèle​

Les modèles de reçus sont des fichiers PHP qui génèrent une sortie HTML. Voici la structure de base :

<?php
/**
 * Custom Receipt Template
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly
}
?>
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
    <meta charset="<?php bloginfo( 'charset' ); ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <style>
        /* Your custom CSS styles */
        body { font-family: sans-serif; font-size: 14px; }
        .receipt-header { text-align: center; margin-bottom: 20px; }
        /* Add more styles as needed */
    </style>
</head>
<body>
    <!-- Your receipt content -->
    <div class="receipt-header">
        <h1><?php echo get_bloginfo( 'name' ); ?></h1>
        <p><?php echo get_bloginfo( 'description' ); ?></p>
    </div>

    <!-- Order details, items, totals, etc. -->

</body>
</html>

Variables de Modèle Disponibles​

Lors de la création de modèles personnalisés, vous avez accès à diverses fonctions et données WordPress et WooCommerce :

Informations sur le Magasin​

  • get_bloginfo( 'name' ) - Nom du magasin
  • get_bloginfo( 'description' ) - Slogan du magasin
  • get_bloginfo( 'url' ) - URL du magasin

Données de Commande​

Les données de la commande actuelle sont disponibles via les fonctions de commande WooCommerce standard lors du rendu du modèle.

Fonctions WCPOS​

Vous pouvez utiliser des fonctions spécifiques à WCPOS (préfixées par wcpos_) pour accéder aux données et fonctionnalités liées au POS.

Meilleures Pratiques​

Développement de Modèles​

  1. Commencez par une Copie : Commencez toujours par copier un modèle par défaut plutôt que de créer à partir de zéro
  2. Testez en Profondeur : Utilisez la fonction d'aperçu pour tester votre modèle avant de l'activer
  3. Conservez des Sauvegardes : Exportez vos modèles personnalisés ou conservez des copies de votre code
  4. Compatibilité Mobile : Assurez-vous que vos modèles fonctionnent bien sur différentes tailles d'écran

Qualité du Code​

  1. Validez HTML : Assurez-vous que votre HTML est bien formé
  2. Échappez la Sortie : Utilisez les fonctions d'échappement de WordPress pour la sécurité
  3. Gestion des Erreurs : Incluez une vérification des erreurs appropriée dans votre code PHP
  4. Commentaires : Documentez vos personnalisations pour référence future

Performance​

  1. Optimisez CSS : Gardez les styles minimaux et efficaces
  2. Minimisez PHP : Évitez la logique complexe dans les modèles
  3. Testez l'Impression : Vérifiez que les modèles fonctionnent bien avec vos imprimantes de reçus

Dépannage​

Problèmes Courants​

Le modèle ne montre pas les modifications
  • Assurez-vous d'avoir cliqué sur "Mettre à Jour" pour enregistrer vos modifications
  • Vérifiez que le modèle est défini comme "Actif"
  • Effacez tous les plugins de mise en cache
Erreurs de syntaxe
  • Utilisez la mise en évidence de la syntaxe pour identifier les problèmes
  • Vérifiez les points-virgules, les crochets ou les guillemets manquants
  • Validez votre syntaxe PHP
Problèmes de style
  • Testez votre CSS en mode aperçu
  • Assurez-vous que les styles sont compatibles avec les imprimantes de reçus
  • Gardez à l'esprit les principes de design adaptés à l'impression
Modèle non disponible
  • Vérifiez que le type de modèle est défini sur "Reçu"
  • Vérifiez que le statut du modèle est "Publié"
  • Assurez-vous d'avoir les permissions appropriées

Obtenir de l'Aide​

Si vous rencontrez des problèmes avec la personnalisation des modèles :

  1. Vérifiez l'aperçu du modèle pour les messages d'erreur
  2. Consultez le journal de débogage de WordPress pour les erreurs PHP
  3. Testez d'abord avec une copie du modèle par défaut
  4. Assistance AI : Les outils modernes d'IA comme Gemini, ChatGPT et Claude sont excellents pour aider avec des modèles WordPress simples comme ceux-ci. Vous pouvez coller votre code de modèle et décrire ce que vous voulez atteindre.
  5. Consultez la documentation WCPOS pour une personnalisation avancée

Personnalisation Avancée​

Pour les utilisateurs avancés qui ont besoin de plus de contrôle sur les modèles de reçus :

Intégration de Thème​

Vous pouvez remplacer le modèle par défaut en plaçant un fichier receipt.php personnalisé dans votre thème :

your-theme/woocommerce-pos/receipt.php

Hooks et Filtres​

WCPOS fournit divers hooks et filtres pour la personnalisation des modèles. Consultez la documentation pour les développeurs pour les options disponibles.

Champs Personnalisés​

Vous pouvez inclure des champs de commande personnalisés, des attributs produit et d'autres métadonnées dans vos modèles de reçus en utilisant les fonctions appropriées de WordPress et WooCommerce.