=== Threepress ===
Contributors: kerryoco
Tags: threejs, 3d model, gltf, chat, multiplayer
Donate link: http://threepress.oko.nyc/donate
Requires at least: 4.0
Tested up to: 6.8
Requires PHP: 5.6
Stable tag: 1.8.7
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

3d model gallery uploader and viewer powered by three.js

== Description ==

Easily embed [three.js](https://threejs.org) in [Wordpress](https://github.com/Wordpress/Wordpress)

## What you can do:

### Create three.js galleries anywhere

Create galleries using the shortcode generator in the Threepress admin, and then paste the shortcode wherever you want - the javascript that renders the shortcodes is loaded on all public pages.

A gallery renders one three.js Scene.

To customize the layout or dimensions of your gallery, use CSS.  An id tag of form `#threepress-gallery-[gallery name]` is put on the *wrapper* of the `<canvas>` element, or use class `.threepress-gallery` / `.threepress-gallery canvas` to target all galleries.

The gallery renderer (three.js object) should adjust to match your given dimensions automatically to prevent skewing or blurring.

If you want to custom code your own gallery, scroll down to 'javascript devs'.

## Installation

The plugin will create one database table to store your galleries:
`threepress_shortcodes`,

This remains in place upon deactivation, so if you want to remove it you must do so manually.

## Notes

All models must be in ".glb" format - most 3d programs can export to this.  

They are stored in the Media Library like everything else, but can be found easily through the Threepress library, which simply filters for ".glb" extensions.

#### For javascript devs:
All the galleries on a given page will be available in the global variable `THREEPRESS`, in the `galleries` property.  See the `Gallery` class (`static/js/ThreepressGallery.js`) for insight on interacting with these.

== Screenshots ==
1. A GUI for quickly creating scenes, with many features planned to be added
2. Added in v1.0 - heightmaps, fog and sunlight
3. Experimenting with 'readymade' models in Threepress World
4. An artist installing their own artworks in a Threepress World 

== Changelog ==
= 1.8.7 =
* fix - Disable Threepress Worlds query indefinitely
= 1.8.6 =
* Switched all external links from 'threepress.shop' to 'threepress.oko.nyc'
= 1.8.5 =
* clearer UX for logged / non-logged, edit / cannot edit toons in Threepress World
= 1.8.3 =
* better toon management both for users and admins in Threepress World.   
= 1.8.1 =
* typo!  version was omitted previously
= 1.8.0 =
* fixes glb uploads for hosts which required model/gltf-binary mime types (this should fix wordpress.com uploads)
= 1.7.4 =
* fixed bug when previewing some galleries in admin
= 1.7.3 =
* added a loading bar to all on-page galleries
= 1.7.2 =
* escape shortcode attributes on save / load to ensure validity
= 1.7.1 =
* feature: allow Threepress World admins more backend controls
= 1.7.0 =
* feature: global settings - allow conditional loading by post / page
* fix: clearer model load errors in admin
= 1.6.7 =
* fixed versioning
= 1.6.5 =
* feature: World: allow extensible section of 'readymades'
* fix: World: OrbitControls and object transforms fixes
= 1.6.3 =
* feature: change World controls to OrbitControls instead of custom
= 1.6.2 =
* fix: prevent mobile panning on zoom
= 1.6.1 =
* fix: allow GLTFloader to load compressed models using 'meshopt_decoder.js' module
= 1.6.0 =
* feature: basic support for multiplayer model uploading in Threepress Worlds
= 1.5.1 =
* fix: some animation names were not getting decoded, so, would not play.
= 1.5.0 =
* feature: Media Library will now preview glb files
= 1.4.2 =
* require jquery
= 1.4.1 =
* ongoing updates to Threepress World
= 1.4.0 =
* Threepress World procedurally generated worlds and terrain
* Threepress World image and model installs
* Threepress World image and model controls
= 1.3.0 =
* Threepress World, multiplayer chat, beta
* non-fatal undefined variable in threepress.php fixed
= 1.2.1 = 
* activation error fixed
= 1.2.0 =
* basic HDR images available
= 1.1.2 =
* animation display bugfix
* multiple threejs versions
= 1.1.1 =
* animation GUI bugfixes
= 1.1.0 =
* ambient lights
* animations
= 1.0.3 =
* added snow
* saving coordinates bugfix
= 1.0.2 = 
* cleaner cam / light / ground positioning code, and bugfixes
* UI tweaks
= 1.0.1 = 
* allow 10x more model 'float' granularity for ground contact
= 1.0.0 =
* core features added to editor - fog, heightmaps, shadows.  Also editor UI update.
