Wiki source code of Personnalisation du thème du tableau de bord
Last modified by Aurelie Bertrand on 2025/09/04 15:55
Hide last authors
author | version | line-number | content |
---|---|---|---|
![]() |
53.1 | 1 | {{ddtoc/}} |
2 | |||
3 | ---- | ||
4 | |||
![]() |
59.1 | 5 | Lors de la première installation de Digdash, le thème //digash_2024 //est défini par défaut comme thème serveur et utilisé pour l'affichage des tableaux de bord. |
![]() |
38.1 | 6 | |
![]() |
83.1 | 7 | Il est possible de personnaliser simplement le thème utilisé pour vos tableaux de bord. En effet, vous pouvez utiliser un modèle fourni par DigDash (//digdash_2019 ou digdash_2024//) comme base de votre thème et le modifier à souhait. |
![]() |
1.1 | 8 | |
![]() |
83.1 | 9 | La personnalisation du thème complet nécessite plusieurs paramétrages. |
![]() |
56.1 | 10 | Il est recommandé de commencer par créer le thème dans l'éditeur de tableaux de bord. Vous pouvez ensuite modifier les styles des graphiques dans le Studio. |
![]() |
83.1 | 11 | Enfin, vous pouvez définir le nouveau thème comme thème serveur si vous souhaitez le propager à l'ensemble des éléments du tableau de bord pour tous les utilisateurs. |
![]() |
19.5 | 12 | |
![]() |
1.1 | 13 | = Créer le thème dans l'Éditeur de tableaux de bord = |
14 | |||
![]() |
83.1 | 15 | L'Éditeur de thèmes permet de créer simplement un nouveau thème via une interface intuitive tout en proposant un éditeur CSS pour les besoins de personnalisation plus avancée. |
![]() |
33.1 | 16 | |
![]() |
85.1 | 17 | Consultez la page [[Éditeur de thèmes>>doc:Digdash.user_guide.dashboard.theme_editor.WebHome]] pour plus de détails. |
![]() |
33.1 | 18 | |
![]() |
84.1 | 19 | = Définir les styles des graphiques dans le Studio = |
![]() |
19.2 | 20 | |
21 | Le thème dans le Studio permet de modifier les styles des graphiques. Pour cela, vous pouvez soit : | ||
22 | |||
![]() |
19.3 | 23 | * utiliser l'assistant de création de thème : il permet de modifier simplement le thème via une interface. Consultez la page [[Assistant d'édition de thème>>doc:Digdash.user_guide.studio.Create_flow.Configure_flow.Modify_style.style_editor.WebHome]] pour plus de détails. |
![]() |
23.1 | 24 | * importer un thème à utiliser comme modèle et modifier les constantes. |
![]() |
19.2 | 25 | |
![]() |
50.1 | 26 | (% class="box warningmessage" %) |
27 | ((( | ||
![]() |
56.1 | 28 | ❗Il est recommandé d'utiliser le même nom de thème que dans l'éditeur. Cela sera nécessaire si vous souhaitez ensuite définir le thème comme thème serveur. |
![]() |
50.1 | 29 | ))) |
30 | |||
![]() |
19.3 | 31 | == Importer un thème == |
![]() |
19.2 | 32 | |
![]() |
45.1 | 33 | Pour utiliser un thème existant: |
![]() |
19.2 | 34 | |
![]() |
56.1 | 35 | 1. Lors de la configuration des flux (graphiques), allez dans l'onglet **Thèmes**. Par défaut, c'est le thème serveur qui est sélectionné s'il y en a un de défini. |
![]() |
19.4 | 36 | 1. Cliquez sur le bouton **+** à droite de la liste des thèmes pour afficher l'interface avancée. |
![]() |
35.1 | 37 | 1. Cliquez sur le bouton **+** puis **Ajouter** pour créer un nouveau thème. |
![]() |
78.1 | 38 | [[image:Add_theme_Studio_FR.png||alt="Nouveau thème"]] |
![]() |
48.1 | 39 | ➡ Une boite **Nouveau** s'affiche. |
![]() |
56.1 | 40 | 1. Entrez le **Nom** du thème : le même que celui du thème éditeur. |
![]() |
57.1 | 41 | 1. Dans la liste déroulante **Rôle**, sélectionnez** **un rôle auquel restreindre le thème ou** Aucun **pour partager le thème à tous les rôles puis cliquez sur **OK**. |
![]() |
56.1 | 42 | 💡 Choisissez **Aucun **si vous souhaitez utiliser le thème comme thème serveur. |
![]() |
19.4 | 43 | ➡ Le thème est ajouté à la liste. |
![]() |
78.1 | 44 | 1. Sélectionnez-le et cliquez sur le bouton [[image:Edit_button.png]] pour l'éditer. |
![]() |
19.5 | 45 | 1. ((( |
46 | (% style="line-height:1.38" %) | ||
47 | (% id="cke_bm_283460S" style="display:none" %) (%%)Le nouveau thème est vide par défaut. Il faut spécifier le thème Digdash à utiliser comme modèle. Pour cela, ajoutez la ligne suivante en première ligne : | ||
![]() |
19.2 | 48 | |
![]() |
19.5 | 49 | {{code language="css"}} |
50 | @import url "<nom du template digdash>.css"; | ||
51 | {{/code}} | ||
![]() |
19.2 | 52 | |
![]() |
19.5 | 53 | dans laquelle **<nom du template digdash>** est à remplacer par le nom du thème que vous souhaitez utiliser comme base de style : //digdash_2019// ou //digdash_2024//. |
54 | ))) | ||
55 | |||
![]() |
19.9 | 56 | Vous pouvez alors renseigner les constantes que vous souhaitez modifier. Pour cela, ajoutez un bloc root après la ligne d'import sous la forme : |
![]() |
19.5 | 57 | |
58 | {{{:root { --<nom de la constante 1 CSS>: <valeur de la constante 1 CSS> … --<nom de la constante N CSS>: <valeur de la constante N CSS> }}}} | ||
59 | |||
60 | (% class="box infomessage" %) | ||
61 | ((( | ||
62 | **Note** | ||
63 | |||
64 | Les constantes CSS doivent être définies dans le (seul et unique) bloc **//:root//**. | ||
65 | Les noms des constantes doivent commencer par **~-~-** par convention de nommage. | ||
66 | ))) | ||
67 | |||
68 | (% class="wikigeneratedid" %) | ||
![]() |
66.1 | 69 | Les constantes disponibles sont les suivantes (avec valeurs d'exemple) : |
![]() |
19.5 | 70 | |
![]() |
19.6 | 71 | (% class="wikigeneratedid" %) |
![]() |
64.1 | 72 | :root { |
73 | ~-~-dd-font-family-fontFamily:Open Sans; | ||
74 | ~-~-dd-font-weight-fontWeight:inherit; | ||
75 | ~-~-dd-font-style-fontStyle:Normal; | ||
76 | ~-~-dd-font-color-fontColor:#000000; | ||
77 | ~-~-dd-axes-border-borderSize:0.3; | ||
78 | ~-~-dd-axes-border-borderColor:#888888; | ||
79 | ~-~-dd-tooltips-fontWeight:inherit; | ||
80 | ~-~-dd-tooltips-fontStyle:normal; | ||
81 | ~-~-dd-tooltips-fontColor:#888888; | ||
82 | ~-~-dd-tooltips-backgroundColor:#ffffff; | ||
83 | ~-~-dd-table-border-borderSize:0.5; | ||
84 | ~-~-dd-table-border-borderColor:#888888; | ||
85 | ~-~-dd-table-header-fontColor:#ffffff; | ||
86 | ~-~-dd-table-header-backgroundColor:#00b0f0; | ||
87 | ~-~-dd-table-header-fontWeight:bold; | ||
88 | ~-~-dd-table-TD-fontColor:#000000; | ||
89 | ~-~-dd-table-TD-backgroundColor:#ffffff; | ||
90 | } | ||
![]() |
19.5 | 91 | |
![]() |
56.1 | 92 | (% class="wikigeneratedid" %) |
93 | Si ces variables ne sont pas suffisantes, vous pouvez chercher les classes css et les ajouter. | ||
![]() |
21.1 | 94 | |
![]() |
56.1 | 95 | = (% id="cke_bm_112484S" style="display:none" %) (%%)Paramétrer le thème serveur = |
96 | |||
97 | (% class="box infomessage" %) | ||
98 | ((( | ||
99 | 💡L'utilisation d'un thème serveur permet une personnalisation "industrialisée" du tableau de bord avec les mêmes paramètres pour tous les utilisateurs et tous les graphiques. | ||
100 | Il est également possible de définir un thème au niveau utilisateur (consultez la page [[Gérer les utilisateurs>>doc:Digdash.deployment.configuration.administration.User_management.User_management.WebHome]]) ou d'une page (consultez la paragraphe [[Modifier les paramètres d'une page>>doc:Digdash.user_guide.dashboard.dashboard_editor_guide.edit_dashboard.edit_dashboard_pages.WebHome||anchor="Parametres_page"]]). | ||
101 | À noter que le thème défini au niveau de la page prévaut sur le thème au niveau utilisateur qui prévaut lui-même sur le thème serveur. | ||
102 | ))) | ||
103 | |||
104 | Il est alors possible de définir le thème créé dans l'Éditeur de tableaux de bord comme thème serveur afin de le propager à tous les éléments du tableau de bord et tous les utilisateurs. Pour cela : | ||
105 | |||
106 | 1. Depuis la page d'accueil, allez dans **Configuration** -> **Paramètres Serveurs** -> **Paramètres supplémentaires** -> **Divers**. | ||
107 | 1. Dans la liste déroulante **Thème**, sélectionnez le thème créé. | ||
108 | Les thèmes disponibles sont ceux livrés par Digdash ou créés dans l'Éditeur de tableaux de bord. | ||
![]() |
82.1 | 109 | [[image:Select_theme_server_parameters_FR.png||alt="Thème serveur"]] |
![]() |
56.1 | 110 | 1. Cliquez sur **Enregistrer.** |