Virgildia

<p>A responsive modern carousel slider for the Gutenberg block editor that lets you add any blocks to your slides.</p>
<p>🚀 <strong>Carousel Slider Version 2 is here!</strong> Now powered by <strong>Swiper.js</strong> for a smoother, faster, and more modern experience. See below for update instructions.</p>
<h4>Features</h4>
<ul>
<li>Add unlimited slides</li>
<li>Add any blocks to the slides</li>
<li>Preview the carousel in the editor</li>
<li>Responsive and touch enabled</li>
</ul>
<h4>Settings</h4>
<ul>
<li>Slides per view</li>
<li>Slides to scroll at a time</li>
<li>Slide speed</li>
<li>Slide padding</li>
<li>Prev/next arrows</li>
<li>Dots navigation</li>
<li>Infinite loop sliding</li>
<li>Autoplay</li>
<li>Responsive settings: slides to show and scroll at given screen size</li>
<li>RTL</li>
</ul>
<h3>Requirements</h3>
<p>PHP 5.6+ is recommended, WordPress 5.8+, with Gutenberg active.</p>
<h3>Documentation</h3>
<p>Select the Carousel Slider block from the Design category. Click the + button located at the end of the carousel to add slides. Add any block within the slides. Use the horizontal scrollbar to preview the slides in the editor.</p>
<p>You can reorder the slides by using the left and right arrow buttons in the toolbar.</p>
<p>To remove a slide, select the slide and click the three dots right above it. Click the option to remove that slide.</p>
<p>Click the Carousel Block (the block nesting all the slides) to show the carousel settings.</p>
<h3>Carousel Slider Version 2</h3>
<p>Carousel Slider v2 now uses Swiper.js instead of Slick. It’s more modern, better supported, and works smoother across devices.</p>
<h4>Upgrading from Legacy Carousel</h4>
<ul>
<li>Existing legacy (v1) Carousel Slider blocks will still work. You can re-enable them in the admin settings under <strong>Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Carousel Slider</strong>.</li>
<li>To upgrade, click on a legacy Carousel Slider block in the editor. In the block’s toolbar (the floating bar that appears above the block), click the <strong>block icon (first button on the left)</strong>. From the dropdown, choose <strong>“Transform to Carousel Slider v2”</strong>. Your existing carousel settings will be preserved, but note that the design and HTML markup will change.</li>
<li>Legacy styles will not apply to v2. You may need to adjust custom CSS. </li>
</ul>
<p><strong>Optional: Re-enable Legacy Blocks</strong></p>
<p>You can show/hide legacy blocks from the block inserter and disable v2 upgrade notices via <strong>Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Carousel Slider</strong> in the admin menu.</p>
<p><strong>Note</strong>: Legacy blocks will continue to function, but are no longer supported. It is highly recommended to upgrade to v2 for continued improvements and compatibility.</p>
<h4>Customizing v2 Styles</h4>
<p>Carousel Slider v2 supports custom styling via CSS variables:</p>
<h3>Navigation</h3>
<ul>
<li><code>--wp--custom--carousel-block--navigation-size</code>: Arrow icon size  </li>
<li><code>--wp--custom--carousel-block--navigation-sides-offset</code>: Distance from edge  </li>
<li><code>--wp--custom--carousel-block--navigation-color</code>: Arrow color  </li>
<li><code>--wp--custom--carousel-block--navigation-hover-color</code>: Arrow hover color (falls back to <code>navigation-color</code>)  </li>
<li><code>--wp--custom--carousel-block--navigation-alignfull-color</code>: Arrow color when carousel is full width  </li>
</ul>
<h3>Pagination (dots)</h3>
<ul>
<li><code>--wp--custom--carousel-block--pagination-top</code>: Top offset  </li>
<li><code>--wp--custom--carousel-block--pagination-bottom</code>: Bottom offset  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-size</code>: Bullet size  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-active-color</code>: Active bullet color  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-inactive-color</code>: Inactive bullet color  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-inactive-hover-color</code>: Inactive bullet hover color (falls back to <code>active-color</code> if set)  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-active-opacity</code>: Active bullet opacity  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-inactive-opacity</code>: Inactive bullet opacity  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-inactive-hover-opacity</code>: Inactive bullet opacity on hover (falls back to <code>inactive-opacity</code> if not set)  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-horizontal-gap</code>: Space between bullets (horizontal)  </li>
<li><code>--wp--custom--carousel-block--pagination-bullet-vertical-gap</code>: Space between bullets (vertical)  </li>
</ul>
<h3>Block Spacing</h3>
<ul>
<li><code>--wp--custom--carousel-block--image-margin-top</code>: Top margin for image blocks  </li>
<li><code>--wp--custom--carousel-block--image-margin-bottom</code>: Bottom margin for image blocks  </li>
<li><code>--wp--custom--carousel-block--cover-margin-top</code>: Top margin for cover blocks  </li>
<li><code>--wp--custom--carousel-block--cover-margin-bottom</code>: Bottom margin for cover blocks  </li>
</ul>
<h3>Theme JSON Support</h3>
<p>All the CSS variables can also be defined directly inside your theme’s <code>theme.json</code> under the <code>settings.custom</code> key.</p>
<p>For example:</p>
<pre><code>{
  "settings": {
    "custom": {
      "carousel-block": {
        "navigation-size": "22px",
        "navigation-color": "#000",
        "pagination-bullet-active-color": "#000"
      }
    }
  }
}
</code></pre>


