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 des templates classiques Symfony, seule une nomenclature spécifiqueune nomenclature particulère a été a été définie. Les fichiers de templates sont stockés dans le dossier ./templates de chaque module. De base Apostrophe en fournit deux

• homeTemplate.php: utilisé pour la page d'accueil.
• defaultTemplate.php: utiliser par toute page lorsque aucun template particulier n'est définit.

Il est possible de modifier le template par défaut via l'interface d'administration en utilisant le breadcrumb trail.

Pour creer son propre template, ne pas modifier le template d'Apostrophe

• http://trac.apostrophenow.org/wiki/ManualDesignersGuide