=== Planet Pop ===
Contributors: futurewebdesign
Donate link: https://fwdapps.net/p/pp
Tags: planets, space, 3D model viewer, gltf, sun
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Interactive 3D planet viewer with hotspots, tooltips, animations, environment maps and realistic lighting.

== Description ==
Showcase authentic 3D planets with realistic rendering (lights, environment maps and shadows). Add markers with tooltips and info windows, control animations, and tween the camera to predefined positions.

== Video Tutorial ==
https://www.youtube.com/watch?v=rNwZkonJe9g

== Highlights ==
**Realistic 3D Planets** - Realistic rendering with lights, environment maps and shadows.

**Easy To Configure And Install** - Includes documentation, video tutorials, demo pages, updates, and support from the developer - <strong><a href="mailto:tibi@fwdapps.net">Tibi @ FWD</a></strong>.

### Main Features

- **Responsive Layout** - Fully responsive and adaptable regardless of which device or screen size is used.
- **Desktop & Mobile Optimized** - Adapts to any screen size and device, whether on iOS/iPhone, Android, or desktop browsers.
- **Two Intro Transition Types** - When the scene is displayed for the first time, there are two available transitions: teleportation and opacity.
- **Parallax** - Optional vertical parallax.
- **Scale On Scroll** - This option lets Planet Pop start zoomed in, and as the user scrolls the page, the celestial smoothly returns to its normal scale.
- **Customizable Size** - The size of the images and the spacing between them can be adjusted as needed.
- **Customizable Geometry** - Configure the radius on the X and Z axes independently to create a true oval shape.
- **Sun** - Add realistic solar system planets to your page at any size, with configurable parameters like spin speed, light direction, and more... <a href="https://fwdapps.net/p/pp/demo-2.html">Saturn</a>, <a href="https://fwdapps.net/p/pp/demo-3.html">Jupiter</a>, <a href="https://fwdapps.net/p/pp/demo-4.html">Uranus</a>, <a href="https://fwdapps.net/p/pp/demo-5.html">Neptune</a>, <a href="https://fwdapps.net/p/pp/demo-6.html">Mercury</a>, <a href="https://fwdapps.net/p/pp/demo-7.html">Venus</a>, <a href="https://fwdapps.net/p/pp/demo-8.html">Earth</a>, <a href="https://fwdapps.net/p/pp/demo-10.html">Moon</a>, <a href="https://fwdapps.net/p/pp/demo-11.html">Mars</a>, <a href="https://fwdapps.net/p/pp/demo-19.html">Nebula</a>.
- **Planets** - Subtle camera rotation that follows the mouse, with adjustable strength for fine-tuned interaction.
- **Bonus Rocket** - Bonus rocket that can be added to your page at any size. <a href="https://fwdapps.net/p/pp/demo-12.html">Example here</a>.
- **Custom Tool To Place Celestials** - Detailed documentation for both WordPress and JavaScript versions.

== Configuration ==
After activation, open the plugin settings in the WordPress admin area and create a new viewer preset. Then use the shortcode below in any post or page.


### Use Cases
- Embedding 3D planets in posts or pages
- Product visualization with 3D previews
- Showcasing GLTF/GLB planets interactively
- Creating 3D hotspots and annotations
- Displaying 3D assets in portfolios or documentation

### Links
- [Homepage & Docs](https://fwdapps.net/p/pp)
- [Demo](https://fwdapps.net/p/pp#demos)
- [Support](https://fwdapps.net/contact)
- [Revolution Lightbox](https://fwdapps.net/p/rl/)

== Installation ==
1. Upload the plugin folder to the `/wp-content/plugins/` directory.  
2. Activate the plugin through the ‘Plugins’ menu in WordPress.  
3. Use the provided shortcode in your posts or pages.

== Shortcode ==
Basic example:

[fwdpp id="1"]


== Development ==
This plugin’s full source code is publicly available for transparency and verification.  
Developed and maintained by [FutureWebDesign](https://fwdapps.net).

- [Source code & build tools](https://fwdapps.net/p/pp/source.zip) — includes original uncompiled files and Vite build configuration.
- Distributed plugin uses a compiled build generated by Vite for optimal performance.

== Frequently Asked Questions ==
= Does it work with Gutenberg? =  
Yes. You can use the shortcode in any block or the Classic block.

= Is it mobile-friendly? =  
Yes. Planet Pop is fully responsive and optimized for touch.

= Can I use it with external media? =  
Yes, it supports many external media types (YouTube, Vimeo, Google Drive, etc.).
