=== ID Image Overlay ===
Contributors: insightdezign, freemius
Tags: image overlay, text overlay, shortcode, image caption, visual editor
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.2.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display an image with a positioned text overlay, optional link, and customizable styling.

== Description ==

Image Overlay lets you place styled text over any image using a simple shortcode. Choose from 9 text positions, solid or gradient overlays, full-image or text-area coverage, and rich HTML content — all without writing CSS.

**Features:**

* 9-point text positioning (top/middle/bottom + left/center/right)
* Solid color or gradient overlay backgrounds
* Full-image or text-area-only overlay coverage
* Rich HTML overlay content (not just plain text)
* Customizable text color, font size, and padding
* Optional link with target and title attributes
* Custom image sizes (including WxH format)
* Lightweight CSS with no JavaScript on the frontend
* WPBakery Page Builder element with Design Options
* IDVE (Insight Dezign Visual Editor) block integration

**Shortcode Usage:**

`[id_image_overlay image="123"]Your overlay text here[/id_image_overlay]`

== Installation ==

1. Upload the `id-image-overlay` folder to `/wp-content/plugins/`.
2. Activate the plugin through the Plugins menu.
3. Use the `[id_image_overlay]` shortcode in any post or page.

== Frequently Asked Questions ==

= What shortcode attributes are available? =

* `image` — Attachment ID of the image (required)
* `img_size` — Image size: full, large, medium, thumbnail, or WxH format like 800x600
* `text_position` — Position: top-left, top-center, top-right, middle-left, middle-center, middle-right, bottom-left, bottom-center, bottom-right
* `text_align` — Text alignment: left, center, right
* `text_color` — Hex color for text (default: #ffffff)
* `font_size` — Font size in pixels (default: 18)
* `overlay_coverage` — Coverage mode: text-only or full (default: text-only)
* `overlay_type` — Overlay type: solid or gradient (default: solid)
* `bg_color` — Overlay color or gradient start color (supports rgba)
* `bg_color_2` — Gradient end color (when overlay_type is gradient)
* `gradient_direction` — Gradient direction: to bottom, to top, to right, to left, to bottom right, to bottom left, to top right, to top left
* `padding` — Overlay padding in pixels (optional)
* `link_url` — Optional URL to link the image
* `link_target` — Link target: _self or _blank
* `link_title` — Link title attribute
* `el_class` — Custom CSS class for the wrapper
* Content between opening and closing tags is used as overlay text (supports HTML)

= Does this work with page builders? =

Yes, it includes native integrations for both WPBakery Page Builder (with Design Options) and the Insight Dezign Visual Editor (IDVE). The shortcode can also be used in any page builder that supports shortcodes.

== Screenshots ==

1. Image with centered text overlay
2. Multiple position options demonstrated

== Changelog ==

= 1.2.0 =
* Added gradient overlay support (solid color or two-color gradient with 8 directions).
* Added full-image overlay coverage option (in addition to text-area-only).
* Overlay text now supports rich HTML content via enclosing shortcode tags.
* WPBakery element now includes Design Options (CSS editor), grouped parameter tabs, and admin labels.
* Updated IDVE block with all new overlay fields.
* Removed bg_opacity attribute; overlay color opacity is now controlled via the color picker.

= 1.1.1 =
* Added WPBakery Page Builder element integration.

= 1.1.0 =
* Added Freemius SDK integration
* Added WordPress.org metadata and readme
* Added uninstall cleanup handler

= 1.0.0 =
* Initial release
