Description
This WordPress Plugin adds a simple & lightweight Lightbox to the standard WordPress Gallery & Image Block. It detects if a post contains a Gallery or Image Block and then loads & initialize baguetteBox.js, a pure JavaScript Lightbox script without any dependencies and a modern minimal look.
There is no lock in effect. It does not add a new Block Editor/Gutenberg Block and relies solo on the standard WordPress Gallery and Image Block. You can deactivate this plugin at any time and your Gallery and Image Blocks will work as they’ve done before. Just without the lightbox.
Just one important thing to remember: You always have to select Link
Link to image file or Link images to media file (see screenshots below) for all of your Image & Gallery Blocks to work properly. If you choose None or Link to attachment page it will not work. But that’s fine if you don’t want the Lightbox for a specific Image or Gallery.Consultez la vidéo YouTube de Jakson où il donne son avis sur cette extension :
Fonctionnalités
Voici les caractéristiques de baguetteBox.js :
- Écrit en pur JavaScript
- Aucune dépendance (p. ex. jQuery)
- Image captions support
- Responsive
- Prise en charge des gestes de balayage
- Environ 13 Ko, 7 Ko compressé
Compatible avec
- Bloc galerie (Bloc par défaut)
- Bloc image (Bloc par défaut)
- Bloc média et texte (Bloc par défaut)
- Galerie (Galerie par défaut de l’éditeur classique)
- Blocs galeries Coblocks Collage / Masonry / Offset / Stacked
- Meow Gallery (+ Gallery Block)
- GenerateBlocks Image (Set
Enable Dynamic Data
Link source
toSingle image
)
N’oubliez pas de sélectionner Lien vers
Fichier média pour que toutes vos galeries et images fonctionnent correctement.Notice: At the moment, just Blocks inside a post are supported. Not Blocks in a Widget. You can make it work but have to enqueue the necessary style & script yourself. See FAQ –> Comment mettre en file d‘attente les ressources nécessaires (script et style) pour les blocs en dehors des publications ou pour les types de blocs qui ne sont pas pris en charge par défaut ?
Captures d’écran
Installation
- Upload the folder
gallery-block-lightbox
to the/wp-content/plugins/
directory - Activez l’extension via le menu « Extensions » de WordPress.
- Add a Gallery or Image Block to your Post and set Link to Media File
- Check your Gallery or Image with Lightbox on the front end by clicking on an image
FAQ
-
Lorsque je clique sur une image, rien ne se passe.
-
Check if you used the built in Gallery Block and if Link to is set to Media File in the Block sidebar. On an Image Block choose Add Link at the Toolbar.
-
Fonctionne-t-il pour les images uniques ?
-
Yes! Just set the Link at the Toolbar to Media File
-
Can I deactivate the Lightbox for a single Image or Gallery?
-
Set Media File to None or remove the Link.
-
Is there a way to set the default Link to option to Media File?
-
Since WordPress 5.6 you can now set the default behavior for Link to. Go to
yourblog.com/wp-admin/options.php
and search forimage_default_link_type
. Set the value tofile
and hit save. This will apply to all new Image & Gallery Blocks.Or you can add the follow snipped (WordPress 5.7+ / PHP 7.4+) to your functions.php:
add_filter( 'option_image_default_link_type', fn () => 'file' );
-
Comment puis-je ajouter mon propre bloc ? / Comment puis-je modifier le sélecteur CSS ?
-
You can change the CSS selector to a gallery (or galleries) containing
<a>
tags used by baguetteBox.js with thebaguettebox_selector
filter:
add_filter( 'baguettebox_selector', function( $selector ) { return $selector . ',.my-gallery'; } )
You can override the full selector by just returing your selector e.g. to show all images in your post in one lightbox (not per Gallery/Image Block):
add_filter( 'baguettebox_selector', function() { return '.entry-content'; } )
-
Comment mettre en file d‘attente les ressources nécessaires (script et style) pour les blocs en dehors des publications ou pour les types de blocs qui ne sont pas pris en charge par défaut ?
-
Si vous utilisez un bloc Galerie ou Image en dehors d‘une publication, par exemple à l‘intérieur d‘un widget, et souhaitez appliquer la visionneuse, vous devez vous assurer que les ressources nécessaires de baguettebox (script et style) sont mises en file d‘attente à l‘aide du filtre baguettebox_enqueue_assets.
If the Widget is on every page or the majority of pages, you can just enqueue the baguettebox assets everywhere. Just add the following snippet to
functions.php
:
add_filter( 'baguettebox_enqueue_assets', '__return_true' );
If your Widget is just at the front page, useis_front_page()
:
add_filter( 'baguettebox_enqueue_assets', function( $enqueue_assets ) { return is_front_page(); } );
If you want to use the Gallery & Image Block Lightbox plugin with a block type that is not supported by default, you can make use of thehas_block()
function. For instance, in the case of the Kadence Blocks Advanced Gallery, use:
add_filter( 'baguettebox_enqueue_assets', function ( $enqueue_assets ) {
return $enqueue_assets || has_block( 'kadence/advancedgallery' );
} );
Of course, in the previous example you also have to add the appropriate baguettebox selector, i.e.
add_filter( 'baguettebox_selector', function( $selector ) {
return $selector . ',.wp-block-kadence-advancedgallery';
} ); -
Puis-je modifier ou désactiver l‘animation lors des transitions d‘images ?
-
By default, baguetteBox.js shows a slide-in animation on image transitions. You can change it to the following filter to
'fadeIn'
:
add_filter( 'baguettebox_animation', function () { return 'fadeIn'; } );
Or disable the animation completely with'false'
:
add_filter( 'baguettebox_animation', function () { return 'false'; } );
Avis
Contributeurs/contributrices & développeurs/développeuses
« Lightbox for Gallery & Image Block » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
Contributeurs“Lightbox for Gallery & Image Block” a été traduit dans 9 locales. Remerciez l’équipe de traduction pour ses contributions.
Traduisez « Lightbox for Gallery & Image Block » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal
1.16
- Add filter baguettebox_animation to choose between ‘slideIn’ | ‘fadeIn’ | ‘false’ animation styles on image transitions.
1.15
- Add filter baguettebox_captions to change the JavaScript function to get the caption of an image
1.14
- Add the CSS class
.no-lightbox
to an element to disable the lightbox
1.13
- Support GenerateBlocks Image
1.12
- Support Meow Gallery (+ Gallery Block)
1.11
- Add filter baguettebox_enqueue_assets to control enqueing of baguettebox assets.
1.10.1
- Fix Image in Media & Text Block
1.10.0
- Add two Filter baguettebox_selector for the baguetteBox.js CSS selector and baguettebox_filter for the baguetteBox.js file type RegExp filter
1.9.0
- Support new Gallery Block format (will be released with WordPress 5.9 in December 2021) https://make.wordpress.org/core/2021/08/20/gallery-block-refactor-dev-note/
1.8.5
- Fix Caption for the single Image Block
1.8.4
- Add Caption Support for the Classic Editor Gallery
1.8.3
- Fix Regex Filter
1.8.2
- Add support for file links with query parameter at the end
1.8.1
- Fix image link filter
1.8.0
- Add support for .avif, .heif/.heic, .tif
1.7.0
- Add support for Media and Text Block
1.6.0
- Add support for CoBlocks Gallery Collage / Masonry / Offset / Stacked
1.5.0
- Add support for Classic Editor Gallery
1.4.0
- Ajout de la prise en charge des images .svg
1.3.1
- Remove trailing slash from register_script/style
1.3.0
- Prise en charge du bloc d’image par défaut
1.2.0
- Prise en charge de l‘HTML pour la légende
1.0.0
Première version