=== Prime Slider Pro ===
Contributors: bdthemes
Donate link: https://bdthemes.com/
Tags: hero slider, content slider, elementor addon, image slider, video slider
Requires at least: 6.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 4.7.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Elementor requires at least: 4.0.0
Elementor tested up to: 4.3.3

Prime Slider Pro unlocks the premium widgets, skins and extensions of Prime Slider — the all-in-one slider addon for Elementor.

== Description ==

Prime Slider Pro is the premium extension of [Prime Slider](https://wordpress.org/plugins/bdthemes-prime-slider-lite/). It adds 40+ premium slider widgets, extra skins, WooCommerce sliders, remote navigation widgets and a set of handy site-wide features to the free plugin.

Everything is built for Elementor's drag-and-drop editor, so you can design a hero slider, post slider, product slider or a fully custom content slider without writing code.

**[Live Demo](https://primeslider.pro/demo/)** | **[Pricing](https://primeslider.pro/pricing/)** | **[Documentation](https://bdthemes.com/knowledge-base/prime-slider/)** | **[Support](https://bdthemes.com/support/)**

= Important =

Prime Slider Pro is an add-on. It requires both **Elementor** and the free **Prime Slider** (core/lite) plugin to be installed and active. The free plugin must be at least the version stated in `BDTPS_CORE_REQUIRED_VERSION`; if it is older, Pro shows an admin notice and stays inactive until you update it.

== Pro Widgets ==

= Post =

* [Fluent](https://primeslider.pro/demo/fluent/) - A full-width slider designed to create a dynamic and engaging blog interface.
* [Knily](https://primeslider.pro/demo/knily/) - A wide base display slider with floating thumb tabs for showcasing content in style.
* [Marble](https://primeslider.pro/demo/marble/) - A unique slider that presents posts like a horizontal timeline with customizable options.
* [Material](https://primeslider.pro/demo/material/) - A clean and professional slider that gives your content a polished and sophisticated look.

= Custom =

* [Astoria](https://primeslider.pro/demo/astoria/) - Elegant slider for hero pages with social share buttons for a more engaging visitor experience.
* [Avatar](https://primeslider.pro/demo/avatar/) - Creative image slider with a breathtaking interface to take your content to the next level.
* [Cards Stack](https://primeslider.pro/demo/cards-stack/) - Stacked card layout that reveals each slide as the visitor moves through the stack.
* [Cloud](https://primeslider.pro/demo/cloud/) - Floating, cloud-like item layout with adjustable item height and mobile-friendly navigation.
* [Coddle](https://primeslider.pro/demo/coddle/) - A simple, elegant slider perfect for delivering key content with seamless transitions.
* [Crossroad](https://primeslider.pro/demo/crossroad/) - A fun and unique slider for displaying posts with a new concept of art.
* [Custom](https://primeslider.pro/demo/custom/) - Create your own custom template and select it in the custom slider to personalize your design.
* [Escape](https://primeslider.pro/demo/escape/) - Escape slider offers a bold design with creative navigation and animations for a modern site look.
* [Expo](https://primeslider.pro/demo/expo/) - Showcase-style slider built for presenting featured work and products.
* [Flexure](https://primeslider.pro/demo/flexure/) - Full-width slider with background synchronization and a tab-like layout to change images by hovering over titles.
* [Fortune](https://primeslider.pro/demo/fortune/) - Fortune slider makes showcasing content easy with dynamic transitions and engaging effects.
* [Glasco](https://primeslider.pro/demo/glasco/) - Glassmorphism-inspired slider with soft, translucent panels.
* [Monster](https://primeslider.pro/demo/monster/) - A minimalistic content slider for featured posts or products with a full-width layout and smooth navigation.
* [Motion](https://primeslider.pro/demo/motion/) - Animated slider featuring smooth motion effects and kinetic elements for enhanced user engagement.
* [Pandora](https://primeslider.pro/demo/pandora/) - A sleek, dynamic slider with fluid transitions and a modern design.
* [Panorama](https://primeslider.pro/demo/panorama/) - Wide, panoramic viewport slider for immersive full-scene imagery.
* [Paranoia](https://primeslider.pro/demo/paranoia/) - A unique, eccentric slider with fun post layout animations for a memorable user experience.
* [Pieces](https://primeslider.pro/demo/pieces/) - Futuristic slider designed for blog sites with engaging, fun animations and transitions.
* [Prism](https://primeslider.pro/demo/prism/) - The pristine slider is designed to capture attention with centered item images and a clean background.
* [Reveal](https://primeslider.pro/demo/reveal/) - A slider with active reveal transitions designed to boost user engagement and attention.
* [Ring](https://primeslider.pro/demo/ring/) - Circular, ring-shaped slider with reaction and close controls.
* [Super Flow](https://primeslider.pro/demo/super-flow/) - Flowing, continuous slider with rich pagination styling options.
* [Titanic](https://primeslider.pro/demo/titanic/) - Titanic slider offers stunning, large-scale content slides for impactful presentations.
* [Turnar](https://primeslider.pro/demo/turnar/) - Dynamic slider with rotating elements and interactive transitions for captivating visual storytelling.

= Remote Control =

* [Remote Arrows](https://primeslider.pro/demo/remote-arrows/) - Separate the navigation from sliders and use remote arrows to control them from a different place on your site.
* [Remote Fraction](https://primeslider.pro/demo/remote-fraction/) - Add fraction navigation to any slider, regardless of its position, with this remote control widget.
* [Remote Pagination](https://primeslider.pro/demo/remote-pagination/) - Display the number of posts left in the query with remote pagination for enhanced user interaction.
* [Remote Thumbs](https://primeslider.pro/demo/remote-thumbs/) - Link a thumb gallery to any slider to make it more interactive and visually appealing.

= WooCommerce =

* [Woo HotSpot](https://primeslider.pro/demo/woohotspot/) - WooCommerce-focused slider designed to make product discovery easier for customers.
* [Wooexpand](https://primeslider.pro/demo/wooexpand/) - Accordion-style slider fully integrated with WooCommerce for better product showcasing.
* [WooStand](https://primeslider.pro/demo/woostand/) - An eye-grabbing WooCommerce slider to present featured products with smooth transitions.

= 3rd Party =

* [Event Calendar](https://primeslider.pro/demo/event-calendar/) - Display event countdowns and details in a beautifully designed calendar slider.

= Handy Extension =

* [Adaptive Background](https://primeslider.pro/demo/adaptive-bg/) - Automatically adjusts the background image or color based on the content to create dynamic, engaging visuals.

== Pro Features ==

* **White Label** — rebrand the plugin (name, icon, hide license and branding) from a dedicated settings tab.
* **Version Rollback** — restore a previous Prime Slider Pro version from an automatic backup.
* **Custom CSS & JS** — add custom CSS and JavaScript to the site header and footer, with a per-page exclusion list.
* **Skins** — extra premium skins for the free core widgets.
* **WPML support** — multilingual slider content.
* **RTL ready** — right-to-left stylesheets are generated for every module.

== Installation ==

1. Make sure [Elementor](https://wordpress.org/plugins/elementor/) and the free [Prime Slider](https://wordpress.org/plugins/bdthemes-prime-slider-lite/) plugin are installed and active.
2. Upload the `bdthemes-prime-slider` folder to `/wp-content/plugins/`, or install the zip through **Plugins → Add New → Upload Plugin**.
3. Activate **Prime Slider Pro** through the **Plugins** menu in WordPress.
4. Go to **Prime Slider → License** and activate your license key to enable updates.
5. Edit any page with Elementor and search for the Prime Slider widgets in the widget panel.

== External services ==

This plugin connects to the following external services. In each case only the data described is sent, and only under the stated conditions.

1. **Prime Slider Licensing & Updates** (`https://primeslider.pro`) — used to activate/deactivate your license and to deliver plugin updates. The license key, site URL and plugin version are sent when an administrator activates, deactivates or checks a license, and when WordPress checks for plugin updates. Provided by BdThemes — see the [Terms of Use](https://bdthemes.com/terms-of-use/) and [Privacy Policy](https://bdthemes.com/privacy-policy/).

2. **Vimeo oEmbed** (`https://vimeo.com/api/oembed.json`) — used by video slider widgets to fetch the dimensions/thumbnail of a Vimeo video the site owner has embedded. The public Vimeo URL entered by the site owner is sent to Vimeo when such a slide is rendered. Provided by Vimeo — [Terms of Service](https://vimeo.com/terms), [Privacy Policy](https://vimeo.com/privacy).

== Source Code and Build Process ==

This plugin is not obfuscated. The complete, human-readable source for every minified/compiled asset is bundled inside the plugin, in the `src/` directory:

* `src/js/` — uncompiled JavaScript for the front-end, editor, admin and per-module scripts.
* `src/less/` — the LESS source that compiles to the CSS in `assets/css/`.
* `src/admin/`, `src/images/`, `src/fonts/` — admin scripts, images and fonts.

The compiled/minified files in `assets/` are generated from `src/` with [Grunt](https://gruntjs.com/). To rebuild them:

1. Install dependencies: `npm install`
2. Run the build: `npm run build` (or `npx grunt`)

The build configuration is in `gruntfile.js` and `package.json`. Bundled third-party libraries — GSAP, SplitText, anime.js, RevealFx, Splitting, Charming, Popper, Tippy and the UI Initiative swiper effects (Shutters, Swiper GL, Slicer, Tinder, Cards Stack, Expo, Panorama, Material) — retain their original license/version header comments identifying their upstream source. The UI Initiative effects are licensed to BdThemes and are distributed only with this paid plugin.

== Frequently Asked Questions ==

= Do I need the free Prime Slider plugin? =

Yes. Prime Slider Pro is an add-on for the free plugin and will not load without it. It also requires the free plugin to be at least the minimum version defined in `BDTPS_CORE_REQUIRED_VERSION`; if it is older you will see an admin notice asking you to update.

= Do I need Elementor? =

Yes. Elementor (free) 4.0.0 or newer is required.

= Why do I see "your Free/Core version is not sufficient"? =

Update the free Prime Slider plugin to the latest version. Pro and the free core are released together, and Pro needs the matching base functions.

= Where do I activate my license? =

In the WordPress admin, go to **Prime Slider → License**, paste your key from your [BdThemes account](https://bdthemes.com/account/) and click activate.

= Is Prime Slider Pro translation ready? =

Yes. Translation files live in the `/languages` directory and the plugin uses the `bdthemes-prime-slider` text domain. WPML is supported.

= Does it work with WooCommerce? =

Yes. Wooexpand, WooStand and Woo HotSpot are built specifically for WooCommerce products.

== Changelog ==

= 4.7.0 [6th October 2026] =

* Fixed: The Advanced Animation's Animation Of setting passed any saved value to the front-end script. It now only accepts the selectors the control offers
* Fixed: Vendor library handles (GSAP, Tippy, Popper, anime.js and others) are now prefixed with bdtps- so they no longer clash with Element Pack's copies
* Changed: The slider effects stylesheet loads only on pages that use a Prime Slider widget
* Changed: Widget CSS and JS depend on UIkit and the free plugin's helper, so pages without a Prime Slider widget load none of them
* Changed: Widget files join the free plugin's combined CSS and JS when its Asset Optimization option is on

= 4.6.0 [10th September 2026] =

* Fixed: The licence and update client retried with TLS certificate verification turned off whenever the first attempt failed. A failed request now fails outright instead of falling back to an unverified connection
* Fixed: Rollback backups written to the uploads folder were protected only by a directive that Apache 2.4, nginx and LiteSpeed ignore, and their filenames were predictable. Existing backups are renamed and re-protected automatically on the next admin page load
* Fixed: The rollback handler read its version parameter without first checking that it was present
* Changed: An update package is now only accepted from an https address
* Changed: The client IP helper no longer trusts forwarding headers supplied by the caller. Sites behind a reverse proxy or CDN can opt back in with the new prime_slider_trusted_proxies filter
* Changed: The base64 helpers call the encode and decode functions directly instead of assembling their names at run time
* Changed: Removed the unused uglify build dependency, clearing every critical advisory reported against the development toolchain

= 4.5.2 [31st August 2026] =

* Added: Advanced Animation and Reveal Effects now live in this plugin, together with the GSAP, SplitText, anime.js and RevealFx engines that drive them. They are added back to the free plugin's sliders automatically while this plugin is active
* Added: The Shutters, GL, Slicer and Tinder swiper effects and their libraries now ship here, and are restored on the shared Swiper Effect control for this plugin's widgets
* Changed: The license page, the renewal redirect and the extended-license promotion rules moved out of the free plugin and into this one
* Changed: Widgets now request the free plugin's prefixed script handles
* Fixed: The Knily widget asked for a script handle that is registered under a different name, so its social share library never loaded

= 4.5.0 [17th August 2026] =

* Added: Version Rollback — restore a previous Prime Slider Pro version from an automatic backup
* Added: White Label — rebrand the plugin (name, icon, hide license/branding) from a dedicated settings page
* Added: Custom CSS & JS — add custom CSS and JavaScript to the site header and footer, with a per-page exclusion list
* Improved: Version Rollback, White Label and Custom CSS/JS now appear as tabs inside the Prime Slider dashboard

= 4.4.4 [26th July 2026] =

* Added: Tooltip text color and background controls added to the custom and fluent widgets
* Fixed: Output escaping issues in multiple widgets

= 4.4.3 [1st July 2026] =

* Updated: System improved

= 4.4.2 [29th June 2026] =

* Fixed: Style controls visibility issue fixed in the avatar widget
* Fixed: Thumbnail title color now applies correctly in the coddle widget

= 4.4.1 [15th June 2026] =

* Added: Wrapper border and border radius controls added to the ring widget
* Fixed: Corrected pagination bullet opacity behavior in the super flow widget
* Fixed: Padding issues for the close and reaction buttons in the ring widget

= 4.4.0 [3rd June 2026] =

* Added: New ring widget added
* Added: Text limit and strip shortcode controls added to the wooexpand widget
* Added: Loop control added to the woo hotspot widget with proper rewind handling for the tinder effect
* Fixed: White label issue fixed for AppSumo License
* Fixed: Swiper GL effect functioning issue fixed in the fortune widget

= 4.3.2 [21st May 2026] =

* Fixed: Grab Cursor and Pause on Hover issues in the avatar and fortune widgets
* Updated: Made compatible with WordPress version 7.0

= 4.3.1 [13th May 2026] =

* Fixed: Viewport issue fixed in the panorama widget

= 4.3.0 [12th May 2026] =

* Added: Panorama widget added

= 4.2.1 [10th May 2026] =

* Added: Item height and hide arrows on mobile controls to the cloud widget
* Added: New pagination styling controls to the super flow widget

= 4.2.0 [27th April 2026] =

* Added: Expo widget added
* Added: Cloud widget added
* Added: Super Flow widget added
* Added: Cards Stack widget added
* Added: Automatic pagination item generation added in Remote Pagination widget
* Added: Automatic thumbs item generation added in Remote Thumbs widget
* Added: Arrow size and position (vertical and horizontal offset) controls, along with dot height and vertical offset controls in the wooStand widget
* Fixed: Remote fraction delay loading issue fixed
* Fixed: WooStand widget slideshow dot navigation wrapping into multiple rows with higher item counts; dots now distribute evenly using percentage-based layout
* Fixed: Alignment issue fixed in the event calendar widget

= 4.1.1 [2nd February 2026] =

* Fixed: License activation via theme for extended user issue fixed
* Updated: White label improved

= 4.1.0 [28th January 2026] =

* Added: New (full circle) layout to the motion widget
* Added: WPML multi language support added
* Fixed: Hard-coded issues in the flexure, knily, monster, paranoia, pieces and prism widgets

= 4.0.6 [6th January 2026] =

* Added: Navigation vertical offset added in motion widget

= 4.0.5 [9th December 2025] =

* Added: Autoplay added in astoria widget

= 4.0.4 [13th November 2025] =

* Updated: Notice design improved

= 4.0.3 [13th November 2025] =

* Fixed: Notice issue fixed

= 4.0.2 [9th November 2025] =

* Updated: Motion widget improved

= 4.0.1 [3rd November 2025] =

* Fixed: Navigation icon not showing issue fixed in motion widget

= 4.0.0 [28th October 2025] =

* Added: Turnar widget added
* Added: Motion widget added
* Added: White Label feature added
* Added: Custom CSS & JS feature added
* Added: Setup wizard / onboarding feature added
* Added: Rollback version feature added in admin dashboard
* Added: Improved web accessibility for navigation arrows across multiple widgets
* Fixed: Title show/hide issue fixed in pieces widget
* Updated: Security improved
* Updated: Admin dashboard updated

The complete history of older releases is available in `changelog.txt` and in the [changelog announcements](https://feedback.bdthemes.com/announcements?category=category_7wo5zoxl).
