Fauran Invoice Manager

Description

Fauran Invoice Manager helps small businesses manage their day-to-day billing operations directly from wp-admin, with a modular architecture and dynamic branding that adapts to your company details:

  • Categories and services catalog — organize services under categories, with per-service pricing and variants
  • Invoices — create standard and custom invoices, with tax, discount, and partial-payment support
  • Customer management — customer records are created or matched automatically from invoice data, with running stats (total invoices, total spend, balance due)
  • Reminders and follow-ups — schedule a follow-up date per invoice; a dedicated Follow-ups screen surfaces what’s due
  • Price snapshots — past invoices always show the price that was charged at the time, even if a service’s catalog price changes later
  • PDF export and printing — print-friendly invoice/receipt templates and PDF generation for invoices and reports
  • WhatsApp messaging — send reminder, follow-up, and invoice messages to customers directly via WhatsApp
  • Reports — payment and balance-due reporting, exportable to PDF
  • CSV import/export — bulk import customers from CSV, export customer data back out
  • Dynamic branding — company name, logo, address, and footer text flow through to invoices, receipts, and PDFs
  • Extensible — a set of action/filter hooks lets developers customize behavior without editing core files (see “For Developers” below)

Why This Plugin

Most invoicing plugins either lock core billing features behind a paywall or bring more complexity than a small business actually needs. Fauran Invoice Manager focuses on the day-to-day essentials — catalog, invoices, customers, reminders, and reports — in one modular, self-contained plugin:

  • No external SaaS account or API key required to create and print invoices
  • Dynamic branding means it looks like your business, not a generic template
  • Price snapshots protect the accuracy of past invoices when catalog prices change
  • Action/filter hooks let developers extend it without touching core files

How It Works

  1. Set up your catalog — categories and services, each with its own price and optional variants.
  2. Create an invoice (standard or custom), picking catalog items or entering custom line items, with tax, discount, and partial-payment support.
  3. The plugin automatically creates or matches a customer record from the invoice’s contact details and keeps running stats (total invoices, total spend, balance due) up to date.
  4. Optionally set a follow-up date on the invoice; it will surface on the Follow-ups screen, and reminders can be sent to the customer via WhatsApp.
  5. Print or export the invoice as a PDF, and track payment/balance-due activity from the Reports screen.

Requirements

  • WordPress 6.6 or later (tested up to 7.0)
  • PHP 7.4 or later
  • MySQL/MariaDB with permission to create custom tables (the plugin creates its own tables for invoices, customers, services, categories, payments, and reminders on activation)
  • No third-party API keys or paid services required for core functionality

For Developers

Fauran Invoice Manager exposes the following action and filter hooks. Full documentation and usage examples are available at devmubs.com/plugins/fauran-invoice-manager/docs.

Actions

  • faurinma_before_save_invoice — fires before an invoice is saved (create or update), before validation.
  • faurinma_after_save_invoice — fires after an invoice has been saved (create or update).
  • faurinma_before_delete_invoice — fires before an invoice and its related rows are deleted.
  • faurinma_after_delete_invoice — fires after an invoice and its related rows have been deleted.

Filters

  • faurinma_invoice_data — filters the raw invoice submission data before it’s persisted.
  • faurinma_invoice_number — filters the generated invoice number before it’s saved.
  • faurinma_company_logo — filters the company logo URL used on invoice/receipt templates.
  • faurinma_pdf_output — filters the final PDF bytes before they’re streamed to the browser (invoices and reports).
  • faurinma_show_powered_by — filters whether the “Powered by Fauran Invoice Manager” credit is shown.
  • faurinma_powered_by_text — filters the “Powered by” credit text.
  • faurinma_currency_list — filters the list of available currencies.

Screenshots

Installation

  1. Upload the fauran-invoice-manager folder to the /wp-content/plugins/ directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the “Plugins” screen in WordPress.
  3. Use the “Fauran Invoices” menu in wp-admin to configure the catalog and start creating invoices.

Demo data: on first activation only, the plugin seeds one demo category with three services, one demo customer, and two sample invoices (one standard, one custom) so you can see how everything fits together before entering real data. This happens exactly once per install — reactivating or updating the plugin will not seed it again. If you don’t want the demo data, simply delete the demo invoices, customer, services, and category from their respective admin screens; deleting them will not trigger a re-seed.

FAQ

Does this plugin store data in custom database tables?

Yes. The plugin creates its own tables for invoices, customers, services, categories, payments, and reminders on activation, and removes them on uninstall if the corresponding setting is enabled.

Can I import existing customers?

Yes, from the Tools page you can import customers from a CSV file with name and phone columns (and optional email, reminder_date, address, company_name columns).

Does deleting an invoice delete the customer?

No. Deleting an invoice removes that invoice and its line items, payments, and any reminder tied to it, then recalculates the owning customer’s stats — the customer record itself is untouched.

Can I disable the “Powered by” credit?

Not from the settings page — it’s always shown there by design. Developers can hide it using the faurinma_show_powered_by filter. See “For Developers” below, or the full documentation at devmubs.com.

What happens to past invoices if I change a service’s price?

Nothing — each invoice line item stores a snapshot of the service’s price at the time the invoice was saved, so existing invoices keep their original price even after you update the catalog.

Can I add currencies not in the default list?

Yes, via the faurinma_currency_list filter — see “For Developers” below.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Fauran Invoice Manager” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial release.
  • Categories and services catalog with per-service pricing and variants.
  • Standard and custom invoicing with tax, discount, and partial-payment support.
  • Automatic customer creation/matching with running invoice, spend, and balance-due stats.
  • Reminders and a dedicated Follow-ups screen.
  • Price snapshots on invoice line items, independent of later catalog price changes.
  • Print-friendly invoice/receipt templates and PDF export for invoices and reports.
  • WhatsApp messaging for reminders, follow-ups, and invoices.
  • Payment and balance-due reports, exportable to PDF.
  • CSV customer import/export.
  • Dynamic branding (company name, logo, address, footer text) across invoices, receipts, and PDFs.
  • Developer action/filter hooks for extensibility.