=== Category Grid Widget for Elementor ===
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
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.

== Description ==
**Category Grid Widget for Elementor** 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-for-elementor` folder to `/wp-content/plugins/`.
2. Activate **Category Grid Widget for Elementor** 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