====== Personnaliser interface Apostrophe ======

Notes et traduction libre de la documentation "Designer Guide" pour la modification et la personnalisation de l'interface du site de base Apostrophe.

===== Préfixer le titre des pages =====

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:
<file>
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'
</file>

Remarque: Apres modification du fichier app.yml, penser à vider le cache pour que les modifications apportées soient immédiatement visibles.

===== Modification du layout =====

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**:

<code bash>
$ cp plugins/apostrophePlugin/modules/a/templates/layout.php apps/frontend/templates/
</code>

<file>
all:
  a:
    # Désactiver l'utilisation du layout fournit par défaut
    use_bundled_layout: false
</file>


===== Modification des templates =====

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:

  * 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 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

===== Références ===== 

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