=== PlanWise Floor Planner ===
Contributors: ClaimPro
Tags: floor plan, floor planner, measurement, blueprint, real estate
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://planwisewp.com/pricing/

The interactive floor plan plugin for WordPress. Turn your website into a lead generation tool and automated quoting system.

== Description ==

Stop wrestling with rulers and calculators! **PlanWiseWP** is a revolutionary, easy-to-use WordPress plugin that embeds a professional floor plan editor directly into your site with a simple shortcode `[planwisewp]`. Allow your website visitors, clients, or agents to draw floor plans effortlessly in their browser. As they draw, PlanWiseWP **automatically calculates** all crucial measurements in real-time. It's the perfect B2B tool for real estate agencies, contractors, e-commerce stores (paint, flooring, furniture), and anyone who needs to provide accurate quotes or generate qualified leads.

### From a simple utility to a powerful business and engineering engine

While the free version provides a powerful editor for your visitors, the **[PlanWiseWP PRO](https://planwisewp.com/pricing/)** version transforms it into a complete professional asset. **With PlanWiseWP PRO, your website can:** * **Handle Complex Geometries:** Manage sophisticated architectural layouts with advanced **Room Overlapping & Merging** logic and intelligent snapping for non-standard shapes.
* **Precision Dimensioning:** Utilize **Dynamic Guidelines** and on-canvas dimension lines for millimeter-precise planning and professional-grade blueprints.
* **Automate Engineering Quotes:** Instantly calculate **Net vs. Gross Floor Areas**, **Net Wall Surfaces** (automatically subtracting all doors and windows), and **Detailed Perimeters** for accurate skirting or trim material estimation.
* **Thermal & Volume Analysis:** Automatically generate **Air Volume** data and estimated **Heating Load** requirements based on calculated surfaces and room volumes—perfect for HVAC and insulation contractors.
* **Generate Qualified Leads:** Allow users to **Save & Load** their plans, turning anonymous visitors into registered, contactable leads in your database.
* **Strengthen Your Brand:** **Remove our watermark** and **add your own company logo** to all exported high-resolution PNGs.
* **Monetize Your Traffic:** Use the **Company Management** panel to create premium, tiered access for your own B2B clients and partners.
* **Full Data Portability:** View user-saved plans (JSON) in the admin dashboard and unlock **CSV & TXT export** to sync data directly with your CRM or quoting software.

### Core FREE features

* **Visual Snap-to-Grid editor:** An intuitive drawing interface that's easy for anyone to use.
* **Live basic calculations:** Instantly calculates Gross Floor Area, Gross Wall Area, and item counts.
* **Smart magnetic alignment:** Rooms and elements automatically snap together for perfect alignment.
* **Mobile & tablet ready:** Fully responsive and touch-enabled.
* **Metric & Imperial units:** Works seamlessly in (cm/m) or (in/ft).
* **Embed via shortcode:** Place `[planwisewp]` on any page or post.
* **PNG image export:** Lets users download a PNG of their plan (with PlanWiseWP watermark).
* **Admin customization:** Control editor button colors and the preset room name list.
* **Translation ready:** Fully translatable to your site's language.

[See the PRO vs. FREE Comparison](https://planwisewp.com/pricing/) | [Try the Live DEMO](https://planwisewp.com/demo/) | [Read the Documentation](https://planwisewp.com/faq/)

== Installation ==

**Method 1: From your WordPress dashboard (Easiest)**

1. Navigate to 'Plugins' > 'Add New' in your WordPress admin dashboard.
2. Search for "PlanWiseWP".
3. Click 'Install Now', then click 'Activate'.
4. After activation, go to the new 'PlanWiseWP' menu in your admin sidebar to configure the settings.

**Method 2: Manual upload via WordPress admin (from .zip)**

1. Download the `planwisewp.zip` file from the WordPress.org plugin directory.
2. Navigate to 'Plugins' > 'Add New' in your WordPress admin.
3. Click the 'Upload Plugin' button at the top of the page.
4. Select the `planwisewp.zip` file you downloaded and click 'Install Now'.
5. Activate the plugin.

**After activation:**

1. Navigate to the new **PlanWiseWP > Settings** menu in your admin sidebar. This is where you configure all core options:
    * Set the **Unit System** (Metric/Imperial).
    * Set the **Free version default sizes** for doors and windows.
    * Customize frontend **Texts, Titles, and Tooltips**.
2. Place the `[planwisewp]` shortcode on any page or post to display the editor.

== Frequently Asked Questions ==

**How do I display the editor?**
Just add the `[planwisewp]` shortcode to any WordPress page or post.

**What are the essential initial settings?**
Go to **PlanWiseWP > Settings** to set your **Unit System** (Metric/Imperial).

**How do I align rooms or create shared walls?**
Drag rooms close to each other, and they will **magnetically snap** together. The snapping logic uses the **Wall Thickness** value (set in the editor controls) to create a perfect gap, ready for placing shared doors or openings.

**How do I select, move, or delete an element?**
* **Select:** Left-click (or tap) on a room or element.
* **Move:** Click-and-drag (or touch-and-drag) the selected element.
* **Edit Panel:** Right-click (or long-press on touch screens) a selected element to open the Edit Panel.
* **Rotate/Delete:** Use the (↔️) and (🗑️) icons in the Edit Panel.

**What is the difference between the Free and PRO export?**
The Free version exports a PNG image with a "PlanWiseWP" watermark. The PRO version removes this watermark, lets you add your *own* logo, and adds data export options for `.TXT` and `.CSV` files.

== Screenshots ==

1. **The Main Editor Interface (Free):** Shows the clean, responsive canvas, drawing controls, and magnetic snap-to-grid alignment.
2. **Basic Editing:** Demonstrates selecting an element, moving it, and opening the right-click Edit Panel.
3. **Free Measurement Report (General):** Shows the basic General Data report, including Gross Area and total item counts.
4. **Free Measurement Report (Rooms):** Shows the basic per-room data, including Gross Wall & Floor Area.
5. **Admin Settings (General):** Configure core plugin options like Unit System (Metric/Imperial).
6. **Admin Settings (Content):** Customize frontend titles, the "Usage Guide" tooltip, and set the default fixed sizes.
7. **Admin Settings (Customization):** Pre-define the preset Room List dropdown and customize the message shown to logged-out users.
8. **Admin Settings (Branding):** Customize all editor button colors to match your brand.
9. **Admin Settings (Tools):** Shows the option to reset all plugin settings back to their default state.
10. **Project Log:** View and manage your saved floor plans.
11. **Statistics:** View basic stats on plugin usage, including top users and activity by email domain.
12. **Professional PRO Report (General):** Shows the advanced General Data report, including Net Areas and Perimeters.
13. **Professional PRO Report (Rooms):** Detailed per-room data, including Net Wall Surface, Painted vs. Tiled Area.
14. **PRO Editor Features:** Demonstrates On-Canvas Dimensions, custom Room Colors, and the advanced Edit Panel.
15. **Company Management (PRO):** The admin panel for creating "Company" accounts with activity insights.

== Changelog ==

**= 1.0.0 =**
* Initial public release.

== 3rd Party or External Service Disclaimer ==

This plugin, when upgraded to the PRO version, uses the **Freemius** service (https://freemius.com) to handle licensing, payments, and automatic updates.
* **Data Sent:** When purchasing or activating a PRO license, user data (name, email, site URL, license key) is securely sent to Freemius to validate the purchase and manage the license.
* **Freemius Privacy Policy:** https://freemius.com/privacy/
