=== Folder Gallery ===
Contributors: Vincent Jalby v1.7.4 (v3.1.3 MJAP/Claude/Anthropic)
Tags: gallery, folder, lightbox, masonry, responsive
Requires at least: 4.0
Tested up to: 6.9
Requires PHP: 7.0
Stable tag: 3.1.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Donate link: http://jalby.org/wordpress/donate/

Génère des galeries d'images responsives à partir d'un dossier, via un shortcode, avec une lightbox intégrée (aucune extension supplémentaire requise).

== Description ==

Cette extension crée des galeries d'images à partir d'un dossier.
Le dossier d'images doit être téléversé (par FTP) quelque part dans wp-content (par exemple wp-content/uploads). Il doit être accessible en écriture (chmod 755).

**Depuis la version 3.0.0, Folder Gallery est totalement autonome** : la lightbox (affichage plein écran au clic, navigation précédent/suivant, légendes, diaporama automatique) est intégrée à l'extension elle-même, en CSS et JavaScript natifs, sans jQuery ni bibliothèque externe. Aucune extension de lightbox tierce (Easy Fancybox, Firelight Lightbox, Fancybox, Lightbox 2, PhotoSwipe...) n'est nécessaire ni utilisée.

**La grille de vignettes est responsive** : le nombre de colonnes s'adapte automatiquement à la largeur de l'écran (téléphone, tablette, ordinateur), en fonction de la largeur de vignette configurée. C'est du CSS pur (grid + auto-fill). Les vignettes utilisent le chargement paresseux natif du navigateur.

**Disposition « mur de maçon » (masonry)** : chaque galerie peut s'afficher en mur de maçon (`layout="masonry"` dans le shortcode, ou réglage par défaut dans la page d'options) : les images conservent leurs proportions naturelles et s'empilent comme des briques, sans découpe. C'est également du CSS pur (multi-colonnes), sans JavaScript.

Pour insérer une galerie dans un article ou une page, utilisez le shortcode suivant :

	[foldergallery folder="chemin_local_du_dossier" title="Titre de la galerie"]

Pour chaque galerie, un sous-dossier cache_[largeur]x[hauteur] est créé dans le dossier d'images lors du premier affichage de la page.

Une page d'options permet de définir les paramètres par défaut des galeries :

