=== Cards Layout ===
Contributors: bplugins, abuhayat, asadsuzan, btechnologies
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: cards, card layout, showcase, grid,responsive
Requires at least: 6.5
Tested up to: 6.9
Stable tag: 2.0.2
Requires PHP: 7.4
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html


Build responsive, customizable card components with multiple layouts and dynamic styles in the Gutenberg editor.

== Description ==

Cards Layout is a powerful and flexible WordPress Gutenberg block plugin designed to help you create stunning, professional-grade card components in seconds. 

Whether you need to highlight core features, showcase team profiles, display achievement metrics, or present your skill progress, Cards Layout provides a rich set of beautifully crafted, responsive components to elevate your website's design.


[**Cards Layout**](https://bplugins.com/products/cards-layout/) | [**Support**](https://bplugins.com/support/) | [**Demos**](https://bplugins.com/products/cards-layout/#demos)

= ☑ Features =
* **Default Card:** The perfect minimal card for general content, featuring image, title, description, and button controls.

* **Hero Feature Card:** A prominent split-design card with advanced image focal point controls, overlay gradients, floating notification badges, and floating stat highlights.

* **Achievement Card:** Highlight your biggest wins with a large central metric and a customizable spinning SVG badge animation.

* **Feature Card:** A sleek, modern card layout perfect for highlighting key features or benefits.

* **Responsive Grid Engine:** Native control over column counts (Desktop, Tablet, Mobile) and gap spacing to build perfect grids instantly.

* **Advanced Global Styling:** Granular control over everything from typography (fonts, sizes, weights) to multi-state box shadows, borders, padding, and alignments.

= 💎 Pro Features (Premium) =
The following premium layouts and advanced features are available exclusively in the standalone **Cards Layout Pro** plugin (available on our website). These features are not included in this free version and require the separate Pro plugin to be installed.

* **State / Counter Card:** Create dynamic statistic cards featuring up/down trend ribbons and customizable visual sparkline graphs.

* **Progress Card:** Display skill levels or project progress with customizable gradient bars and individual metric tracking.
* **Animated Service Card:** Stand out with glowing, animated border gradients and dynamic hover growth effects.

* **Banner Card:** Build full-width promotional banners featuring stunning "Glassmorphism" blur effects and custom eyebrow taglines.

* **Client Logo Card:** Professionally present brand partners with specialized minimal typographic cards and distinct hover color interactions.

* **Creative Curve Card:** A highly stylized layout with a seamless CSS-curve cutout connecting your icon to your text content.
* **Feature Card:** Premium, sleek layout for displaying software or service features.


== Source Code ==

The source code for all generated build assets is publicly available here: [**https://github.com/bPlugins/cards-layout-free**](https://github.com/bPlugins/cards-layout-free)

To build the plugin from source:
1. Clone the repository.
2. Run `npm install` to install dependencies.
3. Run `npm run build` to generate the production-ready assets in the `build/` directory.

The source files for the following build assets are located in the `src/` directory:
- `build/index.js` -> `src/index.js`
- `build/admin-dashboard.js` -> `src/bplugins-admin/dashboard.js`
- `build/admin-post.js` -> `src/bplugins-admin/post.js`
- `build/view.js` -> `src/view.js`

== Third-Party Libraries ==

This plugin utilizes the following third-party libraries:

1. **immer** (v11.1.8)
   * Repository: https://github.com/immerjs/immer
   * License: MIT

2. **react-router-dom** (v7.15.0)
   * Repository: https://github.com/remix-run/react-router
   * License: MIT

== Feedback & Support ==

Did you find a bug or have a feature request?  
📧 [Send feedback](mailto:support@bplugins.com)

Support forum:  
https://wordpress.org/support/plugin/cards-layout-free/


### Check out our other WordPress Plugins-

[**Html5 Video Player**](https://bplugins.com/products/html5-video-player/) – Display videos as single and playlist in multiple skins.

[**PDF Poster**](https://bplugins.com/products/pdf-poster/) – Display/Embed PDF files with different styles.

[**Html5 Audio Player**](https://bplugins.com/products/html5-audio-player/) – Listen audios with awesome visuals.

[**StreamCast**](https://bplugins.com/products/streamcast-radio-player/) – Customizable radio player with different skins.

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) – Embed 3D models and 3D products with interaction.

[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) – Show posts and custom posts in different layouts.


== External Services ==

This plugin utilizes external services to provide optional diagnostic tracking and support. These services are only active if you explicitly opt-in via the activation screen.

1. = Freemius =
   * **Endpoint:** https://wp.freemius.com/action/service/user/install/
   * **Data Sent:** Site URL, WordPress version, PHP version, locale, plugin version, site name, and user email/name (if provided).
   * **Purpose:** Handles the opt-in process and synchronization of user/site data for support and updates.
   * **Terms of Service:** https://freemius.com/terms/
   * **Privacy Policy:** https://freemius.com/privacy/

2. = ImgBB (External Image Hosting) =
   * **Endpoint:** https://i.ibb.co/
   * **Data Sent:** None (External resource request only).
   * **Purpose:** Provides default placeholder images for the block components.
   * **Terms of Service:** https://imgbb.com/tos
   * **Privacy Policy:** https://imgbb.com/privacy

== Third-Party Libraries ==

= Immer =
* **Version:** 11.1.8
* **Source:** https://immerjs.github.io/immer/
* **GitHub:** https://github.com/immerjs/immer
* **License:** MIT
* **Purpose:** Used for managing immutable state in a more convenient way.

= bpl-tools =
* Source / GitHub: https://github.com/bPlugins/bpl-tools
* License: GPL-2.0-or-later – https://www.gnu.org/licenses/gpl-2.0.html
* Purpose: Shared utility library providing admin dashboard components and common Gutenberg editor controls.
* External Services: The library may connect to bPlugins, WordPress.org, and Freemius services for product data and checkout functionality. See full details: https://github.com/bPlugins/bpl-tools#external-requests--why-they-are-made

== Installation ==

### From Gutenberg Editor:
1. Go to the WordPress Block/Gutenberg Editor
2. Search For **Cards Layout**
3. Click on the **Cards Layout** to add the block

### Download & Upload:
1. Download the **Cards Layout** plugin (*.zip file*)
2. In your admin area, go to the Plugins menu and click on **Add New**
3. Click on **Upload Plugin** and choose the **`cards-layout.zip`** file and click on **Install Now**
4. Activate the plugin and Enjoy!

### Manually:
1. Download and upload the **Cards Layout** plugin to the **`/wp-content/plugins/`** directory
2. Activate the plugin through the Plugins menu in WordPress


== Frequently Asked Questions ==

= Does it work with any WordPress theme? =

Yes, it will work with any standard WordPress theme.

= Can I change block settings? =

Yes, you can change block settings from the Gutenberg block editor's right sidebar.

= How many times can I reuse a block? =

You can use unlimited times as you want.

= Where can I get support? =

You can post your questions on the [support forum here](https://wordpress.org/support/plugin/cards-layout/)


== Screenshots ==

1. Settings
2. Default Design
3. Hero Feature Card
4. Achievement Card
5. Feature Card

== Changelog ==

= 2.0.2 – 13 May, 2026 =

* Removed all Freemius-based feature gating and premium license checks from the plugin codebase.
* Removed locked/blurred Pro-only layouts and any restricted built-in functionality to comply with WordPress.org Guideline #5 (Trialware).
* Removed `PHCLB_HAS_PRO`, `cl_fs()->can_use_premium_code()`, and related conditional premium access logic.
* Cleaned block editor, admin dashboard, and frontend UI from upgrade-lock states and restricted feature handling.
* Updated plugin architecture to ensure all included features are fully functional without license activation.
* Added publicly accessible source code references and development documentation in the plugin readme.
* Included documentation for build tools and asset generation workflow for JavaScript/CSS files.
* Ensured generated assets in `/build` have corresponding human-readable source files available.
* Improved plugin compliance with WordPress.org Guideline #4 (Human Readable Code).
* Performed a full plugin audit for WordPress coding standards, security, and repository compliance.
* Tested plugin on a clean WordPress installation with `WP_DEBUG` enabled.
* General code cleanup, optimization, and maintenance improvements.


= 2.0.1 – 26 April, 2026 =
* Enhanced block title for clearer identification.
* Improved user interface for better accessibility.

= 2.0.0 – 21 April, 2026 =
* Major Release: Introducing a new layout engine!
* New Layouts: Hero Feature Card, Achievement Card, Feature Card.
* Added Responsive Grid Engine for Desktop, Tablet, and Mobile column controls.
* Added granular Icon Wrap Size controls for independent scaling.
* Added dynamic Card Tags across multiple layouts.
* Added customizable badge animation speed for Achievement Card.
* Codebase optimization and bug fixes.

= 1.1.4 – 29 July, 2025 =
* focalPoint added good feature;

= 1.1.3 – 27 July, 2025 =
* Import content from image media;

= 1.1.2 – 9 July, 2025 =
* Image border radius and card content align option added

= 1.1.1 – 6 July, 2025 =
* Card URL and button URL now open in a new tab;

= 1.1.0 – 4 July, 2025 =
* Default layout available
* Set card border, padding, and border radius
* Customize card title, description, and button typography, color, padding, and border radius

= 1.0.0 =
* Initial Release

