Configuration
La configuration de l’environnement du Widget Framework IMu s’effectue en ajoutant des paramètres de configuration dans le répertoire ~/imu/config.
Ce répertoire contiendra un ou plusieurs fichiers PHP et/ou Javascript.
Configuration rapide
Vous n’avez généralement besoin de définir que les paramètres de connexion à imuserver dans le fichier ~imu/config/local.php.
Un exemple pourrait être :
<?php $config['server-host'] = 'manly.syd.kesoftware.com'; $config['server-port'] = 40193; ?>
Bien entendu, vous devrez définir les valeurs de serveur et de port appropriées pour votre environnement d’installation local.
Bien souvent, cela suffit.
Plus d’informations sur la configuration
Les fichiers du répertoire ~imu/config peuvent être nommés comme suit :
commonclientlocal
et avec un suffixe .php et/ou .js.
Fichiers de configuration courants
Les fichiers qui contiennent des valeurs de configuration IMu communes à plusieurs clients portent le nom common. Il s’agit généralement des valeurs par défaut standard à utiliser (sauf indication contraire). Axiell fournit ces fichiers et ils ne doivent pas être modifiés par les clients.
Avertissement
Si les clients modifient des valeurs ici, ces modifications seront écrasées lors d’une mise à niveau du système et seront donc perdues.
Fichiers de configuration du client
Les fichiers qui contiennent des valeurs de configuration propres à un client portent le nom client. Toute valeur définie ici remplace les valeurs équivalentes spécifiées dans les fichiers common. Par exemple, ces fichiers peuvent définir les champs du Catalogue propres à un client à utiliser lors de l’affichage des données. Axiell fournit ces fichiers et ils ne doivent pas être modifiés directement par les clients.
Avertissement
Si les clients modifient des valeurs ici, ces modifications seront écrasées lors d’une mise à niveau du système et seront donc perdues.
Fichiers de configuration locaux
Les fichiers propres à cette installation particulière portent le nom local. Ils remplacent toutes les valeurs équivalentes définies dans les fichiers commun ou client. Parmi les paramètres pouvant être définis ici figurent les valeurs réelles d’hôte et de port nécessaires pour accéder au serveur de base de données depuis le serveur web.
Note: Axiell ne gère aucun fichier local. C’est là que les clients doivent apporter des modifications locales. Les modifications effectuées ici par un client ne seront pas affectées lors d’une mise à niveau d’IMu.
Pour installer un système, il suffit normalement d’ajouter un fichier local.php à ce répertoire. Les fichiers commun et client devraient déjà être correctement configurés après l’installation.
La connexion à la base de données est généralement le principal élément à configurer.
Vous devez spécifier le nom d’hôte du serveur qui exécute le serveur IMu (généralement, mais pas nécessairement, il s’agira du serveur EMu). Vous devez également spécifier le numéro de port du serveur IMu.
Pour ce faire, ajoutez un fichier local.php dans le répertoire imu/config.
Un exemple serait :
<?php $config['server-host'] = 'manly.syd.kesoftware.com'; $config['server-port'] = 40193; ?>
Vous trouverez ci-dessous des exemples de paramètres locaux que vous êtes susceptible de rencontrer. Normalement, ces paramètres sont définis dans le fichier client ; toutefois, dans certaines circonstances, un site peut choisir de remplacer les paramètres client ou d’en ajouter de nouveaux.
Pour ajouter (ou restreindre) les modules interrogés par défaut dans les objets de recherche :
// ajouter un module à la liste $config['include-modules'][] = 'etrapevents' ; // restreindre la recherche des modules à la liste donnée $config['include-modules'] = [ 'ecatalogue', 'eparties' ] ;
Pour définir l’ensemble standard des champs recherchés par un objet de recherche :
$config['search-aliases']['keywords']['ecatalogue'] = array ( 'SumDescription', 'SumTitle', );
Pour définir les champs renvoyés par une recherche :
$config['fetch-sets']['lightbox']['etaxonomy'] = array ( 'irn', 'title=ClaScientificName', 'SummaryData', 'image' );

