Difference between revisions of "STL Viewer - WordPress"

From Help Wiki
m (Upload .STL files to media library)
m
Line 9: Line 9:
 
* '''STL Viewer'''
 
* '''STL Viewer'''
 
* '''AP Extended Mime Types''' - ''let's you upload .stl files to your media library''
 
* '''AP Extended Mime Types''' - ''let's you upload .stl files to your media library''
 +
 +
===Change the default settings for SLT Viewer===
 +
# From your Dashboard go to '''Settings > STL Viewer'''
 +
# Set the Height and Width in pixels, i.e. 300px. '''Alert:''' If these fields are left blank or not formatted properly the plugin may not work.
  
 
===Upload .STL files to media library===
 
===Upload .STL files to media library===
Line 32: Line 36:
 
* alternatively you can change the default settings (see below)
 
* alternatively you can change the default settings (see below)
  
===Change the default settings for SLT Viewer (optional)===
+
 
# From your Dashboard go to '''Settings > STL Viewer'''
+
# Set the Height and Width in pixels, i.e. 300px. '''Alert:''' If these fields are not formatted properly the plugin will not work.
+
  
 
===Troubleshooting Tips / Known issues===
 
===Troubleshooting Tips / Known issues===
 
Doesn't work? Try:
 
Doesn't work? Try:
 
* Using the latest version of Chrome for your browser
 
* Using the latest version of Chrome for your browser
 +
* Make sure to properly apply the settings in '''Settings > STL Viewer'''
 
* Will only load the first stl file on a page. Does not support multiple files per page.
 
* Will only load the first stl file on a page. Does not support multiple files per page.
  

Revision as of 09:35, 21 November 2014

Blue-l.png
The STL Viewer plugin let's you embed interactive 3D models in your WordPress site. This plugin is based on thingiview.js, the similar to the embed tool used at http://www.thingiverse.com/.

Activate the necessary plugins

The following plugins must be activated in Dashboard > Plugins

  • STL Viewer
  • AP Extended Mime Types - let's you upload .stl files to your media library

Change the default settings for SLT Viewer

  1. From your Dashboard go to Settings > STL Viewer
  2. Set the Height and Width in pixels, i.e. 300px. Alert: If these fields are left blank or not formatted properly the plugin may not work.

Upload .STL files to media library

  • The plugin will be referencing the file name of each .stl file so make sure they are unique.
  • If you get an error saying "Sorry, this file type is not permitted for security reasons" you need to activate the AP Extended Mime Types plugin

Add the plugin shortcode

  • Create a post or page and add the STL shortcode:
[stl file="blue_rabbit.stl" /]
  • Replace the filename with your .stl filename.
  • If you're not sure what the filename, go to your media library and look under the Attachment Details for your uploaded file.

Wp-file-attachment.png

  • View your post to check that it's working

Stl-viewer-blue-rabbit.png

For more control of how the model is dispalyed

  • add more parameters to the shortcode
[stl file="blue_rabbit.stl" color="#2b56b8" background="#f8f8f8" width="100%" height="640px" /]
  • alternatively you can change the default settings (see below)


Troubleshooting Tips / Known issues

Doesn't work? Try:

  • Using the latest version of Chrome for your browser
  • Make sure to properly apply the settings in Settings > STL Viewer
  • Will only load the first stl file on a page. Does not support multiple files per page.


Still have WordPress questions?