Karwan Bazar — Super Shop & Grocery Ecommerce Platform

• PHP Version: 8.2, 8.3, 8.4, or 8.5
• Database: MySQL 5.7+ or MariaDB 10.3+
• Web Server: Apache with mod_rewrite or Nginx
• PHP Memory Limit: 256MB or higher (512MB recommended)
• Max Execution Time: 300 seconds
• Upload Max Size: 64MB or higher

1. Log into your cPanel account and navigate to File Manager.
2. Go to your domain root directory (typically public_html or your addon domain folder).
3. Upload the project zip file downloaded from Codester.
4. Click Extract to unpack the files.
5. Ensure your web root points to the project folder (or configure .htaccess).

1. In cPanel dashboard, open MySQL Database Wizard.
2. Create a new database (e.g. myuser_karwan).
3. Create a new database user and generate a strong password.
4. Assign the user to the database with ALL PRIVILEGES. Note down the Database Name, Username, and Password.

1. Open your web browser and visit: https://yourdomain.com/install
2. The installer will automatically verify server extensions and permissions.
3. In Step 2, enter your cPanel MySQL Database credentials.
4. In Step 3, click Run Migrations & Seeds. Tables and demo data will be populated automatically.
5. In Step 4, specify your desired Super Administrator Name, Email, and Password.
6. Installation completes and locks automatically!

If file permission warnings appear in cPanel File Manager, ensure the following folders have write permissions (chmod 775 or chmod 755):

chmod -R 775 storage bootstrap/cache

5.1 Dashboard Analytics & Revenue Metrics

The main overview dashboard features interactive real-time revenue charts (today, this week, this month, this year), gross wholesale margin indicators, total processed orders, customer acquisition counts, and instant status pills.

5.2 Product Catalog & Attribute-Based Pricing

Create grocery products using the 6-Step Guided Wizard:

• General Info: Product title, SKU, brand selector, category & dynamic subcategory dependent selector.
• Descriptions: Rich text descriptions, ingredient specifications, and storage instructions.
• Attribute-Based Pricing: Create price variations by packaging weight (e.g., 500g, 1kg, 5kg) or bulk wholesale grade. Add custom attribute values with inline editing.
• Stock & Inventory: Low stock alert thresholds and quantity tracking.
• Images: Multi-image gallery with real-time client-side preview.
• Auto-SEO Generator: Click the top "Auto SEO" button to automatically generate search meta titles, meta descriptions, and OpenGraph tags from product title and description.

5.3 Category & Subcategory Hierarchy

Build multi-level category navigation (e.g., Fresh Produce → Vegetables → Organic Leafy Greens). Each category supports either an image thumbnail or a searchable Lucide vector icon with custom color badges.

5.4 Order Fulfillment Workflow & Invoicing

Manage orders through comprehensive lifecycle states: Pending → Confirmed → Processing → Dispatched / Out for Delivery → Delivered → Cancelled / Refunded.

Click the Invoice button on any order to display a print-ready thermal or A4 customer bill with order QR, item packaging breakdown, and payment verification.

5.5 Abandoned Cart Recovery System

Automatically captures guest customer phone numbers, emails, items, and checkout drop-off steps in real-time. Features:

• 1-Click WhatsApp Recovery: Opens pre-composed WhatsApp chat with customer cart contents and a special incentive link.
• Direct Phone Calling: Fast contact with prospective buyers.
• Edit & Convert to Real Order: Edit items or delivery address and instantly convert the abandoned session into a confirmed order.

5.6 Anti-Fraud Security & Automated Blacklists

Protects your store against fake cash-on-delivery orders and malicious bots:

• Automatic Multi-Tier Escalation: If a user places excessive orders in an hour (default: >3), their phone number is automatically restricted. If spam attempts continue, their email is locked, followed by an automatic 1-hour IP ban.
• Customizable Thresholds: Set maximum hourly attempts, block durations, and permanent restrictions under Security Settings.
• Permanent Banning: Manually or automatically block rogue IP addresses from even browsing the site.

5.7 Flash Deals of the Day & Discount Coupons

Configure daily limited-time flash discounts with countdown timers, custom deal badges, percentage or fixed discounts, minimum cart spend conditions, and usage caps.

5.8 Homepage Customizer & Navbar Links Manager

Rearrange header navigation items using the Navbar Links Manager (choose from Home, All Categories, Custom Page selector, or Special Deals). Customize feature proposition cards, promotional banners, and announcement strips directly from the admin panel.

5.9 Shipping Methods & Delivery Zones

Set up delivery charges by region (Inside Dhaka: ৳60, Express 2-Hour Dispatch: ৳120, Outer Districts: ৳130, or Free Shipping on carts over ৳1,000). Set estimated transit times (ETA) displayed on product cards and checkout.

5.10 Global Store Settings & Theme

Manage store name, contact email, WhatsApp support phone, currency symbol (৳ / $ / €), tax rate, social media links, and product comparison toggle.