| 1 |
# WPVR Sample Tour Data |
| 2 |
|
| 3 |
This directory contains the sample tour data that gets imported when the WPVR plugin is activated for the first time. |
| 4 |
|
| 5 |
## File Structure |
| 6 |
|
| 7 |
- `wpvr_11852.json` - Main tour configuration file containing: |
| 8 |
- Tour title and settings |
| 9 |
- Scene definitions |
| 10 |
- Hotspot configurations |
| 11 |
- Tour metadata |
| 12 |
|
| 13 |
- `S1.jpg`, `S2.jpg`, `S3.jpg`, `S4.jpg` - Scene images for the sample tour |
| 14 |
- S1: Living room scene (default scene) |
| 15 |
- S2: Stairs view scene |
| 16 |
- S3: Bedroom scene |
| 17 |
- S4: Kids room scene |
| 18 |
|
| 19 |
## How It Works |
| 20 |
|
| 21 |
When the WPVR plugin is activated: |
| 22 |
|
| 23 |
1. The system checks if any existing WPVR tours exist |
| 24 |
2. If no tours exist, it automatically imports the sample tour |
| 25 |
3. Files are copied from this directory to the WordPress media library |
| 26 |
4. A new post of type `wpvr_item` is created with the tour data |
| 27 |
5. Scene images are processed and linked to the tour |
| 28 |
|
| 29 |
## WordPress.org Compliance |
| 30 |
|
| 31 |
This approach is fully compliant with WordPress.org plugin guidelines: |
| 32 |
- No ZIP file extraction at runtime |
| 33 |
- No prohibited file operations |
| 34 |
- Files are included directly in the plugin structure |
| 35 |
- Uses standard WordPress media handling functions |
| 36 |
|
| 37 |
## Customization |
| 38 |
|
| 39 |
To customize the sample tour: |
| 40 |
1. Replace the image files with your own panoramic images |
| 41 |
2. Update the `wpvr_11852.json` file with new tour configuration |
| 42 |
3. Ensure scene IDs in the JSON match the image filenames |
| 43 |
|
| 44 |
## File Requirements |
| 45 |
|
| 46 |
- Scene images should be equirectangular panoramic images |
| 47 |
- Recommended resolution: 2048x1024 or higher |
| 48 |
- Supported formats: JPG, PNG |
| 49 |
- JSON file must be valid JSON format |
| 50 |
|
