=== Keyideas RingBuilder - Jewelry ===

Contributors: Keyideas
Tags: customize rings, jewelry, ring builder, vdb
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.15
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Powerful Ring Builder plugin for WooCommerce jewelry stores. This customizable tool supports multiple languages and global ring sizes.

== Description ==

https://youtube.com/playlist?list=PLxIkMlb2za2WH1qNYoa6Y4iwoAzQn-VC6&si=iOf2HCKVHOTsxaK6

== Boost Your Jewelry Sales with Keyideas’ WooCommerce Ring Builder – Free to Start! ==

Enhance your WordPress jewelry store with our powerful, customizable Ring Builder plugin, designed to increase sales by up to 30%. Offer customers an engaging, interactive way to design their perfect ring.  

==Keyideas RingBuilder Plugin Overview==

The Ring Builder is a complete WordPress & WooCommerce plugin that enables customers to design custom engagement rings. It offers access to an entire inventory of diamonds and gemstones (natural, lab-grown, and colored), advanced filtering, interactive ring building, and seamless integration with your existing store. The plugin is designed to increase sales by up to 30% through enhanced customer engagement.  
View [Demo Store](https://web-design-company.site/apps/jewelry/)  

==Build Your Own Ring (BYOR)==

BYOR stands for 'Build Your Own Ring.' This feature allows customers to design their perfect ring by choosing a diamond or gemstone, selecting a setting or band design, picking metal type and finish, and previewing the final ring before adding to cart. 

==What makes our RingBuilder unique==

Complete BYOR experience with real-time visualization, dynamic pricing updates, seamless WooCommerce integration with no coding required, mobile-optimized responsive design, diamond size viewer, colorless to colored diamond switcher for easy toggling between diamond types, and support for multiple languages, currencies, and global ring sizes.

==Free Version Features==

The free version includes access to entire inventory of diamonds & gemstones (lab-grown, natural, and colored), advanced diamond search and filtering, complete Ring Builder functionality, diamond size viewer, multilingual and multi-currency support, customizable design to match your brand, and mobile-optimized experience.  
**Note:** The Add to Cart feature and Feed Center access are only available in the paid version.


==Paid Version Features==

The paid version includes everything in the free version, plus:  

- Add to Cart functionality for customer purchases  
- Email notifications when diamonds are added to cart  
- Full Feed Center access with sales performance dashboard, custom margin control (including tiered margins based on carat weight or price), strike-through discount pricing, ability to upload your own inventory, robust inventory management tools, and supplier-specific shipping day management

==Pricing==

**Annual Subscription:** $1,450/year (or $145/month)  
**One-time Setup Fee:** $550–$1,000 (based on your website complexity)  
**Payment Method:** Wire transfer only


==One-Time Setup Fee Coverage==

The setup fee includes complete plugin installation and configuration, theme compatibility testing and adjustments, ring builder integration with your product categories, and complete workflow testing and quality assurance. Setup typically takes 3-5 business days. We charge this fee because WordPress environments vary significantly, and we ensure seamless integration rather than leaving you to troubleshoot compatibility issues.

==Available Paid Add-ons==

**Pendant Builder:** Customers can create custom pendants by selecting diamonds or gemstones and pairing them with pendant settings. Works just like the Ring Builder with the same intuitive design process. Yearly subscription required.  
**Earring Builder:** Allows customers to design custom earrings by selecting a pair of diamonds or gemstones and choosing from various earring settings and styles. Yearly subscription required.  
**Engraving Options:** Add personalized text engraving capabilities to your products. One-time fee.  
**Product Library:** Access 100+ trending engagement and wedding ring designs with lifestyle 360° videos. Yearly fee.  
**Certificate Management:** Mask or redact certificate numbers in PDF documents for privacy. One-time fee.  
**Custom Supplier Integration:** Connect with RapNet, VDB, or any other diamond supplier via CSV or API. One-time setup fee plus server bandwidth and usage charges.  
Contact our sales team through the plugin interface for pricing and custom feature requests.

==Upgrading to the Paid Version==
Upgrading from the free version to the paid version is available at any time by contacting the support team. It is recommended to evaluate the free version first to ensure it meets your business requirements.

== Frequently Asked Questions ==

**What’s the Difference Between the Free and Paid Versions?**
The free version allows you to explore the Ring Builder (BYOR) experience with access to the diamond and gemstone catalog, advanced search and filtering, diamond size viewer, multilingual and multi-currency support, customizable design, and a fully mobile-optimized interface.
The paid version includes everything in the free version, plus:

- Add to Cart functionality to enable customer purchases
- Feed Center access with live pricing updates, margin control, sales tracking, and inventory management
- Supplier integrations including Nivoda and RapNet
- Global ring sizing (US, UK, EU, Australian, Asian standards)
- Engraving options (available as an add-on)
- Priority support and advanced configuration tools


**How often does pricing change?**

We review pricing annually to reflect new features and improvements. Any pricing changes are communicated in advance, and existing subscribers are notified before adjustments take effect.

**Do you offer refunds?**

No, we do not provide refunds after payment or subscription activation. This is because the process involves server setup, account configuration, diamond feed integration, and licensing. Please thoroughly test the free version before upgrading to ensure it meets your requirements.


**How does the colorless to colored diamond switcher work?**

The plugin includes an easy toggle that allows customers to switch between colorless (traditional white) diamonds and colored diamonds. This provides a seamless browsing experience and helps customers explore different diamond options without navigating away from their current view.   

**What diamonds and gemstones are available?**

The plugin includes the entire inventory of diamonds and gemstones from Nivoda, featuring natural diamonds (all ten popular shapes), lab-grown diamonds (all ten popular shapes), colored diamonds, and gemstones. We can also integrate with any international supplier who provides data in CSV format. Additionally, you can import your own diamond and gemstone inventory through the Feed Center (paid version only). 

**Can I import my own inventory?**

Yes, with the paid version, you can upload your own stock diamonds and gemstones via the Feed Center. We provide CSV templates (natural.csv, lab.csv, colored.csv, and gemstones.csv) to make the import process straightforward. CSV import guides are included to help you get started. The CSV formats available for download are:  

- [natural.csv](https://engagement-ring-builder-o4hk8.kinsta.app/app/sample-natural.csv)  
- [lab.csv](https://engagement-ring-builder-o4hk8.kinsta.app/app/sample-labgrown.csv)  
- [colored.csv](https://engagement-ring-builder-o4hk8.kinsta.app/app/sample-coloreddiamonds.csv)  
- [gemstones.csv](https://engagement-ring-builder-o4hk8.kinsta.app/app/sample-gemstones.csv)  


**What margins and shipping times are set during the free trial?**

During evaluation with the free version, margins are set at 0% on all diamonds and gemstones, and shipping is set to 10 days (default). Once you upgrade to the paid version, you can customize margins and shipping times through the Feed Center. 

**How does the Feed Center work?**

Once you activate a paid plan, our support team updates the diamonds in different categories through the Feed Center. This gives you access to inventory management, margin control, and performance tracking features. 

**How do I order a Nivoda diamond?**

You'll need a Nivoda account to order diamonds. In the paid version, when a customer adds a diamond to their cart, you'll receive an email notification with the SKU/stock number. Contact Nivoda by phone or email to place your order. This notification system allows you to respond quickly and fulfill orders efficiently. 

**Can you integrate with other suppliers like RapNet or VDB?**

Yes, custom supplier integrations are available as a paid add-on. While Nivoda comes pre-integrated (account required, no subscription to their app necessary), we can connect your store with RapNet, VDB, or any other supplier. Contact our sales team to discuss your specific needs. 

**How can I prevent search engines from indexing diamond inventory?**

You don’t need to add any tags, feeds, or custom robots.txt rules. The plugin automatically applies **noindex, nofollow** to diamond inventory products, category archives, and selected pages at the page level, which is the safest and most reliable SEO method.  
If you’re using additional SEO, caching, or crawler plugins and still see diamond products being crawled, please ensure those plugins are **not overriding page-level noindex rules** or forcing indexing through global settings or sitemaps.<br>**Recommended fallback settings (only if required):**
For SEO plugins like Yoast or Rank Math: 

- Set diamond product categories to **Noindex** 
- Disable sitemap inclusion for:  
    - kirb-diamonds  
    - kirb-lab-diamonds  
    - kirb-loose-diamonds  
    - kirb-gemstone-diamonds  
    - kirb-color-diamonds  
      
        
**Optional robots.txt rules (only if needed)**:  
 Disallow: /product-category/kirb-diamonds/  
 Disallow: /product-category/kirb-lab-diamonds/  
 Disallow: /product-category/kirb-loose-diamonds/  
 Disallow: /product-category/kirb-gemstone-diamonds/   
 Disallow: /product-category/kirb-color-diamonds/  


**Do you provide sample rings?**

Yes, we provide sample engagement rings to demonstrate how the Ring Builder works. These samples also serve as a guide for categorizing and tagging your own rings for compatibility. You can easily import these sample rings using the 'Import Sample Rings' button in Settings → Settings Category. You can replace them with your own designs at any time—your products remain completely yours. 

**What if I don't have my own ring settings?**

We offer a Product Library (paid add-on) with 100+ engagement and wedding ring designs in various metal types, complete with product and 360° lifestyle videos. These designs can be licensed for your website. Contact our sales team for details.
**Note:** We provide only digital assets. Design defects, manufacturing, and order fulfillment are your responsibility.

**How does the Ring Builder increase sales?**

Online retailers offering customization options like ring builders have seen conversion rates increase by 2-3x compared to stores without customization, and Average Order Value (AOV) boost of up to 30%. Customers are willing to pay more for personalized products and appreciate the ability to design their perfect ring.

**How can I customize the Ring Builder?**

You can add navigation menu links like 'Start with a Setting' or 'Start with a Natural Diamond,' select ring sizes for your region under Language & Region settings, adjust colors, fonts, and design elements in plugin settings to match your brand, and customers can preview the diamond and engagement ring setting before making a purchase.

**Can I customize the appearance to match my brand?**

Yes, the plugin is fully compatible with modern WordPress themes and WooCommerce. You can customize colors, fonts, and design elements through the plugin settings page. You can also hide specific elements on ring detail or review pages using custom CSS classes.

**Can I see examples of stores using the Ring Builder?**

Yes See how other jewelry stores have customized the Ring Builder to match their unique branding and style:  

- [dimendscaasi.com](https://dimendscaasi.com)  
- [bongioielli.com](htpps://bongioielli.com)  
- [ramziandco.com.au](https://ramziandco.com.au)   
 
These examples showcase the flexibility and professional results possible with our plugin.

**What if the plugin doesn't load properly with my theme?**

If plugin/filters are not loading, ensure your theme has proper WooCommerce container classes. For BYOR tab position issues, contact our support team for theme-specific CSS adjustments. Our support team is available to ensure seamless integration with your WordPress theme.

**What permissions does the plugin require?**

The plugin requires Read/Write Products (to create diamond products when added to cart), Read Orders (to access order details and mark diamonds as sold), Create Pages (to automatically generate diamond listings and detail pages), and Access WooCommerce Settings (to integrate with checkout and cart functionality).

**What languages are supported?**

The plugin supports multiple languages, including English (UK/US), French, Italian, German, Spanish, Arabic, Hebrew, and more. It supports both LTR (left-to-right) and RTL (right-to-left) languages and is compatible with popular translation plugins like WPML and Polylang. The default language is English.

**How do I select ring sizes for my region?**

Navigate to Language & Region → Basic tab in plugin settings. Select your language, and the ring size system will be automatically selected for that language (e.g., R1 for US/Mexico/Canada, R2/R3 for other countries). You can use the slider to preview different ring sizes. You can also hide the ring size feature on the review page if needed.

**Can I add multiple languages?**

Yes, in the Language & Region → Basic tab, you can add multiple languages by clicking on them. The ring size system for each language will be auto-selected.

**Can I customize the text on plugin pages?**

Yes, go to the Language & Region → Translations tab. Select the page you want to translate from the dropdown, enter your custom text in your desired language, and save. You can customize terms like 'cut', 'color', 'clarity' and more. For paid clients, this feature is managed by our support team.

**What is Keyideas Jewelry Filter and Search plugin?**

Transform your jewelry store with powerful filter and search capabilities designed for all jewelry types: Engagement Rings, Wedding Bands, Fine Jewelry, Earrings, Necklaces, Bracelets, Pendants, and more. Help customers find their perfect jewelry piece 3x faster and increase sales by up to 30% with an intuitive, mobile-optimized shopping experience.  
**Learn more:** [Keyideas Jewelry Filter and Search](https://wordpress.org/plugins/keyideas-jewelry-ring-filter-search/)

**What is Keyideas Vizora - 3D Try-On?**

Our 3D Virtual Try-On technology allows customers to try on jewelry rings from home using augmented reality. This plugin integrates seamlessly with WooCommerce to provide an immersive shopping experience, helping customers visualize how rings look on their hand before purchasing.  
**Learn more:** [Keyideas Vizora - 3D Try-On](https://www.keyideasinfotech.com/industries/retail-ecommerce/jewelry/3d-ar-virtual-try-on-vto-jewellery/) 

**What is Keyideas Timenox: All-in-One Watch Integration & Smart Filter App?**

Easily integrate luxury timepieces into your jewelry store with our powerful Watch Filter App. Filter by Brand, Model, Dial, Bracelet, Bezel, Size, Condition, Paper, and Year. Import your own inventory or browse curated collections. The app seamlessly adapts to your store's theme with mobile-optimized design, advanced search filters, and effortless inventory management, helping you expand beyond jewelry into luxury watches.  
**Learn more:** [Keyideas Timenox - Integrate Watches](https://www.keyideasinfotech.com/industries/retail-ecommerce/luxury-watch-store-website-design-services/)

**What is Keyideas Jewelith: 3D Jewelry Configurator for Rings, Bracelets & Necklaces?**

Design custom jewelry with real-time 3D previews (rotate, zoom & view details). Customers can customize metals, stones, engraving and sizes, with options for guided concierge service or self-serve configuration. Features include product uploads, shareable design links, seamless cart integration, and mobile-ready WordPress compatibility for an interactive shopping experience.  
**Learn more:** [Keyideas Jewelith - 3D Design Studio](https://www.keyideasinfotech.com/industries/retail-ecommerce/jewelry/3d-configurator-design-studio/)

**Where can I find video tutorials?**

Video tutorials are available within the plugin interface under Help and Support → Video Tutorials. These videos cover topics like adding filters, editing details, the BYOR process, and uploading diamonds.   
**Learn more:** [YouTube Playlist](https://www.youtube.com/playlist?list=PLxIkMlb2za2WH1qNYoa6Y4iwoAzQn-VC6)

**Where can I find FAQs within the plugin?**

Within the plugin interface, go to Help and Support → FAQs. You'll find answers to common queries about plan details, settings, language & region, and more.

**How do I get support?**

For support, custom features, or add-on inquiries, you can:  

- Use the contact form within the plugin interface (Help and Support → Contact Us)  
- Email our team at [sales@keyideasinfotech.com](mailto:sales@keyideasinfotech.com) or message us at [Whatsapp](https://wa.me/+919999403715) for assistance.  
- Edit your contact info within the plugin by clicking 'Edit contact info'    
  
Our support team is available to help with technical issues and troubleshooting, theme compatibility adjustments, custom feature development, supplier integration setup, and general plugin questions.

**Where can I learn more?**

**Demo Store:** See the Ring Builder in action with live examples of natural diamonds, lab-grown diamonds, colored diamonds, and gemstones at [Demo Store](https://web-design-company.site/apps/jewelry/)  
**Product Page:** View features, pricing, and latest updates at [WooCommerce Plugins by Keyideas](https://www.keyideasinfotech.com/industries/retail-ecommerce/jewelry/diamond-engagement-ring-builder/)
 

== Installation ==

**Minimum Requirements:**

- PHP 7.0 or higher
- MySQL 5.6 or higher
- WordPress 5.5 or higher

**Recommended Requirements:**

- PHP 8.1 or higher
- MySQL 5.7 or higher
- WordPress 6.7 or higher

**Plugin Installation:**

1. Log in to your WordPress admin panel
2. Navigate to *Plugins → Add New*
3. Search for 'Keyideas RingBuilder - Jewelry'
4. Click Install Now, then Activate
5. The plugin will appear in your WordPress left side menu  
 
**Plugin Link:** [Keyideas RingBuilder ](https://wordpress.org/plugins/diamond-ring-builder-jewelry/) 

**Post-Installation Setup:**

After installation, go to *Settings → Permalinks* and click Save Changes. This creates the necessary detail pages for diamonds and rings to display properly.

**Accessing the Plugin Dashboard:**

After activation, click on 'Keyideas RingBuilder' in your WordPress left side menu. From there, you can access Manage, Settings, Language & Region, Feed Center, and Help & Support sections.

**Plugin Configuration:**

Stone types can be configured from *Settings → Choose Your Stones*. Select the stone types you want to display (Natural Diamonds, Lab Diamonds, Gemstones, Colored Diamonds). When a stone type is selected, its listing page link is automatically created. You can also define how many products load initially on the listing page.

== Changelog ==

= v1.0.0 =
* Initial release

= v1.0.1 =
* Performance and UI Updates

= v1.0.2 =
* Resolved UI issues on listing and detail pages.

= v1.0.3 =
* Resolved performance and plugin activation related issues.

= v1.0.4 =
* UI and performance updates with few bug fixes.

= v1.0.5 =
* Overall plugin UI and performance updates with major bug fixes. 

= v1.0.6 =
* We’ve added two stunning new diamond shapes to the collection
* Updated the overall plugin experience and increased speed for smoother performance.

= v1.1.0 =
* Implemented numerous bug fixes and performance enhancements.
* Introduced teal-colored gemstones as a new addition.
* Revamped caching system for significantly improved performance and greatly reduced server resource usage.
* Integrated diamond virtual try-on feature on the diamond detail page.

= v1.1.2 =
* Virtual Diamond Viewer now defaults to shape and carat of respective diamond.

= v1.1.3 =
* Added Italian language support.

= v1.1.4 =
* UI and performance updates with few bug fixes.

= v1.1.5 =
* Minor bug fixes and improvements.

= v1.1.6 =
* Minor internal bug fixes and improvements.

= v1.2.0 =
* Major bug fixes and UI improvements.

= v1.2.1 =
* Major major bugs and enhance the overall plugin performance.

= v1.2.2 =
* Fix security issues in the plugin and overall plugin enhancements.

= v1.2.3 =
* Fix minor issues on diamond listing page filters.

= v1.2.4 =
* Minor stability bug fixes and review notice added.

= v1.2.5 =
* Renamed plugin from "Diamond Ring Builder ‑ Jewelry" to "Keyideas RingBuilder - Jewelry"

= v1.2.6 =
* Minor stability bug fixes.

= v1.2.7 =
* Update SEO and search engine crawling issues.

= v1.2.8 - v1.2.15 =
* Minor stability bug fixes.