Différences

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

--- apps:albulle1.0:parametrage [2008/11/17 13:35] – Ajouts marqueurs nouveautés samray1024
+++ apps:albulle1.0:parametrage [2024/10/03 07:31] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
+====== Paramétrer Albulle ======
+<note>
+  * **Objectif :** Paramétrer votre installation d'Albulle
+  * **Niveau de difficulté :** Facile
+</note>
+Vous avez la possibilité de **configurer** Albulle grâce à un ensemble de **constantes** dont vous pouvez définir les valeurs. Ces constantes se trouvent dans le fichier **/albulle/config.php**.
+<note warning>**Avant d'éditer config.php**, je vous invite à lire l'[[accueil|avertissement]] présent à l'accueil de la documentation si ce n'est pas déjà fait !</note>
+//:!: : les paramètres marqués avec cette pastille correspondent aux **paramètres ajoutés depuis la version précédente**.//
+===== Constantes générales =====
+Utilisez ces paramètres pour influer sur le comportement général d'Albulle.
+^  Constante  ^  Type  ^  Valeurs autorisées  ^  Description  ^
+|JB_AL_FERMER |booléen |true, false |En définissant cette constante à **true** vos galeries seront fermées. |
+|JB_AL_MSG_FERMETURE |chaîne de caractères |tout |Si vous fermez Albulle, utilisez ce paramètre pour personnaliser le message affiché à la place des galeries. |
+===== Dossiers et fichiers =====
+Ici sont configurés toutes les adresses pour l'accès aux différentes ressources nécessaires au fonctionnement d'Albulle.
+<note importante>
+  * Les paramètres qui représentent un **dossier** doivent comporter un **'/'** (slash, barre oblique) à la fin ! Autrement vous aurez des erreurs lors de l'exécution.
+  * Les adresses doivent être **relatives** au dossier principal d'Albulle (Exemple : //data/photos///).
+</note>
+^  Constante  ^  Type  ^  Valeurs autorisées  ^  Description  ^
+^Gestion du thème d'affichage ^^^^
+|JB_AL_DOSSIER_THEMES |chaîne de caractères |adresse d'un dossier |Adresse du dossier qui contient les thèmes. |
+|JB_AL_DOSSIER_THEME_ACTIF |chaîne de caractères |adresse d'un dossier |Adresse relative au dossier des thèmes du thème à utiliser. |
+^Dossiers des données ^^^^
+|JB_AL_DOSSIER_DATA |chaîne de caractères |adresse d'un dossier |Adresse du dossier général des données. |
+|JB_AL_DOSSIER_PHOTOS |chaîne de caractères |adresse d'un dossier |Adresse du dossier où se trouvent les photos à publier (doit être relatif au dossier des données). |
+|JB_AL_DOSSIER_MINIATURES |chaîne de caractères |adresse d'un dossier |Adresse du dossier où seront générées les miniatures des photos publiées (doit être relatif au dossier des données). Ce dossier doit impérativement être autorisé en écriture (cf. [[installation_autonome#etape_2_changer_les_droits|changer les droits]]). |
+|JB_AL_DOSSIER_ORIGINALES |chaîne de caractères |adresse d'un dossier |Adresse du dossier où peuvent être stockées les images dans une meilleure qualités pour le téléchargement (doit être relatif au dossier des données). |
+^Autres ^^^^
+|JB_AL_FICHIER_ACCUEIL |chaîne de caractères |adresse d'un fichier |Chemin d'accès au fichier qui contient le texte d'accueil. |
+|JB_AL_URL_BASE :!: |chaîne de caractères |URL |Contient l'URL de base de votre installation d'Albulle. Utilisée pour le flux RSS, cette constante est définie automatiquement. |
+^Tri des dossiers et fichiers ^^^^
+|JB_AL_FILTRE_PREFIXES_ACTIF|booléen |true, false |Mettre à **vrai** pour activer le filtrage des noms de dossiers et fichiers pour utiliser un tri personnalisé. |
+|JB_AL_PREFIXES_SEPARATEUR|chaîne de caractères |tout |**Séparateur** qui permet d'identifier la fin du préfixe. Lorsque le paramètre précédent est **vrai**, tout ce qui se trouve avant ce séparateur est caché lors de l'affichage. |
+==== Comment utiliser les préfixes pour trier vos dossiers / fichiers ? ====
+Vous pouvez avoir besoin d'**ordonner** vos dossiers et photos dans **un autre ordre** que celui **alphabétique**. Si tel est le cas, activez le filtrage des préfixes pour pouvoir utiliser des préfixes sur vos noms. Ainsi vous pourrez redéfinir un classement qui vous est propre tout en gardant un affichage "propre".
+Pour utiliser votre classement vous devrez nommer vos dossiers et fichiers de la façon suivante :
+;;Mon_image.jpg
+;;Mon_autre_image.jpg
+  ...
+  (De la même façon pour des dossiers)
+De manière générale le nommage doit être de la forme :
+  [indice][séparateur][nom de l'image/nom du dossier].[extension si vous nommez un fichier]
+Lors de l'affichage des dossiers et des fichiers (si vous avez demandé l'affichage des noms des photos), tout ce qui se trouve devant le séparateur ('_' par défaut) ne sera pas affiché à l'écran (séparateur compris).
+===== Titre et sous-titre =====
+Paramétrage de l'entête des pages.
+^  Constante  ^  Type  ^  Valeurs autorisées  ^  Description  ^
+|JB_AL_AFFICHER_ENTETE |booléen |true, false |Activer/désactiver l'affichage de l'entête de page. Si ce paramètre vaut **false**, les deux paramètres suivants sont ignorés. |
+|JB_AL_TITRE_GALERIE |chaîne de caractères |tout |Titre de vos galeries. |
+|JB_AL_SOUS_TITRE_GALERIE |chaîne de caractères |tout |Sous-titre de vos galeries. |
+===== Données à afficher =====
+Les paramètres qui suivent permettent de modifier les éléments affichés dans la page.
+^  Constante  ^  Type  ^  Valeurs autorisées  ^  Description  ^
+^Zone copyright ^^^^
+|JB_AL_AFFICHER_VERSION |booléen |true, false |Afficher le numéro de version dans le copyright. |
+^Zone arborescence ^^^^
+|JB_AL_AFFICHER_NB_PHOTOS |booléen |true, false |Afficher le nombre de photos présentes dans chaque dossier à côté du nom du dossier. |
+|JB_AL_AFFICHER_NB_SI_VIDE |booléen |true, false |Afficher le nombre de photos même s'il vaut 0. |
+|JB_AL_DEROULER_TOUT |booléen |true, false |Permet de basculer le mode de déroulement des dossiers. True déroule tous les dossiers, False ne déroule que le dossier courant. |
+^Zone vignettes ^^^^
+|JB_AL_AFFICHER_NOMS |booléen |true, false |Afficher le nom des photos sous la miniature. |
+|JB_AL_REMPLACER_TIRETS_BAS |booléen |true, false |Remplacer les '_' (tirets bas) présents dans les noms des photos par des espaces. |
+|JB_AL_AFFICHER_EXTENSION |booléen |true, false |Afficher l'extension du fichier de la photo. |
+|JB_AL_AFFICHER_POIDS |booléen |true, false |Afficher le poids de l'image sous la miniature. |
+|JB_AL_AFFICHER_DIMENSIONS |booléen |true, false |Afficher les dimensions de l'image, toujours sous la miniature ;). |
+^Zone rappel des sous-dossiers ^^^^
+|JB_AL_RAPPELER_SOUS_DOSSIERS |booléen |true, false |Afficher un rappel des sous-dossiers du dossier courant après la liste des vignettes. |
+|JB_AL_RAPPELER_QUE_SI_VIDE |booléen |true, false |N'afficher le rappel de ces sous-dossiers que s'il n'y a aucune vignette dans le dossier courant. |
+^Autres ^^^^
+|JB_AL_AFFICHER_TXT_VIDE :!: |booléen |true, false |Permet de choisir si le texte par défaut quand un dossier ne contient pas de photos doit s'afficher ou pas. |
+===== Mode d'affichage des images =====
+Choisissez la manière dont les images vont être ouvertes.
+^  Constante  ^  Type  ^  Valeurs autorisées  ^  Description  ^
+^Général ^^^^
+|JB_AL_MODE_DIAPO_DEFAUT |booléen |true, false |Mettre à **true** pour que le mode diaporama soit le mode activé par défaut. |
+^Pour le mode galerie ^^^^
+|JB_AL_OUVERTURE_BLK |booléen |true, false |Ouvrir les images dans une nouvelle fenêtre sans Javascript. La nouvelle fenêtre ne sera pas aux dimensions de l'image et les barres d'outils seront visibles. L'utilisation de cette option invalide la compatibilité XHTML Strict à cause du target="_blank". |
+|JB_AL_OUVERTURE_JS |booléen |true, false |Ouvrir les images dans une popup grâce à Javascript. Cela permet, à l'inverse du paramètre précédent, de disposer d'une fenêtre sans barres d'outils et aux dimensions de l'image. Vous conservez la validité XHTML, mais vous prenez le risque de rendre l'ouverture des images impossible pour les personnes qui auraient interdit l'exécution de code Javascript. |
+|JB_AL_OUVERTURE_LBX |booléen |true, false |Si vous avez activé le paramètre précédent, vous pouvez alors utiliser le mode LightBox. L'ouverture des images se fait alors dans un cadre animé qui se superpose à la page. Vous pouvez alors naviguer d'une image à l'autre comme dans le mode diaporama, les animations en plus ;). |
+^Pour le mode diaporama ^^^^
+|JB_AL_OUVERTURE_BLK_DIAPO |booléen |true, false |Idem que pour le mode galerie. |
+|JB_AL_OUVERTURE_JS_DIAPO |booléen |true, false |Idem que pour le mode galerie. |
+|JB_AL_OUVERTURE_LBX_DIAPO |booléen |true, false |Idem que pour le mode galerie à ceci près que la fonctionnalité diaporama de LightBox n'est pas disponible lorsque l'on se trouve dans le mode diaporama d'Albulle. |
+^Pour les deux modes ^^^^
+|JB_AL_POPUP_LARGEUR |entier |valeur positive ou nulle |Si vous avez choisi le mode d'ouverture par popup Javascript, vous pouvez spécifier la largeur maximum de la popup. L'image sera alors redimensionnée si ses dimensions sont trop grandes. Laissez à 0 pour ne pas limiter les dimensions de la popup. |
+|JB_AL_POPUP_HAUTEUR |entier |valeur positive ou nulle |Idem paramètre précédent mais pour la hauteur. |
+<note important>L'ouverture des images par popup Javascript est **prioritaire** sur l'ouverture sans Javascript. C'est-à-dire que si vous mettez **JB_AL_OUVERTURE_JAVASCRIPT** à **true**, quelque soit la valeur de ce que vous metterez pour **JB_AL_OUVERTURE_BLK**, elle sera ignorée.</note>
+===== Paramétrage des vignettes =====
+^  Constante  ^  Type  ^  Valeurs autorisées  ^  Description  ^
+|JB_AL_VIGNETTES_PAR_PAGE |entier |valeur positive |Nombre de vignettes à afficher par page. |
+^Pour le mode galerie ^^^^
+|JB_AL_VIGNETTES_LARGEUR |entier |valeur positive |Largeur que doivent prendre les vignettes, en pixels. |
+|JB_AL_VIGNETTES_HAUTEUR |entier |valeur positive |Hauteur que doivent prendre les vignettes, en pixels. |
+^Pour le mode diaporama ^^^^
+|JB_AL_VIGNETTES_DP_LARGEUR |entier |valeur positive |Idem que pour le mode galerie mais pour les vignettes du mode diaporama. |
+|JB_AL_VIGNETTES_DP_HAUTEUR |entier |valeur positive |Idem. |
+^Pour les deux modes ^^^^
+|JB_AL_VIGNETTES_QUALITE |entier |[0..100] |Choisissez la qualité des miniatures (uniquement pour les images au format JPEG). La qualité est meilleure à une valeur de 100 mais la miniature prend plus de poids. A vous de voir selon la capacité de votre hébergement. |
+<note tip>Si vous changez les valeurs des dimensions des miniatures :
+  - pensez à adapter la feuille de styles de structure CSS (structure.css),
+  - il sera très certainement nécessaire de **purger le dossier des miniatures** générées aux anciennes dimensions pour ne pas surcharger votre dossier.
+</note>
+===== Paramétrage du panier =====
+^  Constante  ^  Type  ^  Valeurs autorisées  ^  Description  ^
+|JB_AL_PANIER_ACTIF |booléen |true, false |Activer / désactiver le panier. Si vous désactivez le panier, les paramètres qui suivent sont ignorés. |
+|JB_AL_PANIER_CAPACITE_MAX |entier |[0..n] |Nombre maximum de fichiers que peut contenir le panier (0 = désactiver la limitation). |
+|JB_AL_PANIER_POIDS_MAX |entier |[0..n] |Poids maximum que peut faire un panier en Mo (0 = poids infini). |
+|JB_AL_PANIER_NOM_ARCHIVE |chaîne de caractères |toute chaîne |Nom à donner aux archives générées (sans l'extension). |
+|JB_AL_PANIER_NO_READFILE |booléen |true, false |Si les zip >= 10MB téléchargés sont corrompus, essayez de passez cette valeur à **true** pour éviter d'utiliser "readfile". Attention, en mettant **true**, le script consommera plus de temps d'exécution (souvent limité à 30sec). |
+===== Avancé =====
+^  Constante  ^  Type  ^  Valeurs autorisées  ^  Description  ^
+^Mode intégration dans un site ^^^^
+|JB_AL_INTEGRATION_SITE |booléen |true, false |Si vous souhaitez intégrer Albulle dans votre site Internet, mettez ce paramètre à **true**. Cela aura pour effet d'enlever les entêtes HTML lors de la génération des pages d'Albulle pour qu'il n'y ait pas de redondance avec votre propre site. |
+|JB_AL_SORTIE_ISO |booléen |true, false |Par défaut, Albulle produit du contenu en **utf8**. En metttant ce paramètre à **true** vous pourrez récupérer le contenu en **iso-8859-1** si vous n'utilisez pas l'utf8 pour votre site. Cette conversion est cependant plus gourmande que de laisser l'utf8. |
+|JB_AL_CONSERVER_URL_HOTE |booléen |true, false |Ce paramètre permet d'activer la conservation d'éventuels paramètres utilisé par le site hôte dans lequel vous vous insérez. Désactivez-le si vous êtes en mode autonome. |
+|JB_AL_ACCUEIL_ALT :!: |chaîne de caractères |tout |Permet de surcharger le texte d'accueil à afficher. Si ce paramètre est utilisé, le contenu du fichier **data/texte_accueil.html** ne sera pas utilisé. Cette constante n'est pas présente dans **config.php** et ne peut être utilisée qu'en définition externe avant l'appel d'Albulle. |
+^Mode centre de téléchargements ^^^^
+|JB_AL_MODE_CENTRE |booléen |true, false |Mettez **true** pour activer le mode centre de téléchargement. |
+|JB_AL_DOSSIER_CENTRE |chaîne de caractères |adresse d'un dossier |Si le mode centre est actif, vous devez définir le dossier où seront placés les fichiers à télécharger (ce dossier doit être relatif au dossier des données). |
+|JB_AL_EXTENSION_FICHIERS |chaîne de caractères |.xxx |Extension des fichiers à télécharger. |
+^Lien "Retour au site" ^^^^
+|JB_AL_HOME_HREF |chaîne de caractères |url |Vous pouvez définir une **url** vers votre site principal pour le cas où Albulle ne le serait pas. Le lien s'affichera à gauche du lien vers l'accueil d'Albulle. Définissez l'Url avec ce paramètre. |
+|JB_AL_HOME_TEXTE |chaîne de caractères |toute chaîne |Le texte du lien, utilisé uniquement si le paramètre précédent n'est pas vide. |
+^Création des miniatures ^^^^
+|JB_AL_CHMOD_FICHIERS |entier |valeur de chmod |Valeur du chmod de création des miniatures. **Ne changez ce paramètre que si vous savez ce que vous faites**. |