=== Multipix ===
Contributors: mickyhood
Tags: gallery, slider, images, post, swiper
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a multi-image gallery to WordPress posts, shown as a slider, in addition to the native single featured image.

== Description ==

WordPress natively lets you assign only one "featured image" to each post. Multipix adds a meta box to the post editor that lets you select multiple images from the Media Library and show them as a swipeable slider right below the post's featured image, wherever the theme prints it. If the theme doesn't display the featured image at all, the slider is shown at the top of the post content instead.

Developed by Michele Bruno (Mickyhood) — [michelebruno.it](https://michelebruno.it)

Features:

* Meta box with multi-select from the Media Library, or drag-and-drop upload
* Reorder images via drag & drop
* Frontend slider based on Swiper.js: large image + clickable centered thumbnails below (touch swipe, arrows)
* Assets loaded only on posts that actually have a gallery
* No external CDN dependencies: all libraries are bundled with the plugin
* `[multipix_gallery]` shortcode for manual placement in builder-based themes (BeTheme, Divi, Elementor, WPBakery...)
* "Multipix" entry in the main WordPress menu, with a quick guide and options: enabled content types, main image size, navigation arrows

= Free vs Pro =

The free version is fully functional, with no limit on the number of images per gallery. A separate Pro add-on (in development) adds extra features on top, without touching the core files:

* Additional transition effects (coverflow, cube, advanced fade), autoplay, zoom
* Video slides in addition to images
* Out-of-the-box support for builder-based themes (no manual shortcode needed)

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin from the WordPress "Plugins" menu
3. Edit a post: in the "Image gallery (slider)" box, add and order your images
4. Publish or update the post to see the slider right below the featured image

= Themes with their own builder (BeTheme, Divi, Elementor, WPBakery...) =

These themes render the single post's featured image with a builder module/element instead of WordPress's native `the_post_thumbnail()` function. In that case the plugin can't hook in automatically right below the featured image, and falls back to showing the slider at the top of the content.

To get the slider exactly below the featured image even with these themes:

1. Open the single post template editor in the builder (in BeTheme: Muffin Builder → "Single Post" template)
2. Find the element/module that displays the featured image (in BeTheme: "Post Image" / "Featured Image")
3. Right after that element, add a "Shortcode" element (or a "Text/HTML" element with shortcodes enabled) with the content: `[multipix_gallery]`
4. Save: the slider will appear there, and the automatic fallback at the top of the content will no longer be shown, to avoid duplicates

== Frequently Asked Questions ==

= How many images can I add in the free version? =

There's no limit: the free version lets you add as many images per post as you like.

= Does it work with any theme? =

Yes. The plugin tries to hook in automatically right below the featured image; if the theme generates it with its own builder (BeTheme, Divi, Elementor, WPBakery...) instead of WordPress's native function, use the dedicated shortcode instead — see the "Installation" section above.

= Does the plugin send data from my site? =

The plugin integrates the Freemius SDK to handle an optional Pro license and updates. On activation an opt-in screen is shown: no data is sent unless you explicitly consent, and you can decline (the "Skip" option) without losing any free-version functionality. More information on Freemius's privacy policy: https://freemius.com/privacy/

= Is there a Pro version? =

It's in development. It will add extra transition effects, autoplay, zoom, video slides and more, without requiring any changes to the free plugin's files.

== Screenshots ==

1. "Image gallery" meta box in the post editor, with drag & drop and reordering
2. Frontend slider with main image and clickable thumbnails
3. Plugin settings page in the WordPress menu

== Changelog ==

= 1.0.0 =
* First release: gallery meta box + Swiper.js slider on the single post

== Upgrade Notice ==

= 1.0.0 =
First public release.