* Disposition de la galerie (layout) : grid = grille alignée, masonry = mur de maçon (les images gardent leurs proportions ; la hauteur de vignette est ignorée)
* Affichage des vignettes (thumbnails) : all = galerie standard, single = une seule vignette liée à la galerie lightbox, none = un lien texte vers la galerie lightbox
* Tri des images (sort) : filename (nom de fichier), filename_desc (ordre inverse), date, date_desc, random (aléatoire)
* Colonnes maximum sur grand écran (columns) : 0 = automatique. Sur les écrans plus petits, le nombre de colonnes s'adapte toujours automatiquement.
* Largeur et hauteur des vignettes (width & height) : la largeur définit aussi le seuil de bascule de la grille responsive. Hauteur = 0 : chaque image garde son ratio naturel (recommandé pour la disposition Masonry). Hauteur fixe (valeur par défaut : 120) : toutes les vignettes sont recadrées à une taille identique, ce qui donne une grille bien alignée sans espaces blancs en disposition Grille.
* Bordure des images (border), marge intérieure (padding), marge (margin — utilisée comme espacement de la grille)
* Format des légendes (caption) : default (titre + numéro d'image), filename, filenamewithoutextension, smartfilename, modificationdate, modificationdateandtime, modificationdater (RFC 2822), modificationdatec (ISO 8601), none
* Légendes sous les vignettes (show_thumbnail_captions) : afficher (ou non) la légende sous chaque vignette
* Diaporama (lightbox intégrée) : lecture automatique à l'ouverture, navigation cyclique, vitesse du diaporama (ms), délai initial (ms). Un bouton marche/arrêt dans la lightbox permet en plus à chaque visiteur de démarrer ou d'arrêter le diaporama lui-même, à tout moment (barre d'espace au clavier).
* Divers — Orientation : corrige l'orientation des images selon la balise EXIF (les images sont réécrites ; nécessite l'extension PHP EXIF)
* Divers — WPML : corrige les chemins WPML

La plupart de ces réglages peuvent être surchargés dans le shortcode :

	[foldergallery folder="chemin" title="titre" columns=4 width=150
			height=90 border=1 padding=2 margin=10 thumbnails=single layout=masonry]

== Installation ==

1. Décompressez l'archive foldergallery.zip et téléversez le dossier 'folder-gallery' dans '/wp-content/plugins/'.
2. Activez l'extension depuis le menu 'Extensions' de WordPress.
3. Allez dans Réglages > Folder Gallery pour ajuster les réglages par défaut.
4. Téléversez un dossier d'images dans 'wp-content/uploads/MesImages'.
5. Insérez le shortcode suivant dans un article ou une page :

	[foldergallery folder="wp-content/uploads/MesImages" title="Ma galerie d'images"]

== Frequently Asked Questions ==

= Ai-je besoin d'installer une extension de lightbox (Easy Fancybox, Fancybox...) ? =

Non. Depuis la version 3.0.0, Folder Gallery embarque sa propre lightbox (CSS + JavaScript natifs, sans dépendance). Si vous utilisiez une version antérieure avec Easy Fancybox / Firelight Lightbox, vous pouvez désinstaller cette extension : elle n'est plus utilisée par Folder Gallery et n'interfère pas avec sa lightbox intégrée si vous la gardez pour d'autres besoins.

= Comment fonctionne la grille responsive ? =

La galerie est une grille CSS : chaque colonne a au minimum la largeur de vignette configurée (plafonnée à 100 % du conteneur), et autant de colonnes que l'écran peut en contenir sont créées automatiquement. Sur un téléphone, on obtient généralement 1 à 2 colonnes, sur une tablette 3 à 4, sur un ordinateur davantage — sans aucune configuration. L'option « Colonnes maximum » ne fait que plafonner le nombre de colonnes sur grand écran (0 = pas de plafond).

= Comment fonctionne la disposition « mur de maçon » (masonry) ? =

Ajoutez `layout="masonry"` au shortcode (ou choisissez « Masonry » comme disposition par défaut dans les réglages) :

	[foldergallery folder="chemin" title="Ma galerie" layout="masonry"]

Les images conservent leurs proportions naturelles et s'empilent en colonnes, comme des briques. La hauteur de vignette est ignorée dans ce mode (elle imposerait un recadrage uniforme, ce qui redonnerait une grille). Techniquement, c'est du CSS multi-colonnes, supporté par tous les navigateurs. Particularité de ce mode : les images se suivent de haut en bas dans chaque colonne (et non de gauche à droite) ; l'ordre de la lightbox reste celui du tri configuré.

= Comment fonctionne le diaporama automatique ? =

Activez « Auto-play » dans la section Diaporama de la page de réglages. Vous pouvez régler la vitesse (ms entre deux images), un délai initial différent pour la première image, et la navigation cyclique (revenir à la première image après la dernière). Ces réglages s'appliquent à la lightbox intégrée de Folder Gallery.

= Je voudrais afficher une seule vignette au lieu de la liste complète =

Ajoutez l'attribut `thumbnails` avec la valeur `single` :

	[foldergallery folder="chemin" title="Ma galerie" thumbnails="single"]

Si vous souhaitez utiliser une autre image (que la première) comme vignette unique, ajoutez au dossier une image nommée `!!!` (par exemple `!!!.jpg`) : elle servira de vignette mais n'apparaîtra pas dans la galerie lightbox. Vous pouvez aussi utiliser `thumbnails=-n`, où `n` est le numéro de l'image à utiliser comme vignette.

= Je voudrais afficher seulement les n premières vignettes =

	[foldergallery folder="chemin" title="Ma galerie" thumbnails=3]

= Je voudrais afficher une légende sous chaque vignette =

	[foldergallery folder="chemin" title="Ma galerie" show_thumbnail_captions=1 caption="smartfilename"]

`caption` peut valoir `filename`, `filenamewithoutextension` ou `smartfilename` (nom de fichier sans extension, numéros en tête supprimés, tirets bas remplacés par des espaces).

= Quels formats d'image sont pris en charge ? =

jpg / jpeg, png, gif, bmp et webp, avec extensions insensibles à la casse.

== Screenshots ==
1. Options de Folder Gallery
2. Folder Gallery dans un article
3. Lightbox de Folder Gallery

== Changelog ==

= 3.1.3 [13/10/2026] =
* Correction (production, suite de la 3.1.2) : la grille de vignettes restait cassée sur une galerie de 350+ photos après la 3.1.2, qui corrigeait un problème réel mais pas celui-ci. Vérification en direct sur le site : les 450 vignettes se chargeaient bien (aucune manquante), mais la galerie était placée dans un bloc accordéon (bloc « Détails » de Gutenberg) replié ; à l'ouverture, toutes les vignettes passent instantanément de hauteur nulle à visibles, et le chargement natif (`loading="lazy"`) les demande alors toutes en même temps — environ 230 requêtes quasi simultanées mesurées en direct, avec un temps de réponse médian de plus de 10,6 s (jusqu'à 23 s), ce qui ressemblait à une grille cassée alors qu'aucun fichier ne manquait. Les vignettes sont désormais chargées par petits groupes (6 à la fois, quel que soit le nombre qui devient visible d'un coup) via le script de la lightbox, avec repli `loading="lazy"` classique si JavaScript est désactivé. Même scénario réévalué en direct après correction : temps de réponse médian 10,6 s → 6 ms (90e percentile : 22,6 s → 8 ms). Un filet de sécurité a aussi été ajusté après un deuxième test en conditions réelles (défilement jusqu'en bas d'une page de 450 photos, puis saut instantané en bas de page à la touche Fin) : quelques vignettes déjà dépassées par un saut rapide pouvaient rester bloquées sur leur emplacement réservé ; elles sont maintenant toujours rechargées sans limite de distance une fois que le défilement les a dépassées.

