MohlaDesk – Repair & Maintenance Tracking System

MohlaDesk is a powerful, flexible repair and maintenance tracking plugin engineered for any service-based business. Whether you fix automobiles, repair smartphones, service luxury timepieces, or tune up bicycles, MohlaDesk gives your business an organized internal ticket manager and provides your customers with a modern, real-time tracking portal directly on your WordPress site. Stop answering repetitive phone calls asking "Is my item ready yet?". MohlaDesk automates customer updates, builds trust through photo verification and chronological progress updates, and elevates your customer service to an enterprise standard. Who Is MohlaDesk For? MohlaDesk was built specifically for repair shops, service centers, maintenance contractors, and specialized craftsmen. Thanks to fully customizable terminology, it adapts seamlessly to any industry:

• Automotive & Mechanic Garages: Track car inspections, oil changes, engine diagnostics, bodywork, and collision repairs. Label tickets as "Work Orders", items as "Vehicles", and use custom fields for VIN # and License Plate.
• Computer, Smartphone & Electronics Techs: Manage screen repairs, battery replacements, water damage recovery, and hardware upgrades. Rename items to "Devices" and track by IMEI or Serial Number.
• Jewelry & Watch Repair Specialists: Keep clients informed as heirloom rings, luxury Swiss watches, and custom jewelry pass through appraisal, ultrasonic cleaning, movement servicing, and polishing.
• Bicycle & E-Bike Workshops: Track tune-ups, hydraulic brake bleeds, wheel truing, and suspension overhauls. Customize items to "Bicycles" with Frame Serial Numbers.
• HVAC, Plumbing & Appliance Service: Manage repair tickets for AC compressors, heating systems, refrigerators, and commercial kitchen appliances with visit timestamps and work logs.
• Musical Instrument Repair Shops: Perfect for luthier shops, brass/woodwind technicians, and amplifier repairers who need detailed inspection notes and service timelines.
• Shoe Repair, Tailoring & Dry Cleaners: Track garment alterations, leather restoration, resoling, and cleaning workflows.
• Internal IT Departments & Equipment Depots: Track equipment loans, internal hardware repairs, preventative maintenance schedules, and warranty claims.

Key Features & Capabilities 1. Interactive Visual Progress Timeline Give your customers an intuitive, engaging timeline that visually shows every milestone of their repair. * Step-by-Step Milestones: Each status change is displayed sequentially with color-coded status badges, exact date/time stamps, and custom notes. * Current Status Highlighting: The active stage stands out prominently so customers know precisely where their item is right now. * Theme-Proof Design: Beautifully styled with scoped CSS variables that integrate seamlessly with any WordPress theme without style conflicts. 2. Status Photo Attachments & Lightbox Viewer A picture is worth a thousand words — build unwavering customer trust with photographic proof. * Visual Repair Evidence: Attach photos to status updates (e.g. diagnostic computer readouts, worn-out parts removed, newly installed components, or the completed gleaming product). * Built-in Frontend Lightbox: Customers can click any timeline image to view a high-resolution modal preview on mobile or desktop without leaving the tracking page. * Full Media Library Integration: Seamlessly upload and manage repair images using the native WordPress media uploader. 3. Privacy-First Two-Point Verification Security and client confidentiality are central to MohlaDesk. * No Guessable URLs: Basic trackers use sequential ID numbers that allow malicious actors to snoop on other customers' data. * Two-Factor Lookup: Customers must supply both their Ticket ID (e.g., MHLD-1001) and the Last 4 Digits of their Phone Number to unlock ticket information. * Anti-Scraping Protection: Prevents unauthorized viewing of customer names, repair descriptions, and private service details. 4. Unlimited Custom Workflow Statuses Every business operates differently. Build the exact workflow that matches your daily operations. * Custom Status Creator: Add, edit, reorder, and remove workflow stages (e.g. Received, Initial Diagnostics, Awaiting Parts, Bench Work, Quality Inspection, Ready for Pickup, Completed). * Color Customization: Assign unique hex color badges to each status so staff and customers can identify stages at a glance. * Custom Sorting: Control the display sequence of statuses in admin dropdowns and timeline steps. 5. 100% Flexible Industry Terminology Adapt the plugin to your business language with zero code modifications: * Custom Entity Labels: Change "Ticket" to "Work Order", "Repair", or "Job". * Custom Item Terminology: Change "Item" to "Vehicle", "Phone", "Watch", "Bicycle", or "Unit". * Custom Client Labels: Rename "Customer" to "Client", "Owner", or "Patient". * Prefix Customization: Brand your ticket numbers with custom prefixes (e.g. AUTO-, FIX-, TECH-). * Two Dedicated Custom Fields: Enable and rename two extra meta fields for serial numbers, VIN, IMEI numbers, estimated costs, warranty info, or pickup deadlines. 6. Automated Customer Email Notifications Keep your customers in the loop automatically without manual messaging. * Instant Status Updates: Automatically dispatch branded emails whenever a ticket's status is updated in the dashboard. * Smart Dynamic Merge Tags: Personalize messages dynamically with tags like {customer_name}, {ticket_id}, {status}, {item_name}, {date}, {custom_field_1}, and {tracking_link}. * Customizable Sender & Template: Adjust the sender name, sender email, email subject line, and full body text directly from the settings panel. 7. Private Staff-Only Diagnostic Notes Keep your internal workshop chatter completely confidential. * Staff Diagnostic Logs: Technicians can record internal diagnostic tests, parts part-numbers, supplier prices, and internal reminders. * Strict Customer Isolation: Internal notes are strictly restricted to the WordPress admin and are never rendered on the frontend tracker. 8. Appearance Customizer with Live Preview Ensure the frontend tracking form matches your brand identity effortlessly: * Interactive Color Pickers: Customize primary accent colors, button background, button text, timeline progress lines, card background, and typography colors. * Instant Admin Preview: See how buttons, cards, and timeline steps will look before publishing changes. * Pure Scoped Variables: Uses modern CSS variables that adapt to light and dark themes without breaking your page layout. 9. Full Timeline History Management Made a typo or selected the wrong status? No problem. * Edit Past Events: Directly edit past timeline notes, switch status assignments, or replace attached photos from the admin edit screen. * Delete History Records: Delete mistaken timeline entries with a single click, instantly recalculating the ticket's current status. * User Attribution: Displays which staff member logged each timeline update for team accountability. 10. Lightning-Fast Pure Vanilla JavaScript

