Descripción
A responsive modern carousel slider for the Gutenberg block editor that lets you add any blocks to your slides. Easily create sliders for hero sections, testimonials, products, and anything else using Gutenberg blocks.
🚀 Carousel Slider Version 2 is built on the modern Swiper.js library for improved performance and better mobile compatibility.
Plugin site: carouselblock.com
Características
- Agrega diapositivas ilimitadas
- Añadie cualquier bloque a las diapositivas
- Vista previa del carrusel en el editor
- Adaptable y compatible con toques
- Developer friendly: supports CSS variables & theme.json
Ajustes
- Diapositivas por vista
- Diapositivas que hacen desplazamiento al mismo tiempo
- Velocidad de desplazamiento
- Relleno de diapositivas
- Flechas de anterior/siguiente
- Navegación por puntos
- Blucle de diapositivas infinito
- Reproducción automática
- Pause on hover
- Disable on interaction
- Ajustes de adaptabilidad: diapositivas a mostrar y desplazarse en un tamaño de pantalla dado
- RTL
Advanced Settings
For dynamic layouts where the slider or its surrounding layout changes after load, such as tabs, accordions, or lazy-loaded content.
- ResizeObserver
- Observer
- Observe parent elements
- Observe slide children
Included Patterns
- Full Width Hero Slider
- Testimonials Slider
- Logos Carousel
The final look of these sliders depends on your theme styles. You can also fine-tune the design using custom CSS variables (see below).
Requisitos
Recomendamos PHP 5.6+, WordPress 5.8+, con Gutenberg activo.
Documentación
Full documentation: carouselblock.com/docs
Selecciona el bloque de carrusel de diapositivas desde la categoría de diseño. Haz clic en el botón + situado al final del carrusel para agregar diapositivas. Agrega cualquier bloque dentro de las diapositivas. Usa la barra de desplazamiento horizontal para previsualizar las diapositivas en el editor.
Puedes reordenar las diapositivas usando los botones de flecha izquierda y derecha de la barra de herramientas.
Para quitar una diapositiva selecciona la diapositiva y haz clic en los tres puntos de la derecha sobre la misma. Haz clic en la opción de eliminar esa diapositiva.
Haz clic en el bloque de carrusel (el bloque que anida todas las diapositivas) para mostrar los ajustes del carrusel.
Upgrading from Legacy Carousel
See the support topic for upgrading legacy blocks to Carousel Slider Version 2.
Legacy settings remain available at /wp-admin/options-general.php?page=cb-carousel-settings. The page is hidden from the admin menu and can be accessed directly by URL.
Customizing Styles
Carousel Slider v2 supports custom styling via CSS variables:
Styling documentation: carouselblock.com/docs?doc=styling
Navegación
--wp--custom--carousel-block--navigation-size: Arrow icon size--wp--custom--carousel-block--navigation-sides-offset: Distance from edge--wp--custom--carousel-block--navigation-color: Arrow color--wp--custom--carousel-block--navigation-hover-color: Arrow hover color (falls back tonavigation-color)--wp--custom--carousel-block--navigation-alignfull-color: Arrow color when carousel is full width
Pagination (dots)
--wp--custom--carousel-block--pagination-top: Top offset--wp--custom--carousel-block--pagination-bottom: Bottom offset--wp--custom--carousel-block--pagination-bullet-size: Bullet size--wp--custom--carousel-block--pagination-bullet-active-color: Active bullet color--wp--custom--carousel-block--pagination-bullet-inactive-color: Inactive bullet color--wp--custom--carousel-block--pagination-bullet-inactive-hover-color: Inactive bullet hover color (falls back toactive-colorif set)--wp--custom--carousel-block--pagination-bullet-active-opacity: Active bullet opacity--wp--custom--carousel-block--pagination-bullet-inactive-opacity: Inactive bullet opacity--wp--custom--carousel-block--pagination-bullet-inactive-hover-opacity: Inactive bullet opacity on hover (falls back toinactive-opacityif not set)--wp--custom--carousel-block--pagination-bullet-horizontal-gap: Space between bullets (horizontal)--wp--custom--carousel-block--pagination-bullet-vertical-gap: Space between bullets (vertical)
Espaciado del bloque
--wp--custom--carousel-block--image-margin-top: Top margin for image blocks--wp--custom--carousel-block--image-margin-bottom: Bottom margin for image blocks--wp--custom--carousel-block--cover-margin-top: Top margin for cover blocks--wp--custom--carousel-block--cover-margin-bottom: Bottom margin for cover blocks
Theme JSON Support
All the CSS variables can also be defined directly inside your theme’s theme.json under the settings.custom key.
For example:
{
"settings": {
"custom": {
"carousel-block": {
"navigation-size": "22px",
"navigation-color": "#000",
"pagination-bullet-active-color": "#000"
}
}
}
}
Frontend API
Carousel Slider exposes a small frontend API for integrations with tabs, accordions, modals, or other hidden UI.
For some of these dynamic layout cases, the Advanced Settings observer options can also handle updates automatically.
window.CarouselSliderBlock.init( container ): Initializes carousel instances inside the given container.window.CarouselSliderBlock.update( container ): Updates existing carousel instances inside the given container and initializes any that are not yet initialized.
Capturas de pantalla
Bloques
Este plugin proporciona 2 bloques.
- Carousel Slider Display a carousel using any blocks as slides.
- Slide A single slide within the carousel.
Instalación
- Desde tu escritorio de WordPress, ve a Plugins > Agregar nuevo.
- Busca Carousel Slider Block en la caja Buscar plugins.
- Haz clic en Instalar ahora para instalar el plugin Carousel Slider Block.
- Haz clic en Activar para activar el plugin.
- El bloque de carrusel de diapositivas se agregará al grupo de bloques de diseño en el editor.
Si aún necesitas ayuda, visita Codex de WordPress
FAQ
-
¿Qué es Gutenberg?
-
Gutenberg es el nombre del nuevo editor basado en bloques introducido en WordPress 5. Gutenberg facilita crewar contenido dentro del editor usando bloques.
-
¿Cómo agrego un carrusel a WordPress?
-
Seleciona el bloque de carrusel de diapositivas desde la categoría de diseño.
-
¿Cómo agrego una diapositiva a WordPress?
-
Selecciona el bloque de carrusel de diapositivas. Haz clic en el botón + para agregar diapositivas al carrusel.
-
How do I add an image carousel in Gutenberg?
-
Add the Carousel Slider block from the block inserter and upload images or create slides inside the block. Each slide can contain images, text, or other blocks.
-
Can I add multiple carousels on the same page?
-
Yes. You can add multiple Carousel Slider blocks to a page or post and each carousel will work independently.
-
Can I add images and text inside carousel slides?
-
Yes. Each slide can contain images, text, buttons, or other blocks depending on how you want to design your carousel.
-
Is the carousel mobile friendly?
-
Yes. The carousel is fully responsive and works on mobile phones, tablets, and desktop devices.
-
Can I use the carousel in posts and pages?
-
Yes. The Carousel Slider block works in both WordPress posts and pages anywhere the block editor is available.
-
How can I make the carousel performant in WordPress?
-
The Carousel Slider block uses the lightweight Swiper library for fast and smooth performance. For best results, use optimized images and enable lazy loading on any Image blocks inside slides so images load only when needed.
-
How do I make the slider update inside tabs, accordions, modals, or other dynamic layouts?
-
Use the Advanced Settings observer options when the slider or its surrounding layout changes after load. For custom integrations, you can also call
window.CarouselSliderBlock.init( container )orwindow.CarouselSliderBlock.update( container )after the layout changes. -
Why does the plugin use Swiper.js?
-
The Carousel Slider block uses the lightweight Swiper.js library because it provides fast, smooth, and responsive sliders. Swiper is widely used, mobile-friendly, and optimized for performance.
-
How do I add a slider to WordPress without coding?
-
Install the Carousel Slider plugin and add the Carousel Slider block to your page or post using the block editor.
Reseñas
Colaboradores & Desarrolladores
“Carousel Slider Block for Gutenberg” es software de código abierto. Las siguientes personas han contribuido a este plugin.
Colaboradores“Carousel Slider Block for Gutenberg” ha sido traducido en 12 idiomas. Gracias a los traductores por sus contribuciones.
Traduce “Carousel Slider Block for Gutenberg” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN, o suscríbete al registro de desarrollo por RSS .
Historial de cambios
2.1.1
- Improved PHP 8+ compatibility for the hidden settings page
2.1.0
- Added starter carousel patterns for hero, testimonials, and logos
2.0.10
- Stability fix
2.0.9
- Hid the legacy settings page from the admin menu while keeping direct URL access at
/wp-admin/options-general.php?page=cb-carousel-settings - Added advanced Swiper observer settings and updated documentation
- Increased default vertical spacing for navigation dots
2.0.8
- Simplified the labels in the editor panel
- Removed “v2” from block titles and added “v1” to legacy blocks
2.0.7
- Added pauseOnMouseEnter and disableOnInteraction to autoplay settings
- Exposed frontend carousel init() and update() APIs for tabs, accordions, and other hidden UI.
2.0.6
Additional CSS variables
2.0.5
Fix block insert
2.0.4
- Fix for hide legacy option
- Update plugin description
2.0.3
Removed block.json from legacy blocks
2.0.2
- Added custom CSS variable for pagination bullet gap
- Corrected documentation for navigation color variable
- Removed unnecessary max-width property blocking inner block widths in editor
2.0.1
- Changed legacy block setting to “Show legacy blocks”, disabled by default
- CSS update for pagination margin
2.0.0
- Introduced Carousel Slider v2 built on Swiper.js
- Legacy blocks are still supported but can be upgraded to v2 via block transforms
- Added settings to hide legacy blocks and legacy upgrade notices
1.0.16
Fix slider init.
1.0.15
Button block appender fix.
1.0.14
Actualiza las CSS para centrar bloques de imágenes.
1.0.13
Se revirtió Slick init a una solución funcional, fuera del proceso de construcción del bloque WP.
1.0.12
Agregada la dependencia de etiquetas.
1.0.11
Corregido el problema de diseño en filas.
Código de reprogramación.
1.0.10
Corregido el error de “lodash” con la última actualización de WordPress 6.4.
1.0.9
Corregido el mensaje de error en la pantalla del editor de widgets. Probado en WordPress 6.3.1.
1.0.8
Pequeñas mejoras de CSS en el editor. Se actualizó el uso de la hoja de estilos CSS. Probado en WordPress 6.0.
1.0.7
Agregado un conjunto adaptable para que las diapositivas se desplacen a la vez.
1.0.6
Se eliminó el problema de CSS con margen de bloque en las diapositivas.
Se cambió el estilo del botón “Agregar diapositiva”.
1.0.5
Se agregó “block.json”. Diseño de bloque de carrusel mejorado en el editor. Ícono de bloque de diapositiva actualizado. Probado para WordPress 5.9.
1.0.4
Experiencia de usuario mejorada mediante el uso de controles de bloques internos. Agregada la opción RTL. Eliminada la opción de relleno. Actualizado el ícono de bloque diapositiva.
1.0.3
Agregado los ajustes de la reproducción automática.
1.0.2
Actualización para la última versión de WP Gutenberg. Corregido el editor de CSS.
1.0.1
Corregido el problema de “lodash”.
1.0.0
Primera versión del plugin.





