{"id":4323,"date":"2024-12-23T12:25:00","date_gmt":"2024-12-23T18:25:00","guid":{"rendered":"http:\/\/racmanuel.dev\/?post_type=docs&#038;p=4323"},"modified":"2024-12-23T12:25:01","modified_gmt":"2024-12-23T18:25:01","password":"","slug":"getting-started","status":"publish","type":"docs","link":"https:\/\/racmanuel.dev\/en\/docs\/ar-model-viewer-for-woocommerce\/getting-started\/","title":{"rendered":"Getting Started"},"content":{"rendered":"\n<h4 class=\"wp-block-heading\"><strong>1. Install and Activate the Plugin<\/strong><\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Automatic Installation<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Log in to your WordPress Admin Panel.<\/li>\n\n\n\n<li>Navigate to <strong>Plugins > Add New<\/strong>.<\/li>\n\n\n\n<li>In the search bar, type <strong>AR Model Viewer for WooCommerce<\/strong>.<\/li>\n\n\n\n<li>Click <strong>Install Now<\/strong> next to the plugin, and once installed, click <strong>Activate<\/strong>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Manual Installation<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Download the plugin\u2019s ZIP file from <a href=\"https:\/\/wordpress.org\/plugins\/ar-model-viewer-for-woocommerce\/\" rel=\"nofollow noopener\" target=\"_blank\">WordPress.org<\/a>.<\/li>\n\n\n\n<li>Go to <strong>Plugins > Add New > Upload Plugin<\/strong>.<\/li>\n\n\n\n<li>Select the downloaded ZIP file and click <strong>Install Now<\/strong>.<\/li>\n\n\n\n<li>After installation, click <strong>Activate Plugin<\/strong>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Verification<\/strong>:\n<ul class=\"wp-block-list\">\n<li>After activation, verify that the plugin appears in your WordPress Admin under <strong>Settings > AR Model Viewer for WooCommerce<\/strong>.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>2. Configure Plugin Settings<\/strong><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">After activating the plugin, configure it to suit your store&#8217;s needs:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Navigate to Settings<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Go to <strong>Settings > AR Model Viewer for WooCommerce<\/strong> in your WordPress Admin Panel.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Basic Settings<\/strong>:\n<ul class=\"wp-block-list\">\n<li><strong>Default Model Dimensions<\/strong>: Set the initial dimensions for displaying 3D models. Adjust these to match the typical size of your products.<\/li>\n\n\n\n<li><strong>Enable AR Support<\/strong>: Toggle this setting to allow AR viewing on compatible devices.<\/li>\n\n\n\n<li><strong>Max File Size<\/strong>: Specify the maximum upload size for 3D model files to ensure large models can be added without errors.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>meshy.ai Integration<\/strong>:\n<ul class=\"wp-block-list\">\n<li>If using the Pro version, enter your <strong>meshy.ai API Key<\/strong> to unlock AI-powered 3D model generation.<\/li>\n\n\n\n<li>Configure default AI settings, such as preferred model output resolution.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Shortcode Customization<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Review and adjust shortcode settings if you plan to display 3D models outside of WooCommerce product pages.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Save Changes<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Click the <strong>Save Changes<\/strong> button to apply your configurations.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>3. Add 3D Models to Your Products<\/strong><\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Navigate to WooCommerce Products<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Go to <strong>Products > All Products<\/strong> in your WordPress Admin Panel.<\/li>\n\n\n\n<li>Select an existing product to edit, or click <strong>Add New<\/strong> to create a new product.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Locate the AR Model Viewer Metabox<\/strong>:\n<ul class=\"wp-block-list\">\n<li>In the product edit page, scroll down to find the <strong>AR Model Viewer<\/strong> section.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Upload a 3D Model<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Click <strong>Choose File<\/strong> and upload a .glb or .gltf file for your product.<\/li>\n\n\n\n<li>For large models, ensure the file size does not exceed the upload limit configured in the plugin settings.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Set Model Properties<\/strong>:\n<ul class=\"wp-block-list\">\n<li><strong>Initial Position and Zoom<\/strong>: Define the default orientation and zoom level for the model when displayed in 3D.<\/li>\n\n\n\n<li><strong>Lighting and Background<\/strong>: Customize how the model appears, including lighting and the background color or texture.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Save the Product<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Click <strong>Update<\/strong> (for existing products) or <strong>Publish<\/strong> (for new products) to save your changes.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>4. Preview in AR<\/strong><\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>View the Product Page<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Open the product page on your WooCommerce store.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Check for 3D and AR Buttons<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Ensure that a <strong>View in 3D<\/strong> button is displayed for all users.<\/li>\n\n\n\n<li>Confirm that a <strong>View in AR<\/strong> button appears for devices with AR compatibility (e.g., mobile devices with ARCore or ARKit support).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Test the AR Feature<\/strong>:\n<ul class=\"wp-block-list\">\n<li>On a compatible mobile device:\n<ul class=\"wp-block-list\">\n<li>Click the <strong>View in AR<\/strong> button.<\/li>\n\n\n\n<li>Follow the device prompts to place the product in your environment using the camera.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Verify Customer Experience<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Ensure the model loads properly and that AR interaction works as expected.<\/li>\n\n\n\n<li>Adjust the model&#8217;s dimensions, rotation, or lighting settings in the product editor if necessary.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>5. Advanced Configuration (Optional)<\/strong><\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Custom Shortcodes<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Use the <code>[ar_model_viewer]<\/code> shortcode to embed 3D models on posts, pages, or other parts of your website.<\/li>\n\n\n\n<li>Configure additional attributes such as width, height, or specific model files.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Enable AI Model Generation (Pro Feature)<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Go to <strong>Settings > AR Model Viewer for WooCommerce > AI Features<\/strong>.<\/li>\n\n\n\n<li>Choose to generate a model from text descriptions or images.<\/li>\n\n\n\n<li>Test generated models and link them to your WooCommerce products.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Test Across Devices<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Verify functionality on various devices (desktop, mobile, tablet) to ensure seamless compatibility.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>1. Install and Activate the Plugin 2. Configure Plugin Settings After activating the plugin, configure it to suit your store&#8217;s needs: 3. Add 3D Models to Your Products 4. Preview in AR 5. Advanced Configuration (Optional)<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_gspb_post_css":"","_glsr_average":0,"_glsr_ranking":0,"_glsr_reviews":0,"footnotes":""},"doc_category":[90],"doc_tag":[],"class_list":["post-4323","docs","type-docs","status-publish","hentry","doc_category-ar-model-viewer-for-woocommerce"],"blocksy_meta":[],"year_month":"2026-06","word_count":582,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"racmanuel","author_nicename":"ra_cm","author_url":"https:\/\/racmanuel.dev\/en\/author\/ra_cm\/"},"doc_category_info":[{"term_name":"AR Model Viewer for WooCommerce","term_url":"https:\/\/racmanuel.dev\/en\/docs\/category\/ar-model-viewer-for-woocommerce\/"}],"doc_tag_info":[],"acf":[],"_links":{"self":[{"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/docs\/4323","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/comments?post=4323"}],"version-history":[{"count":1,"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/docs\/4323\/revisions"}],"predecessor-version":[{"id":4324,"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/docs\/4323\/revisions\/4324"}],"wp:attachment":[{"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/media?parent=4323"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/doc_category?post=4323"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/racmanuel.dev\/en\/wp-json\/wp\/v2\/doc_tag?post=4323"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}