Aller au contenu

Guide d'installation

Integration datadir

Le datadir geOrchestra contient une section dediee au header : https://github.com/georchestra/datadir/tree/master/header

Ces parametres permettent de configurer le header depuis le datadir, notamment le script a charger et l'usage du header legacy.

Parametres datadir (default.properties)

Resume simple des reglages du header :

Parametre Description Defaut
headerScript URL du script du composant header. https://cdn.jsdelivr.net/gh/georchestra/header@dist/header.js
headerHeight Hauteur du header en px. 80
useLegacyHeader Conserver le header historique en iframe. false
headerUrl URL du header legacy (utilisee si useLegacyHeader=true). /header/

Remplacement du legacy

Le nouveau composant header remplace le header legacy.

Pour l'utiliser, definir useLegacyHeader=true dans default.properties du datadir.

Usage

Le composant web est distribue sous forme de fichier JS statique sur la branche dist. Il est accessible via un CDN comme JsDelivr :

https://cdn.jsdelivr.net/gh/georchestra/header@dist/header.js

  1. Ajouter une balise script pointant vers le JS :
<script src="https://cdn.jsdelivr.net/gh/georchestra/header@dist/header.js"></script>
  1. Inserer le composant header :
<geor-header></geor-header>

Note : contrairement aux iframes il n'est pas necessaire de definir une hauteur, le composant gere sa taille et decale le contenu de page.

Le mode iframe legacy reste disponible avec legacy-header et legacy-url :

<geor-header legacy-header="true" legacy-url="/header/" legacy-style="width: 100%"></geor-header>

Attributs disponibles

Attribut Description Exemple Nouveau header Header legacy (iframe)
active-app Definir l'onglet actif dans le menu. <geor-header active-app='console'> v
config-file Chemin du fichier de config du nouveau header. <geor-header config-file="/config.json"> v
stylesheet Ajouter une feuille de style au nouveau header. <geor-header stylesheet="mystylesheet.css"> v
height Definir la hauteur en pixels. <geor-header height="80"> v v
legacy-header Activer le header legacy en iframe. <geor-header legacy-header="true"> v
legacy-url URL de l'iframe legacy. Requiert legacy-header. <geor-header legacy-header="true" legacy-url="/header/"> v
logo-url URL du logo pour le nouveau header. <geor-header logo-url="https://linktomylogo.com"> v
custom-nonce Nonce CSP pour les liens injectes. <geor-header custom-nonce="nonce"> v

Feuille de style custom

header {
  --georchestra-header-primary: #e20714;
  --georchestra-header-primary-light: white;
}
.admin-dropdown > li.active {
  background-color: red;
  color: white;
}

Nonce CSP

Si votre CSP exige un nonce pour les scripts inline, definir la valeur sur le script et le composant :

<script src="https://cdn.jsdelivr.net/gh/georchestra/header@dist/header.js" nonce="your-nonce-value"></script>
<geor-header custom-nonce="your-nonce-value"></geor-header>