---
title: "Personnalisation (auto-hébergement)"
weight: 32
description: "Personnalisez votre instance DoliSCAN auto-hébergée : arborescence, pages web, emails et documents PDF."
---

# Personnalisation de DoliSCAN (auto-hébergement)

## Arborescence de l'application

L'application serveur DoliSCAN est organisée comme ceci (arborescence classique d'un projet Laravel) :

- `/app` : le code source de l'application
- `/bootstrap` : des fichiers temporaires, aucune raison d'y toucher
- `/config` : configuration de l'application, normalement il vaut mieux modifier le fichier `.env` que de modifier les fichiers présents dans ce dossier
- `/database` : tout ce qui permet de créer / modifier / mettre à jour la base de données, vous ne devriez pas avoir à y toucher
- `/fail2ban` : des outils de filtrage
- `/jeu-essai` : des données pour les développeurs (jeu d'essai pour simuler des utilisations)
- `/larecipe-components` : morceau de documentation
- `/Modules` : modules complémentaires
- `/node_modules` : modules complémentaires node
- `/public` : partie "publique" de l'application, normalement le virtualhost pointe sur ce sous-dossier
- `/resources` : les ressources, c'est ici que vous irez pour personnaliser les pages web et les mails
- `/routes` : la table de routage interne de l'application
- `/storage` : le stockage des fichiers, logs, images des frais, etc. (voir ci-dessous)
- `/tests` : les tests
- `/tools` : des outils complémentaires
- `/vendor` : toutes les bibliothèques complémentaires qui sont gérées par "composer"

### Le dossier storage

Ce dossier contient trois sous-dossiers principaux :

- **LdeFrais** : pour chaque "ligne de frais" un justificatif. Vous trouverez donc dans ce dossier toute une arborescence de stockage de chaque photo de justificatif envoyé
- **NdeFrais** : les "notes de frais", donc le stockage des PDF et autres fichiers générés par DoliSCAN
- **CdeFrais** : les "classeurs de frais" pour les classeurs qui regroupent toutes les notes de frais d'une entreprise pour un import unique dans le logiciel de l'expert-comptable par exemple

À côté de ces trois principaux dossiers vous avez également :

- **chunks** : un dossier spécial qui stocke les "morceaux" d'images qui arrivent sur le serveur. L'application découpe chaque justificatif en paquets et envoie les paquets en vrac, charge ensuite au serveur de réassembler ces paquets. C'est une solution pour faire face aux problèmes réseau (lents, mauvaise couverture, etc.)
- **logs** : les journaux système

## Personnalisation des pages web

Tout se passe dans le dossier `resources/views` :

- `webheader.blade.php` : le bandeau de navigation en tête du site web
- `webfooter.blade.php` : le pied de page du site web
- `home.blade.php` : le contenu de la page d'accueil

## Personnalisation des emails

Les fichiers à adapter sont dans le dossier `resources/views/emails/`. Ils sont souvent doublés : l'un permet de générer la partie "html" des mails, l'autre pour la partie "texte brut".

### Modèle global des mails (signature / en-tête)

- `template.blade.php` : version html
- `template_text.blade.php` : version texte

### Mail d'invitation

- `account/new_html_content.blade.php` : version html du mail
- `account/new_text.blade.php` : version texte brut

### Mail d'information

- `closed.blade.php`
- `freezed.blade.php`
- `send.blade.php`
- `tocomplete.blade.php`

Vous pouvez modifier le contenu. Attention aux mots clés entre "moustaches" `{{` et `}}` qui sont remplacés par du texte généré par le code de l'application.

## Personnalisation des documents PDF générés

Les documents PDF générés par DoliSCAN sont en vérité des documents "html" qui sont ensuite automatiquement transformés en PDF.

Vous trouverez les squelettes des documents PDF dans la même arborescence que les "pages web" ou les "emails" : `resources/views`. Ils sont suffixés du code "print" pour les identifier plus facilement :

- `webprint.blade.php` : la "note de frais" en tant que telle, elle fait appel à deux autres fichiers :
  - `webprintsubpart.blade.php` : sous-partie réutilisée pour chaque type de frais
  - `webprintsubpartIK.blade.php` : sous-partie spécifique des indemnités kilométriques
- `webuserprint.blade.php` : la fiche utilisateur
- `webprintconfigaccounts.blade.php` : la fiche de configuration des comptes
- Les fichiers `*justificatifs*` sont dédiés au mécanisme d'export des justificatifs (ça regroupe X photos sur une seule page A4 PDF)