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