=== Rouergue Creation Carousel Style Query Loop ===
Contributors: rock4temps
Tags: post carousel,custom post type carousel,carousel,query loop,Gutenberg
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.txt

Adds a "Carousel" style mainly in CSS to the native WordPress Query Loop block.

== Description ==

This plugin enhances the Gutenberg Query Loop block by adding a new **"Carousel" style** 
that transforms the list of posts or CPT into a horizontal scrolling carousel, using only modern CSS.
  

Features: 
   
- Works with the native WordPress Query Loop block  
- "Carousel" style selectable in the **Styles** panel of the block settings
- By default, the carousel allows scrolling by pagination of three posts per page.  
- Navigation with built-in browser scroll buttons & markers  
- Responsive, compatible with desktop & mobile devices.

== Installation ==

1. From your site dashboard, go to Plugins -> Add New.
2. Search for "Native Block Carousel Query Loop"
3. Click install and activate the plugin  
3. In the block editor (Gutenberg), insert a **Query Loop** block  
4. In the block settings **Styles Panel**, select the **Carousel** style  
5. In the Block Settings, define a **Custom Query Type**, choose your **Post Type**, select a **number of items per page** greater than three, in Advanced settings **disable Reload Entire Page**.
  
== Frequently Asked Questions ==

= Is it compatible with all browsers? =  
The carousel uses recent CSS specifications.  
Currently, it is supported by **Chrome, Edge and Opera**.

Other browsers will display a standard Query Loop layout.  

= Does the plugin use JavaScript? =  
Yes, a **very lightweight JavaScript** is used solely to enable keyboard navigation with the arrow keys ← →.
The carousel's core functionality relies on **native CSS**.

= Is keyboard navigation possible? =  
Yes.  
 
- **Right arrow (→)**: next page
- **Left arrow (←)**: previous page
A loop mode allows you to return to the beginning or the end.

= Can I change the slider width? = 
To change the slider width, you can:

- Embed the Query Loop block within a Column block.
- You can also customize the carousel width by overriding the plugin's CSS file via your child theme,or via the tool in the Appearance/Customize/Custom CSS menu.
``` 
.wp-block-query.is-style-nbcql-carousel-query-loop{
   width:720px;
   max-width: 100%;
} 
``` 

== Screenshots ==

1. Selecting the "Carousel" style in the Query Loop block   
2. Example of the carousel display on the front-end  

## 🔍 Démo 
Discover the plugin in action on our [Demo Site](https://rouerguecreation.fr/demo-carousel-style-query-loop-2/)

## 🌍 Translations 
◆ English
◆ French

== Discover our other plugins ==
◆ [Easy Custom Event Tickets](https://wordpress.org/plugins/custom-event-tickets/)
◆ [Editor Custom Color Palette](https://wordpress.org/plugins/editor-custom-color-palette/)
◆ [Filter Bar Custom Post Type](https://wordpress.org/plugins/filter-bar-custom-post-type/) 
◆ [Rouergue Creation Top Notice Bar](https://wordpress.org/plugins/rouergue-creation-top-notice-bar/)
◆ [Rouergue Creation Events Sidebar](https://wordpress.org/plugins/rouergue-creation-sidebar-embed/) 
◆ [Slider Galerie Native Responsive](https://wordpress.org/plugins/slider-galerie-native-responsive/)

== Changelog ==

= 1.0.2 =

Modified

- Optimizing loading styles & JS script
- Recourse when the user has not disabled page reload in the advanced settings of the request loop block
- The number of carousel columns is no longer three by default, but is defined in the query loop block settings.

= 1.0.1 =

Added

- Added keyboard navigation using the ← → keys
- Added a loop mode for keyboard navigation
- Updated documentation

Corrected

- The Carousel style is not applied to the 
Query Loop block when multiple CSS classes are present.

= 1.0 =
* First stable version
* Added the "Carousel" style for the Query Loop block