Threepress
kerryoco By kerryoco

May 12, 2024

Threepress Plugin

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

Easily embed three.js in 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’.

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.

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.

Screenshots

  1. A GUI for quickly creating scenes, with many features planned to be added

    A GUI for quickly creating scenes, with many features planned to be added

  2. Added in v1.0 - heightmaps, fog and sunlight

    Added in v1.0 - heightmaps, fog and sunlight

  3. Experimenting with 'readymade' models in Threepress World

    Experimenting with 'readymade' models in Threepress World

  4. An artist installing their own artworks in a Threepress World

    An artist installing their own artworks in a Threepress World

Changelog

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.

Details

  • Version: 1.7.1
  • Active installations: 200
  • WordPress Version: 4.0
  • Tested up to: 6.4.5
  • PHP Version: 5.6

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars