ThreeWP is a WordPress plugin that integrates the Three.js library and its addons into your WordPress site using a custom bundle file. This setup allows you to create and manage custom 3D models, animations, and interactive graphics directly within your WordPress theme or custom JavaScript code.<\/p>\n\n
The source code for the minified JavaScript bundle file used in this plugin is publicly available at the following URL: https:\/\/github.com\/rondevs\/threejs-custom-bundler<\/p>\n\n
After activating the plugin, Use the Add Custom JavaScript:\n- Add your Three.js initialization and rendering code to your theme\u2019s JavaScript file or use a custom script. Here\u2019s a basic example:<\/p>\n\n NOTE: Destructure THREE and the addons to access from ThreeWP bundle.<\/p>\n\n Responsive Design: Adjust the size of the Three.js container or renderer according to your design requirements. Handle window resizing events to keep the 3D content responsive.\nDocumentation: Refer to the Three.js documentation for detailed information on creating more complex scenes, objects, and animations.<\/p>\n\n *Introduced custom bundle file integration for Three.js and essential addons like OrbitControls, GLTFLoader, EffectComposer, and BloomPass etc. \n*This version enhances the plugin's capabilities and provides a more comprehensive setup for integrating Three.js with WordPress.<\/p>\n\n We welcome contributions to improve this plugin. If you have suggestions, bug reports, or feature requests, please open an issue on https:\/\/github.com\/rondevs\/threewp\/issues.<\/p>\n\n This plugin is licensed under the GPLv2 or later. See the LICENSE file for details.<\/p>\n\n If you encounter any issues or need assistance, please reach out via https:\/\/github.com\/rondevs\/threewp\/issues.<\/p>\n\n Thank you for using ThreeWP! We hope it enhances your WordPress site with exciting 3D content.<\/p>\n\n\n - Go to your WordPress dashboard.\n- Navigate to Plugins<\/strong> > Add New<\/strong>.\n- In the search bar, type ThreeWP<\/strong>.\n- Locate the ThreeWP<\/strong> plugin and click Install Now<\/strong>.\n- After installation, click Activate<\/strong>.<\/p>\n\n[use_threewp]<\/code> shortcode to enable Three.js for specific pages. Three.js and its addons will be available for use in your theme or custom JavaScript files. You need to manually add your Three.js code to create and manage 3D content.<\/p>\n\nExample Usage<\/h3>\n\n
document.addEventListener('DOMContentLoaded', function () {\n if (typeof ThreeWP !== 'undefined') {\n \/\/ Destructure THREE and THREE_ADDONS from ThreeWP\n const { THREE, OrbitControls } = ThreeWP;\n \/\/ Create a scene\n const scene = new THREE.Scene();\n \/\/ Setup a camera\n const camera = new THREE.PerspectiveCamera(\n 75,\n window.innerWidth \/ window.innerHeight,\n 0.1,\n 1000,\n );\n \/\/ Setup a renderer\n const renderer = new THREE.WebGLRenderer();\n \/\/ Give the renderer a width and height\n renderer.setSize(window.innerWidth, window.innerHeight);\n \/\/ Append the renderer into the html body\n document.body.appendChild(renderer.domElement);\n \/\/ Set camera position\n camera.position.z = 2;\n \/\/ Load a texture\n const textureLoader = new THREE.TextureLoader();\n const texture = textureLoader.load(\n 'https:\/\/threejsfundamentals.org\/threejs\/resources\/images\/wall.jpg',\n ); \/\/ Replace with your image URL\n \/\/ Create geometry\n const geometry = new THREE.BoxGeometry(1, 1, 1);\n \/\/ Create material\n const material = new THREE.MeshStandardMaterial({ map: texture });\n \/\/ Combine into mesh\n const sphere = new THREE.Mesh(geometry, material);\n scene.add(sphere);\n const light = new THREE.AmbientLight(0xffffff);\n scene.add(light);\n \/\/ Set up OrbitControls\n const controls = new OrbitControls(\n camera,\n renderer.domElement,\n );\n \/\/ Optional: Adjust controls settings (e.g., damping, auto-rotation)\n controls.enableDamping = true; \/\/ Adds smoothness when dragging\n controls.dampingFactor = 0.03;\n controls.autoRotate = true;\n controls.autoRotateSpeed = 2;\n function animate(t = 0) {\n requestAnimationFrame(animate);\n controls.update();\n renderer.render(scene, camera);\n }\n animate();\n \/\/ Responsive\n window.addEventListener('resize', () => {\n camera.aspect = window.innerWidth \/ window.innerHeight;\n camera.updateProjectionMatrix();\n renderer.setSize(window.innerWidth, window.innerHeight);\n });\n } else {\n console.error('Three.js could not be loaded.');\n }\n});\n<\/code><\/pre>\n\nTips<\/h3>\n\n
Available Tools in This Plugin<\/h3>\n\n
\n
\n
v2.0.2<\/h3>\n\n
\n
2.0.1<\/h4>\n\n
\n
defer<\/code> attribute to the Three.js script for improved performance and load times.<\/li>\n2.0.0<\/h4>\n\n
1.1.0<\/h4>\n\n
\n
1.0.0<\/h4>\n\n
\n
Contributing<\/h3>\n\n
License<\/h3>\n\n
Support<\/h3>\n\n
\n