Inco Jewellery – Complete System Documentation Last updated: 31-01-2026

Installation & Setup

2.1 System Dependencies

• XAMPP / WAMP / LAMP Stack
• Apache Web Server
• PHP 8.x or higher
• MySQL 5.7+
• VS Code or equivalent editor

2.2 Technology Stack

• Frontend: HTML5, CSS3, JavaScript
• Backend: PHP (MVC-based architecture)
• Database: MySQL
• Authentication: Registration, Login (mobile + password), Password Reset via OTP

2.3 Application Setup Steps

1. Upload Inco Jewellery files to server root
2. Create a new database
3. Import the provided SQL file
4. Configure database credentials
5. Set the application base URL

2.4 User Registration & Login

In Inco Jewellery, users must first register before logging in. During registration, the following details are required:

• Full Name
• Mobile Number
• Email Address
• Password
• Shipping Address

After successful registration, users can log in using their mobile number and password. OTP is not required for login.

2.5 Password Reset via OTP

In IncoJewellary, the password reset process is implemented using a One-Time Password (OTP) mechanism in a Core PHP environment. When a user forgets their password, the system retrieves the email address used during registration and sends an OTP to that same email for identity verification.

This functionality is handled directly within the forgot-password.php page. The OTP is generated server-side and sent using the PHP mailer function. Once the user enters the correct OTP within the allowed time, they are permitted to set a new password.

• Registered Email – The OTP is sent to the email address provided during user registration
• Admin Email – Used as the sender email for all OTP and system emails
• PHP Mail / PHPMailer – Used to send the OTP email from the forget password page

2.6 Email Configuration

IncoJewellary uses the built-in PHP mailer function to send emails directly from the server. All emails, including OTPs and password reset notifications, are sent from the admin email address to the user’s registered email.

ADMIN_EMAIL=info@incojewellary.com
MAIL_FROM_NAME=Inco Jewellery

• ADMIN_EMAIL – Email address used as the sender for all outgoing emails
• MAIL_FROM_NAME – Display name shown as the sender in user inboxes

3. Public Website Usage

3.1 Purpose of Public Website

The public website of Inco Jewellery serves as the primary storefront for browsing premium and trendy jewellery products. Users can explore jewellery listings, view product details, and check pricing before registering or logging in. To purchase jewellery, users must first create an account or log in, ensuring secure order processing and a personalized shopping experience.

3.2 Publicly Accessible Features

• Browse and search exquisite jewellery collections with high-quality images and detailed descriptions
• View product categories such as gold, silver, diamond, and fashion jewellery
• Register or log in to a user account to buy jewellery and manage orders
• Add favourite jewellery items to the wishlist for future purchase after login
• Add selected jewellery to the shopping cart and manage quantities
• Proceed to checkout and complete orders using secure payment options
• Make online payments through integrated Razorpay gateway
• Place orders using Cash on Delivery (COD) where available
• Receive order confirmation and invoice after successful purchase
• Track order status and delivery progress through Shiprocket integration
• Access order history, current orders, and delivery updates from the user account dashboard

After placing an order, users can monitor the entire order lifecycle from their account, including order processing, shipment dispatch, and final delivery status. Real-time tracking via Shiprocket ensures transparency and reliable delivery for jewellery purchases.

5. Admin Panel – Detailed Features

5.1 Admin Dashboard Overview

The Admin Dashboard in Inco Jewellery provides a centralized overview of the entire jewellery eCommerce platform, allowing administrators to monitor real-time business performance and sales trends.

• Total registered users/customers
• Total jewellery products, categories, and subcategories
• Total orders placed, including pending, processing, completed, and cancelled
• Total payments received via online methods and Cash on Delivery (COD)
• Graphical sales reports and product performance trends

5.2 User Account Management

Administrators can manage all registered customers from a single interface.

• View all registered users/customers
• Access profiles and order history
• Manage newsletter subscribers and contact enquiries
• Enable or disable user accounts when necessary

5.3 Product & Order Management

Inco Jewellery gives full control over jewellery listings and order processing.

• Add, edit, and delete jewellery products
• Manage product images, pricing, discounts, stock, and material details (gold, silver, diamond, etc.)
• View and process customer orders
• Handle exchange, return, and refund requests
• Update order statuses (Processing, Shipped, Delivered, Cancelled)
• Track shipment status through Shiprocket integration

