MarketPlexUs
Sign InAdd Listing
Documentation

Marketplace User Guide

This guide summarizes the current marketplace features, how users move through the system, and what remains on the roadmap.

Overview

What this application does

This PHP marketplace app supports public browsing, seller account management, buyer checkout, and admin moderation. It runs on WAMP with clean URLs and a MariaDB/MySQL backend.

Public storefront User dashboard Buyer cart and checkout Admin panel
Public View

Features available before login

  • Home page with hero search, category shortcuts, featured listings, and latest listings
  • Product listing page with keyword search, filters, sorting, and pagination
  • Product detail page with seller details, gallery, favorites, messaging, cart, and reviews
  • Seller public profile page with active seller listings and filters
  • Static CMS pages served by slug
  • Marketplace branding driven by admin settings
Authentication

Account access and recovery

  • User registration and login
  • Logout with CSRF protection
  • Forgot password and reset password flow
  • Email verification marker flow from dashboard
  • Session-based role-aware access for users and admins
User Module

What a logged-in user can do

  • Access a personal dashboard with listing, favorite, message, notification, order, and review counts
  • Edit profile information and seller bio
  • Create, edit, delete, renew, and mark listings as sold
  • Upload multiple product images and paste images directly from the clipboard
  • Delete uploaded listing images
  • Use favorites, conversations, and notifications
  • View order history from the buyer side
Buyer Flow

How buying works

  • Add products to cart from the product detail page
  • Adjust quantities in the cart
  • Complete checkout with demo card, bank transfer, or cash on delivery
  • Store orders, order items, and payment records in the database
  • Review purchased products through the verified purchase review flow
Seller Tools

Listing and seller capabilities

  • Manage listing content, price, location, quantity, and status
  • Respond to buyer messages
  • Receive notifications about interest and activity
  • Expose a public seller page with profile and active listings
  • Use image resizing and thumbnail generation during upload
Admin Module

Administrative controls

  • Admin dashboard overview
  • User management
  • Category and subcategory CRUD
  • Product moderation and featured product control
  • Reports management
  • CMS page management
  • Settings management for site name, contact details, logo path, and currency
  • Activity log review
Security

Current protection and system foundations

  • Clean URL routing without visible PHP extensions
  • CSRF protection on core user and admin actions
  • Password hashing
  • Role-based route protection for admin access
  • Database-backed marketplace data on WAMP/MariaDB
Roadmap

Suggested delivery phases

Phase 1: Core marketplace

Public storefront, auth, user dashboard, listing management, admin moderation, and branding/settings.

Phase 2: Buyer and trust features

Cart, checkout, orders, reviews, notifications, richer seller pages, and improved search.

Phase 3: Production hardening

Real email, payment gateway integration, order lifecycle tooling, analytics, and stronger testing.

Pending Features

What is still left

  • Real payment gateway integration and callback verification
  • Admin order and payment management
  • Seller-side order management
  • Review moderation tools in admin
  • SMTP email sending for password resets, verification, and marketplace notices
  • Favicon support in the shared layout
  • Actual logo upload handling instead of path-only branding
  • Cover image selection and reordering for product galleries
  • Improved SEO metadata and sitemap generation
  • Stronger validation, stock concurrency handling, and broader test coverage