=== Logo Carousel – Responsive Logo Slider, Logo Showcase, and Clients Logo Gallery ===
Contributors: shapedplugin, shamimmiashuhagh, rubel_miah, khalilu
Tags: logo carousel, logo slider, logo gallery, logo showcase, display logo
Requires at least: 6.3
Requires PHP: 7.4
Tested up to: 7.1
Stable tag: 4.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Showcase clients, partners, sponsors and brand logos with Carousel and Grid blocks, Ready Patterns and an AI builder. No coding required!

== Description ==

[__Logo Carousel__](https://logocarousel.com/?ref=1) is a logo showcase plugin for the WordPress block editor. Add the **Carousel** or **Grid** block from the Logo Carousel category, drop in your logos and style every detail — or start from a Ready Pattern, or describe the showcase you want and let the AI builder create it. Perfect for clients, sponsors, partners, affiliates, supporters and brand logos, with NO CODING knowledge required.

Version 4.0 is a complete rebuild around Gutenberg blocks. Your existing shortcodes (`[logocarousel id="…"]`), the classic Logo Carousel block and the Elementor widget keep working exactly as before.

[youtube https://www.youtube.com/watch?v=jZC44B7cBCM&list=PLoUb-7uG-5jNQCZorsMl_TBePe8WZilDw]

[__Live Demo__](https://logocarousel.com/patterns/) | [__Documentation__](https://docs.logocarousel.com/guide/introduction) | [__Upgrade to Pro!__](https://logocarousel.com/pricing/?ref=1)

= Two powerful blocks =

* **Carousel block** – Standard, Staggered, Center and Multi Columns (multi-row) styles, horizontal or vertical orientation, center emphasis, partial slide view, variable width, edge fade.
* **Grid block** – Standard, Strip, Staggered and Zigzag styles, responsive columns, gaps and alignment, Load More or numbered pagination with infinite scroll.

= Key features =

* Fully responsive: columns, rows, gaps and visibility per device.
* Upload logos or pick them from the Media Library, then edit title, caption, tagline, description, categories, tooltip text, link, alt text and rating per logo.
* Carousel controls: autoplay, speed, pause on hover, loop, direction, slides to scroll, sliding effects, adaptive height, keyboard, mousewheel and free scroll.
* 13 navigation arrow icons and 6 pagination dot styles, fully styleable.
* Ajax Live Filter (by logo category) and Ajax Search.
* Logo tooltips with position, arrow, effects, typography and colours.
* Display elements: title, tagline, description, rating and read more, with sortable order, typography, colours, borders and card backgrounds.
* Logo details popup, or link each logo to a URL.
* 17 hover animations, image filters (grayscale, blur and more), opacity, overlay, aspect ratio and resolution control.
* Lazy loading and SVG support.
* **Ready Patterns Library** – insert pre-designed logo showcases in one click.
* **Create with AI** – describe a logo showcase and the AI builder matches a pattern or builds the block (uses your own OpenAI, Groq, Anthropic or Google Gemini API key, or a provider connected in WordPress; optional).
* **Saved Templates** – save a showcase once and reuse it anywhere with the `[lc_template]` shortcode.
* A modern dashboard to switch blocks and modules on or off, plus a setup wizard.
* Import and export logos and logo carousels (JSON).
* Custom CSS and JS, and FontAwesome/Swiper enqueue controls.
* Translation ready, RTL ready, developer friendly and SEO friendly.

= Logo Carousel Pro =

Need more? [__Logo Carousel Pro__](https://logocarousel.com/pricing/?ref=1) adds the List, Marquee and Table blocks, Scheduling, Motion Effects, Glassmorphism backgrounds, Logo Analytics (impressions and clicks) and priority support. See the **Lite vs Pro** tab in the plugin dashboard for the full comparison.


= Multilingual Ready =

* [WPML](https://wpml.org/)
* [Polylang](https://wordpress.org/plugins/polylang/)
* [qTranslate-x](https://wordpress.org/plugins/qtranslate-x/)
* [GTranslate](https://wordpress.org/plugins/gtranslate/)
* [Google Language Translator](https://wordpress.org/plugins/google-language-translator/)
* [WPGlobus](https://wordpress.org/plugins/wpglobus/)


= Page Builders Ready =

* Gutenberg (blocks)
* WPBakery
* Elementor
* Divi Builders
* BeaverBuilder
* SiteOrgin
* Themify Builder
* Fusion Builder
* Genesis Framework


= For fast support, features request, and bug reporting =

We are very responsive about support requests – so if you face a problem or find any bugs, post it in the support, and we will respond within 15 hours (except holidays).

>Ask us at our [__Support__](https://shapedplugin.com/create-new-ticket/)


= Author =

Designed and Developed by [__ShapedPlugin__](https://shapedplugin.com/)



== Installation ==

= MINIMUM REQUIREMENTS =

* PHP 7.4 or later
* MySQL 5.6 or later
* WordPress 6.3 or later

**This section describes how to install the plugin and get it working**

= AUTOMATIC INSTALLATION (EASIEST WAY) =

To do an automatic install of Logo Carousel, log in to your WordPress dashboard, navigate to the Plugins menu and click
Add New.
In the search field type "Logo Carousel" by ShapedPlugin. Once you have found it you can install it by simply clicking
"Install Now" and then "Activate".

= MANUAL INSTALLATION =

**Uploading in WordPress Dashboard**

* Download logo-carousel-free.zip
* Navigate to the ‘Add New’ in the plugins dashboard
* Navigate to the ‘Upload’ area
* Select logo-carousel-free.zip from your computer
* Click ‘Install Now’
* Activate the plugin in the Plugin dashboard

**Using FTP**

* Download logo-carousel-free.zip
* Extract the logo-carousel-free directory to your computer
* Upload the logo-carousel-free directory to the /wp-content/plugins/ directory
* Activate the plugin in the Plugin dashboard

The WordPress codex contains <a href="https://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation">instructions</a> on how to install a WordPress plugin.


== Frequently Asked Questions ==

= How can I create Logo Carousel? =
Open any post or page in the block editor and add the **Carousel** or **Grid** block from the Logo Carousel category. Choose **Ready Patterns**, **Create with AI** or **Build from Scratch**, add your logos and customise the block from the sidebar.

Existing shortcode users can keep using Logo Carousel → Manage Logo Views and the `[logocarousel id="…"]` shortcode.

= Will my existing shortcodes still work after updating to 4.0? =
Yes. Shortcodes, the classic Logo Carousel block and the Elementor widget are unchanged. Your plugin settings are kept and are now managed from Logo Carousel → Settings in the new dashboard.

= Do I need to have coding skills to use Logo Carousel? =
No. You don’t need any coding skill. No more pain writing any shortcode attributes to display logo carousel in your website. With just few clicks, you can amazingly showcase your logos using Shortcode Generator.

= Is Logo Carousel responsive? =
Yes, Logo Carousel is fully responsive, mobile and touch friendly.

= Can I add Logo Carousel anywhere on my website? =
Yes, you can add Logo Carousel inside your blog posts, pages, widgets, and anywhere else on your WordPress website with a shortcode or PHP function.

= Can I have multiple logo carousel with separate setting? =
Yes. You can have unlimited logo carousel or showcase with each separate setting in page, post or template.

= Will Logo Carousel work with my theme? =
Logo Carousel works with any WordPress theme if themes are developed according to WordPress standard.

= Is Logo Carousel supported with WordPress multisite? =
Yes, Logo Carousel works perfectly with WordPress multi network site.

= How can I get support if the plugin is not working? =
If you face any problem with our plugin or something is not working as it should, first follow the preliminary steps:
Test the plugin with a WordPress default theme, to be sure that the error is not caused by the theme you are currently using.

Deactivate all plugins you are using and check if the problem is still occurring.

If none of the previous listed actions helps you solve the problem, then, open a topic in the [__Support Forum__](https://wordpress.org/support/plugin/logo-carousel-free/) and describe your problem accurately, specify WordPress and plugin versions you are using and any other information that might help us solve your problem as quickly as possible.

= Where can I report bugs? =
Bugs can be reported in our [__Support__](https://shapedplugin.com/create-new-ticket/).

= I’d like access to more features. How can I get them? =
You can get access to more features when you purchase a license of the plugin. Purchasing a license of [__Logo Carousel Pro__](https://logocarousel.com/pricing/?ref=1) gets you access to the full version of Logo Carousel.

= Is Logo Carousel Translation Ready? =
Yes, **Logo Carousel** is 100% translation ready and tested with [WPML](https://wpml.org/), [Polylang](https://wordpress.org/plugins/polylang/), [qTranslate-x](https://wordpress.org/plugins/qtranslate-x/), [GTranslate](https://wordpress.org/plugins/gtranslate/), [Google Language Translator](https://wordpress.org/plugins/google-language-translator/), [WPGlobus](https://wordpress.org/plugins/wpglobus/)



== Screenshots ==
1. Live Demo
2. General Settings
3. Style Settings
4. Logo Image Settings
5. Carousel Controls
6. Typography (Pro)
7. All Logo Carousels (Shortcodes)
8. Advanced Settings
9. Custom CSS
10. Tools (Export)
11. Tools (Import)
12. Add New Logo
13. All Logos



== Changelog ==

= Version 4.0.0 – Oct 23, 2026 =
* New: Carousel block with Standard and Center styles for smooth, eye-catching logo sliders.
* New: Grid block with responsive columns that look great on every device.
* New: Create with AI module to describe a showcase and get a ready-made design, using your own OpenAI, Anthropic, Gemini, or Groq key, or a provider connected in WordPress.
* New: Ready Patterns library to insert pre-designed logo showcases in one click.
* New: Saved Templates to design once and reuse anywhere with the [lc_template] shortcode, including Elementor, Divi 4 and 5, WPBakery, Oxygen, Beaver Builder and Bricks.
* New: Edit Logos window to reorder logos, update titles, alt text, links and descriptions, and add more from the Media Library in one place.
* New: Secure SVG logo uploads, plus lazy loading, 17 hover animations, and image filters.
* Improved: Admin Dashboard with a Placements tab showing where each showcase is used.
* Improved: Rebuilt around Gutenberg blocks, while existing shortcodes, the classic block, and the Elementor widget keep working unchanged.
* Improved: 13 navigation arrow styles, including all former Pro styles, and 6 pagination dot styles, all fully customizable.
* Improved: Settings, Control Assets, Import & Export, and Custom CSS now live in the dashboard; old pages redirect there automatically.
* Improved: Now requires WordPress 6.3 and PHP 7.4.
* Tested: Compatible with WordPress 7.1.3.

= Version 3.6.14 – Aug 18, 2026 =
* Fixed: Logo Carousel block compatibility with WordPress 7.1 iframed editor.
* Fixed: Security issue with dismissing admin notices without proper permission verification.

= Version 3.6.13 - Jul 21, 2026 =
* Improved: Added comprehensive capability checks to all AJAX handlers and admin actions to prevent unauthorized access.
* Improved: Implemented safe unserialize() with is_serialized() check and allowed_classes restriction to prevent PHP object injection.
* Improved: Added CSS output sanitization to prevent XSS through dangerous CSS patterns.
* Improved: Replaced manual WordPress.org API calls with core plugins_api() function for better reliability.
* Fix: Fixed undefined array key issue in uninstall.php that could cause PHP warnings.

= Version 3.6.12 - Jun 17, 2026 =
* Fix: Resolved WPCS-related code warnings to align with WordPress coding standards.
* Compatibility: Tested and confirmed compatibility with the Elementor Atomic Editor

= Version 3.6.11 - Apr 07, 2026 =
* Fix: Some CSS style issues found with WP 7.0.
* Improved: Code maintainability has been improved.
* Tested: WordPress 7.0 compatibility.

= Version 3.6.10 - Dec 26, 2025 =
* Improved: Standardized singleton instance property naming.
* Improved: Code readability and maintainability improved.

= Version 3.6.9 - Nov 25, 2025 =
* Tested: WordPress 6.9 compatibility.

= Version 3.6.8 - Oct 29, 2025 =
* New: Added lazy loading support for logo images to improve page performance.
* Tested: WordPress 6.8.3 compatibility.

= Version 3.6.7 - Sep 11, 2025 =
* Improved: Enhanced plugin security and data validation.
* Improved: The Additional CSS option.

= Version 3.6.6 - Jun 25, 2025 =
* Improved: Add skip-lazy class to preloader icon to skip lazy.
* Improved: The plugin setting page tab icons.
* Fix: The help page style issue was identified during testing with the WordPress Playground.
* Updated: The language(.pot) file.
* Tested: WordPress 6.8.1 compatibility.

= Version 3.6.5 - Apr 14, 2025 =
* Fix: The translation-related warning was found with WP 6.8.
* Fix: The help page recommended plugins logo URL not found issue.
* Fix: The mismatched text domain issue.
* Updated: The language (.pot) file.
* Tested: WordPress 6.8 compatibility.

= Version 3.6.4 - Jan 29, 2025 =
* Improved: The plugin-backed options improved.
* Improved: The review notice section style for small devices.
* Fix: The shortcode select option gap issue was found in the gutenberg block.
* Fix: The plugin relative path issue. 
* Fix: The 404 issue for the recommended plugin's logo URL.
* Tested: WordPress 6.7.1 compatibility.

= Version 3.6.3 - Nov 21, 2024 =
* Fix: The plugin style issue for RTL sites.

= Version 3.6.2 - Nov 11, 2024 =
* Updated: The language (.pot) file.
* Tested: WordPress 6.7 compatibility.

= Version 3.6.1 - Oct 16, 2024 =
* Fix: The PHP 7.2 compatibility issue.

= Version 3.6.0 - Sep 19, 2024 =
* New: The Grid Layout feature
* New: The Responsive Columns, Spacing, Border, Limits, and more options for grid layout.
* New: The Vertical Alignment option for grid and carousel layouts.
* New: The Justify Logo option for grid layout.
* Improved: The Layout Preset option was moved to the top section of the Manage Views single page.
* Improved: The Carousel Style option was placed after the Layout Preset option.
* Tested: WordPress 6.6.2 compatibility.

= 3.5.2 Jul 06, 2024 =
* Fix: Some strings translation issue.
* Fix: The fontello icons conflict issue.
* Improved: The Plugin backend options have been improved.
* Updated: The language (.pot) file.
* Tested: WordPress 6.5.5 compatibility.

= 3.5.1 Mar 28, 2024 =
* Fix: The warning was found when the plugin was activated via the WP-Cli command.
* Tested: WordPress 6.5 compatibility.

= 3.5.0 Jan 19, 2024 =
* New: The Adaptive Height option.
* New: The Tab & Key Navigation option.
* New: The Swipe To Slide option.
* New: The Logo Border Radius option with multiple (px/%) units.
* Improved: The Plugin Backend Options Panel enhanced.
* Improved: The Tooltip/Help texts of the plugin options have been improved.
* Improved: The 'Shortcode Generator' menu item was renamed to 'Manage Views'.
* Improved: The Options of Carousel Settings were reorganized by the Nested Tab.
* Improved: The Carousel Navigation and Pagination's Hide in mobile option have been separated.
* Improved: The Options of Display Settings were reorganized by the Nested Tab.
* Improved: SVG icons have been optimized.
* Improved: The Help Page has been redesigned to make it more user-friendly.
* Updated: The Language (.pot) file.
* Fix: The background style issue was found after upgrading from Light to the Pro version.

= 3.4.23 Nov 06, 2023 =
* Improved: The loading animation of export import feature.
* Fix: Few PHPCS warnings found with PHP8.2.
* Removed: The deprecated  get_page_by_title function from plugin.
* Tested: WordPress 6.4 compatibility.

= 3.4.22 Aug 24, 2023 =
* Fix: The style issue of the plugin admin panel for RTL sites.
* Fix: The carousel pagination position overlap issue if a large no. of logos are shown in the carousel.
* Tested: WordPress 6.3 compatibility.

= 3.4.21 Jul 05, 2023 =
* Updated: Minimum required version of WordPress for the plugin.
* Tested: Tested: WordPress 6.2.2 compatibility.

= 3.4.20 May 01, 2023 =
* New: The Carousel Starts on Screen option.
* Fix: The Gutenberg Block preview shows only the preloader at the second reload.
* Tested: WordPress 6.2 compatibility.

= 3.4.19 Mar 17, 2023 =
* Improved: Gutenberg Block NMP packages updated.
* Fix: The Elementor block icon gets modified by other plugin icon.
* Fix: The extra padding of section title in live preview mode.
* Fix: Plugin CSS changes in admin panel does not apply until meta reload.
* Removed: The plugin settings link from admin bar.

= 3.4.18 Feb 11, 2023 =
* New: The Space Between the logos option.
* Improved: The margin-bottom option of section title moved to Typography tab.
* Improved: Some options are reorganised.

= 3.4.17 Dec 27, 2022 =
* Fix: The arrows of the carousel navigation are not in the right position with the Storefront theme.
* Fix: Shows error when image URL is not valid.
* Improved: Plugin security improved.
* Tested: WordPress 6.1.1 compatibility.

= 3.4.16 Dec 07, 2022 =
* Fix: A image URL is missing in the Display tab of the shortcode edit page.
* Improved: Dynamic CSS of logo carousel for Elementor edit preview.

= 3.4.15 Nov 10, 2022 =
* New: The Free mode option.
* Improved: Load dynamic style according to the shortcode on the page.
* Fix: The JS warning on click export of logos on the export page.
* Fix: Dequeue Assets option does not work when the Elementor plugin is enabled.
* Tested: WordPress 6.1 compatibility.

= 3.4.14 Sept 29, 2022 =
* Fix: Few deprecated JS warnings on the plugin admin page.

= 3.4.13 Aug 25, 2022 =
* Improved: SVG preloader icon as a pre-loader image.
* Improved: Optimized SVG images.
* Fix: Security issues.
* Fix: Conflict with the W3 Total Cache's lazyload feature.
* Removed: Unused codes and assets from the plugin.

= 3.4.12 Aug 01, 2022 =
* Fix: Logo Alt Text shown for Logo title, not from alt text.
* Removed: Removed unused codes and functions from the plugin.
* Updated: Live Demo page & Landing page link.

= 3.4.11 Jul 07, 2022 =
* Fix: Logo items are not excluded from WordPress Search Results.
* Updated: The notice texts of creating/editing the shortcode.

= 3.4.10 Jun 14, 2022 =
* Fix: The premium page warnings.
* Update: The language (.pot) file.

= 3.4.9 May 19, 2022 =
* Tested: WordPress 6.0 compatibility.
* Fix: Deprecated warning of Gutenberg Block.
* Fix: Few deprecated js warnings.

= 3.4.8 Apr 23, 2022 =
* New: Elementor Addon.
* Fix: Some assets of the Logo Carousel admin panel are not loaded properly in a few websites as that hosting directory is different.


= 3.4.7 Mar 09, 2022 =
* New: Gutenberg Block for Logo Carousel shortcode.
* New: The alt attribute to the preloader image has been added.
* New: Specific class added in the logo image tag to exclude lazyload conflict of other plugins.
* Fix: Image vertically middle/center does not work.
* Fix: Custom CSS loads multiple times if multiple shortcodes are used on a page.

= 3.4.6 Jan 26, 2022 =
* Tested: WordPress 5.9 compatibility.

= 3.4.5 Dec 21, 2021 =
* Fix: Image tag title attr double quote issue.
* Improved: Plugin security improved.

= 3.4.4 Dec 14, 2021 =
* Improved: Shortcode duplication nonce sanitized.
* Fix: The export issue.
* Removed: Unnecessary codes.

= 3.4.3 Nov 30, 2021 =
* Improved: Plugin security improved.

= 3.4.2 Nov 17, 2021 =
* New: Capability permission hook added.
* Improved: Plugin security improved.
* Removed: Google Font asset removed.

= 3.4.1 Nov 08, 2021 =
* Fix: Logo limit field blank issue.

= 3.4.0 Oct 19, 2021 =
* New: Shortcode live preview option.
* Improved: Shortcode settings panel text.
* Fix: Several minor tweaking.

= 3.3.5 Aug 26, 2021 =
* Improved: Plugin security.

= 3.3.4 Jul 10, 2021 =
* Fix: AutoPlay stopping on mobile device issue.

= 3.3.3 Jun 05, 2021 =
* New: Export and Import option.

= 3.3.2 May 27, 2021 =
* New: Margin bottom for the section title.
* New: Logo margin between logos.
* New: Show/Hide logo image.
* New: Available logo image cropped sizes.
* Improved: Logo limits default value 15 withdrawn.
* Improved: Backend Generator Settings panel.
* Improved: Codes optimized.
* Improved: Minor CSS tweaking.

= 3.3.1 May 11, 2021 =
* New: Plugin Settings page added.
* New: Clean-up data on deletion option.
* New: Enqueue/Dequeue FontAwesome CSS.
* New: Enqueue/Dequeue Swiper CSS.
* New: Enqueue/Dequeue Swiper JS.
* New: Custom CSS field to override styles.
* Fix: Spinner field issue.
* Fix: Shortcode area padding issue.
* Improved: Minor tweaking.

= 3.3.0 May 01, 2021 =
* New: Infinite loop for the logo carousel.
* New: Carousel Direction: Right to Left and Left to Right.
* New: Navigation hide on mobile.
* New: Pagination hide on mobile.
* New: Navigation color and hover color.
* New: Navigation border width, style, color, and hover color.
* New: Pagination dot independent active color.
* New: Logo section title.
* New: Logo border width, style, color, and hover color.
* New: Logo title attribute.
* New: Preloader option.
* Improved: Color accessibility for disabled people.
* Improved: Shortcode Generator Settings panel.
* Improved: Optimized for speed.
* Update: Plugin framework and whole code base.

= 3.2.13 Apr 23, 2021 =
* Improved: Swiper latest version has been added.
* Fix: Shortcode area icon click and responsive issue.

= 3.2.12 Mar 13, 2021 =
* New: Shortcode onClick copy option.
* Tested: WordPress 5.7 compatibility.

= 3.2.11 Dec 24, 2020 =
* Fix: WordPress 5.6 compatibility issue.
* Improved: Pro version compatibility.
* Improved: Carousel scripts.

= 3.2.10 Aug 17, 2020 =
* Fix: WordPress 5.5 compatibility issue.

= 3.2.9 Jul 10, 2020 =
* New: Carousel duplicate option.

= 3.2.8 Dec 06, 2019 =
* Fix: Backend logo column image sizing issue.
* Improved: Load minified CSS & JS.

= 3.2.7 Nov 25, 2019 =
* Fix: WordPress 5.3 compatibility issue.

= 3.2.6 Aug 08, 2019 =
* Improved: Style and Script enqueue system.
* Improved: Admin dashboard UI.

= 3.2.5 May 22, 2019 =
* Fix: WordPress 5.2.1 compatible issue.

= 3.2.4 Mar 04, 2019 =
* Fix: WordPress 5.1 compatible issue.

= 3.2.3 Dec 27, 2018 =
* Improved: Carousel script improved.

= 3.2.2 Dec 03, 2018 =
* Fix: Images are visible before carousel is initialized.

= 3.2.1 Nov 05, 2018 =
* Fix: "Pause on Hover" issue for carousel.

= 3.2 Oct 23, 2018 =
* Admin Dashboard UI improvement.
* CSS tweaks and whole codes optimized.

= 3.1.2 Aug 25, 2018 =
* Post conversion SQL query improved.

= 3.1.1 December 18, 2017 =
* JavaScript Codes Improved to make more SEO friendly.

= 3.1, November 08, 2017 =
* Admin dashboard improved
* Some issues fixed

= 3.0.2 =
* Widget area issue fixed

= 3.0.1 =
* Custom column added in logo post

= 3.0 =
* Shortcode Generator Added
* Tiny MCE button to insert shortcode
* Total Logo
* Tailor based responsive option
* Order and OrderBy Option
* AutoPlay
* AutoPlay speed
* Pause on hover
* Touch Swipe
* Mouse Drag
* RTL mode

= 2.0 =
* Massive changes

= 1.3 =
* Fixed CSS

= 1.2 =
* Fixed fatal error

= 1.1 =
* Add shortcode backend

= 1.0 =
* First Release

== Upgrade Notice ==

= 4.0.0 =
Major update: new Carousel and Grid blocks, Ready Patterns, AI builder, Saved Templates and a new dashboard. Existing shortcodes keep working. Requires WordPress 6.3+ and PHP 7.4+. Please back up your site before updating.