Carousel Slider Block for Gutenberg

Finally a slider/carousel block that doesn't try too hard and is still easy and fun to use. It just needs a few additional sidebar settings (like slide gap and maybe custom icons for the prev/next navigation) and it would be perfect.

Thanks, i know i will be using this plugin A LOT in future projects - and for that it has definitely earned a full 5 star rating!

Almost perfect!

I tried several plugins and this one it's just perfect! Easy to use <3

Very simple and easy-to-use


I'm kind of an "old school" developer who is being dragged kicking and screaming into the world of the Block Editor (Gutenberg). One of my "old school" ideas is only using plugins for massive functionality (think WooCommerce, The Events Calendar, Gravity Forms), and not for things I can easily build myself. (Kind of ironic, since I've also developed a handful of plugins myself that don't follow that rule.)



Well… a week of fumbling around proved that at least in the new Gutenberg world, this is not something I can build myself, but I was still averse to using a plugin because in most of my past experience, using plugins with a narrow focus like this is that they a) aren't narrowly focused enough (trying to do too much), or b) they get in the way with too much of their own non-standard, over-designed interface elements.



I can safely say this plugin does not do any of that. It feels like it's a core part of Gutenberg… which it should be. I especially love (LOVE!) the fact that you can put any blocks into the carousel. That's exactly what I wanted/needed. The design is simple, intuitive, and unobtrusive.



I also really like the fact that in the Block Editor itself, the carousel is just a simple horizontal scrolling block. Very clever way to handle making the content editable and still feel fairly WYSIWYG, vs. trying to actually replicate the carousel functionality somehow on the back end.



The only problem I ran into was that the previous/next arrows and dot nav were rendering weirdly, but that was my own fault — some of my custom CSS was interfering. Once I adjusted that, everything is perfect.



If you're a long-time WordPress theme developer like I am, and you're resistant to Gutenberg, haven't learned React, and also are reluctant to start embracing more plugins… don't be afraid of this one! I just wish I had found this plugin sooner.


Excellent plugin for putting ANY blocks into a carousel


It is missing several basic Slick settings, though, like fade, centerMode, adaptiveHeight, variableWidth…


Nice and minimal

Thank you for a great little plugin.  It handles slides really well and the block settings are intuitive and allows for a lot of style variations and layouts.

I have a few ideas on how to further improve it.  Is is on GitHub?  I'd like to do a PR to contribute some code.

Some ideas for improvement:

- allow the slides to pause on mouse hover over the arrows or pagination dots.
- enable custom navigation by allowing a custom element with the right css to listen for click events.

Lovely little plugin

A responsive modern carousel slider for the Gutenberg block editor that lets you add any blocks to your slides.

