WP 3D Thingviewer Lite

Description

This plugin provide a 3D model files viewer to embed your 3d models on your WordPress pages or posts.
You can load models into WordPress media into multiple format (STL, OBJ, FBX, GLB) 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. Gutenberg block editor support
2. Ease of use via shortcode button generator
3. Display a preview image for the 3d model
4. Support multiple 3d model file types (STL, FBX, OBJ, GLB)
5. Support textured model in GLB file format
6. Multiple thingviewers per page or post
7. 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
8. Fully translatable via .PO files
9. Built on WordPress Plugin Boilerplate by Tom McFarlin.
10. Uses Three.js library to render the viewer.

There is available a paid version of the plugin that have more customization options here:

https://codecanyon.net/item/wp-3d-thingviewer/23631168

Screenshots

Blocks

This plugin provides 1 block.

• WP 3D Thingviewer Lite

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 and Gutenberg.

This is the shortcode manual use:

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

The parameters are the following

• model_file: specify the model 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.

You can display a preview image instead of the Thingviewer at page load.

This is the shortcode with the preview image:

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

If your 3d model is displayed in a incorrect rotation, you can rotate the model on loading, by specifying the rotation values on X, Y, and Z axis in the shortcode.
This is the usage:

[wp-3dtvl model_file="https://www.mywebsite.com/wp-content/uploads/2019/01/case.stl" rotation_x=20 rotation_y=30][/wp-3dtvl]

In this example the model will be rotated by 20 degrees on the X axis, by 30 degrees on the Y axis and by 0 degrees on the Z axis.

What can I do in the thingviewer?

You can display a preview image when the Thingviewer is loaded.
You can switch from the prewie image to the Thingviewer by clicking the “toggle” button.
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.

Can I insert multiple thingviewers in the same page?

Yes, it is possible to embed multiple thingviewers in the same page.

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 thingviewer javascripts.
This feature is available in the full version.

Can I decide what button display into the thingviewer?

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

Where I can find the full version of this plugin?

The full version of this plugin is available here:

https://codecanyon.net/item/wp-3d-thingviewer/23631168

Reviews

Simple and straightforward to use

Tatenda B Mpofu February 17, 2024

Simple and straightforward to use, good features available on the free app

No plugin config page in the WP Admin Menu

dusitnpoissant February 7, 2023 1 reply

In the demo the config page appears in the WP Admin Menu, but when I installed it nothing showed up. I tried deactivating and reactivating and uninstalling and reinstalling… no config page ever shows up so this is completely useless, but it looks great on their demo page and I wish i could get it to work.

Good to develop further.

t1m1ng March 1, 2022

Light weight clean looking viewer should be developed further so users can customize more settings. Support of .3MF files.

Got nowhere with this…

0maha June 11, 2021

Gave it a try. When you install, there are no configuration screens or anything. After a bit of reading, discovered that the use is based on embedding a shortcode like this: [wp-3dtvl model_file=”your_file_name”][/wp-3dtvl] Tried that with multiple models, and all I got was an on-screen error saying “An error occurred loading model”. Dug around some more and found the author’s demo model from the Envato based paid version of this plugin. Tried substituting the path for that model. Same result. In summary: Gave this an honest try. Could not get it to work at all.

After a long search this STL-viewer works!!

hertje78 March 8, 2019

I’ve been searching for a simple STL-viewer and I found it in WP 3D Thingviewer Lite!

Contributors & Developers

Changelog

3.2

• Added support for DRACO model files
• Added automatic demo page creation ad plugin activation

3.1

• Fixed bug for missing files
• Deleted unused files

3.0

• Added Gutenberg block editor support
• Added model preview image with thingviewer activation button
• Added 3D model rotation on loading
• Added support for Popup Anything plugin (allow to load the thingviewer into a Popup Anything modal)
• Added support for model with texture (in GLB file format)
• Fixed thingviewer appearance on page load problem
• Fixed model volume and area calculation problem
• Bugfix for GLB model loading
• Changed three.js library to r136

2.1

• Bug fix for i18 class

2.0

• Added FBX, OBJ and GLB 3d model file support
• Added multiple thingviewer in the same page

1.2.5

• Bug fix

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.