ASF Sanitary Fittings — Website

ASF Sanitary Fittings is a clean, responsive PHP storefront for showcasing and managing bathroom and kitchen sanitaryware products. This repository contains a customer-facing storefront and a compact admin dashboard for managing products and administrators.

Project Highlights

• Brand: ASF Sanitary Fittings — premium sanitaryware and bathroom fixtures.
• Purpose: Product catalog, featured product display, product details, and admin CRUD for products.
• Design: Modern responsive UI using Bootstrap and custom SCSS/CSS.

Features

• Product Catalog: Browse products with images, ratings, and feature tags.
• Featured Products: Homepage highlights handpicked items (randomized selection).
• Product Detail Page: Full product description, images, and metadata.
• Admin Panel: Add, update, list, and delete products; admin user management located under the core folder.
• Search & Filters: Product attributes (category, price, rating) available as data attributes for JS filtering.
• Responsive Navigation: Mobile drawer and desktop dropdowns with accessible interactions.
• Progressive Fallbacks: Inline SVG fallbacks and graceful degraded images if product images are missing.

Tech Stack & Libraries

• Language: PHP (session-based admin, server-side rendering)
• Database: MySQL / MariaDB (connection helper: conn.php)
• CSS & UI: Bootstrap, custom SCSS/CSS, Font Awesome icons
• JS: Vanilla JS and jQuery included for UI behaviours
• Charts & Dashboards: ApexCharts included in admin core/assets/libs/apexcharts
• Utilities: Simplebar, additional vendor libs under core/assets/libs

Important Files & Locations

• Site entry: index.php
• Header & Footer: header.php, footer.php
• Product pages: products.php, product-detail.php
• Database connection: conn.php
• Admin dashboard (core): core/index.php
• Admin scripts: core/add-product.php, core/list-products.php, core/update-product.php, core/delete-product.php
• Admin auth: core/login.php, core/create-admin.php

Quick Setup

• Requirements: PHP 7.4+, MySQL/MariaDB, Composer (optional for local tooling), or XAMPP/WAMP (Windows).
• Database:
  • Create a database (e.g., asf_db).
  • Create a products table matching the columns referenced in index.php (common columns: id, title, description, price, rating, image_1, features, category, is_featured, material).
  • Update DB credentials in conn.php.
• Run locally (quick):
  • Using PHP built-in server (from project root):

php -S localhost:8000 -t .

• Or drop the project into htdocs (XAMPP) and start Apache + MySQL.

Admin Access

• Navigate to core/login.php to sign in to the dashboard. If no admin exists, use core/create-admin.php to create one.

Customization Notes

• Images: Product image files are expected under assets/product-img (referenced in index.php).
• Branding: Logo located at assets/images/logo.png (added assets/images/logo.svg to modernize branding).
• Styles: Main site CSS in assets/css/style.css and assets/css/bootstrap.min.css. Admin styles live under core/assets/scss / compiled CSS.

Security & Maintenance Tips

• Use prepared statements or parameterized queries for all DB interactions to avoid SQL injection.
• Harden core admin routes by verifying sessions and using CSRF tokens for form submissions.
• Store credentials in environment variables or a protected config file outside webroot.

Contribution

• Suggestions, bug fixes, improvements, and documentation updates are welcome. If you want me to:
  • Add a database schema SQL export,
  • Harden authentication and prepared statements,
  • Add a sample .env and installation script, tell me which and I'll implement it.

License

• Not specified — add a license file (e.g., MIT) if you want this repo public.

-- Generated README and logo by the code assistant. If you want a different logo style (PNG, higher-res SVG, or a full branding pack), or screenshots inserted, I can add them next.