Notes et traduction libre de la documentation “Designer Guide” pour la modification et la personnalisation de l'interface du site de base Apostrophe.
La variable app_a_title_prefix est initialisée avec la valeur contenue dans le fichier de configuration de l'application apps/config/app.yml. Ceci permet de définir un préfixe qui apparaîtra dans le titre de toutes les pages du site. Par défaut le préfixe est 'Apostrophe Sandbox':
apps/frontend/config/app.yml:
all:
a:
title_prefix:
# Peut se differencier en fonction de la culture
en: 'my_web_site'
fr: 'mon_site_web'
# Pour un site ne se declinant pas en plusieurs langues:
title_prefix: 'mon_site_web'
Remarque: Apres modification du fichier app.yml, penser à vider le cache pour que les modifications apportées soient immédiatement visibles.
Apostrophe est une application(plugin) Symphony, elle utilise les principes de layouts et de templates du framework. Le layout est le cadre de mise en forme commun à toutes les pages du site. Apostrophe utilise son propre layout (inclus dans le plugin) par défaut. Ce comportement peu être altéré grâce à la variable use_bunled_layout. Lorsque la variable use_bundled_layout est à false, Apostrophe utilise le layout m le fichier layout.php contenu dans apps/frontend/templates.
Une bonne pratique lorsqu'on souhaite personnaliser l'interface d'Apostrophe est donc de faire la copie du layout dans le dossier apps/frontend/templates et de modifier la variable app_a_use_bundled_layout:
$ cp plugins/apostrophePlugin/modules/a/templates/layout.php apps/frontend/templates/
all:
a:
# Désactiver l'utilisation du layout fournit par défaut
use_bundled_layout: false
Les éléments spécifiques à un type de page sont introduits dans les templates. Apostrophe utilise le système de templates de Symfony avec une nomenclature particulière. La sandbox est livrée avec plusieurs templates:
Il est possible de modifier le template utilisé par la page via l'interface d'administration en utilisant le menu .
Pour creer son propre template, ne pas modifier le template d'Apostrophe