Configurer l'application

Configuration initiale

Installateur graphique

L'installateur graphique est accessible à l'adresse <URL racine de votre site>/install/

Configuration manuelle

Si vous choisissez de configurer manuellement votre application monosite, vous devrez éditer a minima les fichiers de configuration suivants :
 

1. /application/config/config.php : contient les paramètres généraux du framework et de l'application, dont la configuration de l'URL racine du site et des cookies
2. /application/config/database.php : contient les paramètres de la base de données utilisée par l'application
3. /application/config/site.php : contient les paramètres locaux/avancés du site construit avec l'application, dont les paramètres de communication (envoi de messages email, SMS, passerelle email-sms...
4. /application/config/ckeditor.php : contient les paramètres d'url et de chemin nécessaire au fonctionnement de l'éditeur de texte enrichi CKeditor (c'est l'éditeur proposé par défaut dans les formulaires d'édition de l'application)
5. /application/config/additional_databases.php : contient la configuration d'une table personnalisée qui sera utilisée pour stocker des paramètres additional sur les comptes d'utilisateurs. En principe, vous n'avez pas besoin de modifier ce fichier.

Veuillez noter que la configuration d'une application multisites est plus complexe et fait l'objet d'un document séparé.
 

Tests de fonctionnement

Débogage et enregistrement des erreurs

Certains paramètres sont particulièrement utiles pour enregistrer et étudier les erreurs rencontrées par l'application :
 

1. La constante DEBUG_ENVIRONMENT définie par défaut à la fin du fichier websites.php : lorsqu'elle est définie à development, l'analyseur de performances est activé sur les pages de visualisation des collections et contenus et tous les messages d'erreur (y compris de niveau notice) sont visibles et enregistrés dans les journaux PHP de l'application (créés dans /application/logs/).
2. La variable $this->debug au début du fichier de la bibliothèque d'authentification (application/libraries/Auth.php) :
   $this->debug=FALSE; //Set to TRUE to display uobject and oobject.
   Lorsqu'elle est égale à TRUE, les tests effectués pour contrôler les droits d'accès sont affichés.
3. Le paramètre $debug de la méthode translate() de la bibliothèque des formats (/application/libraries/Formats.php) : lorsqu'il est égal à TRUE, les chaînes de caractères non traduites dans la langue de l'utilisateur génèrent un message d'erreur.

