=== Logo Slider WP Pro ===
Contributors: LogicHunt, themearth, vaskarjewel
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=vaspal.kt@gmail.com&lc=US&item_name=LogicHunt&item_number=wp&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted
Tags: logo slider, logo carousel, logo showcase, logo gallery, client logos
Requires at least: 5.8
Tested up to: 7.1
Stable tag: 6.1.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Show client logos and WooCommerce brand logos in a responsive logo slider, carousel, grid or flexbox layout, with a Gutenberg block or shortcode.

== Description ==

👉 [Live Demo](https://demo.logichunt.com/logo-slider-wp/) | [Documentation](https://docs.logichunt.com/logo-slider-wp/) | [Support](https://logichunt.com/support/) | [Get Pro](https://logichunt.com/product/wordpress-logo-slider/)

**Logo Slider WP** shows logos on your WordPress site: the client, sponsor and partner logos you upload, and — new in 6.1.0 — the brand logos of your WooCommerce store. Display them as a responsive logo slider, logo carousel, grid or flexbox showcase with a native Gutenberg block, a shortcode or PHP. No page builder and no coding needed. Unlimited logos, three layout types, and a full visual Showcase Builder are free, not a trial.

The Free edition includes both logo sources, the Gutenberg block, the shortcode and the Showcase Builder with live preview. Pro adds more styling options, hover effects, Ticker mode and brand selection.

* Two logo sources in one plugin: your own Logo Library or your WooCommerce Brands
* Unlimited logos, unlimited showcases — no artificial caps on the Free edition
* Native Gutenberg block, plus shortcode and PHP function support for any theme or builder
* A real visual Showcase Builder — Carousel, Grid, and Flexbox layouts, live preview as you configure
* Category filtering, drag-and-drop ordering, and per-logo links — all Free

= Two logo sources in one plugin =

Every showcase starts with one choice in the **Content Source** panel: where do the logos come from?

**Logo Library — your own logos.** Upload client, partner, sponsor or team logos, give each one a name, link, tooltip and category, and order them by drag and drop. Works on every WordPress site.

**WooCommerce Brands — the brands you sell.** Show the brands from **Products → Brands** without uploading anything twice. Each brand shows its own logo (the brand thumbnail) and can link to its brand page. The showcase reads your brands directly from WooCommerce.

Both sources share the same layouts, styling options, live preview, Gutenberg block and shortcode. You can switch a showcase to the other source at any time, and all its other settings are kept.

= WooCommerce brand logo slider =

Turn your store's brands into a brand logo slider, carousel or grid in three steps:

1. Give each brand a thumbnail image under **Products → Brands**.
2. In **Logo Slider → Showcases**, create a showcase and pick **WooCommerce Brands** in the Content Source panel.
3. Choose Carousel, Grid or Flexbox and add the showcase to any page with the block or shortcode.

**Free:** show every brand that has a logo and at least one product, so the showcase has no empty tiles. Sort them by name, by the order they were added or at random, set how many to show, and use every Free display control.

**Pro:** choose or exclude specific brands with a searchable list, show brands without a logo as their name, and show brands that have no products.

This source needs WooCommerce with its Brands feature active (Products → Brands). Brands is part of WooCommerce and is on by default from version 9.6. If WooCommerce is turned off, the showcase keeps its settings and shows no logos until it is active again.

= What's new in 6.1.0 =

* New **Content Source** panel: choose the Logo Library or WooCommerce Brands for each showcase.
* The brand source is Free, with Pro controls for brand selection and display.
* Safer brand settings: a stored brand setting the builder does not recognise is shown as "Unknown" and kept, never changed silently.
* The texts shown by the Showcase Builder script can now be translated.
* Your existing logos, showcases and shortcodes are not changed by this update.
* Requires WordPress 5.8 or later and PHP 7.4 or later.

= Showcase types =

**Carousel** — a smooth, auto-scrolling slider. Best for a compact header or footer sponsor strip.
**Grid** — an evenly-spaced grid layout. Best for a dedicated "Our Clients" or "Partners" page.
**Flexbox** — a flexible, wrapping layout with full alignment control. Best when logo sizes vary and you want them to sit naturally together.

= Perfect for =

* Agencies showcasing client work
* WooCommerce stores showing the brands they sell
* SaaS and software companies displaying integration partners
* Conferences and events listing sponsors
* Membership and community sites crediting supporting brands
* Any site that needs "as seen in" or "trusted by" social proof

= Why Logo Slider WP =

**One plugin for logos and brands**
Use the same builder for your client logos and your store's brands — no second slider plugin needed.

**Live Preview in the Editor**
With our native Gutenberg block, see exactly how your slider looks without leaving the WordPress editor.

**Show all logos without front-end display limits**
Every logo you add is shown in full — no hidden caps, no upgrade required.

**Full visual control from the admin panel**
Colours, spacing, borders, backgrounds, image dimensions, and alignment — all adjustable.

**Direct support from the plugin developers**
All users — Free and Pro — get direct support at the [LogicHunt Support Center](https://logichunt.com/support/). Pro users receive priority handling.

= Free vs Pro =

**✅ FREE:**

**Display & Layouts**
* Native Gutenberg block
* Carousel, Grid & Flexbox showcase types
* Unlimited logos — no display cap
* Multiple independent showcases per page
* Content source: Logo Library or WooCommerce Brands

**Logo Management**
* Category-based filtering
* Drag-and-drop logo ordering
* Per-logo link URL
* Brand source: show every brand with a logo and at least one product; sort by name, order added or random
* Brand name show/hide
* Logo height & width control (Max Width unlocked)
* Logo position & info alignment

**Responsive**
* Independent column count for mobile, tablet, desktop, and large desktop

**Carousel Controls**
* Autoplay, delay, transition speed & infinite loop
* Pause on hover
* RTL direction support
* Touch swipe & simulated touch
* Standard slide transition
* Navigation arrows (on/off, icon choice)
* Navigation arrow color & spacing controls
* Navigation border (on/off, color, width, style)
* Pagination dots (on/off, color)

**Design & Styling**
* Grid column/row gaps & outline color
* Flexbox gaps, align items, and basic justify-content (Start, Center)
* Brand name color, size & top margin
* Description color, size & top margin (apply when descriptions are shown with Pro)
* Logo image border (color, width, radius)
* Item padding & margin

**Section & Header**
* Section header (title, subtitle) on/off
* Section width & container
* Section background color
* Section margin

**Advanced**
* Preloader (hides showcase until fully loaded)
* Tooltip (position, min/max width, on/off)

**⭐ PRO:**

**Display & Layouts**
* Ticker mode (continuous non-stop scroll)

**Logo Management**
* Link target (new tab) & nofollow attribute
* Brand source: choose or exclude specific brands, show brands without a logo as text, show brands without products
* Brand/item description field
* Logo width sizing modes beyond Max Width (Width, Min Width)

**Carousel Controls**
* Mouse wheel navigation & grab cursor
* Coverflow 3D transition
* Item vertical alignment & auto height
* Lazy loading
* Advanced navigation arrows (custom button type/text, hover state, mobile visibility)
* Navigation position & sizing controls
* Navigation border radius
* Advanced pagination (mobile visibility, dynamic bullets)

**Design & Styling**
* Advanced grid styling (grid style, item min height, image vertical align)
* Advanced flexbox controls (wrap, direction, full justify-content options)
* Brand name font weight & bottom margin
* Description font weight & bottom margin
* Item card border (color, width, radius)
* Item card background color
* Hover effects on logo items (grayscale, box shadow, overlay with link or title) and hover animations

**Section & Header**
* Section header typography (alignment, size, color, weight, margins)
* Section background image
* Section padding

**Advanced**
* Branded preloader (custom icon & background color)
* Advanced tooltip (animation, trigger, colors, border, arrow, timing)

👉 [View Pro features & upgrade →](https://logichunt.com/product/wordpress-logo-slider/)

= Per-logo fields (Logo Library) =

WooCommerce Brands uses each store brand's name, thumbnail and brand page. Each Logo Library entry supports:

* Brand Name and Logo Image (the two required fields)
* Website URL (leave empty for a logo that is not clickable)
* Tooltip (uses the Brand Name until you change it)
* Alt Text (uses the Brand Name until you change it)
* Custom Brand Name (show a different name without renaming the logo)
* Description (shown with Pro, in layouts that support descriptions)
* Categories (used for category filtering)


= Embedding methods =

**Gutenberg Block (recommended).** Search "Logo Slider WP" in the block inserter, select a showcase, done — live preview right in the editor.

**Shortcode.** `[lgxlogoslider id="X"]` — works in any theme, page builder, or widget area that renders shortcodes.

**PHP function.** For theme developers: `<?php echo do_shortcode('[lgxlogoslider id="X"]'); ?>`

= Support =

Direct support from the developers who built the plugin.

**Ready to get started? Download Logo Slider WP for free today!**


== Installation ==

= Option 1: From the WordPress dashboard (recommended) =

1. Go to **Plugins → Add New**.
2. Search for **"Logo Slider WP"**.
3. Click **Install Now**, then **Activate**.

= Option 2: Upload a ZIP file =

1. Download `logo-slider-wp.zip` from WordPress.org.
2. Go to **Plugins → Add New → Upload Plugin**.
3. Select the ZIP and click **Install Now**, then **Activate**.

= Option 3: Manual FTP =

1. Unzip `logo-slider-wp.zip` and upload the folder to `/wp-content/plugins/`.
2. Activate from **Plugins** in your WordPress dashboard.

After activation, **Logo Slider** appears in your admin sidebar.


= Quick start =

1. **Add logos** — go to **Logo Slider → Logos**, then click **Add New Logo**. Upload your image, set the brand name, URL, and category.
2. **Create a showcase** — go to **Logo Slider → Showcases**, then click **Create Showcase**. Choose Carousel, Grid, or Flexbox and configure your settings.
3. **Embed via Gutenberg** — add the **Logo Slider WP** block to your page and select your showcase from the dropdown. See a live preview instantly!
4. **Embed via Shortcode (Alternative)** — paste the generated shortcode (e.g. `[lgxlogoslider id="39"]`) into Elementor, Divi, or any page builder.


== Frequently Asked Questions ==

= How do I display logos on my page? =

**Step 1:** Go to **Logo Slider → Showcases**, then click **Create Showcase**.
**Step 2:** Embed it on your page using one of these methods:
* **Method A (Recommended):** Add the native **Logo Slider WP Block** in the Gutenberg editor. Select your newly created showcase from the dropdown and enjoy a live preview!
* **Method B:** Copy the generated shortcode (e.g., `[lgxlogoslider id="39"]`) and paste it into Elementor, Divi, WPBakery, or any other page builder.

= Can I show WooCommerce brand logos in a slider or carousel? =

Yes. Since version 6.1.0 a showcase can use **WooCommerce Brands** as its content source. Create a showcase, pick that source in the Content Source panel and choose Carousel, Grid or Flexbox. The logos are the brand thumbnails you set under **Products → Brands**. When the link option in the Essential panel is on, each logo links to its brand page.

= Which brands are shown, and can I choose them? =

Free shows every brand that has a logo and at least one product, sorted by name, by the order added or at random. Pro lets you show only selected brands or exclude some, show brands without a logo as text, and show brands without products.

= Do I need WooCommerce? =

No. It is needed only for the brand source. The Logo Library works on any WordPress site.

= What happens to a brand showcase if WooCommerce is turned off? =

Its settings are kept and stay editable, and it shows no logos until WooCommerce is active again. You can also switch the showcase back to the Logo Library at any time.

= Can I switch between shortcode and block? =

Absolutely! The shortcodes and the new Gutenberg block share the exact same showcases. You can use a shortcode on one page, and the block on another. Both render the same showcase with the same settings.

= Does the block affect existing shortcodes? =

No. If you have been using Logo Slider WP for a while, all of your existing shortcodes remain completely intact and will function perfectly as they always have. Neither method is deprecated.

= Does the block work in Full Site Editing? =

The native Gutenberg block and shortcode both work within FSE-based sites through their normal output — insert the block or shortcode into any template area that renders blocks or shortcodes. This isn't a dedicated FSE-specific integration.

= Is the block available in Free? =

Yes! The full native Gutenberg block experience is available right now in both the Free and Pro versions.

= Is there a logo display limit in the free version? =

No. The 20-logo cap is permanently removed. Item Limit defaults to -1, which shows all logos (0 also means unlimited).

= Does this plugin work with Elementor, Divi, WPBakery? =

Yes. Paste `[lgxlogoslider id="39"]` into:
* **Elementor** — Shortcode widget
* **Divi** — Code module
* **WPBakery** — Text Block element
* **Beaver Builder** — HTML module

= Can I run multiple showcases on the same page? =

Yes. Each showcase is fully independent. Different types, settings, and logo sets — no conflicts. Feel free to stack multiple blocks on a single page!

= Can I add custom CSS? =

Yes. Each showcase has a unique wrapper class. Add CSS via **Appearance → Customize → Additional CSS** or your theme's CSS field.

= What is the difference between free and Pro? =

Free covers all three layout types, unlimited logo display, the native Gutenberg Block, category filtering, WooCommerce Brands as a content source, responsive control, RTL direction, preloader, and full shortcode compatibility. Pro adds brand selection, hover effects (grayscale, box shadow and overlays), hover animations, Coverflow 3D, full typography control, background images, branded preloader, ticker mode, and priority developer support.

= Is there a live demo? =

Yes — [demo.logichunt.com/logo-slider-wp](https://demo.logichunt.com/logo-slider-wp/)

= Does this work on WordPress Multisite? =

Logo Slider WP hasn't been fully tested on WordPress Multisite networks yet.

= Is Logo Slider WP translation ready? =

Yes. A `.pot` file is included, so you can translate the plugin with standard WordPress translation tools such as Loco Translate, WPML, or Polylang.

= Can I use SVG logos? =

Yes. Logo Slider WP can display SVG logos when your WordPress site allows SVG uploads.

= How do I get support? =

Both Free and Pro users get direct help at the [LogicHunt Support Center](https://logichunt.com/support/) — Pro users receive priority email handling.


== Screenshots ==

1. Carousel showcase on the frontend
2. Grid showcase on the frontend
3. Flexbox showcase on the frontend
4. Carousel showcase with the Coverflow transition
5. Team Slider Showcase — an example of using Logo Slider WP to present team members instead of company logos
6. The Dashboard
7. Help & Resources
8. Showcase Builder — Content tab
9. Showcase Builder — Style tab, live preview updating as settings change
10. The Logos list
11. Categories
12. The Gutenberg block in the editor, live preview visible


== Upgrade Notice ==

= 6.1.0 =
Adds WooCommerce Brands as a second logo source and a Content Source panel in the Showcase Builder. Requires WordPress 5.8+ and PHP 7.4+. Your existing logos, showcases and shortcodes are not changed.

= 6.0.0 =
A full rebuild of the Showcase Builder — the old settings-tab interface is replaced with a single-page, live-preview editor. Category filtering is now Free, and your existing logos, showcases, and shortcodes carry over.

= 5.5.5 =
The Native Gutenberg Block is here! Insert, preview, and switch your logo showcases seamlessly inside the Block Editor without memorizing shortcodes.

= 5.5.4 =
Security: Fixed stored XSS vulnerability. Fixed dynamic CSS not rendering for carousel navigation buttons.


== Changelog ==

= 6.1.0 =
* New: WooCommerce Brands as a second content source (Free). Show your store's brand logos, sorted by name, order added or at random. Each logo links to its brand page when the link option is on.
* New: Content Source panel in the Showcase Builder to choose between your own logos and your store's brands. Switching source keeps all other settings.
* New (Pro): choose or exclude specific brands with a searchable brand list, show brands without a logo as text, and show brands without products.
* New: A stored brand setting that matches no option is shown as "Unknown (value)" and kept when you save.
* Improvement: The live preview follows the same Pro rules as saving.
* Improvement: Showcase Builder script texts are translatable.
* Improvement: Brand name text, the empty-state message and the editor hint have front-end styles.
* Hardening: Field labels in builder notes are escaped.
* Tweak: Requires WordPress 5.8 and PHP 7.4.
* Tested: WordPress 7.1

= 6.0.0 =
* New: Full Showcase Builder rebuild — single-page, live-preview admin experience
* New: Category filtering now available in the Free edition
* New: Automatic demo content seeding on fresh activation
* Fix: Logo max-height/width settings no longer silently overridden by conflicting values
* Fix: Free-mode rendering corrected for the four real Logo Height/Width fields
* Fix: Text-domain usage corrected across 584 strings for reliable translation loading
* Fix: Corrected a broken CSS media-query block causing admin styling issues
* Note: Version numbers 5.5.6 through 5.9.9 were internal development builds, never publicly released.
* Tested: WordPress 7.1

= 5.5.5 — July 2026 =
* Feature: Native Gutenberg Block introduced for seamless insertion and live preview within the WordPress editor!
* Fix: Resolved multiple code quality, performance, and UI regressions (Phase E RC-4).
* Tweak: Plugin version bump to 5.5.5.

= 5.5.4 — July 2026 =
* Fix: Dynamic CSS for carousel navigation buttons now renders perfectly.
* Fix: Grid and Flexbox dynamic styles now output reliably.
* Tweak: Plugin version bump to 5.5.4.

= 5.5.2 — July 2026 =
* Security: Fixed stored XSS vulnerability related to tooltip settings.

= 5.5 — July 2026 =
* Improvement: Removed front-end logo display limit — all logos now display in the free version.
* Improvement: Preloader is now free for all users.
* Maintenance and compatibility updates.

= 5.3 — March 2026 =
* Added Flexbox showcase type.
* Maintenance and compatibility updates.

= 5.0.0 =
* Security: Fixed stored XSS vulnerability.
* Security: Improved input validation for Showcase Builder.

= 4.9.0 =
* Security: Fixed stored XSS in multiple colour picker fields.
* Security: Added sanitisation on save and escaping on output for all colour settings.
* Security: Improved Showcase Builder input validation.
* Compatibility: Confirmed compatibility with WordPress 7.0.

= 4.8.0 =
* Compatibility check with latest WordPress.

= 4.7.0 =
* Compatibility check with latest WordPress.

= 4.6.0 =
* Security vulnerability resolved.
* Compatibility check with latest WordPress.

= 4.5.0 =
* Fixed cross-site scripting (XSS) issue.
* Compatibility check with latest WordPress.

= 4.1.0 =
* Improved plugin security.
* Compatibility check with latest WordPress.

= 4.0.0 =
* Fixed cross-site scripting (XSS) issue.
* Updated security hardening.
* Compatibility check with latest WordPress.

= 3.9.2 =
* Fixed image border and radius display issue.

= 3.9.0 =
* Code optimisation.
* Updated usage guidelines.

= 3.7.0 =
* Code optimisation.
* Rearranged admin fields.
* Updated demo and styles.

= 3.6.0 =
* Security improvements following security researcher feedback.

= 3.5.1 =
* Added image location options.
* Added content alignment option.

= 3.5.0 =
* Updated styles.
* Added section header.
* Added max height and width controls.
* Fixed navigation hide issue.

= 3.4.0 =
* Added new grid style.

= 3.2.3 =
* Added tooltip min and max width fields.

= 3.2.0 =
* Added item order sorting.
* Grid logo vertical alignment control.

= 3.0.0 =
* Added Showcase Builder.
* Core system upgraded.
* File structure rearranged.

= 2.5.0 =
* Added ticker mode for Carousel type.
* Added autoplay timeout speed control.

= 2.3.4 =
* Added drag and drop logo order sorting.

= 1.0.0 =
* Initial public release.
