=== PicPoints - Interactive Image Maps, Floor Plans Builder ===
Contributors: yalogica, freemius
Tags: interactive image, image map, floor plan, hotspot, clickable image
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.5.1
Requires PHP: 7.4
License: GPLv3
License URI: https://gnu.org

Create high-performance interactive images, multi-level floor plans, shoppable lookbooks, and vector-accurate responsive image maps.

== Description ==

**🏆 The Best Interactive Map and Floor Plan Builder for WordPress**

PicPoints is the most advanced, developer-friendly interactive image and floor plan builder for WordPress. Built for performance and modern web standards, it handles many interactive elements effortlessly without lagging your website.

Unlike traditional image map plugins that break when your WordPress theme updates, PicPoints renders entirely inside a **Shadow DOM**. This guarantees 100% CSS and JS isolation your theme's styles will never break your interactive maps, and your maps will never slow down your site.

Whether you need to build a multi-story real estate floor plan, an interactive product anatomy showcase, a shoppable e-commerce lookbook, or a vector-accurate event map, PicPoints provides a Figma-like vector editor right inside your WordPress dashboard.

Draw complex clickable shapes with pixel-perfect accuracy using **native Bezier curves**, group layers, and create rich-content popups and tooltips in minutes.

[youtube https://youtu.be/AmEn0b1bgf8]

=== 🚀 Why Developers & Businesses Choose PicPoints: ===
* **Isolated Shadow DOM Architecture:** Zero CSS conflicts with your theme. 100% visual consistency on any website.
* **Extreme Performance:** Hardcore optimization tested with up to 1,000 active vector elements on a single canvas.
* **Pro-Grade Vector Editor:** Draw ellipses, rectangles, markers, and custom polygons with smooth Bezier curves.
* **Multi-Scene & Multi-Level Canvas:** Perfect for real estate (Floor 1, Floor 2, Floor 3) and complex architectural blueprints.
* **Figma-Like Layer Management:** Group, rename, and organize your vector shapes and markers hierarchically.
* **Fully Responsive & Liquid:** Adapts flawlessly to mobile devices, tablets, and desktops with smart touch controls.
* **Rich Tooltips & Popups:** Trigger automated tooltips on hover or open rich-media popups (images, text, iframes) on click.

###🔥 FEATURES
PicPoints Free is perfect for small projects and testing. PicPoints Pro unlocks the full potential for professional agencies and realtors.

**PicPoints Free** - General Features
⚡ **Number of maps:** Max 3
⚡ **Number of scenes (levels) per map:** Max 3
⚡ **Number of interactive layers/markers per scene:** Max 10
✅ **Markers:** non-scalable pins (icon + text or image) with custom anchor point positioning.
✅ **SVG Layers:** rectangles, ellipses, images, text (with left/center/right alignment), and polygons.
✅ **Smart Undo/Redo History:** full history stack to undo/redo changes for scenes & layers.
✅ Standard Tooltips & Popups (Auto-close enabled)
✅ Flexible tooltip positions: top, bottom, left, right, center, follow
✅ Strict Pan & Zoom behavior
✅ Change viewport & scene background, can be color or image

**PicPoints Free** - Widgets
✅ **Scene Title**
✅ **Scene Navigation Dots**
✅ **Scene Navigation Switcher**
✅ **Fullscreen Toggle**
✅ **Fit to Screen**
✅ **Zoom Controls**

**PicPoints Pro** includes everything from Free, plus:
✅✨ **Unlimited Maps, Scenes, and Layers** for enterprise-scale projects.
✅✨ **Import layers from SVG** import `<g>` and `<path>` vector elements from Illustrator or Inkscape with automatic layer tree and partial style retention.
✅✨ **Auto-Load** toggle map auto-loading on/off or configure a custom delay timer to optimize website page load speed.
✅✨ **Greeting dialog** show message before map load.
✅✨ **Bulk Attribute Editing** select multiple layers or groups at once to edit, update, or assign common custom metadata.
✅✨ **Advanced Handlebars Templates** use classic Handlebars logic ({{variable}}, {{#if}}, {{#each}}) inside Tooltips and Popups to build highly dynamic, data-driven layouts without coding.
✅✨ **Physics-Based Canvas Bounce** advanced configurations for a smooth viewport experience.
✅✨ **Custom JS & CSS Sections** per map and per element for infinite extensibility.
✅✨ **Developer API Access** to connect your interactive maps with external CRM, WooCommerce, or custom databases.
✅✨ **Priority email support** for agencies and businesses that need fast help.


*Note: The undo/redo history covers all scene or layer movements and visual style modifications. Rich content formatting changes inside tooltips and popups bypass the history stack.*

[youtube https://youtu.be/yk9iK76KuFU]


### 🚀 COMPATIBILITY
Not all themes and plugins are built the same way, so PicPoints is designed with extra compatibility in mind.​ PicPoints works seamlessly with modern WordPress themes and popular page builders that support standard blocks and shortcodes.

**PAGE BUILDERS**
* [Gutenberg](https://wordpress.org/plugins/gutenberg/) – modern built-in WordPress block editor
* [Classic Editor](https://wordpress.org/plugins/classic-editor/) – classic built-in WordPress editor
* [Elementor](https://elementor.com/) - leading website builder platform on WordPress
* [WP Bakery](https://wpbakery.com/) - create any layout with intuitive way
* [Beaver](https://www.wpbeaverbuilder.com/) – page builder you can trust with your business
* [Bricks](https://bricksbuilder.io/) - amazing block editor with many templates
* [Brizy](https://www.brizy.io/) - next-gen website builder that anyone can use
* and more...


###💼 GDPR & Privacy
* We do not collect or store any information about our visitors or users without their consent.
* We also do not transfer any data to external servers without users' consent.


###🔥 Check out our other WordPress Plugins
[**HappyVR**](https://wordpress.org/plugins/happyvr/) - virtual tour builder and 360 panorama viewer for WordPress
[**MediaCommander**](https://wordpress.org/plugins/mediacommander/) - bring folders to media, posts, and pages
[**NinjaDraw**](https://wordpress.org/plugins/ninjadraw/) - create diagrams, sketches & visual workflows
[**Post Order Master**](https://wordpress.org/plugins/post-order-master/) - free drag & drop hierarchy manager


== Support ==

Found an issue or have a feature request? Head over to our [support forum](https://wordpress.org/support/plugin/picpoints/) or drop us an email for assistance. We're here to help you create stunning floor plans and image maps with ease!


== Installation ==

1. Upload the `picpoints` folder to the `/wp-content/plugins/` directory, or install the plugin directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Look for the "PicPoints" menu item in your WordPress dashboard left sidebar to start building.
4. Copy the generated shortcode `[picpoints id="..."]` and paste it into any page, post, or widget area.


== Frequently Asked Questions ==

= I installed the plugin, what's next? =
Once you've installed the plugin, you can start creating your first interactive map right away. Just open the PicPoints menu in your WordPress dashboard, create a new scene, setup canvas background and begin adding interactive markers and shapes. Your map will be ready to embed on any page in minutes.

= Does PicPoints work with page builders? =
Without a doubt, PicPoints works with most popular web page builders such as Elementor, Divi, Beaver Builder, Visual Composer, WP Bakery, Brizy, Blocks, and many others.

= Where is the developer version hosted? =
The developer version is available [here](https://github.com/yalogica/picpoints-wordpress-plugin).

= Will this plugin slow down my page load speed? =
No. PicPoints is built with performance in mind. Thanks to lightweight vector rendering and modular architecture, it can handle over a thousand active elements without visible performance drops or layout shifting.

= Will my theme's CSS break the maps layout? =
Never. PicPoints utilizes **Shadow DOM encapsulating technology**. It encapsulates all styles inside a shadow tree, meaning your active theme cannot inject or override the CSS of your interactive maps.

= Can I link markers to WooCommerce products? =
Yes! You can use rich-text popups to insert product links, images, and prices. With the Pro version, you can use the custom JS/API section to create deep integration like "Add to Cart" directly from the image hotspot.


== Changelog ===

= 1.5.1 =
* Fixed: Duplicating a map only copied the title, all scene content, layers, and configuration were lost in the copy.
* Fixed: Layer hover effect lingered on screen during scene transitions, causing a visual glitch when switching between scenes.

= 1.5.0 =
* Fixed: Tooltips and popups could freeze on screen during rapid interaction due to a race condition in the show/hide animation lifecycle.
* Changed: Right panel now displays mixed-value state when multiple scenes or layers with different property values are selected.

= 1.4.0 =
* Added: Tooltip inherit option, layers can now inherit tooltip settings from their parent group.
* Added: Visual tooltip enabled/disabled indicator in the layers panel.

= 1.3.0 =
* Added: Dynamic variable substitution ({{layer_name}}, {{attribute_key}}) in text tooltips via Handlebars.
* Fixed: Layers panel virtual list rendering offset on new maps when adding the first layer group.
* Fixed: SVG import not rendering paths with multiple subpaths (e.g., country borders with enclaves).

= 1.2.0 =
* Added: Advanced custom attributes engine to store structural data per layer or group.
* Added: Dynamic Handlebars templating engine for Popups and Tooltips.
* Added: XSS security layer powered by DOMPurify with native iframe embedding support.
* Fixed: Streamlined layer sidebar UI layout for faster B2B developer workflow.

= 1.1.0 =
* Added: Brand new redesigned version

= 1.0.0 =
* Initial release