Three Importer

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