=== Site3D Configurator ===
Contributors: site3d
Donate link: https://configurator.site3d.site
Tags: shortcode, widget, blocks, media, customization
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Insert a shortcode to embed interactive 3D configurators from Site3D on any page or post.

== Description ==

Site3D Configurator connects your WordPress site to [Site3D](https://configurator.site3d.site). After you create a configurator in the Site3D service, use the plugin to generate a shortcode and place the 3D widget wherever you need it.

* Shortcode: `[site3d data="CONFIGURATOR_ID"]` (with optional height parameters generated in the admin tool).
* Admin screen under **Site3D** in the dashboard to build the shortcode and copy it to the clipboard.

**External resources**

On the front end, the plugin enqueues a script from `site3d.site` to load the 3D viewer. No visitor data is sent to Site3D by the script URL alone; your configurator ID is only present in the shortcode output you place on the page.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install the ZIP from **Plugins → Add New → Upload Plugin**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Site3D** in the admin menu, enter your configurator ID, choose height options, and copy the shortcode into a post or page.

== Frequently Asked Questions ==

= Where do I create a configurator? =

Create it at [https://configurator.site3d.site](https://configurator.site3d.site), then use the ID in this plugin’s admin screen.

= Does this work with the block editor? =

Yes. Paste the shortcode into a Shortcode block or the classic shortcode block.

= Why does the plugin load JavaScript from site3d.site? =

The 3D viewer is hosted by Site3D; the plugin injects the loader script so the widget can run in the browser.

== Screenshots ==

1. Plugin admin page — configurator ID, height presets, and shortcode output.

== Changelog ==

= 0.1 =
* Initial release.

== Upgrade Notice ==

= 0.1 =
First release in the WordPress.org plugin directory.