Isamu Takeda

<p>An overview of the features is below.<br />
– Operate the slider plugins VEGAS2 and SWIPER using the block interface and provide blocks to display on the website.<br />
– Two blocks are bundled: <code>Fade MainView</code> which operates and displays VEGAS2 settings and <code>Slide MainView</code> which operates and displays SWIPER settings.<br />
– <code>Fade MainView</code> selects multiple images from the WordPress media library and displays them one by one. At that time, settings can be made by operating blocks to produce a variety of VEGAS2 effects.<br />
– <code>Slide MainView</code> is set to <code>Design Grorp</code> of <a href="https://ja.wordpress.org/plugins/block-collections/" rel="nofollow ugc">BLOCK COLLECTIONS plugin</a> as the SWIPER slide. Therefore, not only images, but also content such as text and tables can be displayed as SWIPER slides with a variety of effects.</p>
<h3>Related Links</h3>
<ul>
<li><a href="https://github.com/itmaroon/slide-blocks" rel="nofollow ugc">Github</a></li>
<li><a href="https://github.com/itmaroon/slide-blocks/tree/master" rel="nofollow ugc">source code</a></li>
<li><a href="https://github.com/itmaroon/block-class-package" rel="nofollow ugc">block-class-package:GitHub</a>  </li>
<li><a href="https://packagist.org/packages/itmar/block-class-package" rel="nofollow ugc">block-class-package:Packagist</a> </li>
<li><a href="https://www.npmjs.com/package/itmar-block-packages" rel="nofollow ugc">itmar-block-packages:npm</a>  </li>
<li><a href="https://github.com/itmaroon/itmar-block-packages" rel="nofollow ugc">itmar-block-packages:GitHub</a></li>
</ul>
<h3>Arbitrary section</h3>
<ol>
<li>Style settings that may require responsive support can be set separately for desktop mode (displayed on devices with a width of 768px or more) and mobile mode (displayed on devices with a width of 767px or less). To tell which setting is set, when you switch the display mode in the block editor or site editor, “(Desktop)” and “(Mobile)” will be displayed in the side menu display.<br />
Please note that responsiveness for tablet display is not supported.</li>
<li>This plugin depends on the <a href="https://ja.wordpress.org/plugins/block-collections/" rel="nofollow ugc">BLOCK COLLECTIONS plugin</a>. This plugin requires installation and activation in order to use it.</li>
<li>Regarding the display of text, etc., settings are made using WordPress’s internationalization function, so it is possible to display text in multiple national languages. Currently, English and Japanese notation is possible.</li>
<li>The Fade MainVeiw block uses VEGAS2. Regarding licenses, etc., please follow the following terms of use.<br />
<a href="https://github.com/jaysalvat/vegas" rel="nofollow ugc">Vegas – Backgrounds and Slideshows</a><br />
As of April 29, 2024, this plugin has been downloaded and used v.2.5.4.</li>
<li>The Slide MainView block uses SWIPER. Terms and conditions are listed on the next page.<br />
<a href="https://github.com/nolimits4web/swiper" rel="nofollow ugc">Swiper</a><br />
As of May 22, 2024, this plugin has been downloaded and is using v.11.1.3.</li>
<li>PHP class management is now done using Composer.<br />
<a href="https://github.com/itmaroon/block-class-package" rel="nofollow ugc">GitHub</a><br />
<a href="https://packagist.org/packages/itmar/block-class-package" rel="nofollow ugc">Packagist</a><br />
As of May 22, 2024, this plugin has been downloaded and is using v.1.1.1. </li>
<li>I decided to make functions and components common to other plugins into npm packages, and install and use them from npm.<br />
<a href="https://www.npmjs.com/package/itmar-block-packages" rel="nofollow ugc">npm</a><br />
<a href="https://github.com/itmaroon/itmar-block-packages" rel="nofollow ugc">GitHub</a></li>
</ol>


Slide Blocks

This block allows you to control slide plugins and customize the slider.

Carousel Slider Block for Gutenberg vs Slide Blocks