Açıklama
Press3D is a powerful and feature-rich WordPress plugin that enables you to display interactive 3D models directly on your website. Built with the industry-standard Three.js library, it provides a professional-grade 3D viewing experience with extensive customization options.
Supported 3D Model Formats:
- STL – Popular for 3D printing and CAD models (binary and ASCII)
- OBJ – Universal 3D format compatible with most 3D software
- GLB – Binary glTF format (recommended for best web performance)
- GLTF – Text-based glTF format with separate asset files
Key Features:
- Gutenberg Block Integration – Native WordPress block editor support with live preview
- Shortcode Support – Use
[press3d id="123" version="1"]anywhere in your content with version control - Interactive 3D Viewer – Rotate, zoom, and pan with mouse or touch controls
- Camera State Persistence – Saves and restores exact camera position and orientation
- Auto-Rotate Mode – Automatic model rotation with adjustable speed (-10 to +10)
- Material Customization – Control colors, shininess/metalness (0-1 scale)
- Lighting Control – Adjustable light intensity (0-10 range) with ambient + directional lighting
- Shadow Support – Enable realistic shadows for your 3D models
- Camera Controls – Option to enable or disable user camera interaction
- Multiple Loading Animations – Choose from Spinner, Progress Bar, 3D Cube, or None
- Responsive Design – Automatic canvas resizing for all screen sizes and devices
- Mobile-Friendly – Touch controls for rotation, zoom, and pan on tablets and phones
- Accessibility Ready – ARIA labels, alt text support, and keyboard navigation
- WordPress Media Library – Upload models directly through standard media uploader
- Dimension Controls – Set custom width/height with multiple units (px, %, em, rem, vw, vh)
- Translation Ready – Full internationalization support (text domain: press3d)
Perfect for:
- Product showcases and e-commerce 3D product views
- Architectural visualization and real estate
- Educational content and scientific models
- Engineering and CAD model presentations
- 3D printing file previews
- Medical and anatomical models
- Art and sculpture portfolios
- Game assets and character models
Source Code
The source code for this plugin is available in the src and assets/src directories.
Ekran Görüntüleri
Bloklar
Bu eklenti 1 blok sağlar.
- 3D Model Display an 3D model file.
Yükleme
Automatic Installation:
- Log in to your WordPress admin panel
- Go to Plugins Add New
- Search for “Press3D”
- Click “Install Now” and then “Activate”
Manual Installation:
- Download the plugin ZIP file
- Go to Plugins Add New Upload Plugin
- Choose the downloaded file and click “Install Now”
- Activate the plugin through the Plugins menu
Using the Plugin:
- Go to Settings Press3D to configure default options
- In the block editor, add a “Press3D Model” block (find it in the Media category)
- Upload your 3D model file (STL, OBJ, GLB, or GLTF) via the media library
- Customize viewer settings in the block inspector panel
- Publish your page/post to display the interactive 3D model
Using Shortcodes:
After uploading a model to the Media Library:
1. Click on the model attachment to open Attachment Details
2. Click the “3D model shortcode” button to configure viewer settings
3. Copy the generated shortcode (e.g., [press3d id="123" version="2"])
4. Paste the shortcode anywhere in your posts, pages, or widgets
The shortcode format is: [press3d id="123" version="2"] where:
– id is the attachment ID
– version is the model version number (supports multiple versions of the same model)
SSS
-
What 3D model formats are supported?
-
Press3D supports four major 3D formats: STL, OBJ, GLB, and GLTF. GLB (binary glTF) is recommended for best web performance and file size.
-
Is the plugin compatible with the Gutenberg block editor?
-
Yes! Press3D includes a native Gutenberg block with live preview, full inspector controls, and real-time 3D viewer in the editor.
-
Can I use shortcodes instead of blocks?
-
Absolutely! Use the shortcode
[press3d id="123" version="2"]where 123 is your media attachment ID. Shortcodes also support versioning with theversionparameter:[press3d id="123" version="2"]. -
Does it work with Classic Editor?
-
Yes, the shortcode works in both Gutenberg and Classic Editor.
-
What is the recommended file size for 3D models?
-
For optimal performance and page load times, we recommend keeping model files under 10MB. Consider using GLB format with compression for larger models.
-
Can I customize the appearance of the 3D viewer?
-
Yes! You can control:
– Model color
– Light intensity (0-10 scale)
– Shininess/metalness (0-1 scale, affects roughness and metalness)
– Auto-rotate speed and direction (-10 to +10)
– Loading animation style (Spinner, Progress Bar, 3D Cube, or None)
– Viewer dimensions (width/height with multiple units) -
Does the camera position save?
-
Yes! Press3D saves the exact camera state (position, target, up vector) so when you refresh the page, the 3D model appears exactly as you positioned it.
-
Is Three.js library included?
-
Yes, the Three.js library is bundled with the plugin and optimized for WordPress.
-
Are there any server requirements?
-
You need PHP 7.4 or higher and WordPress 6.6 or higher. The plugin uses standard WordPress APIs and doesn’t require special server configurations.
-
Does it work on mobile devices?
-
Yes! Press3D is fully responsive with touch controls for rotation, zoom, and pan on tablets and smartphones.
-
Can I use this plugin commercially?
-
Yes, Press3D is licensed under GPLv2 or later, which allows commercial use.
-
Is the plugin accessible?
-
Yes, Press3D includes ARIA labels, alt text support for screen readers, keyboard navigation, and semantic HTML structure.
-
Why are my STL models rotated differently than in other viewers?
-
Press3D automatically rotates STL models -90° around the X-axis to match the Y-up orientation standard used by most 3D software.
-
Can I set a default color for all models?
-
Yes! Go to Settings Press3D and set a default color.
-
How do I access model metadata programmatically?
-
Press3D exposes model metadata via WordPress REST API.
İncelemeler
Katkıda Bulunanlar ve Geliştiriciler
“Press3D” açık kaynaklı yazılımdır. Aşağıdaki kişiler bu eklentiye katkıda bulunmuşlardır.
Katkıda bulunanlar“Press3D” eklentisini dilinize çevirin.
Geliştirmeyle ilgilenir misiniz?
Kodu görüntüleyin, SVN deposuna göz atın ya da RSS ile geliştirme günlüğüne abone olun.
Değişiklik Kaydı
1.0.2
- Fixed remaining issues from the plugin review (escaping).
- Removed unused methods from Utils class.
1.0.1
- Fixed issues from the plugin review (remote assets, security).
1.0.0
Initial release.




