🌍
English
Differences
This shows you the differences between two versions of the page.
|
fr:configuration [2006/12/22 16:26] 83.157.249.51 |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | Les informations de cette page correspondent **à la branche 1.5** (et sont, sur le principe, applicables à la 1.6. Attention: les variables et valeurs peuvent être différentes). | ||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | ==== Configuration externe ==== | ||
| - | |||
| - | === Principe de la Mise à jour de la configuration externe === | ||
| - | Supposez qu'il existe ce paramètre: | ||
| - | <code php>// comment_give_happiness: make someone happy each time a user | ||
| - | // adds a comment | ||
| - | $conf['comment_give_happiness'] = false;</code> | ||
| - | |||
| - | Ouvrez (ou créez) le fichier ''config_local.inc.php'' et remplissez-le comme suit : | ||
| - | |||
| - | <code php><?php | ||
| - | // my personnal configuration | ||
| - | |||
| - | $conf['comment_give_happiness'] = true; | ||
| - | ?></code> | ||
| - | |||
| - | Voilà, vous venez de **surcharger** la configuration par défaut. | ||
| - | |||
| - | **Par défaut**: Le fichier include/config_**local**.inc.php n'existe pas, vous devez le créer au premier changement d'un paramètre. \\ | ||
| - | Ne laissez que les modifications dans ce fichier pour vous en faciliter la relecture ultérieurement et vous permettre de savoir ce que **vous** avez modifié... | ||
| - | |||
| - | |||
| - | |||
| - | |||
| - | **Rappel**: Toute modification d'un paramètre est à faire uniquement dans le fichier local: include/config_**local**.inc.php | ||
| - | |||
| - | C'est un fichier php -- <?php et ?> (aux bonnes places) -- à compléter ou à créer, pour lequel seules les variables $conf['xx'] ** à modifier ** seront présentes. | ||
| - | Cela sera plus simple pour vous à gérer ultérieurement. | ||
| - | |||
| - | Donc, quelque chose comme le fichier ''include/config_default.inc.php'', avec beaucoup moins de lignes dans sa version locale. | ||
| - | |||
| - | === La configuration externe par défaut === | ||
| - | |||
| - | Voici le fichier ''include/config_default.inc.php'' dont les commentaires sont traduits en français. | ||
| - | |||
| - | <code php><?php | ||
| - | // +-----------------------------------------------------------------------+ | ||
| - | // | divers | | ||
| - | // +-----------------------------------------------------------------------+ | ||
| - | |||
| - | // order_by : comment changer l'ordre d'affichage des images dans une | ||
| - | // catégorie ? | ||
| - | // | ||
| - | // Il y a plusieurs champs qui peuvent servir à ordonner l'affichage : | ||
| - | // | ||
| - | // - date_available : date d'ajout dans la galerie | ||
| - | // - file : le nom du fichier | ||
| - | // - id : l'identifiant unique de l'image | ||
| - | // - date_creation : la date de création | ||
| - | // | ||
| - | // Une fois que vous avez choisi quels champs utiliser, vous devez choisir | ||
| - | // l'ordre croissant ou décroissant sur chaque champ. Exemples : | ||
| - | // | ||
| - | // 1. $conf['order_by'] = " order by date_available desc, file asc"; | ||
| - | // va ordonner selon la date d'ajout par ordre croissant, puis sur le nom du | ||
| - | // fichier par ordre croissant | ||
| - | // | ||
| - | // 2. $conf['order_by'] = " order by file asc"; | ||
| - | // va ordonner selon le nom du fichier par ordre croissant | ||
| - | // | ||
| - | $conf['order_by'] = ' ORDER BY date_available DESC, file ASC, id ASC'; | ||
| - | |||
| - | // slideshow_period : temps d'attente en secondes entre 2 pages lors du | ||
| - | // diaporama automatique | ||
| - | $conf['slideshow_period'] = 4; | ||
| - | |||
| - | // file_ext : extensions des fichiers autorisés, sensible à la casse | ||
| - | $conf['file_ext'] = array('jpg','JPG','png','PNG','gif','GIF','mpg','zip', | ||
| - | 'avi','mp3','ogg'); | ||
| - | |||
| - | // picture_ext : extensions pour les fichiers de type image, doit être un | ||
| - | // sous ensemble de $conf['file_ext'] | ||
| - | $conf['picture_ext'] = array('jpg','JPG','png','PNG','gif','GIF'); | ||
| - | |||
| - | // top_number : nombre d'éléments à afficher pour les catégories spéciales | ||
| - | // "les plus visitées", "les mieux notées". | ||
| - | $conf['top_number'] = 15; | ||
| - | |||
| - | // anti-flood_time : nombre de secondes entre 2 commentaiers, 0 pour | ||
| - | // désactiver | ||
| - | $conf['anti-flood_time'] = 60; | ||
| - | |||
| - | // calendar_datefield : champs date de la table "images" utilisé pour le | ||
| - | // calendrier. | ||
| - | $conf['calendar_datefield'] = 'date_creation'; | ||
| - | |||
| - | // rate : activer la fonctionnalité de notation des images | ||
| - | $conf['rate'] = true; | ||
| - | |||
| - | // newcat_default_commentable : lors de sa création, une catégorie doit être | ||
| - | // commentable ou non ? | ||
| - | $conf['newcat_default_commentable'] = 'true'; | ||
| - | |||
| - | // newcat_default_uploadable : lors de sa création, une catégorie physique | ||
| - | // doit être uploadable ou non ? | ||
| - | $conf['newcat_default_uploadable'] = 'false'; | ||
| - | |||
| - | // newcat_default_visible : lors de sa création, une catégorie doit être | ||
| - | // visible ou non ? Attention, si la catégorie parente est invisible, la | ||
| - | // catégorie fille est automatiquement invisible (invisible = verrouillée) | ||
| - | $conf['newcat_default_visible'] = 'true'; | ||
| - | |||
| - | // newcat_default_status : lors de sa création, une catégorie doit être | ||
| - | // publique ou privée ? Attention, si la pcatégorie parente est privée, | ||
| - | // alors la catégorie fille est automatiquement privée. | ||
| - | $conf['newcat_default_status'] = 'public'; | ||
| - | |||
| - | // level_separator : chaîne de caractères séparant 2 niveaux | ||
| - | // decatégorie. Suggestions : ' / ', ' » ', ' → ', ' - ', ' >' | ||
| - | $conf['level_separator'] = ' / '; | ||
| - | |||
| - | // paginate_pages_around : sur les barre de pagination, combien de pages | ||
| - | // afficher avant et après la page courante ? | ||
| - | $conf['paginate_pages_around'] = 2; | ||
| - | |||
| - | // tn_width : largeur par défaut pour la création des miniatures | ||
| - | $conf['tn_width'] = 128; | ||
| - | |||
| - | // tn_height : hauteur par défaut pour la création des miniatures | ||
| - | $conf['tn_height'] = 96; | ||
| - | |||
| - | // show_version : afficher le numéro de version de PHpWebGallery en bas de | ||
| - | // chaque page ? | ||
| - | $conf['show_version'] = false; | ||
| - | |||
| - | // links : liste de liens externesà ajouter dans le menu. Un exemple valant | ||
| - | // mieux qu'une longue explication : | ||
| - | // | ||
| - | // $conf['links'] = array( | ||
| - | // 'http://phpwebgallery.net' => 'PWG website', | ||
| - | // 'http://forum.phpwebgallery.net' => 'PWG forum', | ||
| - | // 'http://phpwebgallery.net/doc' => 'PWG wiki' | ||
| - | // ); | ||
| - | // | ||
| - | // Si la liste est vide, le sous menu "liens" n'apparaît pas. | ||
| - | $conf['links'] = array(); | ||
| - | |||
| - | // show_thumbnail_caption : sur la page des miniatures, afficher une légende | ||
| - | // sous chaque miniature ? | ||
| - | $conf['show_thumbnail_caption'] = true; | ||
| - | |||
| - | // show_picture_name_on_title : sur la page de visualisation d'une image, | ||
| - | // afficher le nom de l'image en titre ? | ||
| - | $conf['show_picture_name_on_title'] = true; | ||
| - | |||
| - | // allow_random_representative : pour représenter une catégorie, | ||
| - | // souhaitez-vous que PhpWebGallery recherche parmi les éléments un nouveau | ||
| - | // représentant à chaque rafraichissement ? | ||
| - | // | ||
| - | // Si ce paramètre est à faux, un élément est choisi au hasard ou | ||
| - | // manuellement pour chaque catégorie et reste le représentant tant que | ||
| - | // l'administrateur ne change pas de représentant. | ||
| - | // | ||
| - | // Attention : mettre ce paramètre à vrai est consommateur de ressources. Si | ||
| - | // vous décidez de changer la valeur de ce paramètre, un administrateur doit | ||
| - | // mettre à jour les informations des catégories dans l'écran | ||
| - | // [Administration > Général > Maintenance] | ||
| - | $conf['allow_random_representative'] = false; | ||
| - | |||
| - | // allow_html_descriptions : autoriser les administrateurs à utiliser du | ||
| - | // HTML dans les descriptions de la galerie, des catégories et des images. | ||
| - | $conf['allow_html_descriptions'] = true; | ||
| - | |||
| - | // galery_url : URL fourni dans le flux RSS | ||
| - | $conf['gallery_url'] = 'http://demo.phpwebgallery.net'; | ||
| - | |||
| - | // prefix_thumbnail : chaîne de caractère préfixant le nom de fichier dans | ||
| - | // le répertoire "thumbnail" de chaque répertoire d'images. Ce préfixe ne | ||
| - | // peut contenir que des caractères parmi : a à z (sensible à la casse, "-" | ||
| - | // ou "_". | ||
| - | $conf['prefix_thumbnail'] = 'TN-'; | ||
| - | |||
| - | // users_page: combien d'utilisateurs montrer par page sur l'écran | ||
| - | // [Administration > Identification > Utilisateurs] | ||
| - | $conf['users_page'] = 20; | ||
| - | |||
| - | // mail_options : ne mettre à vrai que si un message d'erreur apparaît lors | ||
| - | // de l'envoi d'un email. | ||
| - | $conf['mail_options'] = false; | ||
| - | |||
| - | // +-----------------------------------------------------------------------+ | ||
| - | // | metadata | | ||
| - | // +-----------------------------------------------------------------------+ | ||
| - | |||
| - | // show_iptc: montrer les métadonnées IPTC sur picture.php si l'utilisateur | ||
| - | // le demande. | ||
| - | $conf['show_iptc'] = false; | ||
| - | |||
| - | // show_iptc_mapping : correspondance entre un élément de langue et un | ||
| - | // identifiant IPTC. Cette correspondance est utilisé pour montrer les IPTC | ||
| - | // sur picture.php. Pour chaque clé du tableau, vous avez besoin d'avoir la | ||
| - | // même clé dans le tableau de langue $lang. | ||
| - | // | ||
| - | // Par exemple, si ma première clé est "iptc_keywords" (associée à | ||
| - | // l'identifiant IPTC 2#025) alors vous avez besoin de | ||
| - | // $lang['iptc_keywords'] dans le fichier common.lang.php correspondant à la | ||
| - | // langue de l'utilisateur. Si la clé n'est pas présente dans le tableau de | ||
| - | // langue, alors la clé sera affichée non traduite. | ||
| - | // | ||
| - | // Pour savoir quels identifiants IPTC sont disponibles, utiliser l'outil | ||
| - | // tools/metadata.php | ||
| - | $conf['show_iptc_mapping'] = array( | ||
| - | 'iptc_keywords' => '2#025', | ||
| - | 'iptc_caption_writer' => '2#122', | ||
| - | 'iptc_byline_title' => '2#085', | ||
| - | 'iptc_caption' => '2#120' | ||
| - | ); | ||
| - | |||
| - | // use_iptc : utiliser les métadonnées IPTC durant la synchronisation. | ||
| - | $conf['use_iptc'] = false; | ||
| - | |||
| - | // use_iptc_mapping : dans quelles métadonnées IPTC PhpWebGallery va-t-il | ||
| - | // trouver les informations de l'image ? Ce paramétrage est utilisé durant | ||
| - | // la synchronisation. Chaque clé du tableau représente une colonne de la | ||
| - | // table images, chaque valeur correspond à un identifiant IPTC. | ||
| - | $conf['use_iptc_mapping'] = array( | ||
| - | 'keywords' => '2#025', | ||
| - | 'date_creation' => '2#055', | ||
| - | 'author' => '2#122', | ||
| - | 'name' => '2#005', | ||
| - | 'comment' => '2#120' | ||
| - | ); | ||
| - | |||
| - | // show_exif: montrer les métadonnées EXIF sur picture.php | ||
| - | $conf['show_exif'] = true; | ||
| - | |||
| - | // show_exif_fields : liste des métadonnées EXIF à afficher. Il est possible | ||
| - | // de choisir des champs parmi des groupes. Par exemple | ||
| - | // ['COMPUTED']['ApertureFNumber'], pour cela, créer une clé | ||
| - | // 'COMPUTED;ApertureFNumber'. | ||
| - | // | ||
| - | // Le titre de l'information affichée sur picture.php sera une clé de | ||
| - | // langue, comme $lang['exif_field_Make'] si elle existe. Pour les champs | ||
| - | // composés, ne prendre en compte que le dernier niveau : pour la clé | ||
| - | // 'COMPUTED;ApertureFNumber' vous avez besoin de | ||
| - | // $lang['exif_field_ApertureFNumber'] | ||
| - | $conf['show_exif_fields'] = array( | ||
| - | 'Make', | ||
| - | 'Model', | ||
| - | 'DateTimeOriginal', | ||
| - | 'COMPUTED;ApertureFNumber' | ||
| - | ); | ||
| - | |||
| - | // use_exif : utiliser les métadonnées EXIF lors de la synchronisation. | ||
| - | $conf['use_exif'] = false; | ||
| - | |||
| - | // use_exif_mapping : même comportement que $conf['use_iptc_mapping'] | ||
| - | $conf['use_exif_mapping'] = array( | ||
| - | 'date_creation' => 'DateTimeOriginal' | ||
| - | ); | ||
| - | |||
| - | // +-----------------------------------------------------------------------+ | ||
| - | // | sessions | | ||
| - | // +-----------------------------------------------------------------------+ | ||
| - | |||
| - | // authorize_remembering : permet aux utilisateurs de rester connecter | ||
| - | // longtemps. Cela créé un cookie longue durée sur le poste client. | ||
| - | $conf['authorize_remembering'] = true; | ||
| - | |||
| - | // remember_me_length : durée de validité pour le cookie longue durée, en | ||
| - | // secondes. | ||
| - | $conf['remember_me_length'] = 31536000; | ||
| - | |||
| - | // session_length : durée de validité d'une session normale, en secondes. | ||
| - | $conf['session_length'] = 3600; | ||
| - | |||
| - | // session_id_size : longueur de l'identifiant de session. Un identifiant de | ||
| - | // session est composé de caractères alphanumériques sensibles à la | ||
| - | // casse. Chaque caractère a 62 possibilités. Le nombre de sessions | ||
| - | // simultanées possibles est 62^$conf['session_id_size']. | ||
| - | // | ||
| - | // 62^5 = 916,132,832 | ||
| - | // 62^10 = 839,299,365,868,340,224 | ||
| - | $conf['session_id_size'] = 10; | ||
| - | |||
| - | // +-----------------------------------------------------------------------+ | ||
| - | // | debug | | ||
| - | // +-----------------------------------------------------------------------+ | ||
| - | |||
| - | // show_queries : montrer les requêtes SQL et le temps d'exécution de | ||
| - | // chacune | ||
| - | $conf['show_queries'] = false; | ||
| - | |||
| - | // show_gt : monter le temps de génération de chaque page, PHP + SQL. | ||
| - | $conf['show_gt'] = true; | ||
| - | |||
| - | // debug_l10n : affiche un avertissement à chaque fois qu'on tente d'accéder | ||
| - | // à une clé inexistante. | ||
| - | $conf['debug_l10n'] = false; | ||
| - | |||
| - | // +-----------------------------------------------------------------------+ | ||
| - | // | authentification | | ||
| - | // +-----------------------------------------------------------------------+ | ||
| - | |||
| - | // apache_authentication : utiliser l'authentification HTTP d'Apache comme | ||
| - | // référence au lieu de la table des utilisateurs ? | ||
| - | $conf['apache_authentication'] = false; | ||
| - | |||
| - | // users_table : quelle table est la table de référence pour les | ||
| - | // utilisateurs ? Peut être une table externe à PhpWebGallery. | ||
| - | // | ||
| - | // Si vous décidez d'utiliser une table externe, vous devez préparer votre | ||
| - | // base de données en supprimant certains données : | ||
| - | // | ||
| - | // delete from phpwebgallery_user_access; | ||
| - | // delete from phpwebgallery_user_cache; | ||
| - | // delete from phpwebgallery_user_feed; | ||
| - | // delete from phpwebgallery_user_group; | ||
| - | // delete from phpwebgallery_user_infos; | ||
| - | // delete from phpwebgallery_sessions; | ||
| - | // delete from phpwebgallery_rate; | ||
| - | // update phpwebgallery_images set average_rate = NULL; | ||
| - | // delete from phpwebgallery_caddie; | ||
| - | // delete from phpwebgallery_favorites; | ||
| - | // | ||
| - | // Toutes les informations contenues dans ces tables sont relatives au | ||
| - | // contenu de la table des utilisateurs. | ||
| - | $conf['users_table'] = $prefixeTable.'users'; | ||
| - | |||
| - | // user_fields : correspondance entre un nom générique de champ et le nom | ||
| - | // spécifique dans la table. Par exemple, dans PhpWebGallery, l'adresse | ||
| - | // email est "mail_address" et dans PunBB, son nom est "email". | ||
| - | $conf['user_fields'] = array( | ||
| - | 'id' => 'id', | ||
| - | 'username' => 'username', | ||
| - | 'password' => 'password', | ||
| - | 'email' => 'mail_address' | ||
| - | ); | ||
| - | |||
| - | // pass_convert : fonction pour chiffrer ou hasher le mot de passe afin de | ||
| - | // le stocker en base de donnée. | ||
| - | $conf['pass_convert'] = create_function('$s', 'return md5($s);'); | ||
| - | |||
| - | // guest_id : identifiant de l'invité | ||
| - | $conf['guest_id'] = 2; | ||
| - | |||
| - | // webmaster_id : identifiant du webmaster | ||
| - | $conf['webmaster_id'] = 1; | ||
| - | |||
| - | // +-----------------------------------------------------------------------+ | ||
| - | // | téléchargement | | ||
| - | // +-----------------------------------------------------------------------+ | ||
| - | |||
| - | // On parle ici du téléchargement par HTTP accessible optionnellement aux | ||
| - | // utilisateurs. | ||
| - | |||
| - | // upload_maxfilesize: poids maximum des images à télécharger, en kilo | ||
| - | // octets. | ||
| - | $conf['upload_maxfilesize'] = 200; | ||
| - | |||
| - | // upload_maxheight : hauteur maximum des images à télécharger, en pixels. | ||
| - | $conf['upload_maxheight'] = 800; | ||
| - | |||
| - | // upload_maxwidth : largeur maximum des images à télécharger, en pixels. | ||
| - | $conf['upload_maxwidth'] = 800; | ||
| - | |||
| - | // upload_maxheight_thumbnail : hauteur maximum des miniatures. | ||
| - | $conf['upload_maxheight_thumbnail'] = 100; | ||
| - | |||
| - | // upload_maxwidth_thumbnail : largeur maximum des miniatures. | ||
| - | $conf['upload_maxwidth_thumbnail'] = 150; | ||
| - | |||
| - | // +-----------------------------------------------------------------------+ | ||
| - | // | historique | | ||
| - | // +-----------------------------------------------------------------------+ | ||
| - | |||
| - | // nb_logs_page : nombre de ligne d'historique à afficher par page | ||
| - | $conf['nb_logs_page'] = 300; | ||
| - | |||
| - | // history_admin : historiser les visites des administrateurs ? | ||
| - | $conf['history_admin'] = false; | ||
| - | |||
| - | ?></code> | ||
| - | FIXME La version présentée ici est encore incomplète... | ||
| - | Comme vous pouvez le voir, de nombreux paramètres de configuration sont présents dans ce fichier. Il est donc inutile et relativement incompréhensible de les reporter tous en _local.\\ | ||
| - | En fait, il est complet pour la 1.5. Il manque les paramétrages 1.6 | ||