= 3.1.2 [12/10/2026] =
* Correction (production) : sur une galerie de 350 images, la grille de vignettes pouvait apparaître cassée (images manquantes) alors que la lightbox, elle, affichait correctement toutes les photos jusqu'au bout. Cause : la lightbox pointe directement vers la photo originale et ne dépend jamais du cache de vignettes, qui lui continuait de fonctionner même quand une vignette donnée n'avait pas pu être créée (génération trop lente pour une très grande galerie au premier affichage, ou échec silencieux sur une image précise). La grille utilise désormais la photo originale en repli tant que sa vignette n'existe pas, au lieu d'afficher une image cassée ; la génération des vignettes est en outre limitée à 60 nouvelles par chargement de page (les suivantes se complètent sur les chargements suivants) pour éviter un dépassement du temps d'exécution PHP sur les grandes galeries. Un échec de génération est désormais consigné dans le journal d'erreurs PHP pour être diagnosticable.

= 3.1.1 [15/09/2026] =
* Revue pré-production (correction + performance) : l'audit sécurité de la 2.0.5 reste valide (rejeu vérifié, pas seulement relu : traversée de chemin, XSS, CSRF, contrôle des droits) — aucune faille nouvelle trouvée, mais quatre points réels corrigés :
* Correction : un dossier dont le nom se terminait par une extension image (ex. « album.jpg ») était pris pour une photo, provoquant un échec silencieux et répété à chaque chargement de page. Seuls les vrais fichiers sont désormais retenus.
* Performance : la date de modification d'une image pouvait être relue deux fois par photo (tri par date + légende de type « date de modification ») ; elle n'est plus lue qu'une fois par photo et par affichage.
* Performance : les réglages de l'extension n'étaient plus rechargés à chaque génération de vignette manquante.
* Correction (accessibilité) : la lightbox annonce `aria-modal="true"` mais la touche Tab pouvait auparavant atteindre le contenu de la page derrière elle ; le focus reste maintenant sur les boutons de la lightbox tant qu'elle est ouverte.

= 3.1.0 [11/09/2026] =
* Nouveauté : bouton marche/arrêt du diaporama dans la lightbox (coin supérieur gauche). Le réglage « Lecture automatique » ne décide plus que de l'état de départ à l'ouverture d'une image ; le visiteur peut ensuite démarrer ou arrêter le diaporama à tout moment, y compris via la barre d'espace au clavier.
* Correction (UX) : quand le diaporama non cyclique atteint la dernière image, il s'arrête désormais proprement et le bouton repasse sur « Lecture » (auparavant il ne se passait rien de visible à chaque tentative suivante).

= 3.0.1 [11/09/2026] =
* Correction (UX) : la hauteur de vignette par défaut passe de 0 à 120 (pour une largeur par défaut de 160). En disposition Grille, une hauteur à 0 (ratio naturel) fait que chaque rangée s'étire à la hauteur de sa vignette la plus haute, laissant des espaces blancs sous les vignettes plus courtes. Ce défaut ne concerne que les nouvelles installations ; les réglages déjà enregistrés ne sont pas modifiés. Pour corriger une installation existante : Réglages > Folder Gallery > Hauteur des vignettes, mettre une valeur fixe (ex. 120) puis Enregistrer.
* Interface : le texte d'aide du champ « Hauteur des vignettes » explique désormais le compromis Grille / Masonry.

