=== Elementor Category Grid Widget ===
Contributors: mrraph
Donate link: https://your-site.example/donate
Tags: elementor, category, grid, widget, posts
Requires at least: 5.8
Tested up to: 6.8.1
Requires PHP: 7.0
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Responsive grid of post categories with images for Elementor.
Allows manual selection of categories to display, inclusion of subcategories, hiding categories without images, and control over number of columns, image sizes, style settings, and hover effects.

== Description ==
**Elementor Category Grid Widget** adds a simple yet powerful widget to Elementor for displaying your post categories in a grid:
- Manual selection of categories to display
- Option to show subcategories
- Option to hide categories without an image
- Configurable number of columns (1–6)
- Choice of image size (thumbnail, medium, large, full)
- **Style** tab: spacing, card background & border, typography, shadow
- **Hover** tab: customizable overlay (color & opacity), title color on hover
- Each card is clickable and links to the category archive page

The widget uses WordPress’s native category image feature (a “Category Image” field added in the admin).

== Installation ==
1. Upload the `elementor-category-grid-widget` folder to `/wp-content/plugins/`.
2. Activate **Elementor Category Grid Widget** in the **Plugins** menu.
3. In Elementor, add the **Category Grid** widget to your layout.
4. Configure: select categories, columns, style, and hover effects.

== Screenshots ==
1. Elementor editor: widget settings panel  
2. 4-column grid with hover overlay  
3. Mobile: responsive single column  
4. Advanced options in the Style tab  

== Frequently Asked Questions ==
= How do I assign an image to a category? =
When creating or editing a category, a “Category Image” field appears in the admin. Click “Select Image” to set it.

= Can I hide categories without an image? =
Yes, enable the **“Hide categories without image”** option in the widget’s Content tab.

= How do I customize the hover effect? =
Open the **Style » Hover** tab: choose the overlay color & opacity, and the title color on hover.

== Changelog ==
= 1.2.1 =
* Initial release  
* Manual category and subcategory selection  
* Configurable number of columns and image size  
* Option to hide categories without image  
* Added Style and Hover tabs for advanced customization