Three Importer allows users to insert custom ThreeJS scenes which can be implemented via Block editor, shortcode, or custom script injection. This allows people with little-to-no coding experience to well-seasoned developers to create beautiful, 3D scenes with full control over the settings.

Block Support
Three Importer has full support with the official WordPress Block Editor. Simply type and select “/Three Importer” in your page editor and you’ll see the 3D render notice for the public view.

Shortcode Support
Three Importer allows the exact same functionality from blocks within the [ti3d_scene] shortcode. Developers can also use the [ti3d_sceneinject] shortcode to call project-specific libraries from THREE and use them within custom scripts.

Shortcode Parameters

Geometry Settings

geometry : Type of 3D shape (default: box).
geometry_color : Hex color code (default: #000000).
geometry_material : Three.js material type (default: basic).
geometry_size : Scaling factor (default: 1).
geometry_xrotation / yrotation / zrotation : Initial rotation.
geometry_instancing : Enable instanced rendering (default: false).
geometry_instancingnum : Total instances (default: 50).
geometry_instancingspacing : Gap between instances (default: 1).
gltf_url : URL for external GLTF/GLB models.

Lighting Settings

light : Light source type (default: ambient).
light_color : Color of the light (default: #ffffff).
light_intensity : Brightness (default: 1).
light_xpos / ypos / zpos : Light coordinates (default: 0).
light_helper : Toggle visual position guide (default: false).

Camera Settings

camera_xpos / ypos / zpos : Camera coordinates.
camera_xtarget / ytarget / ztarget : Camera look-at target.
camera_followmouse : Enable mouse-tracking (default: false).

Particles & Scene

scene_background : Background color or transparency (default: none).
particle_amount : Total particles (default: 1000).
particle_size : Size of particles (default: 1).
particle_speed : Movement speed (default: 5).
particle_direction : Flow direction (default: right).
particle_color : Particle hex color (default: #000000).
particle_stretch : Motion stretch factor (default: 5).

Grid & Text

cubegrid_stretch : Grid stretch amount (default: 120).
cubegrid_spacing : Distance between grid cubes (default: 1).
cubegrid_material : Material for the grid (default: phong).
cubegrid_color : Grid hex color (default: #ffffff).
trid_text : String of text to render in 3D (default: TI).
trid_color : Color of 3D text (default: #ffffff).
trid_size : Depth/Size of 3D text (default: 1).

[ti3d_sceneinject] Available Modules

Controls: orbitcontrols, flycontrols, firstpersoncontrols, pointerlockcontrols, trackballcontrols
Loaders: gltfloader, objloader, fbxloader, textureloader, cubetextureloader, dracoloader, rgbeloader
Post-Processing: effectcomposer, renderpass, unrealbloompass, shaderpass, ssaopass
Shaders: fxaashader, copyshader, luminosityshader, sobeloperatorshader
Geometry: boxlinegeometry, convexgeometry, parametricgeometry, teapotgeometry
Helpers: gridhelper, axeshelper, camerahelper, directionallighthelper
Misc: animationmixer, gui