1. Dans les fichiers logs/log-YYYY-mm-dd.php pour les erreurs de fonctionnement de l'application ou de la base de données
2. Dans le journal des événements système (visible au superutilisateur à l'adresse <URL racine du site>/manage) lorsqu'il s'agit d'erreurs générées par les fonctions utilisateurs (tels que l'échec de création d'un contenu dans l'interface)
3. Dans la table _rest_logs de la base de données de l'application pour les erreurs de communication avec l'API Restful

Paramètres locaux de l'application

Édition des menus d'en-tête et de pied-de-page

Dans le cas d'une installation nouvelle, le menu principal de l'application (menu de l'en-tête ou menu haut) est préconfiguré avec deux sous-menus personnalisés (et éditables), respectivement intulés Explorer et Découvrir :
–le premier permet d'explorer les contenus sous différents axes : par sujets, par collections, en recherchant...
–le deuxième donne accès à un certain nombre de collections fournies à titre d'exemples et mettant en œuvre différents modes d'affichage (cartographie pour les lieux, vignettes pour les produits et la galerie de médias, blocs dépliants pour la Foire aux questions, etc.)

De même, le menu du pied-de-page contient dans sa deuxième colonne quelques entrées fournies à titre d'exemple.

Il est vraisemblable que vous souhaiterez modifier ces menus pour les adapter à votre site. Pour cela, vous pouvez utiliser l'interface de gestion des Menus (Gérer » Menus).

Vous devrez d'abord choisir la langue pour laquelle vous souhaitez éditer les entrées de menu (les menus sont indépendants pour chaque langue disponible dans l'application).
En cliquant sur le bouton Ajouter ou Editer d'une entrée, vous accéderez au formulaire d'édition suivant :

Le choix du type de menu (Footer ou Header) détermine à quel menu appartient l'entrée et quels éléments parents vous pouvez sélectionner.
La position d'un élément dans le menu est déterminée par un entier (les éléments sont triés par ordre croissant s'ils se trouvent au même niveau hiérarchique).
Lorsque vous souhaitez créer un sous-menu, sélectionnez Dépliant ? Actif sur l'élément de premier niveau. Puis, choisissez-le comme Parent des éléments qu'il devra contenir.
Le champ URI doit contenir l'adresse à laquelle renverra l'entrée du menu : vous pouvez renseigner une adresse complète (commençant par http://...) ou, par exemple :
— browse/all-topics pour renvoyer à la collection dont le permalien est all-topics,
— view/my-content pour renvoyer au contenu dont le permalien est my-content.
— # lorsque l'entrée ne possède aucun lien
Vous pouvez éventuellement limiter la visibilité de certaines entrées à des rôles d'utilisateurs particuliers (par défaut, les entrées sont visibles par tous les utilisateurs, y compris les utilisateurs non connectés, sauf dans le cas où le site a été configuré comme un site privé).
Enfin, vous devez rendre l'élément Actif pour qu'il soit affiché.

Notez également que si le menu sombre utilisé ne vous plaît pas, vous pouvez inverser les teintes de fond / du texte en cliquant sur le sous-onglet Style des menus : choisissez une couleur de fond claire ou sombre : celle-ci prendra automatiquement la teinte définie pour le thème de l'interface.

Les menus sont reconstruits (c'est-à-dire qu'il sont enregistrés dans un fichier cache) à chaque accès à l'interface de gestion, pour chaque langue et pour chaque environnement de l'application (dans le cas d'une installation multisites) : il est cependant possible que le cache de votre navigateur ne vous permette pas de visualiser les changements effectués immédiatement. Dans ce cas, rafraîchissez la page d'édition des entrées de menus.

Si jamais vous « cassez » un menu (par exemple, en créant une hiérarchie d'entrées problématique), l'affichage peut être perturbé : dans un tel cas, il faut modifier ou supprimer les entrées qui posent problème. Commencer par supprimer les informations de hiérarchie (en sélectionnant Dépliant ? Inactif et en supprimant les parents) est généralement la meilleure manière de procéder.

Certains éléments des menus ne sont pas éditables dans l'interface (par exemple, le sous-menu Gérer). Il est néanmoins possible de les modifier en éditant les vues suivantes (procédez avec précaution et réalisez toujours une copie de sauvegarde des fichiers avant de les modifier !) :
— /application/views/Main_menu.php
— /application/views/Footer.php

Problèmes fréquemment rencontrés

Affichage d'une page blanche

Lorsqu'une page blanche/vide s'affiche au lieu de la page d'accueil une fois la configuration initiale effectuée, cela est dû le plus souvent à une mauvaise configuration de la redirection dans .htaccess (à la racine de l'installation). Vérifiez que la ligne

RewriteBase /

contient la valeur appropriée. Par exemple, si votre installation se trouve dans un dossier webapp de la racine de l'hôte http, celle-ci devra contenir :

RewriteBase /webapp/

Alternativement, le problème peut être dû à un cache corrompu : si les autres pages s'affichent correctement, purgez le contenu du dossier /application/cache/ et ajoutez ?refresh=true à la fin de l'URL de la page d'accueil pour régénérer les fichiers css/js.

Impossible de s'authentifier

Vérifiez la configurations des cookies et de la session dans /application/config/config.php

Impossible d'attacher des fichiers aux contenus et collections

Si vous ne parvenez pas à envoyer des fichiers sur un serveur Microsoft une fois la configuration effectuée (ou si les fichiers attachés n'apparaissent pas dans l'interface, par exemple lorsque la galerie de médias est vide), vérifiez que la constante LIBFILESROOT (contenant le chemin du dossier racine du dépôt) est bien renseignée avec des anti-slashes à la place des slashes (ceci est requis avec Ms Windows).

Mauvais fonctionnement de l'explorateur de fichiers ckeditor (par exemple, pour changer l'icône d'un contenu)

Vérifiez que les valeurs du fichier /application/config/ckeditor.php sont correctes.

Entrées des menus incorrectes

Pour régénérer le cache des menus, identifiez-vous comme administrateur et chargez l'interface de gestion des menus de l'application (manage/menus).