5.4 Advertisement & Promotion Management

Admins can manage promotional banners, offers, and advertisements displayed across the jewellery platform.

• Add and manage homepage and category-specific advertisements
• Control visibility and display duration
• Enable or disable ads anytime
• Promote special offers, festive collections, and seasonal deals

5.5 Reviews, Enquiries & Content Control

Administrators can monitor and manage user-generated content to maintain platform credibility.

• View and manage jewellery product reviews
• Approve or feature selected reviews
• Manage testimonials submitted by customers
• Respond to contact and product enquiries

5.6 Categories, Attributes & System Settings

This section allows administrators to configure the structural and system-level settings of the jewellery platform.

• Add and manage product categories and subcategories (e.g., Gold, Silver, Diamond, Fashion Jewellery)
• Configure product attributes such as size, metal type, gemstone, and design
• Manage coupons, pincodes, and delivery availability
• Update website branding, contact information, and store policies

5.7 Reports, Payments & Analytics

Inco Jewellery provides detailed reports and analytics for informed business decisions.

• View payment history and transaction details for online and COD payments
• Analyze order trends, popular products, and sales performance
• Monitor COD vs online payment statistics
• Generate daily, monthly, and yearly sales and revenue reports

FAQs – Ecommerce Setup & Usage (Inco Jewellery)

1. Users are unable to place orders. What should be checked first?

Order placement issues are usually related to login status, cart validation, or product availability.

• Ensure the user is registered and logged in before checkout
• Verify selected jewellery products are in stock and active
• Check cart validation rules such as quantity limits and pricing
• Confirm checkout page routes are correctly configured

2. Razorpay payment is not opening or failing during checkout.

This typically occurs due to incorrect Razorpay key configuration or order creation issues.

• Verify Razorpay Key ID and Key Secret
• Ensure the order creation API returns a valid order ID
• Confirm test/live keys match the environment
• HTTPS must be enabled on the live server

3. Payment is successful but order status remains pending.

This happens when payment verification or webhook handling is incomplete.

• Ensure Razorpay payment verification is properly implemented
• Verify payment ID and signature validation logic
• Check database update after successful payment
• Confirm webhook URL is correctly configured (if used)

4. Cash on Delivery (COD) option is not visible at checkout.

COD availability depends on admin settings and serviceable pincodes.

• Enable COD in admin payment settings
• Verify that the delivery pincode supports COD
• Check if COD is disabled for specific jewellery products

5. Products added to cart are disappearing after refresh.

Cart persistence issues are usually related to session or database storage.

• Ensure the cart is stored against the user ID after login
• Verify session and cookie configuration
• Check insert/update logic in the cart table
• Ensure cookies are not blocked in the browser

6. Wishlist items are not saving or showing correctly.

Wishlist functionality requires user authentication and proper product-user mapping.

• Ensure the user is logged in before adding to wishlist
• Verify the wishlist table’s user-product relationship
• Check for duplicate entry handling

7. Order history is not visible in the user account.

Order history depends on successful order creation and proper user association.

• Confirm orders are saved with the correct user ID
• Check order status filters (pending, processing, completed, cancelled)
• Ensure account page queries retrieve the right data

8. Shiprocket tracking status is not updating.

Delivery status updates rely on proper Shiprocket API integration.

• Verify Shiprocket API credentials
• Ensure shipment ID is saved after order creation
• Check API cron jobs or status sync logic
• Confirm order is marked as shipped in the admin panel

9. Admin updates order status but users cannot see the change.

This may be caused by caching or incorrect status mapping in the frontend.

• Clear application and browser cache
• Verify order status values and mapping
• Ensure frontend queries the live database

10. Reports or sales analytics are not showing correct data.

Analytics depend on accurate order, payment, and user records.

• Include only completed orders in reports
• Verify date filters and timezone settings
• Check payment status before aggregating sales
• Ensure database indexing for large datasets

Need Help During Setup?

Free Setup Support for Inco Jewellery

Having trouble with installing or configuring Inco Jewellery — like user registration, login setup, product catalog setup, payment gateway (Razorpay) integration, COD configuration, or Shiprocket delivery tracking? Our support team offers free assistance to help you set up your jewellery eCommerce platform quickly and smoothly.

Click the button below to reach out and we’ll guide you step-by-step.

Contact Support Team