=== ModelVista – 3D Model Viewer for WordPress ===
Contributors: secilkars
Tags: 3d viewer, 3d model, glb, gltf, woocommerce
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

ModelVista for WordPress: GLB/GLTF 3D models via shortcode; optional poster; interactive viewer. WooCommerce-friendly.

== Description ==

**ModelVista – 3D Model Viewer for WordPress** is a **3D model viewer for WordPress**: it lets you **display GLB and GLTF 3D models** in posts and pages using a simple shortcode. It is an **interactive 3D viewer plugin**—visitors can rotate, zoom, and explore models on desktop and mobile with the bundled `<model-viewer>` web component (no external JS CDNs).

**3D product viewer for WooCommerce:** WooCommerce is not required, but you can paste the same shortcode into product descriptions, tabs, or block content to showcase products in 3D—ideal as a **product viewer** alongside your catalog.

**Search-friendly phrases:** 3D model viewer for WordPress · display GLB and GLTF 3D models · 3D product viewer for WooCommerce · interactive 3D viewer plugin · GLB viewer · GLTF viewer · 3D viewer shortcode.

**How it works**

**ModelVista – 3D Model Viewer for WordPress** registers a dedicated content type for your models. Upload a **GLB** from the Media Library, set an optional **poster** image, tune height and controls, then copy the generated shortcode.

**Highlights**

* **3D model** workflow: one viewer per post type entry, Media Library integration
* **GLB** / **GLTF** (binary glTF) focus with bundled `model-viewer`
* **WooCommerce-friendly:** shortcode anywhere—classic editor, blocks, or product fields
* Per-viewer settings: height, auto-rotate, camera controls, disable zoom
* Live preview in admin; shortcode column in the list table
* Lightweight CSS; script loaded when needed

**Shortcode**

`[mode3dvi_3d_viewer id="123"]`

Replace `123` with your viewer post ID. Optional attributes: `height`, `auto_rotate`, `camera_controls`, `disable_zoom`.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Go to **ModelVista – 3D Model Viewers** in the admin menu and add a new viewer.
4. Upload a GLB file and optionally a poster image.
5. Copy the shortcode from the editor and paste it into any post, page, or **WooCommerce** product content.

== Frequently Asked Questions ==

= Which file formats are supported? =
The viewer targets **GLB** uploads. **GLTF** content is supported when provided as compatible glTF/GLB for `model-viewer`.

= Can I use this as a 3D product viewer for WooCommerce? =
Yes. Paste the shortcode into the product short description, a custom tab, or a block. WooCommerce does not need to be installed for the plugin to work elsewhere.

= Does the plugin load scripts from third-party CDNs? =
No. The `model-viewer` script is included in the plugin package.

= Is the viewer mobile-friendly? =
Yes. Controls are touch-friendly and the container is responsive.

== Screenshots ==

1. ModelVista – 3D Model Viewer for WordPress: editor with GLB, poster, settings, live preview, and shortcode
2. Front-end 3D model with interactive controls
3. List table with shortcode column for quick copy

== Changelog ==

= 1.0.6 =
* Version bump to align `Stable tag` with a new SVN release tag (`tags/1.0.6`). No functional code changes from 1.0.5.

= 1.0.5 =
* Plugin display name: **ModelVista – 3D Model Viewer for WordPress** aligned across `readme.txt` (title, short description, Description, Installation, Screenshots) and admin labels (post type, meta box).
* Readme: short description limited to 150 characters (WordPress.org plugin directory rule).

= 1.0.4 =
* Readme: SEO-oriented description keywords; tags updated (3d viewer, 3d model, glb, gltf, woocommerce). Note: WordPress.org allows at most five tags — "product viewer" is emphasized in the description text.

= 1.0.3 =
* Readme: expanded description and FAQ; screenshot captions updated for the plugin directory.

= 1.0.2 =
* Main plugin file renamed to `modelvista-3d-viewer.php` to match the plugin slug (WordPress.org convention).
* Remove directory banner/icon PNGs from the plugin package; add those via SVN `/assets/` after the plugin is approved.

= 1.0.1 =
* Unique `mode3dvi` prefix for functions, classes, options, script handles, and stored keys (WordPress.org guidelines).
* Bundle `model-viewer` web component locally instead of loading from a CDN.
* Remove manual `load_plugin_textdomain` call; WordPress.org loads translations for this plugin slug automatically.
* If you used version 1.0.0, the plugin migrates existing viewer posts and meta keys to the new prefix on upgrade.

= 1.0.0 =
* Initial release
* GLB upload support
* Poster image support
* Shortcode rendering with model-viewer

== Upgrade Notice ==

= 1.0.6 =
Release tag alignment only; no database changes.

= 1.0.5 =
Readme / branding alignment only; no database changes.

= 1.0.4 =
Readme and tag updates only; no database changes.

= 1.0.3 =
Documentation and readme updates only; no database changes.

= 1.0.2 =
If you installed a development build that used `modelvista-3d.php` as the main file, deactivate it and activate **ModelVista – 3D Model Viewer for WordPress** again after updating (file name now matches the plugin slug).

= 1.0.1 =
Prefix and shortcode tag updated to `mode3dvi_3d_viewer`; existing 1.0.0 data is migrated automatically when you update.
