Omacha Shop v1.0.0 - Full-Stack E-commerce Toy Store (PHP & MySQL)

🚀 Omacha Shop v1.0.0 - Initial Stable Release 🚀

We are excited to launch the first stable version of Omacha Shop, a complete, full-stack e-commerce platform for toys, built with PHP and MySQL. This release is designed to run locally using XAMPP and provides a comprehensive solution for both customers and administrators.

Omacha Shop showcases a feature-rich online store with an intuitive user interface, secure (simulated) checkout, and a powerful admin dashboard for managing products, orders, and users.

✨ Key Features in This Release

For Customers:

• 🛍️ Seamless Shopping Experience: Browse products on a feature-rich homepage, filter items on the product listing page, and view detailed product information with images and reviews.
• 🛒 Advanced Cart & Wishlist: Fully functional shopping cart with quantity updates, coupon support, and a wishlist to save favorite items.
• 💳 Secure Checkout Flow: A clear, multi-step checkout process with (simulated) shipping calculation and order summary.
• 📄 Invoice Generation: Automatically generates a printable PDF invoice upon successful order completion.
• 👤 Customer Accounts: Full user registration and login functionality.
• ✍️ Community Engagement: A blog section for articles and a comment system on products/posts with admin reply capabilities.

For Administrators:

• 📊 Comprehensive Dashboard: Get an at-a-glance overview of sales, users, orders, and pending comments.
• 📦 Full Product Management: Easily add, view, edit, and delete products in the store's inventory.
• 📈 Order & User Management: Track all customer orders and manage registered user accounts.
• 💬 Comment Moderation: Approve, delete, and reply to customer comments to maintain a healthy community.
• 📈 Statistical Reports: Visualize sales data with charts for best-selling products and revenue trends.

🛠️ Technology Stack

• Backend: PHP (Procedural/Custom Structure)
• Frontend: HTML5, CSS3, JavaScript, Bootstrap, Tailwind CSS
• Database: MySQL
• Local Server Environment: XAMPP (Apache, PHP, MySQL)

🚀 Getting Started & Installation

This project is designed to be run on a local server environment like XAMPP.

1. Prerequisites:

   • Install XAMPP from apachefriends.org.
   • Ensure Git is installed on your system.

2. Setup Instructions:

   • Start XAMPP: Launch the XAMPP Control Panel and start the Apache and MySQL services.
   • Clone Repository: Clone this project into the htdocs directory of your XAMPP installation (e.g., C:\xampp\htdocs).

     git clone [URL-to-your-repo] C:\xampp\htdocs\OmachaShop

   • Database Setup:
     1. Go to http://localhost/phpmyadmin.
     2. Create a new database named toy-shop with utf8mb4_general_ci collation.
     3. Select the new database and use the "Import" tab to upload the toy-shop.sql file located in the project directory.
   • Database Connection: Verify that the database connection file (e.g., config.php, db.php) in the project has the correct credentials for a default XAMPP setup (Host: localhost, User: root, Password: ``, DB: toy-shop).

3. Access the Application:

   • Customer Site: http://localhost/OmachaShop/Frontend/
   • Admin Panel: http://localhost/OmachaShop/Admin/

📦 Assets

The complete source code for this release is available for download below. Follow the setup instructions above to run the project on your local machine.

👥 Contributors

This project was brought to life by Team Engineering:

• Nguyễn Thùy Khanh - Team Leader | Project Visionary & Lead Ideator
• Trần Hữu Đạt - Full-Stack Web Developer - @TranHuuDat2004
• Trần Bình Quyển - Member
• Dương Thị Thùy Linh - Member

---

Thank you for checking out Omacha Shop! We hope this project serves as a great example of a full-stack PHP application.