> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/efalia-process/administration/gestion-themes.md).

# 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](#prise-en-compte-dun-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 :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-6e133044a63eaadd237e9e4571bfb55a79e00e5e%2Fprocess-gestion-themes-skin-activation.webp?alt=media" alt=""><figcaption><p>Activation d'un thème</p></figcaption></figure>

## 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 nommant `default` va être créé pour accueillir les répertoires applicatifs
* Création des répertoires applicatifs `app/`, `designer/` et `login/` dans `default/`

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-js` est 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/`).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/efalia-process/administration/gestion-themes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
