Frappe Framework
Page Apps
La page Apps donne un accès rapide aux applications installées. Une application personnalisée s’y ajoute par un hook, et une application par défaut peut être imposée.
À quoi sert la page
La page Apps offre une navigation rapide vers toutes les applications installées sur le site. Par défaut, toutes les applications Frappe installées y apparaissent.
Afficher une application personnalisée
Ajoutez add_to_apps_screen dans le hooks.py de l’application. Chaque élément de la liste devient une application sur la page. L’exemple est celui de Frappe CRM. L’option has_permission affiche ou masque l’icône selon la logique métier, par exemple pour cacher l’icône à un utilisateur du site (Website User).
add_to_apps_screen = [{
"name": "crm",
"logo": "/assets/crm/logo.png",
"title": "CRM",
"route": "/crm",
"has_permission": "crm.api.check_app_permission",
}]À retenir
Cette déclaration est prise en charge à partir de la version 15.
Application par défaut
Une application par défaut envoie l’utilisateur directement vers elle à la connexion. Sans application par défaut, la page Apps s’affiche.
La configuration existe à deux niveaux :
- niveau utilisateur : chaque personne choisit son application par défaut ;
- niveau système : une application par défaut vaut pour tous les utilisateurs.
La source illustre ces deux niveaux par des captures, sans décrire les champs dans le texte.
Point d’attention
has_permission est un chemin de fonction, pas un rôle. Sans cette clé, la source ne dit pas que l’icône est filtrée.