Table des matières
Paramétrer Albulle
- Objectif : Paramétrer votre installation d'Albulle
- Niveau de difficulté : Facile
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.
Avant d'éditer config.php, je vous invite à lire l'avertissement présent à l'accueil de la documentation si ce n'est pas déjà fait !
: 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.
- 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/).
| 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. 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 :
01;;Mon_image.jpg 02;;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. |
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.
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. |
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.
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. |