=== Edel Museum Generator ===
Contributors: edelhearts
Tags: 3d, gallery, museum, three.js, portfolio
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create immersive 3D virtual museums and galleries from your WordPress posts.

== Description ==

**Edel Museum Generator** allows you to easily create high-quality 3D virtual museums and galleries on your WordPress site.

Powered by Three.js, it provides a smooth, immersive "First Person Shooter" (FPS) style walkthrough experience directly in the browser.

This plugin is perfect for artists, photographers, and creators who want to showcase their portfolio in a unique and engaging way.

### ✨ Features

* **Immersive 3D Walkthrough:** Visitors can walk around the gallery using keyboard (WASD) and mouse.
* **Custom Post Types:** Manage "Artworks" and "Exhibitions" easily from the WordPress dashboard.
* **Detailed View:** Click on artworks to view high-resolution images, titles, and descriptions in a popup modal.
* **Customizable Design:** Change textures for floors, walls, and ceilings.
* **Lighting Control:** Adjust room brightness and spotlights with sliders to create the perfect atmosphere.
* **Visual Editor:** Includes a backend visual editor to fine-tune artwork positions.
* **Shortcode Copy:** Easily copy the embed code directly from the list view or edit screen.
* **Full I18n Support:** Fully compatible with translation plugins like Loco Translate.

### 🚀 Upgrade to Pro

Unlock the full potential of your virtual museum with **Edel Museum Generator Pro**:

* **Link Integration:** Add links to your artworks (e.g., WooCommerce product pages, affiliate links).
* **3D Model Support:** Place GLB/GLTF models (sculptures, furniture) in your gallery.
* **Pillar Placement:** Add pillars to the room structure for more layout options.
* **Premium Support:** Get priority assistance via email.

[Get the Pro Version Here](https://edel-hearts.com/edel-museum-generator-pro/)

== Installation ==

1.  Upload the plugin files to the `/wp-content/plugins/edel-museum-generator` directory, or install the plugin through the WordPress plugins screen directly.
2.  Activate the plugin through the 'Plugins' screen in WordPress.
3.  Go to **Museum Artworks** to add your art pieces.
4.  Go to **Exhibition Settings** to create a room and assign artworks to walls.
5.  Copy the shortcode (e.g., `[edel_museum id="123"]`) from the list or edit screen and paste it into any post or page.

== Screenshots ==

1.  **3D Gallery View:** A user exploring a virtual gallery with spotlights.
2.  **Detail Modal:** Clicking an artwork reveals the title and description.
3.  **Editor Mode:** Adjusting the layout visually in the backend.
4.  **Settings Panel:** Customizing textures and lighting.

== Frequently Asked Questions ==

= Can I use my own textures? =
Yes!
You can specify image URLs for the floor, walls, and ceiling in the Exhibition Settings.

= Does it work on mobile? =
Yes, the viewer is responsive and includes touch controls (joystick), although a larger screen is recommended for the best immersive experience.

= Can I sell my art through this plugin? =
The Lite version allows you to display art.
To add "Buy Now" links directly to the artworks, you will need the [Pro Version](https://edel-hearts.com/edel-museum-generator-pro/).

== Changelog ==

= 1.3.0 =
* Fix: Code improvements for WordPress Plugin Directory compliance.
* Fix: Fixed function and HTML ID prefixes to avoid conflicts.
* Fix: Moved inline scripts and styles to external files.
* Update: Updated Three.js library to r147.

= 1.2.0 =
* Bug fixed.

= 1.1.0 =
* Update: Full internationalization (i18n) support.
* Feature: Added "Copy Shortcode" button to the admin list and edit screen.
* Improvement: Improved Viewer UI (Help and Settings toggle).
* Change: Simplified room structure (Wall-only layout) for the Lite version.
* Tested up to WordPress 6.9.

= 1.0.0 =
* Initial release.