======= Service banner.chapril.org =======

Afin d'apporter une personnalisation homogène des services Chapril, une bannière mutualisée a été mise en place. 

Son intégration dans les sites des services passe par NGinx en insérant du code au passage.

Au début, les fichiers de la bannière étaient dans le sites www.chapril.org puis ils ont été déplacés dans un site dédié : banner.chapril.org.

===== Historique des versions =====

Versions de la bannière :

  * version 1 : faite au début juste pour qu'il y ait quelque chose, visible là https://v1.april.org/ ;
  * version 2 : en cours.
 

===== Intégration v1 dans NGinx =====

Deux objectifs :
  * rendre disponible les fichiers utiles à la bannière ;
  * modifier le code HTML des pages servies par NGinx.

** Fichier prédéfinis **

Fichier de configuration pour rendre disponible les fichiers utiles à la bannière :
<code conf /etc/nginx/chapril-banner-location>
    location /Chapril-banner {
        proxy_set_header Host banner.chapril.org;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://lamp.cluster.chapril.org;
    }
</code>

Fichier de configuration pour modifier le code HTML des pages servies :
<code conf /etc/nginx/chapril-banner>
set $banner_head '        <link rel="stylesheet" type="text/css"  href="/Chapril-banner/v1/chapril-banner.css" />';
set $banner_body '    <!-- CHAPRIL BANNER -->
    <header id="chapril-banner">
      <div id="chapril-banner-zone">
    <div id="chapril-banner-logo">
      <a href="https://www.chapril.org/"><img src="/Chapril-banner/v1/chapril-logo-small.png" alt="Logo Chapril" /></a>
    </div>
    <div id="chapril-banner-menu">
      <ul>
        <li><a href="https://www.chapril.org/">Accueil Chapril</a></li>
        <li><a href="https://www.chapril.org/services.html">Services libres</a></li>
        <li><a href="https://pouet.april.org/@aprilorg">Nous suivre</a></li>
        <li><a href="https://www.chapril.org/cgu.html">CGU</a></li>
        <li><a href="https://www.chapril.org/a-propos.html">Mentions légales</a></li>
        <li><a href="https://www.chapril.org/contact.html">Nous contacter</a></li>
      </ul>
    </div>
    <div id="chapril-banner-aprillogo">
      <a href="https://www.april.org/"><img src="/Chapril-banner/v1/april-logo-small.png" alt="Logo April" /></a>
    </div>
      </div>
    </header>';

subs_filter '</head>' '
$banner_head
</head>';
subs_filter '</body>' '
$banner_body
  </body>';

sub_filter_once on;
</code>

**Inclusion des fichiers prédéfinis**

À inclure dans le ficher de configuration NGinx du site ciblé :
<code conf /etc/nginx/sites-enabled/www.foo.org>
    […]
    include /etc/nginx/sexy-chapril;
    include /etc/nginx/acme-challenge;
    include /etc/nginx/chapril-banner-location;
    […]
    location / {
        include /etc/nginx/chapril-banner;
    […]
</code>

** Fichiers de la bannière **

Fichiers de la bannière v1 :
<code>
=(^-^)=root@lamp:/var/www/banner.chapril.org/Chapril-banner/v1# ll
total 24
-rw-r--r-- 1 root root 3574 oct.  14 01:19 april-logo-small.png
-rw-r--r-- 1 root root 1960 oct.  14 01:51 chapril-banner.css
-rw-r--r-- 1 root root 2345 oct.  14 01:28 chapril-favicon.png
-rw-r--r-- 1 root root 2096 oct.  14 00:50 chapril-logo-small.png
-rw-r--r-- 1 root root 1477 oct.  14 01:24 test.xhtml
</code>
===== Dépot GIT =====
Sur la vm lamp, le dossier /var/www/banner.chapril.org/ est gité.

<note warning>Prévoir de rendre accessible ce projet dans Redmine.</note>