Fichiers du modèle
Le modèle utilise les fichiers suivants :
- fichiers avec les feuilles de styles
- fichiers graphiques
- fichiers scripts
- autres fichiers
Les fichiers du modèle sont regroupés dans les dossiers système et les dossiers d’utilisateur.
Les extensions autorisées des fichiers sont les suivantes :
- fichiers avec les feuilles de styles : .css
- fichiers graphiques : .gif, .jpg, .jpeg, .png, .ico
- fichiers scripts : .js
- autres fichiers : .htm, .html, .liquid
Les caractères autorisés dans les noms des fichiers sont les suivants :
- chiffres : 0-9
- minuscules : a-z (sans les signes diacritiques)
- caractères spéciaux : trait d’union, souligné, point
Lors du chargement du fichier depuis le disque, les majuscules dans les noms des fichiers (et des dossiers) seront automatiquement remplacées par les minuscules. Les caractères spéciaux autres que ceux indiqués seront remplacés par le souligné.
Les fichiers dans le modèle doivent être correctement encodés Encodage UTF-8 sans BOM. Les fichiers ne peuvent pas contenir les caractères de contrôle.
Les noms des fichiers et des dossiers qui commencent par „__” (deux soulignés) sont réservés par Comarch. Les dossiers et les fichiers portant ce nom remplissent les fonctions spéciales dans le modèle ou dans les outils de gestion du modèle.
Structure des dossiers
Dossiers „système”
Structure des dossiers „système” dans le modèle
Le dossier css doit contenir les fichiers avec les feuilles de styles utilisés dans le modèle.
Le dossier css/img doit comprendre les fichiers graphiques utilisés dans le modèle.
Le dossier js doit contenir les fichiers scripts utilisés dans le modèle.
Le dossier ROOT doit comprendre les autres fichiers utilisés dans le modèle (pages, insertions).
Les fichiers du modèle avec les feuilles de styles, les fichiers graphiques et les fichiers scripts doivent se trouver dans les dossiers cités ci-dessus. Dans le cas contraire, ils ne seront pas correctement interprétés par les navigateurs Web.
Dossiers d’utilisateur
La structure des fichiers d’utilisateur peut être quelconque. Il faut cependant respecter la règle disant que le nombre de niveaux d’ancrage doit être limité au minimum nécessaire.
La structure des dossiers trop développée risque de ne pas être prise en charge par l’outil de synchronisation des modèles.
Les caractères autorisés dans les noms des dossiers sont les suivants :
- chiffres : 0-9
- minuscules : a-z (sans les signes diacritiques)
- caractères spéciaux : trait d’union, souligné
Fichiers d’utilisateur dans la boutique
Vous pouvez utiliser les fichiers d’utilisateur (dossier usr/*) dans le modèle. Il convient d’être conscient du fait que les fichiers d’utilisateur :
- ne seront pas importés à partir du fichier avec le modèle des pages
- ne seront pas exportés dans le fichier avec le modèle des pages
Il est interdit d’utiliser dans le modèle les fichiers se trouvant dans les dossiers :
- Dossier App_Themes/
- Dossier view/
- Dossier scripts/
- Dossier images/
- Dossier t/
- Dossier m/
- Dossier fb/
Ces dossiers contiennent les éléments de la mise en page des modèles utilisés jusqu’à présent (sans la technologie Liquid).
Fichier __settings.liquid
Le fichier __settings.liquid est utilisé pour construire l’interface graphique permettant de modifier les paramètres du modèle. Ce fichier est préparé par l’auteur du modèle.
Voici les exigences pour le plug-in dédié aux paramètres :
- Nom du fichier __settings.liquid
- Le fichier implémente la fonction __SaveLiquidSettings(). Cette fonction retourne l’objet js à partir duquel les paramètres seront enregistrés. Les propriétés de cet objet peuvent contenir uniquement les types simples et les tableaux. Par contre, elles ne peuvent pas contenir les objets.
__SaveLiquidSettings()
La fonction retourne l’objet js à partir duquel les paramètres seront enregistrés dans le modèle.
La fonction est appelée automatiquement à l’enregistrement des paramètres dans le Panneau d’administration. Pour enregistrer les paramètres dans le panneau, cliquez sur le bouton Enregistrer
.
La fonction doit retourner tous les paramètres, aussi bien ceux modifiés que non modifiés par l’utilisateur.
Contenu exemplaire du fichier __settings.liquid
.settings {
height: 100px;
width: 300px;
border: solid 1px #000000;
padding: 8px;
margin: 8px;
}
</style>
<div class=”settings”>
color1:
<input name=”color1″ type=”color” value=”{{settings.color1}}” />
color2:
<input name=”color2″ type=”color” value=”{{settings.color2}}” />
</div>
<script>
function __SaveLiquidSettings() {
var o = {};
//collecte de tous les paramètres et construction de l’objet à partir d’eux.
//implémentation exemplaire :
$(„.settings input”).each(function (el, el2) { o[el2.name] = el2.value; });
return o;
}
</script>