=== IceCream Elementor Addon ===
Contributors: rezamas
Tags: elementor, addon, post grid, timeline, team
Requires at least: 6.5
Tested up to: 7.1
Stable tag: 3.0
Requires PHP: 7.4
Requires Plugins: elementor
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Creative Elementor widgets for post grids, timelines, galleries, team cards, buttons, and image layouts.

== Description ==

IceCream Elementor Addon is a collection of creative, responsive Elementor widgets for WordPress websites.

All widgets are available in the **IceCream Elementor Addon** category inside the Elementor editor. Widgets can be enabled or disabled from the plugin dashboard without editing code.

== Dashboard Settings ==

Open **IceCream Elementor Addon** from the WordPress admin menu to:

* Enable or disable individual Elementor widgets.
* Manage widgets in Creative, Content, and Team sections.
* Save settings with AJAX without refreshing the page.
* See live enabled-widget counters.
* Request custom Elementor widgets or plugin services through the custom-service CTA.

All widgets are enabled by default.

== Widgets ==

=== Expand Button ===

Create an expanding button with:

* Editable button text and link.
* External-link and nofollow options.
* Left or right expanding direction.
* Selectable Elementor icon.
* Button and hover background colors.
* Text and hover colors.
* Icon color, size, and typography controls.

=== Image 1 ===

Create an image card with hover-revealed content:

* Image, title, description, and accessible alt text.
* Left, center, or right content alignment.
* Image border radius.
* Configurable image movement on hover and keyboard focus.
* Title and description colors.
* Separate typography controls for title and description.

=== Menu Image ===

Create an image with a sliding menu revealed on hover:

* Custom image and alt text.
* Unlimited repeater menu items.
* Editable item titles, links, colors, external links, and nofollow settings.
* Menu background and image-hover background colors.
* Menu typography controls.
* Multiple instances can be used safely on the same page.

=== Image Gallery ===

Create a responsive mosaic image gallery:

* Elementor gallery image selector.
* Deterministic mosaic layout that does not randomly change on every render.
* Configurable grid gap.
* Configurable row height.
* Configurable card border radius.
* Responsive desktop and mobile layout.
* Image accessibility labels where available.

=== Post Grid ===

Display WordPress posts in an editorial card grid:

* Query published posts by category.
* Choose post count, order, and sorting method.
* Responsive one-, two-, three-, or four-column layout.
* Featured images with fallback backgrounds.
* Category badges and reading-time badges.
* Relative post dates.
* Editable excerpts and excerpt length.
* Author avatars and author names.
* Comment counts.
* Numbered pagination.
* Progress footer showing displayed and total stories.
* Load-more link to the next page.
* Individual visibility controls for image, category, date, excerpt, author, comments, reading time, progress, and pagination.
* Separate Elementor style sections for layout, card, image, category, reading time, metadata, title, excerpt, author, avatar, comments, progress, load-more, and pagination styling.

=== Timeline 1 ===

Create an alternating vertical timeline:

* Unlimited repeater timeline items.
* Editable date, title, description, icon, card side, and link per item.
* Alternating left/right cards by default.
* Center timeline line with circular icon nodes.
* Responsive mobile stacking.
* Editable item spacing and card width.
* Editable line color, line width, node size, and icon color.
* Separate card background, border radius, shadow, and padding controls.
* Separate date, title, and description colors and typography controls.

=== Team 1 ===

Create a team member card with:

* Image, name, and position controls.
* Six social links and icons.
* Hover social-icon animation.
* Image hover overlay color.
* Image border radius.
* Name and position typography, color, alignment, and margin controls.
* Social icon color, hover color, size, padding, and margin controls.

=== Team 2 ===

Create a team member card with overlay details:

* Image, name, and position controls.
* Six social links and icons.
* Overlay background and border-radius controls.
* Image border radius.
* Name and position typography, color, alignment, and margin controls.
* Social icon alignment, color, hover color, size, padding, and margin controls.
* Support for both font-based and SVG Elementor icons.

=== Team 3 ===

Create a direction-based team member layout:

* Image, name, position, and description controls.
* Six social links and icons.
* Responsive row, reverse-row, or column direction.
* Image and details width controls.
* Optional configurable card border.
* Optional content-order switching for name, title, description, and social links.
* Image radius and margin controls.
* Separate name, position, description, and icon styling.

=== Team 4 - Big ===

Create a large team card with positioned overlay details:

* Image, name, and position controls.
* Six social links and icons.
* Horizontal and vertical overlay positioning.
* Name and position typography, color, alignment, and margin controls.
* Social icon alignment, color, hover color, size, padding, and margin controls.
* Image sizing and radius controls.

=== Team 5 - Fluid ===

Create a fluid team card with animated details:

* Image, name, and position controls.
* Six social links and icons.
* Configurable details overlay movement.
* Optional content-order switching.
* Image radius and margin controls.
* Name and position typography, color, alignment, and margin controls.
* Social icon color, hover color, size, padding, and margin controls.

== Requirements ==

* WordPress 6.5 or later.
* Elementor installed and active.
* PHP 7.4 or later.

Elementor is declared as a required plugin. WordPress will prevent activation of IceCream Elementor Addon until Elementor is installed and active.

== Frequently Asked Questions ==

= How do I enable or disable widgets? =

Open **IceCream Elementor Addon** in the WordPress dashboard, select the widgets you need, and click **Save changes**. The settings are saved with AJAX and the Elementor widget list uses the selected widgets.

= I changed a widget style but do not see the change. What should I do? =

Regenerate Elementor CSS from **Elementor > Tools > Regenerate CSS & Data**, then clear any page or site cache.

= Can I use multiple instances of the widgets on one page? =

Yes. The widgets use Elementor wrapper selectors and avoid shared element IDs where multiple instances could conflict.

= Can I request a custom widget or feature? =

Use the custom-service button in the plugin dashboard or visit:

https://flexypress.com/request-service/

== Changelog ==

= 3.0 - 12-09-2026 =

* Added Post Grid widget with query, content, pagination, and detailed style controls.
* Added Timeline 1 widget with repeater items and responsive alternating layout.
* Added dashboard widget management with grouped sections and AJAX saving.
* Added Elementor dependency declaration.
* Improved widget accessibility, links, image alt text, SVG icon styling, and responsive behavior.
* Added modern dashboard design and custom-service CTA.

= 2.0 - 30-10-2024 =

* Restructured the plugin and widgets.
* Improved compatibility with WordPress and Elementor.

= 1.2.0 - 26-04-2023 =

* Added compatibility with WordPress and Elementor updates.
* Added five team member widgets.

= 1.0.1 - 06-05-2022 =

* Added a new Elementor widget.

= 1.0.0 - 20-04-2022 =

* Initial release.
