Différences

Ci-dessous, les différences entre deux révisions de la page.

--- format:page:installguide [2016/10/28 16:04] – [Processus d'installation] florence
+++ format:page:installguide [2026/02/09 20:00] (Version actuelle) – [Installation process] admin
@@ Ligne 1: / Ligne 1: @@
-===== Format Page : Installation =====
+====== Page format : Installation Guide =====
-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.
+The page format is a very powerful format, but its installation may be non-trivial. It is not recommended for people not having a minimal architectural knowledge of Moodle, and with low coding skill in LAMP open-source platforms.
-Le processus d'installation suppose :
+The installation process focusses:
-   * Installer les composants nécessaires au fonctionnement du format
+   * Install the necessary components for the operation of the format (standard)
-   * Installer les customisations (customscripts) nécessaires
+   * Install the necessary customizations (customscripts)
-   * Modifier les thèmes utilisés pour inclure les mises en page (layouts) additionnels du format page
+   * Install some patchs for enhanced features (optional)
+   * Edit the themes used to include additional layouts (layouts) in the page format
-==== Composants nécessaires ====
+====Necessary components ====
-En plus du composant "format/page", vous devrez installer :
+In addition to the "format/page" component, you will need to install:
-   * [[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.
+   * The [[blocks:pagemodule|Page Module]] block: This block is responsible for proxying Moodle's activity modules as blocks to unify the page construction process.
+   * The [[blocks:pagetracker|Course Summary]] block: This block offers a simple menu consisting of the pages available from a given root. Its implementation is kept simple.
-L'un (ou les deux) des principes de navigation internes suivants :
+==== Installation process ====
-   * [[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.
+== Download and install components ===
-   * [[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 ====
+   - Unpack the page format archive in the ''/course/format'' directory of your Moodle installation
+   - Unpack the [[blocks:pagemodule|Page Module]] block archive in the ''/blocks'' directory of your Moodle installation.
+   - Unpack the [[blocks:pagetracker|course Summary]] block in the ''/blocks'' directories of your Moodle installation.
+   - Navigate to administration notifications to proceed with the "logical" installation of the added components.
-=== Télécharger et installer les composants ===
+=== Activation of "customizations" ===
-   - Décompactez l'archive du format page dans le répertoire /course/format de votre installation Moodle
+The page format archive comes with a number of add-ins located in the __customscripts and __theme directories of the distribution.
-   - 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" ===
+   - Create (if you have not already) the Moodle customization directory. The use is, in general, that it is called ''customscripts'' and is located at the root of the Moodle installation (but may be eslewhere).
+   - Copy the contents of the <nowiki>__customscripts</nowiki> directory to this directory. WARNING: if your installation already has customizations on identical path files for reasons other than the page format, it will be necessary to ask an integrator to merge the changes.
+   - In the configuration file of Moodle (config.php at the root) add the following line:
-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.
+   $CFG->customscripts = '/path/to/my/moodle/customscripts';
-   - 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 ===
+=== Added additional theme elements ===
-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.
+The __theme add-in contains a pseudo-theme "page". This theme is potentially usable as such, but its use is not recommended because it will not track the customizations of the themes exploited on the platform.
-Ce complément est là pour vous fournir les éléments à ajouter dans les thèmes que vous utilisez par ailleurs dans Moodle.
+This add-in is here to provide you with the items to add in the themes you otherwise use in Moodle.
-Ce package contient essentiellement un layout 'page.php' qu'il faut ajouter aux themes que vous utilisez dans la plate-forme d'exploitation.
+This package essentially contains a 'page.php' layout that must be added to the themes you use in the operating platform.
-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) :
+To activate this layout, edit the **config.php** file of the target theme and add the following lines in the layout definition (Php table):
-    'format_page' => array(
+    'format_page' => [
         'file' => 'page.php',
         'regions' => array('side-pre', 'main', 'side-post', 'footer-left', 'footer-middle', 'footer-right'),
         'defaultregion' => 'side-post',
-    ),
+    ],
-    'format_page_action' => array(
+    'format_page_action' => [
         '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 :
+You will probably have to review the header and footer sequences in the layout **page.php** file. Indeed, each theme producer has his own writing of these sequences. The "active" part of the layout is:
     <!-- END OF HEADER -->
@@ Ligne 70: / Ligne 67: @@
         <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(); ?>
+            <? 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.
+You can place any header or footer construction, respectively above and below the corresponding marker, from other layout files in your target theme.
-[[format:page|Revenir à l'index du composant Format Page]]
+[[format:page|Back to Format Page index]]