Gestion des Thèmes
Préambule
Ce document détaille la mise en œuvre des thèmes/skins Process. Cette fonctionnalité permet de personnaliser l'apparence du panorama, de l'écran de connexion et du modélisateur.
Si vous avez un profil technique, vous vous rendrez compte qu'il est possible d'aller un peu plus loin que le simple fait de personnaliser l'apparence, mais cela reste à vos risques et périls.
Cette fonctionnalité n'est disponible qu'à partir de la version 6.14.0.
Emplacement des thèmes
Les thèmes se trouvent dans le répertoire skins/ du répertoire des données de Process. Ce répertoire est configuré par défaut pour être $WORKEY_DATA/skins (où $WORKEY_DATA est généralement le répertoire workey-data).
Création d'un thème/skin
Pour ce faire, dans le répertoire des thèmes, vous devez créer un dossier qui accueillera vos fichiers. Son nom ne doit pas contenir de caractères spéciaux, mais doit être de type alpha-numérique sans espaces (par exemple: mon-theme).
Si vous voulez modifier l'apparence du panorama, du designer ou de l'écran de connexion, vous devez créer respectivement le(s) dossier(s) app/, designer/ et login/ dans le répertoire précédemment créé.
Vous pouvez ensuite déposer vos fichiers JS et CSS dans chacun des répertoires créés. Ceux-ci seront incorporés par le navigateur dans l'ordre alphabétique de leur nom.
Vous devriez avoir une structure de fichier comme ceci:
skins/
├── blue-theme
│ ├── favicon.png
│ └── workey.style.min.css
│ └── login-cover.jpg
│
└── mon-theme
├── app
│ ├── skin.css
│ └── skin.js
│
├── designer
│ └── skin.css
│
├── login
│ ├── skin.css
│ └── skin.js
│
└── workey.style.min.css
└── header-logo.svg Dans cet exemple ci-dessus, il y a deux thèmes qui se nomment blue-theme et mon-theme.
Une fois votre thème créé, vous devez configurer le serveur Process pour qu'il puisse le prendre en compte, voir Prise en compte d'un thème.
Fichiers réservés
Dans votre thème, il est possible de déposer des fichiers à la racine de ce dernier pour remplacer ceux par défaut.
Il y a 3 fichiers réservés:
header-logo.png: ce fichier est le logo en haut à gauche dans l'entête des applications (png, jpg, ou jpeg).
favicon.png: ce fichier est l'icône qui apparait dans le titre de votre navigateur et celle utilisée dans les favoris du navigateur.
login-cover.jpg: ce fichier est celui de la page de login à gauche du formulaire de saisie des identifiants.
Prise en compte d'un thème
Pour que Process prenne en compte un nouveau thème, (1) il faut se rendre dans les paramètres de Process dans l'administration, (2) activer la fonctionnalité et (3) sélectionner le thème adéquate :

Mise à jour d'une version antérieure à Process 6.14.0
Si vous installez Process 6.14.0 ou plus sur une version antérieure, l'installation va effectuer quelques modifications dans le répertoire des données de Process.
Dans un premier temps, la structure d'un thème par défaut est créée:
Le répertoire
skins/va être créé pour accueillir vos thèmes/skins.Dans
skins/, un thème se nommantdefaultva être créé pour accueillir les répertoires applicatifsCréation des répertoires applicatifs
app/,designer/etlogin/dansdefault/
Dans un second temps les fichiers vont être déplacés:
les fichiers présents dans
/styles/sont copiés vers/skins/default/les fichiers présents dans
/custom-css/* sont copiés vers/skins/default/app/les fichiers présents dans
/custom-js/* sont copiés vers/skins/default/app/le répertoire
/custom-jsest dupliqué sous le nom/external-js
Enfin, les répertoires styles/, custom-css/ et custom-js/ sont renommés avec comme préfixe __unused__ (c'est à dire __unused__styles/, __unused__custom-css/ et __unused__custom-js/).
Mis à jour