= 3.0.0 [11/09/2026] =
* CHANGEMENT MAJEUR : Folder Gallery n'a plus besoin d'Easy Fancybox / Firelight Lightbox, ni d'aucune autre extension de lightbox. Une lightbox intégrée (CSS + JavaScript natifs, sans jQuery ni bibliothèque externe) est désormais fournie avec l'extension : ouverture au clic, navigation précédent/suivant (souris, clavier, glissement tactile), légendes, compteur d'images, et le diaporama automatique (lecture auto, vitesse, délai initial, navigation cyclique) qui reposait auparavant sur le filtre `easy_fancybox_bind` d'Easy Fancybox.
* Migration automatique des réglages : les quatre options de diaporama perdent leur préfixe « efb_ » (efb_autoplay devient autoplay, etc.) ; vos réglages existants sont conservés lors de la mise à jour, rien n'est réinitialisé.
* Nouveau fichier js/fg-lightbox.js et CSS associé dans css/style.css, chargés uniquement sur les pages affichant une galerie (comme la feuille de style existante).
* Si Easy Fancybox (ou une autre extension de lightbox) reste active sur le site, elle continue de fonctionner pour ses propres liens ; les liens de Folder Gallery ne portent plus la classe `fancybox` et n'interagissent donc plus du tout avec elle.

= 2.0.5-efb [11/09/2026] =
* Revue de sécurité indépendante : aucune faille identifiée (traversée de chemin, XSS, CSRF, contrôles de capacité, filtrage des extensions — tout était déjà verrouillé depuis la 2.0.4). Risque résiduel documenté (non corrigé car inhérent à la fonctionnalité) : le shortcode [foldergallery] permet à tout utilisateur pouvant publier un shortcode (rôle Auteur et au-dessus, parfois Contributeur) de parcourir et d'exposer publiquement toute image présente sous wp-content, y compris dans les dossiers d'autres extensions/thèmes. Limitez qui peut publier des shortcodes si cela est sensible sur votre site.
* Optimisation : les réglages du plugin (get_option) étaient mis en cache en mémoire dans fg_efb_slideshow_bind() au lieu d'être relus à chaque groupe de liens lightbox sur la page (fonction supprimée en 3.0.0, voir ci-dessus).
* Optimisation : le décalage horaire (gmt_offset) est lu une seule fois avant la boucle de génération des légendes, au lieu de deux fois par image pour les formats de date RFC 2822 / ISO 8601.

= 2.0.4-efb [13/07/2026] =
* Correction : la combinaison layout="masonry" + thumbnails="none" n'applique plus la mise en colonnes au lien-titre (il pouvait être fragmenté en colonnes étroites) ; réinitialisation CSS défensive ajoutée sur le mode lien seul.
* Correction : le resserrement des espacements sur téléphone (media query ≤ 480 px) s'applique désormais aussi au mode masonry.
* Accessibilité : les libellés de la page de réglages (layout, thumbnails, sort, caption, show_thumbnail_captions) sont maintenant correctement liés à leur champ (for/id) — cliquer un libellé focalise son menu.

= 2.0.3-efb [13/07/2026] =
* Nouveauté : disposition « mur de maçon » (masonry) — attribut de shortcode `layout="masonry"` et réglage par défaut « Disposition de la galerie » dans la page d'options. Implémentée en CSS multi-colonnes (aucun JavaScript), compatible tous navigateurs. La hauteur de vignette est ignorée dans ce mode (les images gardent leurs proportions naturelles).
* Traduction : 4 nouvelles chaînes françaises ajoutées et fichier .mo recompilé.
* Validation : l'attribut `layout` est filtré par liste blanche (grid/masonry) côté shortcode et côté réglages.

