MokoCassiopeia/data/demo/virtuemart/README.md

VirtueMart Sample Data

This directory contains comprehensive sample data for VirtueMart, including products, categories, custom fields, and more.

Contents

• categories.sql - Product categories with hierarchy
• products.sql - 50+ sample products
• product-variants.sql - Product variations (sizes, colors, etc.)
• custom-fields.sql - Custom product fields
• featured-products.sql - Featured product configuration
• stock-management.sql - Stock levels and tracking
• manufacturers.sql - Sample manufacturers/brands
• product-images.sql - Product image references (requires actual image files)

Prerequisites

1. VirtueMart 4.x installed and configured
2. Database backup - ALWAYS backup before importing
3. Joomla 4.x or 5.x with Moko-Cassiopeia template
4. MySQL/MariaDB database access

Installation Order

Import files in this specific order to maintain referential integrity:

1. manufacturers.sql
2. categories.sql
3. products.sql
4. custom-fields.sql
5. product-variants.sql
6. featured-products.sql
7. stock-management.sql
8. product-images.sql (optional - requires image files)

Import Methods

Method 1: phpMyAdmin

1. Log into phpMyAdmin
2. Select your Joomla database
3. Click "Import" tab
4. Choose SQL file
5. Click "Go"
6. Repeat for each file in order

Method 2: Command Line

mysql -u username -p database_name < manufacturers.sql
mysql -u username -p database_name < categories.sql
mysql -u username -p database_name < products.sql
# ... continue with other files

Method 3: Joomla Admin

1. Components > VirtueMart > Tools
2. Use import/export tools for specific data types

What Gets Imported

Categories (20+)

• Electronics (Computers, Phones, Accessories)
• Clothing (Men's, Women's, Kids')
• Home & Garden (Furniture, Decor, Tools)
• Sports & Outdoors (Equipment, Apparel)
• Books & Media

Products (50+)

• Various price points ($9.99 - $999.99)
• Multiple variations (sizes, colors)
• Detailed descriptions
• Product specifications
• SKUs and barcodes
• Stock levels
• Featured products
• Sale items

Custom Fields

• Size selector (XS, S, M, L, XL, XXL)
• Color picker
• Material type
• Warranty information
• Delivery time estimates
• Gift wrap options

Manufacturers

• TechBrand Inc.
• StyleWear Co.
• HomeComfort
• SportsPro
• And more...

Post-Import Steps

1. Verify Import

   • Check VirtueMart dashboard
   • View product listings
   • Test category navigation
   • Verify custom fields display

2. Update Images

   • Upload actual product images
   • Link images to products
   • Set featured images
   • Configure image sizes

3. Configure Prices

   • Review and adjust pricing
   • Set up tax rules
   • Configure shipping costs
   • Add promotional pricing

4. Setup Payment

   • Configure payment methods
   • Test checkout process
   • Setup order notifications

5. Inventory Management

   • Review stock levels
   • Configure low stock alerts
   • Setup stock tracking

Customization

All sample data can be customized:

• Edit product descriptions
• Adjust pricing
• Change category structure
• Modify custom fields
• Update stock levels
• Add/remove variants

Database Tables

This data affects these VirtueMart tables:

• #__virtuemart_categories
• #__virtuemart_products
• #__virtuemart_product_customfields
• #__virtuemart_manufacturers
• #__virtuemart_product_prices
• #__virtuemart_product_medias
• And related tables

Note: #__ represents your Joomla table prefix (usually jos_ or similar)

Data Structure

Sample Product Structure

Product
├── Basic Info (name, SKU, price)
├── Description (short & full)
├── Categories
├── Custom Fields (size, color, etc.)
├── Variants (if applicable)
├── Images (multiple)
├── Stock Level
├── Pricing Rules
└── Featured Status

Troubleshooting

Import errors?

• Check table prefix in SQL files
• Verify VirtueMart version compatibility
• Ensure proper file order
• Check database permissions

Missing products?

• Clear VirtueMart cache
• Rebuild product indexes
• Check category visibility
• Verify publish status

Images not showing?

• Check file paths
• Upload images to correct directory
• Verify image permissions
• Clear image cache

Support

For issues with sample data:

• Check VirtueMart documentation
• Visit VirtueMart forums
• Contact Moko Consulting support

Warning

⚠️ IMPORTANT: This is sample data for demonstration purposes. Do NOT import into a production site with existing products unless you understand the implications. Always backup your database first!

Version

Version: 1.0.0 Last Updated: 2026-01-29 Compatible with: VirtueMart 4.x, Joomla 4.x/5.x