WP 3D Thingviewer Lite

Description

This plugin provide a 3D model files viewer to embed your STL models on your WordPress pages or posts.
You can load models into WordPress media into STL file format and then, by using the plugin shortcode generator, you can embed the thingviewer into you pages or posts.
In the thingviewer you can move, rotate and zoom the camera (with mouse or with keyboard). A set of option buttons are provided to let you access some useful information.
– Help window button to display the mouse and keyboard commands to operate the thingviewer.
– Info window button display some useful information about the loaded model, like surface are, volume, bounding box.
– Fullscreen button let you switch to fullscreen mode. You can go back to the “windowed” mode by clicking on the “close” button.
– Bounding box button display around the loaded model a wireframe bounding box.

Theese are the features of the plugin:

  1. Ease of use via shortcode button generator
  2. Support STL files (binary, ascii)
  3. Info window information visilibity
    • model filename
    • model size in KBytes
    • model triangles number
    • model surface area in cm2
    • model volume in cm3
    • model bounding box size in cm
  4. Fully translatable via .PO files
  5. Built on WordPress Plugin Boilerplate by Tom McFarlin.
  6. Uses Three.js library to render the viewer.

Soon will be available a full version of this plugin with customization functionalities

Screenshots

  • This is a shortcode example.
  • The thingviewer in action.
  • The the help window.
  • The bounding box.
  • The information window.

Installation

This section describes how to install the plugin and get it working.

  1. Upload wp-3d-thingviewer-lite folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the Plugins menu in WordPress

FAQ

How can I display the thingviewer?

Before all you have to load into the media of your WordPress the STL file of the 3D model you want to display.
After that you can use the shortcode to display the thingviewer into your pages or posts.

The plugin provide a shortcode generator button into Classic Editor.

This is the shortcode manual use:

[wp-3dtvl model_file="http://www.mywebsite.com/wp-content/uploads/2019/01/case.stl"][/wp-3dtvl]

The parameters are the following

  • model_file: specify the STL file URL to display.

The plugin display a thingviewer that load the selected STL file and let you interact with this.
The thingviewer is always resized at the width of the parent element.
The height will be calculated to display the thingviewer in a 16:9 ratio.

What can I do in the thingviewer?

You can move and rotate the camera with mouse or with keyboard.
You can display an help window which display the available commands list.
You can display the bounding box of the model.
You can display an information window with some informations abount the loaded model (size, volume, surface area,…)

Why the model I loaded is completely black?

Probably because there are some problems with your model: holes, flipped normals.
You can check and correct the model with your 3D modeling software or with this online tool

https://www.trinckle.com/en/printorder.php

Can I insert multiple thingviewers in the same page?

No. With multiple thingviewers in the same page it will be not possible to use the keyboard commands.
This feature will be available in the full version.

Can I change the colors of the model, grid and fog?

The plugin does not have a configuration page that allow you to do this, howerver you can customize the colors by modify the thingvier javascripts.
A configuration page will be available in the full version.

Can I decide what button display into the thingviewer?

No. The button bar cannot be customized.
This feature will be available in the full version.

Where I can find the full version of this plugin?

Will be available soon.
I will update here the link to the full version when it will be available…

Reviews

Read all 1 review

Contributors & Developers

“WP 3D Thingviewer Lite” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.2.4

  • Bug fix

1.2.3

  • Bug fix

1.2.2

  • Bug fix

1.2.1

  • Bug fix

1.2

  • Bug fix

1.1

  • Bug fix

1.0

  • First release.