=== Billaviz Image Scrolling ===
Contributors: billaviz
Tags: gutenberg, slider, gallery, images, slideshow
Requires at least: 6.0
Requires PHP: 7.4
Tested up to: 7.1
Stable tag: 1.3.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight image slider block designed for the WordPress Gutenberg editor.

== Description ==
Billaviz Image Scrolling lets you create automatic image sliders directly inside Gutenberg. Select your images from the WordPress Media Library, configure the display and animation settings, and see a live preview while editing.


== Features ==
* One-Shot display mode: one image visible at a time, adapting to the width of the parent Gutenberg container.
* Strip display mode: multiple images visible at once, automatically fitted to the available container width.
* Autoplay on/off. If navigation arrows are hidden, autoplay is enabled automatically.
* Optional navigation arrows.
* Optional slide indicators.
* Fade, Slide and Zoom transitions.
* Adjustable pause time and transition speed.
* Optional stop on mouse hover.
* Original, Square 1:1, Standard 4:3, Portrait 3:4, Classic 3:2, Classic Portrait 2:3, Wide 19:9 and Tall 9:16 formats.
* Thumbnail, Medium and Full Size image quality.
* Crop images to fit.
* Adjustable block spacing.
* Responsive layout.
* The slider automatically follows the width of its Gutenberg parent container; width is not configured inside Billaviz Image Scrolling.
* Live Gutenberg editor preview.
* Automatic responsive multi-image carousel fitting in Strip mode based on available width, slider height, image format and spacing.

== Installation ==
1. Go to Plugins > Add New Plugin > Upload Plugin.
2. Upload the billaviz-image-scrolling.zip file.
3. Click Install Now and then Activate Plugin.
4. Open a Gutenberg page or post.
5. Add the Billaviz Image Scrolling block.
6. Select your images and configure the settings in the Block sidebar.

== Usage ==
Select images using the Media Library. Use Display mode to choose One-Shot or Strip, then configure the format, image quality, crop behavior, spacing, autoplay, navigation, indicators and animation. One-Shot shows one image at a time; Strip automatically fits multiple images to the available container width.

== FAQ ==

= What is the difference between One-Shot and Strip? =
One-Shot displays one image at a time and adapts it to the available container width. Strip displays multiple images at once and automatically calculates how many fit from the available width, slider height, format and spacing.

= Is Billaviz Image Scrolling a native Gutenberg block? =
Yes. Billaviz Image Scrolling is registered as a Gutenberg block and can be inserted directly from the WordPress block inserter.

= Does Billaviz Image Scrolling require another slider plugin? =
No. The plugin includes its editor controls and front-end slider behavior.

= How is the slider width determined? =
Billaviz Image Scrolling has no independent width setting. It follows the width supplied by its Gutenberg parent container, such as a Group or Column.

= Can I use many images? =
Yes. Select multiple images from the WordPress Media Library and manage the selection with Edit images.

= What happens when navigation arrows are hidden? =
Autoplay is enabled automatically so users can still move through the slides.

= What is the difference between pause time and transition speed? =
Pause time controls how long an image remains visible. Transition speed controls the duration of the visual transition.

= Does cropping modify the original image? =
No. Crop images to fit only changes how the image is displayed inside the selected format.

= Can Billaviz Image Scrolling be used inside Groups and Columns? =
Yes. It is designed to work as a standard Gutenberg block inside common Gutenberg layout blocks.

== Screenshots ==

1. Billaviz Image Scrolling block in the Gutenberg editor.
2. One-Shot display mode showing one image at a time.
3. Strip display mode showing multiple images fitted to the available container width.
4. Billaviz Image Scrolling block settings in the Gutenberg sidebar.

== Changelog ==

= 1.3.6 =
* Renamed the plugin to Billaviz Image Scrolling and updated the block name and repository slug for WordPress.org review.
* Updated plugin metadata and documentation to use the new distinctive identity.


= 1.3.3 =
* Updated the block to Block API version 3 for WordPress iframe editor compatibility.
* Updated repository metadata and licensing documentation for WordPress.org submission.

= 1.3.2 =
* Updated WordPress.org compatibility metadata for the current WordPress 7.1 release line.
* Updated internal block metadata to match the plugin release version.
* Final pre-submission documentation and metadata cleanup.

= 1.3.1 =
* Updated the View details documentation to fully describe One-Shot and Strip display modes.
* Updated the FAQ to reflect the One-Shot and Strip display mode system.
* Corrected the historical changelog version label.
* Added GPLv2 or later license metadata.

= 1.3.0 =
* Added One-Shot display mode for one image visible at a time.
* Added Strip display mode for responsive multi-image layouts.
* One-Shot adapts to the parent container width and selected image format.
* Added dedicated One-Shot transitions for Fade, Slide and Zoom.
* Updated the Gutenberg editor preview and controls for the two display modes.

= 1.2.3 =
* Removed the Billaviz Image Scrolling Width setting from the Display panel.
* Removed block-level Default, Wide and Full alignment support from Billaviz Image Scrolling.
* Billaviz Image Scrolling now always fills the width supplied by its parent Gutenberg container.
* Preserved automatic visible-image calculation based on real container width, slider height, image format and spacing.
* Improved behavior when Billaviz Image Scrolling is placed inside Gutenberg Groups, Columns and other layout containers.

= 1.2.0 =
* Reworked the multi-image carousel layout from a fixed slide count to dynamic width-based fitting.
* Added automatic calculation of visible images from the real available width, slider height, selected format and spacing.
* Added custom Slider height with Reset to automatic format ratio.
* Removed block-level width/alignment controls. Billaviz Image Scrolling now follows the width of its parent Gutenberg container.
* Improved Original format by calculating each image width from its own aspect ratio.
* Rebuilt the editor preview and front-end carousel around a horizontal track with responsive item widths.
* Removed the concept of a manually selected number of visible images.

= 1.1.4 =
* Rebuilt the editor asset with a unique filename to prevent stale browser/editor caching.
* Added working Slider height and Width controls to the Display panel.
* Added automatic responsive calculation of visible images from available width, height, format and spacing.
* Removed the fixed Visible images setting.
* Added an editor readout showing the automatically calculated number of visible images.
* Added Default, Wide and Full alignment behavior.
* Resetting Slider height restores the selected format ratio.


= 1.1.3 =
* Version metadata maintenance release.

= 1.1.1 =
* Replaced the manual visible-image count with automatic responsive fitting based on available width and slider height.
* Added multi-image carousel movement with one-image-at-a-time navigation.
* Preserved autoplay, arrows, indicators, hover pause, spacing, image quality, crop and format settings.
* Added multi-image support to the live Gutenberg preview.
* Improved responsive carousel rendering.

= 1.1.2 =
* Expanded the View details window with Description, Installation, FAQ and Changelog tabs.
* Added detailed English documentation and minimum requirements.
* Updated the promotional cover with fully English content.

= 1.0.14 =
* Fixed the View details link placement so it appears only in the standard plugin meta row.

= 1.0.12 =
* Moved View details into the standard plugin meta row, matching WordPress plugin conventions.

= 1.0.11 =
* Improved the Plugins page View details placement.
* Added the Billaviz Image Scrolling promotional cover to the View details popup.
* Removed duplicate Billaviz attribution from plugin row metadata.

= 1.0.10 =
* Added autoplay control.
* Added navigation arrows control.
* Added slide indicators control.
* Added interactive arrows and indicators to the editor preview.
* Added English interface and documentation.
* Added a View details plugin action with an English feature and installation overview.
* Added Billaviz attribution.


== Upgrade Notice ==

= 1.3.5 =
Renamed the plugin to Billaviz Image Scrolling and updated its WordPress.org repository identity.