À propos de ce fichier
Module Album
IMPORTANT : la dernière version de ce module compatible avec ZwiiCMS 9.2.x est la version 1.0.b, toujours téléchargeable en bas de cette page
Initialement écrit en septembre 2019 et publié sous le nom de Gallery 2.0 pour remplacer les lourdes images en pleine résolution, réduites visuellement et cropées, des premières versions de la galerie d'origine, par des vignettes légères de haute qualité, créées à la volée et mises en cache, le module Album propose une interface différente, affichant des miniatures en haute résolution respectant les proportions et l’orientation des photos, et des fonctions supplémentaires par rapport aux versions actuelles du module gallery livré avec le CMS
Au premier affichage de l'Album, le script corrige éventuellement le nom, l'orientation et la dimension des images puis créé les vignettes et les affiche, le traitement des photos peut être assez long, le temps d’exécution du script dépend du nombre de photo à traiter, de leur poids et du nombre d'opération à effectuer, durant ce temps l'affichage est interrompu et la page se recharge plusieurs fois, patientez, le script fait son boulot jusqu'au bout.
Dès le second affichage les vignettes sont simplement affichées depuis le cache
Les photos qui intègrent la balise GPS sont géo-localisables sur une carte Open Topo Map :
l'Album s’intègre dans la charte graphique de ZwiiCMS, l'affichage par défaut est sobre, il est facile de le modifier pour l’harmoniser avec votre site, en s'inspirant des données CSS du fichier "modification des couleurs" présent dans l'archive, à ajouter au fichier "custom.css" depuis l'interface de ZwiiCMS, après les avoir modifiées selon votre besoin
Index de la galerie :
Page interne de la galerie :
Le fonctionnement global du module Album est identique à celui de la galerie d'origine, écrite par @Rémi, améliorée et augmentée par @Fred, sur laquelle il est basé
Fonctionnalités supplémentaires :
Renomme Réoriente Redimensionne
- Les caractères non alphanumériques et les espaces sont supprimés des noms des photos.
- Si besoin, la photo est réorientée.
- Les photos trop grandes, donc trop lourdes, mettent beaucoup de temps à s’afficher, ou ne s’affichent pas du tout dans certains cas. Pour un affichage fluide et rapide de la galerie, les trop grandes photos sont dimensionnées à la taille maximum correspondant à l’affichage courant des écrans en haute résolution, soit 1920 × 1280 pixels, les photos d’origine sont conservées et sont accessibles par un lien présent sous la vignette correspondante, pour distinguer ces photos de celles non redimensionnées, leurs noms s’affichent dans une couleur différente, notez que si la légende n’existe pas, elle est remplacée par le nom de la photo.
Ce traitement des images se fait au premier affichage de la galerie.
Géo-Localisation
Cette fonction permet de géo-localiser sur une carte Open Street Map les photos qui intègrent la balise EXIF GPS, et de donner leurs altitudes
Les photos d’origine sont conservées et sont accessibles par un lien présent sous la vignette correspondante :
Les couleurs de fond et de texte peuvent s'harmoniser avec votre site en modifiant et en ajoutant le css ci-dessous dans votre custom.css :
/* !important Le style de la galerie est prioritaire sur le custom.css, pour que vos changements de style soit appliqués vous devez ajouter l'attribut !important à vos éléments */ /* Cases contenant les vignettes */ .galleryPicture, .galleryGalleryPicture { /*exemple*/ background-color: gray !important; } .galleryPicture:hover, .galleryGalleryPicture:hover { /*exemple*/ background-color: silver !important; } /* Nom ou légende de l'image */ .galleryName, .galleryGalleryName { /*exemple*/ color: white !important; } .galleryName:hover, .galleryGalleryName:hover { /*exemple*/ color: black !important; } /* Nom ou légende des images redimensionnées */ .picResized { /*exemple*/ color: yellow !important; } .picResized:hover{ /*exemple*/ color: purple !important; }
Exemple avec couleur sombre et effet hover sur les vignettes :
Exemple avec couleurs et effet hover sur les vignettes :
Installation du module Album sur votre site ZwiiCMS :
Décompressez l’archive module-album.zip, elle contient un dossier module contenant un sous-dossier album, puis envoyez par FTP le dossier module à la racine de votre site sous ZwiiCMS
Remplacement de votre galerie existante par l'album :
En utilisant le module Album, vous souhaiterez sans doutes conserver votre galerie existante, c’est très simple à faire : dans l’archive que vous aurez téléchargé se trouvent 2 fichiers, en plus du dossier d’installation du module album et de 3 autres fichiers informatifs :
- album-install-10.php
- remplacement.txt
Utilisation de ce fichier :
Par sécurité, faites une copie de votre fichier page.json
Cette action remplacera "moduleId":"gallery" par "moduleId":"album" dans le fichier /site/data/fr/page.json de la version 10.x
Copiez le nom de fichier ci-dessous, et copiez-le en fin d'adresse de votre site ZwiiCMS en ligne, comme ceci :
http://www.mon-site-en-ligne.com/album-install-10.php
NB : si la réécriture d'url n'est pas activée sur votre site, n'ajoutez pas le point d'interrogation ?
Puis ouvrez cette page en appuyant sur la touche "entrée" de votre clavier.
Une page vide avec un lien retour s'affiche alors
Par ce moyen, vous avez transféré l'ensemble de votre galerie vers le module album, que votre galerie soit celle livrée par défaut avec ZwiiCMS, ou celle que je proposais sous le nom de module gallery 2.0
Nom de fichier à copier/coller et à utiliser pour une version 10.x de votre ZwiiCMS :
album-install-10.php
Attention : en utilisant le fichier album-install-10.php il y a le risque de renommer aussi la page si vous utilisez le mot gallery dans le titre tel que : My Gallery, la page s'appelant alors my-gallery, si votre page comporte le mot gallery, renommez-la avant d'utiliser le fichier album-install-x.php
Quoi de neuf dans la version 1.1.4 ? Voir le journal des modifications
Publiée
Modifications apportées à la version 1.1.4 :
- Mise en conformité des adresses du thème de la partie administration
Modifications apportées à la version 1.1.3 :
- amélioration du code pour plus de rapidité d'exécution
Modifications apportées à la version 1.1.2 :
- mises à jour relatives au bug : lorsqu'on édite une galerie, l'ordre des galeries est modifié
Modifications apportées à la version 1.1.1 :
- nombreuses mises à jour issues du module gallery de la v10
- tri des galeries, provient du module gallery (non compatible v9)
- tri des images manuel, provient du module gallery (non compatible v9)
- ajout d'un effet hover sur le cadre des images
- suppression de l'effet hover sur les images
- correction de l'affichage responsive de la carte OSM
- prise en compte de null island pour le non affichage du marker GPS (latitude = 0, longitude = 0)
- ajout du format webp en miniature
- fixation de quelques bugs mineurs
Note : Cette version du module Album n'est pas compatible avec les versions 9.2.x de ZwiiCMS, la dernière version compatible avec ZwiiCMS 9.2.x est la version 1.0.b, toujours téléchargeable
Important : Si avant d'utiliser le module Album vous utilisiez déjà mon module Gallery 2.0, les vignettes des versions antérieures à la 3.6.a avaient 2 tailles différentes, une grande pour l’accueil, des plus petites pour les pages internes, à présent toutes les vignettes créées ont la même taille.
Pour pouvoir bénéficier de la sélection de l'image d'accueil dans de bonnes conditions, il faut reconstruire les vignettes, pour ce faire vous devez supprimer le dossier cache présent dans le dossier /site/file/
A l’ouverture de l'Album les vignettes seront rapidement recréées, les éventuels traitements des images, tels que la correction de l’orientation ou le dimensionnement, ayant déjà été faits.
Les principales modifications apportées à la version 3.6.a du module Gallery 2.0 sont :
. modification de l'affichage de l'accueil, 4 vignettes en ligne au lieu de 3 précédemment
. ajout du choix du tri des images et de la sélection de l'image d'accueil
Si ces modifications ne sont pas implémentées sur votre version installée du module Gallery 2.0, alors celle-ci est antérieure à la version 3.6.a, vous devez donc reconstruire les vignettes