= 2.0.2-efb [08/07/2026] =
* Compatibilité « Firelight Lightbox » : Easy Fancybox ayant été renommée Firelight Lightbox (depuis EFB 2.3.0), la détection de l'extension vérifiait désormais la classe PHP `easyFancyBox` OU la constante `EASY_FANCYBOX_VERSION` (les deux existent en 2.3.20) — la détection résistait ainsi à un éventuel renommage futur de l'une des deux. Aucun autre point d'intégration n'avait changé (filtre `easy_fancybox_bind` et réglage `fancybox_scriptVersion` inchangés en 2.3.20, vérifié dans les sources). Ce mécanisme de détection a été retiré en 3.0.0, Folder Gallery n'ayant plus besoin d'Easy Fancybox.
* Interface : les libellés et messages mentionnaient désormais « Easy Fancybox (Firelight Lightbox) » ; l'avertissement « FancyBox V2 » renvoyait au menu « Lightbox » de l'administration.
* Traduction : traduction française complétée (18 chaînes manquantes ajoutées : messages d'erreur, avertissements, section diaporama, réglages responsive) et fichier .mo recompilé.
* Robustesse (PHP 8) : filename_without_extension() ne déclenche plus d'avertissement « Undefined array key » pour un fichier sans extension (défense en profondeur).
* Nettoyage : correction d'une virgule en double dans l'en-tête « Tags » du plugin.
* Aucune faille de sécurité identifiée dans cette revue ; aucun changement de comportement des galeries.

= 2.0.1-efb [07/07/2026] =
* Correctif : les vignettes conservent désormais la casse d'origine du nom de fichier. Auparavant, deux images ne différant que par la casse (par exemple « Photo.JPG » et « photo.jpg ») partageaient une seule vignette sur les systèmes de fichiers sensibles à la casse (Linux) ; la seconde image affichait la vignette de la première.
* Sécurité/robustesse : bornes hautes ajoutées sur les attributs du shortcode (width/height ≤ 2000, margin/padding ≤ 500, border ≤ 100) pour éviter qu'un width="99999" ne déclenche un redimensionnement coûteux sur chaque image.
* Correctif CSS : la formule du plafond « colonnes maximum » n'ajoute plus le padding/la bordure (internes à la vignette en box-sizing:border-box), ce qui faussait le plafond avec un padding élevé.

= 2.0.0-efb [06/07/2026] =
* SIMPLIFICATION : Easy Fancybox était désormais le seul moteur de lightbox pris en charge (testé avec EFB 2.3.20). Suppression de la prise en charge de Lightbox 2, Fancybox 2, Fancybox 3, Lightview, Responsive Lightbox, PhotoSwipe et Slenderbox, de leurs réglages, de leurs scripts (js/fg-fancybox.js, js/fg-fancybox3.js) et du sélecteur de moteur.
* NOUVEAU : grille de vignettes entièrement responsive (CSS grid + auto-fill, propriétés personnalisées). Le nombre de colonnes s'adapte automatiquement à l'écran (téléphone, tablette, ordinateur) selon la largeur de vignette. L'option « columns » devient un maximum sur grand écran (0 = auto). Sans JavaScript.
* NOUVEAU : chargement paresseux natif (loading="lazy") et décodage asynchrone des vignettes.
* NOUVEAU : prise en charge du format WebP dans l'analyse du dossier.
* Les options obsolètes (engine, fb_*, fb3_*, lw_options, permissions) sont supprimées automatiquement de la base de données lors de la mise à niveau (écriture unique).
* Suppression de l'ancienne mise en page à base de float/clear et des largeurs en pixels en ligne.
* Hérité de la 1.7.8-efb : gestion durcie des chemins (ancrage ABSPATH, realpath restreint à wp-content), analyse de dossier portable (sans GLOB_BRACE ni chdir), validation des réglages robuste PHP 8, assets versionnés, CSS chargé uniquement sur les pages à galerie.

= 1.7.8 [06/07/2026] =
* Correctif : suppression de glob() + GLOB_BRACE (erreur fatale sur certains builds PHP 8 dépourvus de cette constante, par exemple Alpine Linux) ; l'analyse du dossier utilise désormais toujours l'implémentation portable à base d'opendir(), sans chdir()
* Sécurité (défense en profondeur) : validation par liste blanche du réglage 'engine'
* Robustesse (PHP 8) : la validation des réglages fusionne la saisie avec les valeurs par défaut, plus d'avertissements « Undefined array key » sur envoi partiel
* Fiabilité : toutes les opérations sur fichiers utilisent des chemins absolus ancrés sur ABSPATH (le contrôle realpath ne dépend plus du répertoire de travail du processus)
* Optimisation : le CSS de l'extension (et celui du moteur) n'est chargé que sur les pages affichant une galerie
* Optimisation : paramètre de version sur les assets de l'extension (rafraîchissement du cache navigateur lors des mises à jour)
* Optimisation : écriture unique des options lors de l'initialisation/des migrations
* Nettoyage : suppression du pseudo-constructeur de style PHP 4 ; bornage des attributs numériques du shortcode ; suppression du second argument ignoré passé à content_url()

= 1.7.6 / 1.7.7 [26/06/2026] =
* Intégration Easy Fancybox v2.3.20

= 1.7.5 [26/06/2026] =
* Corrections diverses de bugs et de sécurité

= 1.7.4 [18/11/2017] =
* Prise en charge de FancyBox 3
* Option de correction WPML
* Corrections diverses

(Entrées plus anciennes : voir l'extension Folder Gallery d'origine de Vincent Jalby.)