===== Format Page : Installation =====

Le format page est un format très puissant mais son installation est non triviale. Elle est déconseillé à des personnes n'ayant pas une connaissance architecturale minimale de Moodle, ou n'ayant pas une bonne habitude de la construction des plates-formes open-source en PHP.

Le processus d'installation suppose : 

   * Installer les composants nécessaires au fonctionnement du format
   * Installer les customisations (customscripts) nécessaires
   * Modifier les thèmes utilisés pour inclure les mises en page (layouts) additionnels du format page

==== Composants nécessaires ====

En plus du composant "format/page", vous devrez installer : 

   * [[BlockPageModule|Le bloc "Module de page"]] : Ce bloc est responsable de la banalisation des modules d'activités de Moodle qui seront gérés comme les autres blocs sur les pages.

L'un (ou les deux) des principes de navigation internes suivants :

   * [[blocks:pagetracker|Le bloc "Etapes de formations]] : Ce bloc propose un menu simple composé des pages disponibles à partir d'une racine donnée. Sa mise en oeuvre est simple. 
   * [[ModPageMenu|Le module Menu Paginé]] : Ce module propose la construction d'un menu flexible à partir de pages, mais aussi de liens externes ou de liens vers des activités du pool commun. En tant que module, il peut facilement être réutilisé sur toutes les pages sans reconfiguration.

==== Processus d'installation ====

=== Télécharger et installer les composants ===

   - Décompactez l'archive du format page dans le répertoire /course/format de votre installation Moodle
   - Décompactez l'archive du bloc [[BlockPageModule|Module de Page]] dans le répertoire /blocks de votre installation Moodle.
   - Décompactez l'une des deux ou les deux archives [[ModPageMenu|Module Menu Paginé]], ou bloc [[blocks:pagetracker|Etapes de fomation]], respectivement dans les répertoires /mod ou /blocks de votre installation Moodle. 
   - Naviguez vers les notifications d'administration pour procéder à l'installation "logique" des composants ajoutés.

=== Activation des "customisations" ===

L'archive du format page vient avec un certain nombre de compléments situés dans les répertoires __customscripts et __theme de la distribution.

   - Créez (si ce n'est déjà fait) le répertoire des customisations de Moodle. L'usage veut, en général qu'il s'appelle "customscripts" et soit situé à la racine de l'installation de Moodle. 
   - Copiez le contenu du répertoire <nowiki>__customscripts</nowiki> dans ce répertoire. ATTENTION : si votre installation comporte déjà des customisations sur des fichiers de chemin identique pour d'autres raisons que le format page, Il conviendra de demander à un intégrateur de fusionner les modifications.
   - Dans le fichier de configuration de Moodle (config.php à la racine) ajoutez la ligne suivante :

   $CFG->customscripts = '/chemin/vers/mon/moodle/customscripts';
   
=== Ajout des éléments supplémentaires de thème ===

Le complément __theme contient un pseudo-theme "page". Ce thème est potentiellement utilisable en tant que tel, mais son usage est déconseillé car il ne suivra pas les personnalisations des thèmes exploités sur la plate-forme.

Ce complément est là pour vous fournir les éléments à ajouter dans les thèmes que vous utilisez par ailleurs dans Moodle.

Ce package contient essentiellement un layout 'page.php' qu'il faut ajouter aux themes que vous utilisez dans la plate-forme d'exploitation.

Pour activer ce layout, éditez le fichier **config.php** du thème cible et ajouter les lignes suivantes dans la définition des layouts (tableau php) : 

    'format_page' => array(
        'file' => 'page.php',
        'regions' => array('side-pre', 'main', 'side-post', 'footer-left', 'footer-middle', 'footer-right'),
        'defaultregion' => 'side-post',
    ),
    
    'format_page_action' => array(
        'file' => 'page.php',
        'regions' => array('side-pre', 'side-post', 'main', 'footer-left', 'footer-middle', 'footer-right'),
        'options' => array('langmenu' => true, 'noblocks' => true),
        'defaultregion' => 'side-post',
    ),

Vous aurez probablement à revoir les séquences d'en-tête et de pied de page dans le fichier de layout **page.php**. En effet, chaque producteur de theme a sa propre écriture de ces séquences. La partie "active" du layout est :

    <!-- END OF HEADER -->
    <!-- START CUSTOMMENU AND NAVBAR -->
    <!-- END OF CUSTOMMENU AND NAVBAR -->
    <!-- page content -->
        <div id="format-page-content" class="format-page-content container-fluid">
            <!-- EVERYTHING HERE IS DEFERRED TO format.php OF THE COURSE FORMAT -->
            <?php echo $OUTPUT->main_content(); ?>
        </div>
    <!-- START OF FOOTER -->

Vous pouvez placer n'importe quelle construction d'en-tête ou de pied de page, respectivement au-dessus et en-dessous du marqueur correspondant, provenant d'autres fichiers de layout de votre thème cible.

[[format:page|Revenir à l'index du composant Format Page]]