PHPackages webbycrown/rapnet-for-bagisto - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. webbycrown/rapnet-for-bagisto ActiveLibrary webbycrown/rapnet-for-bagisto ============================= RapNet Diamond Trading Network integration for Bagisto - Display and sell certified diamonds with real-time inventory access 1.0.1(6mo ago)03MITBladePHP ^8.1 Since Nov 14Pushed 6mo ago1 watchersCompare [ Source](https://github.com/rohit-ghoghari/rapnet-for-bagisto)[ Packagist](https://packagist.org/packages/webbycrown/rapnet-for-bagisto)[ RSS](/packages/webbycrown-rapnet-for-bagisto/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)DependenciesVersions (2)Used By (0) WebbyCrown RapNet for Bagisto ============================= [](#webbycrown-rapnet-for-bagisto) 1. Introduction: ---------------- [](#1-introduction) "RapNet for Bagisto" seamlessly integrates with the RapNet Diamond Trading Network, empowering jewelry store admins to display and sell certified diamonds from RapNet's extensive global inventory. This extension enables Bagisto store owners to access thousands of diamonds, manage pricing with custom commissions, and provide customers with a professional diamond shopping experience. ### Features: [](#features) - πŸ”Œ Direct RapNet API integration for real-time diamond inventory - πŸ’Ž Access to thousands of certified diamonds from global suppliers - πŸ’° Flexible commission system (percentage or fixed discount) - 🎨 Customizable product display with multiple column layouts (1-4 columns) - πŸ“Š Configurable diamond attribute fields with drag-and-drop reordering - πŸ–ΌοΈ Custom placeholder images for different diamond shapes (Round, Princess, Marquise, etc.) - πŸ” Advanced filtering by shape, color, clarity, cut, and more - βš™οΈ Admin panel configuration interface for API credentials and settings - πŸ›’ Optional Add to Cart and Quick View functionality - πŸ“„ Pagination with custom posts per page - 🎯 Easy integration with existing Bagisto stores - πŸ“± Responsive design support 2. Requirements: ---------------- [](#2-requirements) - **PHP**: 8.1 or higher - **Bagisto**: v2.0.\* - **Composer**: 1.6.5 or higher - **RapNet Account**: Active RapNet API subscription required 3. Installation: ---------------- [](#3-installation) ### Step 1: Install the Package [](#step-1-install-the-package) ``` composer require webbycrown/rapnet-for-bagisto ``` ### Step 2: Publish Assets (if needed) [](#step-2-publish-assets-if-needed) ``` php artisan vendor:publish --provider="Webbycrown\RapnetBagisto\Providers\RapnetServiceProvider" ``` ### Step 3: Clear Cache [](#step-3-clear-cache) ``` composer dump-autoload php artisan optimize:clear ``` 4. Configuration: ----------------- [](#4-configuration) ### Admin Panel Settings [](#admin-panel-settings) Navigate to: **Admin Panel β†’ Configuration β†’ APIs β†’ RapNet** The RapNet extension provides four main configuration sections: ### 4.1 API Settings [](#41-api-settings) Configure your RapNet API credentials: FieldDescriptionRequired**API Key**Your RapNet API Keyβœ… Yes**API Secret**Your RapNet API Secret Keyβœ… Yes> **Note:** Get your API credentials from your [RapNet Account Dashboard](https://www.rapnet.com/) ### 4.2 Template Settings [](#42-template-settings) Customize how diamonds are displayed in your store: FieldDescriptionOptions**Commission Type**How to apply commission on diamond prices`percent` or `fixed`**Commission Percentage**Commission amount/percentageNumeric value**Add to Cart Button**Show Add to Cart button on product listingsβœ… Enable/Disable**Quick View**Enable Quick View modal for diamondsβœ… Enable/Disable**Posts Per Page**Number of diamonds to display per pageNumeric (e.g., 20, 50)**Load More Data With**Method for loading more products`pagination` or `infinite scroll`**Shop Page Loader**Custom loading imageUpload image file**Product Column**Grid layout for product display1, 2, 3, or 4 columns**Reorder Fields**Drag-and-drop field orderingSortable list### 4.3 Placeholder Settings [](#43-placeholder-settings) Upload custom placeholder images for each diamond shape when actual images aren't available: - **Default Image** - Fallback for any shape - **Round Image** - For round diamonds - **Princess Image** - For princess cut diamonds - **Marquise Image** - For marquise cut diamonds - **Oval Image** - For oval diamonds - **Radiant Image** - For radiant cut diamonds - **Emerald Image** - For emerald cut diamonds - **Heart Image** - For heart-shaped diamonds - **Cushion Image** - For cushion cut diamonds - **Asscher Image** - For asscher cut diamonds > **Supported formats:** JPG, PNG, BMP, WebP ### 4.4 Shape Settings [](#44-shape-settings) Upload shape icons for filter/navigation display: Upload icons/images for each diamond shape to display in shape filters and navigation menus. 5. Available Diamond Attributes: -------------------------------- [](#5-available-diamond-attributes) The extension provides access to the following RapNet diamond attributes: ### Basic Attributes [](#basic-attributes) - **Diamond ID** - Unique identifier - **Shape** - Diamond shape (Round, Princess, etc.) - **Size** - Carat weight - **Color** - Color grade (D-Z scale) - **Clarity** - Clarity grade (FL-I3 scale) - **Cut** - Cut grade - **Polish** - Polish grade - **Symmetry** - Symmetry grade ### Fancy Color Attributes [](#fancy-color-attributes) - **Fancy Color Intensity** - Color intensity - **Fancy Color Overtone** - Secondary color - **Fancy Color Dominant Color** - Primary color ### Measurements [](#measurements) - **Depth Percent** - Depth percentage - **Table Percent** - Table percentage - **Measurement** - Dimensions (LxWxD) - **Meas Length** - Length in mm - **Meas Width** - Width in mm - **Meas Depth** - Depth in mm ### Grading Details [](#grading-details) - **Girdle Min** - Minimum girdle thickness - **Girdle Max** - Maximum girdle thickness - **Girdle Condition** - Girdle finish - **Culet Size** - Culet size - **Culet Condition** - Culet condition - **Fluor Intensity** - Fluorescence intensity - **Fluor Color** - Fluorescence color ### Certification [](#certification) - **Lab** - Grading laboratory (GIA, IGI, HRD, etc.) - **Cert Num** - Certificate number - **Has Cert File** - Certificate PDF available - **Eye Clean** - Eye clean designation ### Pricing [](#pricing) - **Price Per Carat** - Per carat price - **Total Sales Price** - Final price - **Discount** - Discount percentage - **Currency Code** - Currency (USD, EUR, etc.) - **Currency Symbol** - $ Β£ € etc. ### Media [](#media) - **Has Image File** - Product image available - **Image File URL** - Image URL - **Video URL** - Video URL - **Has Sarineloupe** - Sarine loupe available ### Supplier Information [](#supplier-information) - **Company** - Supplier company name - **Stock Num** - Supplier stock number - **Country** - Supplier country - **Account ID** - RapNet account ID 6. Field Reordering: -------------------- [](#6-field-reordering) The extension includes a powerful drag-and-drop field reordering system: ### How to Reorder Fields: [](#how-to-reorder-fields) 1. Navigate to **Configuration β†’ APIs β†’ RapNet β†’ Template Settings** 2. Find the **Reorder Fields** section 3. **Active Column**: Fields currently displayed 4. **Inactive Column**: Hidden fields ### Reorder Process: [](#reorder-process) - **Drag fields** between Active/Inactive columns - **Reorder fields** within the Active column to change display order - **Edit labels** by clicking the edit icon next to any field - **Custom labels** will be saved and displayed instead of default labels ### Example Configuration: [](#example-configuration) **Active Fields (Displayed):** 1. Checkbox 2. Shape 3. Size 4. Color 5. Clarity 6. Cut 7. Lab 8. Price/CT 9. Total Price 10. Action **Inactive Fields (Hidden):** - Fancy Color Intensity - Fancy Color Overtone - Fluor Intensity - Polish - Symmetry - etc. 7. Pricing & Commission: ---------------------------- [](#7-pricing--commission) ### Commission Types: [](#commission-types) #### Percentage Discount [](#percentage-discount) ``` Final Price = (RapNet Price) Γ— (1 + Commission%) Example: $5,000 Γ— (1 + 0.15) = $5,750 ``` #### Fixed Discount [](#fixed-discount) ``` Final Price = RapNet Price + Fixed Amount Example: $5,000 + $500 = $5,500 ``` ### Setting Commission: [](#setting-commission) 1. Go to **Configuration β†’ APIs β†’ RapNet β†’ Template Settings** 2. Select **Commission Type** (percent or fixed) 3. Enter **Commission Percentage** (e.g., 15 for 15% or 500 for $500) 4. Save configuration 8. Frontend Integration: ------------------------ [](#8-frontend-integration) ### Display Options: [](#display-options) #### Product Grid Columns [](#product-grid-columns) - **4 Column Layout** - Compact grid, more products visible - **3 Column Layout** - Balanced view - **2 Column Layout** - Larger product cards - **1 Column Layout** - Detailed list view #### Additional Features [](#additional-features) - **Add to Cart Button** - Enable instant cart addition - **Quick View** - Modal popup with diamond details - **Pagination** - Standard page navigation - **Infinite Scroll** - Auto-load more products on scroll 9. API Integration: ------------------- [](#9-api-integration) ### How It Works: [](#how-it-works) 1. **API Connection**: Extension connects to RapNet API using your credentials 2. **Data Sync**: Diamond inventory is fetched in real-time 3. **Price Calculation**: Commission is applied based on your settings 4. **Display**: Diamonds are displayed according to your template settings 5. **Filtering**: Customers can filter by shape, size, color, clarity, etc. 6. **Ordering**: Customers can add diamonds to cart and complete purchase ### Data Flow: [](#data-flow) ``` RapNet API β†’ Extension β†’ Price Calculation β†’ Display β†’ Customer Purchase ``` 10. FAQ: -------- [](#10-faq) **Q: Do I need a RapNet account?** A: Yes, you need an active RapNet API subscription to use this extension. **Q: Are diamond prices updated in real-time?** A: Yes, prices are fetched from RapNet API based on your sync settings. **Q: Can I customize the commission per diamond?** A: The extension applies a global commission rate. Custom per-diamond pricing requires additional customization. **Q: What diamond shapes are supported?** A: All standard shapes: Round, Princess, Marquise, Oval, Radiant, Emerald, Heart, Cushion, Asscher, Pear, and more. **Q: Can I hide certain diamond attributes?** A: Yes, use the Field Reordering feature to move unwanted fields to the Inactive column. **Q: Are diamond images included?** A: Yes, if available from RapNet. You can also upload custom placeholder images for each shape. **Q: Can customers filter diamonds?** A: Yes, the extension supports filtering by all major attributes (shape, color, clarity, cut, price range, etc.). **Q: Is the extension compatible with Bagisto themes?** A: Yes, it integrates with standard Bagisto themes. Custom themes may require minor adjustments. 11. Troubleshooting: -------------------- [](#11-troubleshooting) **API connection fails:** - Verify API Key and API Secret are correct - Check RapNet account is active and has API access - Ensure your server can make outbound HTTPS requests - Check firewall/security settings **Diamonds not displaying:** - Confirm API credentials are configured - Check if fields are in the Active column (Field Reordering) - Verify your RapNet account has inventory access - Clear cache: `php artisan cache:clear` **Images not showing:** - Upload placeholder images for each shape - Check image file formats (JPG, PNG, WebP) - Verify storage permissions - Ensure AWS\_FILE\_PATH is set if using S3 **Commission not applying:** - Check Commission Type is selected (percent or fixed) - Verify Commission Percentage field has a value - Clear configuration cache: `php artisan config:clear` **Field reordering not working:** - Clear browser cache - Check JavaScript console for errors - Ensure jQuery and jQuery UI are loaded - Try re-saving the configuration 12. Support: ------------ [](#12-support) - πŸ› [Report Issues](https://github.com/webbycrown/rapnet-for-bagisto/issues) - πŸ“§ Email: - 🌐 Website: [webbycrown.com](https://webbycrown.com) - πŸ“– RapNet API Docs: [rapnet.com/api](https://www.rapnet.com/) 13. Changelog: -------------- [](#13-changelog) ### v1.0.1 - 2025-11-14 [](#v101---2025-11-14) #### πŸ“š Documentation Release [](#-documentation-release) - πŸ“– Complete comprehensive README with detailed documentation - πŸ”§ Added detailed API configuration guide with credential setup - πŸ’‘ Added template customization guide with all options - 🎨 Added placeholder and shape image upload instructions - πŸ“Š Documented all 40+ diamond attributes with descriptions - πŸ”„ Added field reordering system documentation with examples - πŸ’° Added pricing and commission calculation examples - ❓ Added comprehensive FAQ section (8 questions) - πŸ› οΈ Added troubleshooting guide for common issues - 🌐 Added frontend integration options documentation - πŸ› Fixed namespace in RapnetServiceProvider.php - πŸ“‹ Added CHANGELOG.md for version tracking - πŸš€ Added RELEASE\_NOTES.md for GitHub releases - πŸ”‘ Enhanced composer.json with SEO keywords - πŸ“¦ Set package to stable release ready for production --- ### v1.0.0 - 2024-01-01 [](#v100---2024-01-01) #### ✨ Initial Release [](#-initial-release) - πŸŽ‰ Initial release of **RapNet for Bagisto** - πŸ”Œ Full RapNet API integration for diamond inventory management - πŸ’Ž Real-time access to global diamond inventory - πŸ’° Flexible commission system with percentage and fixed options - 🎨 Customizable product display with 1-4 column layouts - πŸ“Š Advanced drag-and-drop field reordering system - πŸ–ΌοΈ Custom placeholder images for all diamond shapes - πŸ” Comprehensive diamond attribute filtering - βš™οΈ Admin panel configuration interface - πŸ›’ Optional Add to Cart and Quick View features - πŸ“„ Configurable pagination and infinite scroll - 🌍 Multi-currency support #### πŸ“š Documentation [](#-documentation) - πŸ“– Comprehensive README with detailed setup guide - πŸ”§ API configuration instructions - πŸ’‘ Template customization examples - 🎨 Placeholder and shape image upload guide - ❓ FAQ section answering common questions - πŸ› οΈ Troubleshooting guide for common issues - πŸ“‹ Complete diamond attributes reference - πŸ“š Field reordering instructions #### πŸ”„ Package [](#-package) - πŸ“¦ Stable package version for production use - ✨ Simple installation: `composer require webbycrown/rapnet-for-bagisto` - 🏷️ Properly tagged and versioned for Packagist - πŸ“¦ Published to Packagist: [webbycrown/rapnet-for-bagisto](https://packagist.org/packages/webbycrown/rapnet-for-bagisto) - πŸ™ Open source on GitHub: [webbycrown/rapnet-for-bagisto](https://github.com/webbycrown/rapnet-for-bagisto) --- **Made with ❀️ by [WebbyCrown](https://webbycrown.com)** ### Health Score 32 β€” LowBetter than 72% of packages Maintenance69 Regular maintenance activity Popularity3 Limited adoption so far Community9 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor1 Top contributor holds 55.6% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 180d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/4be8c491dee65372c701ca519d413336b1d7fc62148a413eb329b087226123c8?d=identicon)[webbycrown](/maintainers/webbycrown) --- Top Contributors [![mayur-dhandhukiya](https://avatars.githubusercontent.com/u/154992408?v=4)](https://github.com/mayur-dhandhukiya "mayur-dhandhukiya (5 commits)")[![rohit-ghoghari](https://avatars.githubusercontent.com/u/50444614?v=4)](https://github.com/rohit-ghoghari "rohit-ghoghari (4 commits)") --- Tags laravele-commercebagistowebbycrownrapnetdiamondsjewelry ### Embed Badge ![Health badge](/badges/webbycrown-rapnet-for-bagisto/health.svg) ``` [![Health](https://phpackages.com/badges/webbycrown-rapnet-for-bagisto/health.svg)](https://phpackages.com/packages/webbycrown-rapnet-for-bagisto) ``` ### Alternatives [jsdecena/laracom Laravel powered e-commerce 2.0k4.4k](/packages/jsdecena-laracom)[amsgames/laravel-shop Package set to provide shop or e-commerce functionality (such as CART, ORDERS, TRANSACTIONS and ITEMS) to Laravel for customizable builds. 4845.9k](/packages/amsgames-laravel-shop)[bagistoplus/visual Bagisto theme framework and visual theme editor 645.8k2](/packages/bagistoplus-visual)[lunarphp/stripe Stripe payment driver for Lunar. 2055.8k4](/packages/lunarphp-stripe)[getcandy/core GetCandy Laravel e-commerce core functionality. 156.6k3](/packages/getcandy-core) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)