• Zero jQuery Bloat: The frontend tracker is built with modern Vanilla JavaScript and the Fetch API.
• Instant Asynchronous Lookups: Fast, smooth ticket searches without annoying page refreshes.
• Lightweight Footprint: Clean code, minimal asset loading, and optimized database queries keep your website flying fast.

Minimum Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher

Automatic Installation

1. Log in to your WordPress admin dashboard.
2. Navigate to Plugins > Add New.
3. Search for MohlaDesk.
4. Click Install Now, then click Activate.

Manual Installation

1. Download the mohladesk.zip file.
2. Unzip and upload the mohladesk folder to your /wp-content/plugins/ directory.
3. In your WordPress dashboard, navigate to Plugins and click Activate under MohlaDesk.

Quick Setup Guide (5 Minutes)

1. Configure Terminology: Navigate to MohlaDesk > Settings and configure your labels (e.g., set Item Name to "Vehicle", "Phone", or "Watch").
2. Setup Your Statuses: Go to MohlaDesk > Statuses to customize your business workflow stages and brand colors.
3. Match Your Brand: Go to MohlaDesk > Settings > Appearance & Colors to set your brand colors.
4. Publish the Tracker Page: Create a new WordPress page (e.g., "Track Your Repair") and paste the shortcode: [mohladesk_tracker]
5. Set the Dedicated Tracking URL: In MohlaDesk > Settings, enter the URL of your newly created tracking page so it gets automatically inserted into customer email notifications via {tracking_link}.
6. Create Your First Ticket: Go to MohlaDesk > Add New Ticket, fill in the customer and item details, and click Publish!

1.0.0

• Initial release.
• Custom Post Type mohladesk_ticket implementation with auto-incrementing custom ticket IDs.
• Two-point verification search (Ticket ID + Phone Last 4 Digits) via [mohladesk_tracker].
• Visual progress timeline with chronological step tracking and current status badge.
• Image attachment support for timeline events with integrated frontend lightbox viewer.
• Custom statuses management screen with color picker, slug generation, and ordering.
• Private internal staff diagnostic notes isolated from customer view.
• Flexible terminology settings to adapt labels for automotive, tech, jewelry, HVAC, bike shops, and more.
• Two customizable meta fields (Serial/IMEI, Estimated Cost, etc.).
• Automated email notifications on status changes with dynamic merge tags.
• Appearance customizer with scoped CSS variables and live admin preview.
• Timeline event editor and deleter in admin metabox.
• Lightweight Vanilla JavaScript Fetch API frontend with zero jQuery dependencies.