## Version 8.85.2 **Release Date:** 2026-05-02 ### Module: Manufacturing — Recipe Import #### New Features - **"Download Excel" button on the Recipe list page:** Mirrors the same UX as the Products page. Exports **all existing recipes** for the current business in the same format the importer accepts. Edit any value (quantities, units, instructions, waste %, extra cost, cost type) and re-upload from *Import Recipes* — matching recipes (by Product SKU) are updated in place; new Product SKUs at the bottom are added as brand-new recipes. Yellow-highlighted rows mark the first row of each recipe so the recipe-level fields are visually obvious. #### Improvements - **Simpler "Import Recipes" file format for everyday users:** The recipe import sheet has been redesigned to be much friendlier for non-technical staff. Each ingredient is now on its own row, and you simply repeat the same **Product SKU** for every ingredient that belongs to the same recipe — no more cryptic codes like `RAW-001:2:Pcs:0|RAW-002:0.5:Kg:1` packed into a single cell. - **Recipe-level fields are filled only on the first row of each recipe:** *Total Quantity*, *Recipe Unit*, *Extra Cost*, *Production Cost Type*, and *Instructions* only need to be entered on the first row of each recipe. Leaving them blank on the following rows automatically inherits the values from the first row. - **Sensible defaults for blank fields:** *Total Quantity* defaults to 1 if left blank, *Production Cost Type* defaults to **fixed**, and units default to the product's base unit — so users can produce a working import sheet with the bare minimum of typing. - **Improved downloadable template:** The Excel template now ships with a styled header row, three full worked examples (a cake recipe with three ingredients, a juice recipe with two ingredients, and a single-ingredient pack), plus a built-in "INSTRUCTIONS" section right inside the sheet so users don't need to leave Excel to know what to do. - **New "Download Sample (with example data)" button:** A second download option provides a fully-populated sample workbook with **5 realistic recipes** (Chocolate Cake, Vanilla Cupcake, Mango Juice, Veg Burger, Sugar Pack) totalling 27 ingredient rows. The first row of each recipe is highlighted yellow so users can see at a glance which row carries the recipe-level fields. A pre-built copy of this file is also stored in the codebase at `cp-docs/samples/recipe_import_sample.xlsx`. - **Backward compatible:** Old import sheets that use the previous one-recipe-per-row pipe-encoded format still work — the importer auto-detects the format from the header row and processes either layout. #### UI / UX Changes - **Redesigned "Import Recipes" page:** The on-screen documentation now clearly marks which columns are required, which apply only to the first row of each recipe, and shows a side-by-side example layout so users can see exactly how to repeat the Product SKU across multiple ingredient rows. - A new green tip box at the top of the page summarises the simple format in three short bullet points. #### Technical Updates - `RecipeImportTemplateExport` rewritten with `WithEvents` to apply header styling, borders, auto-sized columns, and an embedded instructions block. - `RecipeController::importRecipes()` refactored: header-row sniffing routes the file to either `importSimpleRows()` (new layman format) or `importLegacyRows()` (legacy format). Persistence consolidated in `saveImportedRecipe()` to remove duplication. --- ### Module: Sales / POS / Discounts #### Bug Fixes - **"Buy For Quantity" discount now enforces the bundle price even when the unit is cheaper.** Previously, if a product's unit price multiplied by the qualifying quantity already came out *below* the bundle's total price (e.g. unit price ≈ £1.00 each, but a *Buy 2 for £9.99* bundle was active), the POS computed a negative discount and silently skipped the rule — so the line stayed at the cheap unit total (£1.99 for two units) instead of the agreed bundle price. POS now treats the bundle as a forced override: every full bundle of `buy_qty` units is billed at exactly `buy_price`, regardless of whether the variation's normal price is higher or lower. Any units beyond the last full bundle continue to bill at the original unit price. - **Discount-type select now reliably switches to "Fixed" when the rule fires.** The buy-for handler used to flip the per-line discount type by toggling the `selected` HTML attribute, which does not always update the select's actual value (some browsers / select2 builds kept the old `percentage` selection in memory). The handler now also calls `.val('fixed')` so the change cascade reads the correct discount type. - **Robust fallback when the discount column is hidden.** If the POS layout has the per-line *Discount* column turned off, there is no `row_discount_amount` input to write to. The handler now detects this and writes the calculated bundle unit price directly to the line's *Unit Price* field, so the line total still resolves to the agreed bundle amount. #### Technical Updates - `getBuyForDiscounts()` in `public/js/pos.js` rewritten for the `buy_for` branch: explicit inline-only unit-price selector (ignores any modal-rendered `pos_unit_price` inputs), unconditional bundle-price override path, and proper `.val('fixed')` selection on the discount-type select. --- ### Module: Fiji FRCS Integration #### New Features - **New "Fiji FRCS" module added** to help businesses in Fiji follow the Fiji Revenue & Customs Service rules for sending sales receipts to the government in real time. - **Register your fiscal device (EFD):** A new screen lets you enrol your shop's fiscal device with FRCS using the activation code given to you on the FRCS portal. You can switch between **Sandbox** (for testing) and **Production** (for live use) with one click. - **Send sales receipts to FRCS automatically:** Every sale (and refund) made on the POS is automatically sent to FRCS. The module supports four receipt types — **Normal Sale**, **Refund / Credit Note**, **Training**, and **Proforma**. - **Choose how receipts are sent:** Pick the mode that suits you — *Instant* (sent at the moment of sale), *Queued* (sent in the background), *Daily* (sent once a day), or *Manual* (you click a button to send). - **Works even when the internet is down:** If FRCS cannot be reached, receipts are saved safely on your computer and sent automatically as soon as the connection comes back. - **X-Reports and Z-Reports:** Generate the daily *X-Report* (read-only summary you can check anytime) and the end-of-day *Z-Report* (closes the day and is sent to FRCS). Z-Reports can also be generated automatically every night. - **FRCS QR code on every receipt:** Once a receipt is accepted, the official FRCS verification code and QR are stored on the receipt and printed on the customer's PDF copy so customers can verify the receipt with FRCS. - **Easy Settings page:** From one screen you can set your TIN, VAT number, choose the sending mode, decide when a buyer's TIN is required (for example for sales above FJD 1,000), turn the FRCS QR on/off on receipts, set the time for the auto Z-Report, and add an email to be notified about any submission errors. - **Submission history & audit trail:** A new page lists every receipt sent to FRCS with its status (Pending / Submitted / Accepted / Failed), so you can search, filter, view details, and re-send any failed receipt with a single click. A separate "API Logs" page shows every conversation with FRCS for full traceability. - **Bulk submit pending receipts:** A "Submit All Pending" button lets you push all unsent receipts to FRCS in one go. - **Permissions you can assign to staff:** *Access Fiji FRCS Module*, *Manage EFD Onboarding*, *Submit Fiscal Receipts*, and *Generate X / Z Reports* — so only the right users can perform sensitive actions. - **Sold as an add-on:** The module can be enabled per business through the Superadmin subscription packages. --- ### Module: Accounting — Chart of Accounts #### Bug Fixes - **Parent Account dropdown was empty when adding a new account:** When opening the *Add Account* form, the *Parent Account* dropdown showed no options. It now correctly lists all available parent accounts, the same as it does on the Edit form. - **Accounts marked as "Non Posting" (e.g. Bank Account) were not showing in the Parent Account dropdown:** If a non-posting account was created under another account (for example a *Bank* group under *Cash and Cash Equivalents*), it would not appear as a selectable parent when creating or editing another account. This is now fixed — all active non-posting accounts are visible in the Parent Account dropdown regardless of where they sit in the account hierarchy. --- ### Module: POS — Quick Menu Buttons #### Bug Fixes - **Same product added as a new row instead of increasing quantity:** When the business setting *Sales Item Addition Method* was set to *"Increase item quantity if it already exists"*, clicking a quick menu button quickly (or when the screen was a bit slow) would sometimes add the same product as a separate new row instead of increasing the quantity on the existing row. This is now fixed — rapid clicks on the same product always increase the quantity on the existing row. - **Quick menu button not respecting the configured quantity:** If a quick menu button had no quantity configured, clicking it would sometimes add the product with a blank quantity. Fixed — it now always defaults to quantity 1 when no quantity is set on the button. --- ### Module: Purchases #### Improvements - **Purchase details now show gross profit and sell price:** When these fields are enabled for purchases, the purchase details popup now also shows **G.P %** and **Sell Price** after the **Subtotal** column, making it easier to review item pricing without opening the edit screen. --- ### Module: Accounting — Chart of Account Report #### New Features - **Chart of Account Report** added under *Accounting → Reports*. Lists all accounts in the chart of accounts, organised by account type (Asset, Liability, Equity, Income, Expenses) and sub-type, with columns for GL Code, Account Name, Account Sub Type, and Status. - **Show Balances** checkbox (default unticked) — when ticked and *Apply Filters* clicked, a Balance column is appended showing the current live balance for each account, plus sub-type and account-type totals. - **Print** button sends the report directly to the laser printer via `window.print()`, hiding all navigation, filters, and sidebars and rendering a clean print-optimised layout. --- ### Module: Accounting — Transactions (Payroll Advance Payments) #### New Features - **Payroll Advance Payments now visible in Accounting → Transactions:** A new *Advance Payments* tab has been added. It shows all advance and loan payments made to employees, including the employee name, type (Advance or Loan), payment status, and amount. A date filter is available to narrow the list. - **Chart of Accounts mapping for advance payments:** Each advance payment row now has a *Map* button. Clicking it opens the account mapping screen with the correct accounts already pre-selected — the payment method account is credited and the *Payroll Advance Payments* account is debited — matching the same auto-mapping logic used by other payroll transactions. --- ### Module: POS #### New Features - **Draft button opens your saved drafts when the screen is empty:** If you click the *Draft* button on the POS screen without adding any products first, it now opens the Recent Transactions popup and goes straight to the *Draft* tab — so you can quickly pick up a previously saved order without any extra steps. - **Recent Transactions popup remembers which tab to open:** When you open the Recent Transactions popup using the *Draft* button, it automatically lands on the *Draft* tab. When you open it using the *Transactions* button, it lands on the *Final Paid* tab as expected. - **First transaction selected automatically when a tab loads:** When you switch to any tab in the Recent Transactions popup, the most recent transaction in that tab is automatically highlighted and ready to edit, delete, or print — no need to click first. #### UI / UX Changes - **Payment icons added to POS screen navbar:** Two quick-action buttons — *Receive Customer Payment* (green, `fa-hand-holding-usd`) and *Pay Supplier* (yellow, `fa-money-bill-alt`) — have been added to the POS header action bar, matching the same icons and workflow used in the main software navbar. Clicking either button opens the existing contact-search payment modal, filtered by contact type (`customer` / `supplier`), allowing cashiers to process payments without leaving the POS screen. Both buttons respect the existing `sell.payments` and `purchase.payments` permissions respectively, and the Pay Supplier button is only shown when the Purchases module is enabled. ### Module: Security Roles #### Improvements - **Draft permissions moved to the POS tab:** The *View All Drafts*, *View Own Drafts*, *Edit Draft*, and *Delete Draft* permission options have been moved from the *Sales* tab to the *POS* tab when creating or editing a security role. This makes it easier to manage all POS-related access in one place. - **Cashiers can now see and use drafts on the POS screen:** When a cashier role is given *View All Drafts* or *View Own Drafts* permission under the POS tab, that cashier will now see the *Draft* button on the POS screen and can view the saved drafts list inside the Recent Transactions popup. Previously, enabling these permissions had no effect on the POS screen. --- ### Module: Reports — Purchase Analysis #### New Features - **Purchase Analysis report** added under *Reports → Purchase Reports*. Mirrors the existing Sales Analysis report but analyses purchase transactions (`type = 'purchase'`, `status = 'received'`). Supports all period views: **Yearly**, **Monthly** (with optional Compare Previous year toggle), **Weekly**, **Daily**, **Day of Week**, and **Hourly**. Can be filtered by Business Location and report metric — **Amount** or **Number of Purchases**. Includes a Print button. --- ### Module: Reports — Product Sale Report #### New Features - **New "Not Sold (Combo)" tab added to Product Sale Report:** A new tab now appears in the Product Sale Report, placed right after the "Not Sold" tab. It shows only **combo and package** type products that had no sales in the selected date range. All existing filters (location, date range, category, brand, supplier, etc.) apply to this tab as well. --- ### Module: Expense #### New Features - **Sub-category field added to Add Expense modal:** The Expense Sub Category dropdown now appears directly inside the Add Expense modal (between the Expense Category and Expense For fields). When a category is selected, the sub-category list loads dynamically via AJAX — matching the behaviour already present on the full Create and Edit expense pages. #### Bug Fixes - **Category / Sub-category dropdowns appearing in the wrong place when the Add Expense form was scrolled:** When you scrolled inside the Add Expense pop-up and then clicked a dropdown (Category, Sub Category, etc.), the list would open in the wrong spot — sometimes well above or below the field. The dropdowns now always open neatly attached to the field you clicked, no matter how far you've scrolled. #### UI / UX Changes - The Expense Details section of the Add Expense modal now displays three fields per row — Expense Category, Sub Category, and Expense For — using `col-md-4` columns (previously two `col-md-6` columns showing only Category and Expense For). --- ### Module: HRM — Payroll #### Bug Fixes - **Old "Payroll for March 2026" entry could not be deleted from the screen:** A leftover payroll record was still showing under *HRM → Payroll* even after its payments had been cleared, and the Delete option in the Actions menu was not removing it. This old entry has now been cleaned up, so the Payroll list shows correctly with no leftover records. --- ### Module: Reports — Stock Adjustment Report #### New Features - **New "Products Summary" tab** added to `reports/stock-adjustment-report`. Aggregates all stock-adjustment lines by product/variation across the active date range and location filter, showing per-product **count of adjustments**, **total quantity adjusted**, and **total value** (sum of qty × unit_price). Inherits the same date-range / location filter as the other tabs and reloads in real time when filters change. #### Bug Fixes - **Summary tab would not open and the Detailed tab was stuck on "Processing…":** Clicking the Summary or Detailed tabs on the Stock Adjustment Report did nothing or kept loading forever. All three tabs (Totals, Summary, Detailed) now open instantly when clicked and their tables load properly. - **Date-range dropdown did not close on its own after picking a preset (Today / Yesterday / Last 7 Days, etc.):** Choosing a preset from the date picker no longer requires you to click outside to close it — the picker now closes automatically as soon as you select a range. - **Daily Totals tab always showed 0 in the Stock Adjustment column:** The Stock Adjustment column on the Daily Totals tab was incorrectly showing zero for every day. It now shows the correct totals. - **Detailed tab stuck on "Processing…" with a server error:** The Detailed tab failed to load because of a clash inside the report query. The query has been corrected and the Detailed tab now loads its data without errors. - **Date-range / location filter did not refresh the tabs in real time:** Changing the date range or business location only updated the tab you were currently looking at, and the other tabs would still show the old data until you manually clicked them. Now, changing the date range or location refreshes all three tabs (Totals, Summary, Detailed) together so every tab stays in sync with your filter. #### Improvements - **Date-range filter now applies to all three tabs:** Selecting a date range (or location) on the report page now reloads the Totals, Summary and Detailed tables together, so every tab stays in sync with the filter. - **Tables auto-resize when their tab is shown:** Switching between the Totals, Summary and Detailed tabs now redraws the table columns to the correct width, fixing the squashed / misaligned columns that sometimes appeared the first time a tab was opened. --- ### Module: Reports — Sale Invoices Report #### Improvements - **Pagination added to the Detailed tab** of the Sale Invoices Report. Instead of loading all invoices at once — which could cause the page to freeze or time out on large date ranges — results are now shown in pages. By default, 25 invoices are shown per page. A counter at the top shows how many invoices are being displayed out of the total. Use the *Invoices per page* dropdown (options: 10, 25, 50, 100, 200, All) to control how many appear at a time. Page navigation buttons appear below the table. When viewing multiple pages, a **Grand Totals** row shows the combined Total Amount, Paid, and Due across all pages — not just the current page. --- ### Module: Accounting — Transactions / Payroll Advance Tab #### Bug Fixes - **Payroll Advance Payments now show up under *Accounting → Transactions → Payroll Advance Payments* tab.** Any record added from *HRM → Payroll → Advance Payment* (both **Advance Payment** and **Loan Payment**) is now visible here with its date, reference number, type, employee, payment status, and amount. - Each row also shows a button — green **Edit Mapping** if the entry is already linked to the chart of accounts, or blue **Map Transaction** if it still needs to be linked. --- ## Version 8.85.1 **Release Date:** 2026-05-01 ### Module: HRM / Payroll & Accounting #### Improvements - **Auto Chart-of-Accounts mapping for Payroll Advance Payments (Advance & Loan):** When a record is added under **HRM → Payroll → Advance Payment** tab (both `Advance Payment` and `Loan Payment` sub-types), the system now automatically posts a journal entry into the **Chart of Accounts**: - **Debit:** `Payroll Advance Payments` (asset) - **Credit:** the **Payment Method account** mapped on the Business Location's *Default Payment Accounts* for the chosen method (Cash / Bank Transfer / Card / Cheque / etc.) - Added a safe fallback to **Cash in Hand** when the selected payment method has no default account configured for the location, so the entry is no longer silently skipped. --- ## Version 8.85.0 **Release Date:** 2026-04-30 ### Module: Backup #### New Features - **Google Drive Auto-Sync via Centralized Rsync:** Implemented an advanced Google Drive architecture using OS-level `rsync` mounts to bypass the limitations and complexity of Google's API limit tokens. - Local backups generated by the tenant now asynchronously dispatch an Rsync Job to a globally shared Redis queue (`gdrive-sync`). - Server executes uploads sequentially (one at a time) across all 50+ subdomains to eliminate Google connection bans. #### Improvements - **Two-way Sync Deletion:** Native integration with Laravel Spatie Backup cleanup. When Spatie deletes an old backup locally, `rsync --delete` automatically trims it from Google Drive exactly. - **Real-time UI Tracking:** Added a webhook callback that updates the tenant's local UI to accurately show "Sync Pending" or "Synced to Cloud" rather than querying the Drive API. ## Version 8.84.11 **Release Date:** 2026-04-28 ### Module: POS / Quick Menu Tables #### Improvements - **Table CHECKOUT and PRINT BILL now punch products to the POS screen almost instantly.** On the POS screen, when a Quick Menu **Table** button has multiple existing orders, opening the table modal and clicking **CHECKOUT** or **PRINT BILL** previously froze the screen for several seconds before the merged order lines appeared in the products section. The freeze grew with the number of order lines (a table with 15 lines could block for 8–10 seconds). All lines now load in roughly the time of a single product punch — one HTTP round-trip instead of N — regardless of how many lines the merged orders contain. - The same speed-up applies to the **Edit Order & Re-Print Bill** flow on already-billed table orders, the **delete-table-order edit re-fetch** flow, and the user-authentication confirmation flow that re-pulls a table's orders into POS. - **Quick Menu single Product button feels instant.** Clicking a `Product`-type quick button no longer freezes the browser UI for the duration of the server round-trip — the row appears asynchronously without locking the screen, so rapid taps remain responsive. - **Quick Menu Product Set button is much faster.** Selecting set + addon products in the Product Set modal and clicking **Add** previously fired the get-product-row request once per chosen variation, sequentially and synchronously. All variations are now fetched in one batched server call and appended in a single DOM write, while still being correctly grouped under the same `set_group_id` header. - **"Get products from sale invoice" (Send For / Sell-Return invoice lookup)** also benefits — products listed under the entered invoice are now fetched in the same batched call instead of one-at-a-time. --- ### Module: Superadmin / Subscriptions #### Bug Fixes - **Edit Subscription date pickers now open above the modal.** On `superadmin/superadmin-subscription`, opening the Edit modal and clicking **Start Date**, **End Date**, or **Trial End Date** showed the calendar behind the modal (z-index conflict), making it impossible to pick a date. The date pickers are now anchored inside the modal and render correctly on top. --- **Release Date:** 2026-04-28 ### Module: POS / Sales Finalize Performance #### Improvements - **POS bill finalize is faster (especially with FBR PRAL, FBR DI and ZATCA enabled).** Pressing **Final / Save & Print** previously rebuilt the full receipt details up to three times (once for FBR PRAL, once for FBR DI, and again when rendering the print receipt) and re-fetched the same Invoice Layout for each. The receipt object and invoice layout are now memoised per request so the heavy work runs once. No change to what's printed, what's reported to FBR/ZATCA, or what's saved. - **Removed the per-bill internet-probe stall on FBR-enabled locations.** The FBR PRAL submission used to do a fresh `fsockopen` connectivity probe on every checkout, which could block for up to 3 seconds when the link was flaky. The probe result is now cached for 30 seconds, so back-to-back bills don't pay the probe cost each time. If connectivity is genuinely down, FBR is skipped exactly as before (`fbr_invoice_no` saved as `0`). ### Module: Sales / POS / Discounts #### Bug Fixes - **"Buy For Quantity" discount now charges the correct total at POS.** When a discount of type **Buy For Quantity** was configured (e.g. *2 for £9.99* on a product with a unit price of £5.99), punching the qualifying quantity at POS was applying the discount in reverse — the line subtotal showed the discount amount itself (£1.99) instead of the agreed bundle price (£9.99). The line now correctly bills £9.99 for two units, and partial bundles (e.g. 3 units at *2 for £9.99*) correctly charge £15.98 (one bundle + one extra at full price). --- ## Version 8.84.8 **Release Date:** 2026-04-26 ### Module: Products / POS / Sell / Purchases #### Improvements - **F10 Product Search modal much faster.** The product search datatable used by **F10** on POS, the **Sell** screen and the **Purchases** screen now returns rows in a single round-trip instead of running per-row sub-queries. - **F10 modal stops building columns it never displays.** The modal does not show the action dropdown, image, mass-delete checkbox or product-locations cell, but those builders were running for every row anyway. They are now skipped, along with the heavy eager-loads that fed them. - **POS / Sell / Purchase punch — fewer business-detail queries.** Punching a product no longer re-runs the joined `business + tax_rates + currencies` query each time within the same request. --- **Release Date:** 2026-04-25 ### Module: Documentation Hub #### New Features - **Manufacturing module documentation expanded.** The page at `/documentation/module-manufacturing` now serves the full **Manufacturing User Guide** (previously it auto-generated a thin overview). New sections cover every tab in the module's top navigation, including the previously undocumented **Demand Orders** workflow and **Demand Ingredient Report**. - New section **Importing Recipes from a Spreadsheet** with step-by-step instructions and a download-template tip. - New section **Restoring a Deleted Recipe** for accidental deletions. - New section **Demand Orders** with full status table (Draft / Pending / Approved / In Production / Partially Completed / Completed / Cancelled), priority levels, approval flow, and inline status changes. - New section **Demand Ingredient Report** explaining the shortage column and how to use it as a procurement shopping list. #### Improvements - **Contacts guide** now clarifies that a contact saved with type **Both** is treated as a **Barterer** and appears under **Contacts → Barterer** in the sidebar (in addition to the customer and supplier lists). The contact-types table and the *Add a New Contact* steps both call this out. - **Manufacturing → Getting Started** section rewritten with the correct add-on activation flow (sidebar check → Contact Superadmin → log out / log back in) instead of the previous "ask the Superadmin to enable it in Business Settings" wording. - **Module Overview** table on the Manufacturing page now lists every top-nav feature, including Reverse Production, Manufacturing Report, Recipe Report, Demand Orders and Demand Ingredient Report. - **Permissions** table on the Manufacturing page now includes *Access / Add / Edit / Delete / Approve Demand Order*. - **Quick Reference → Navigation Paths** updated to include all new screens. --- ## Version 4.25.26.8 **Release Date:** 2026-04-25 ### Module: Documentation Hub #### Bug Fixes - **Add-on activation instructions corrected.** The auto-generated overview for add-on modules (Accounting, CRM, Manufacturing, Gym, HMS, Repair, Project, FoodPanda, Field Force, Truckmate, Shopify, WooCommerce, Ecommerce, Connector, Spreadsheet, Recruitment, AI Assistance) was wrongly telling users to "tick the box in *Settings → Business Settings → Modules*". Add-ons are not in that tab — that tab only toggles **core base features** (POS, Sale, Products, Purchases, Stock, Expenses, Reports, Notifications, Restaurant tables, Quick Menu, Bookings, etc.). Add-ons are activated by the **Superadmin** as part of the subscription plan. The page now explains the correct flow: check the sidebar → if missing, contact the Superadmin → log out and back in once activated. - Fixed the **Add-on Modules → About Add-on Modules** page (`MODULES_OVERVIEW.md`): replaced the "How to Enable or Disable Modules" section and the related FAQ entries with the correct subscription-based activation flow, plus a clear note distinguishing add-ons from the core feature toggles in Business Settings → Modules. - Fixed the **FoodPanda Troubleshooting** checklist and table: removed the "enable in Business Settings → Modules" instruction and replaced it with a check for the FoodPanda menu in the sidebar plus a request-to-Superadmin step. --- **Release Date:** 2026-04-25 ### Module: Documentation Hub #### New Features - The **Documentation** page has been rebuilt as a true end-user manual. The sidebar is now organised into clear, task-based categories that match how a shop user thinks about their day: - **Getting Started**, **Customers & Suppliers**, **Products & Stock**, **Purchases**, **Sales & POS**, **Money & Expenses**, **Tax, Invoices & Barcodes**, **Reports**, **Users & Permissions**, **Notifications**, **Backup & Data Safety**, **Restaurant Features**, **Add-on Modules**, **Superadmin**, **Contact Superadmin**, **Version Log**. - All add-on modules are now grouped under a single **Add-on Modules** tab instead of producing one tab per module, removing visual noise from the sidebar. #### Improvements - Auto-generated module overview pages now show a friendly description and clear "How to turn it on" steps that point to **Settings → Business Settings → Modules** in the UI. - Superadmin overview page now describes the role in plain language and lists current Superadmin accounts as a friendly bullet list. - Search index updated to match the new layman-friendly page titles and keywords. #### Bug Fixes - Internal developer notes stored in `cp-docs/dev/` no longer leak into the public manual. The language-fallback chain now stops at English; developer reference files are never surfaced to end users. #### UI / UX Changes - Removed all references to codebase paths, environment variables, terminal commands and module folder names from user-facing pages. - Removed the green/orange "module enabled / disabled" badges from sidebar tab labels — the sidebar now reads as a clean topic list. - Renamed several pages to action-oriented titles (for example: "Welcome & First Steps", "Set Up Your Business", "Adding & Managing Products", "Selling at the Point of Sale", "Reading Your Reports", "Email & SMS Templates", "What's New"). - FoodPanda section now exposes only the three pages a user actually needs: **Integration Overview**, **Quick Reference**, **Troubleshooting**. --- **Release Date:** 2026-04-25 ### Module: Reports / POS Reports #### New Features - **Summary Income Report** now supports two print modes: - **Print A4** — prints a centered receipt-style summary card on a standard A4 page. - **Print Thermal (80mm)** — prints a compact monospaced layout sized for 80mm thermal printers (76mm printable, dashed dividers, inverted highlight row for *Receivable Cash*). #### Improvements - Filter row is now responsive: filter inputs collapse to two-per-row on small screens and stack on mobile (`col-md-3 col-sm-6`); action buttons wrap with `flex-wrap` and `gap` for tablet / phone widths. - The summary card itself is responsive (reduced padding and font sizes below 600px). #### Bug Fixes - **Print preview was blank.** Clicking the Print button on the Summary Income Report used to open a blank print preview. The Print A4 and Print Thermal buttons now correctly show the receipt-style summary in the preview every time. #### UI / UX Changes - Replaced the single *Print* button with two clearly labeled buttons: **Print A4** (green) and **Print Thermal (80mm)** (blue). --- ## Version 4.25.26.5 **Release Date:** 2026-04-25 ### Module: Reports / POS Reports #### New Features - **Summary Income Report** added under *Reports → POS Reports*. Renders a Closing-Summary style report with three sections: **Sales Summary** (Sale, Sale Return, Gross Sale, Discount, Sales Tax, Service Charges, Net Sales), **Service Sales Analysis** (per `types_of_service` breakdown with percentage and amount), and **Cash Details** (Cash Sale, Credit Card Sale, Credit Sale, Opening Cash, Receivable Cash, Cash Received, Difference). Filters: Business Location, Cashier (User), Date Range. Includes a Print button that prints only the summary card. #### Improvements - None. #### Bug Fixes - None. #### UI / UX Changes - New sidebar menu item *Summary Income Report* placed directly under *Register Report* in the **POS Reports** dropdown (icon: `fa-file-invoice-dollar`). --- ## Version 4.25.26 **Release Date:** 2026-04-25 ### Module: POS / Sell #### New Features - F10 Product Search Modal — the text search field now searches across **every column the user has chosen to display** in *Users → Settings → Product tab → Product Search Screen Columns*, not just SKU and Product Name. Newly searchable columns: Other Name, Brand, Category (and Sub-Category), Supplier (name + business name), Rack details (rack / row / position), Custom Field 1–4. Variation name and sub-SKU remain searchable as before. #### Improvements - Significantly faster POS bill / invoice finalization. Email, SMS and WhatsApp customer notifications now run after the HTTP response is flushed, so cashiers no longer wait for SMTP / SMS gateway / Meta WhatsApp Cloud API round-trips before the receipt appears. - FBR submission now short-circuits early when the location has no `fbr_pos_id`, when the transaction already has an FBR invoice number, or when it is a quotation. This skips a 3-second `fsockopen` connectivity probe and a heavy receipt-details build for transactions that would never have been submitted to FBR anyway. - Offline mode (`IS_OFFLINE=true`) is now much faster on POS finalize and across the app. Auto FBR submission, FBR Digital Invoicing, ZATCA instant sync, customer email / SMS auto-notifications and the Meta WhatsApp Cloud API call now exit immediately when the app is in offline mode instead of waiting for connect / read timeouts (previously up to ~3 sec each, more if the gateway hung). Manual sync actions (e.g. "Sync FBR Sales") still work as before. - Faster POS product search (typeahead on the POS screen and the F10 product search modal). The `purchase_lines` join used for serial-number / IMEI search is now only added when the **Enable serial number** business setting is on; previously it ran on every keystroke and contained an `OR pl2.imei_numbers IS NOT NULL` clause that produced a near-cartesian product, making search 5\u201320 \u00d7 slower on stores with many purchase lines. The `JSON_SEARCH(imei_numbers, ...)` filter is also gated behind the same setting. - Faster product "punch" (clicking a product to add it as a POS cart line). The tax-rate dropdown and the warranty dropdown are now cached per business for 5 minutes (with automatic invalidation when an admin edits a tax rate or warranty), so the same lookups don't hit the database on every product click. The customer default-tax lookup now selects only the column it needs instead of fetching the full Contact row. #### Bug Fixes - **POS product search made safer and slightly faster.** The product search used on POS has been tightened so that special characters typed into the search box can never affect the database, and repeat searches now reuse the same prepared query for a small speed boost. #### UI / UX Changes - None. ## Version 4.21.26 **Release Date:** 2026-04-21 ### Module: Quotations #### New Features - None. #### Improvements - None. #### Bug Fixes - Fixed the quotations index action menu PDF download so the generated quotation PDF is streamed to the browser instead of opening a blank tab. #### UI / UX Changes - None. ### Module: Product Masters (Brands, Gender, Procurement Source) #### New Features - Added parent-child hierarchy support for Brands, Gender, and Procurement Source, similar to product sub-category behavior. - Added "Add as sub taxonomy" option in create and edit popups for all three modules. #### Improvements - Improved list ordering to show parent items grouped with their sub-items. - Added indented visual display in master lists to make hierarchy easier to read. #### Bug Fixes - Fixed Products Card tab search so the Search SKU or Name field now returns matches by product name and variation name in addition to SKU. #### UI / UX Changes - Updated add/edit forms for Brands, Gender, and Procurement Source with parent selection controls. ### Module: Products #### New Features - Added a new products index tab: Products Card. - Added a dedicated variable-only storefront-style card view to list variable product variations separately from the full product list. #### Improvements - Improved variable-product workflow by applying all existing index filters while forcing product type to variable in the new tab. - Added quick summary cards in the new tab to show filtered variation count and current-page row count. - Enhanced variation display by converting recognized colors into swatches and other variation values into option pills. #### Bug Fixes - None. #### UI / UX Changes - Renamed the variable-product tab to Products Card. - Added a modern storefront-style variable product layout with larger imagery, cleaner action placement, color swatches, and size/option pills. - Added variable-tab search targeting from the product search modal shortcuts.