Skip to content

Releases

v1.0.1 — Invoice Generator (stripped open-source version)

Choose a tag to compare

@altuswebsol-arch altuswebsol-arch released this 14 Nov 06:43

Release notes — Altus Invoice Generator v1.0.1 (stripped open-source version)

First public release of the Altus Invoice Generator as a free WordPress plugin.

What it does
Build a professional UK invoice in minutes, free, with no account and nothing to install. Fill in your business details (name, logo, email, address, VAT number), add your client, set the invoice number, description, issue and due dates, then add line items with quantity and rate. A clean, professional invoice preview builds itself live on screen as you type — subtotal, flat discount and VAT/tax calculated automatically — and one click downloads or prints it as a PDF through your browser. All built in the visitor's browser; nothing entered ever leaves their device.

In this release

  • Business details with logo upload (read in the browser only, never uploaded to the server), email, address and VAT number.
  • Client details, invoice numbering, issue/due dates, description and a notes field for payment terms or bank details.
  • Line items with quantity and rate; automatic subtotals with flat discount and VAT/tax at any rate — (subtotal − discount) × tax%, with the tax base clamped at zero so a discount bigger than the subtotal can never produce a negative total.
  • 2-decimal rounding with en-GB money grouping (£1,234.50).
  • 9 currencies: GBP £, USD $, EUR €, AED, SAR, PKR Rs, INR ₹, CAD C$, AUD A$.
  • Live invoice preview; one-click Download / Print PDF (browser print-to-PDF; the print stylesheet shows only the invoice).

What was removed vs the Altus hosted version
This is the stripped open-source copy: the "Email me a copy" button and form, lead storage (no database table — the original created aig_leads), all email sending, the "Invoice Leads" admin screen, and the Altus License Manager include were removed. The full result is shown on screen and printed or saved from the page instead. The version hosted on altuswebsolutions.com may offer email delivery; this open-source version does not.

Testing

  • php -l clean; node --check clean on both JavaScript files.
  • The invoice logic passed a 49-test Node harness on the stripped logic file (core totals, VAT, discount, currency formatting and text-summary checks; the harness's email/lead assertions are removed along with that feature). A live check on the stripped logic: 2 × £170, −£10 discount, 20% VAT → subtotal £340.00, VAT £66.00, total £396.00.
  • Fresh WordPress 7.1.4 test site (SQLite-backed, PHP 8.3.6): Plugin Check FULL v2.2.0 — first run 1 error (the original inlined its stylesheet by echoing the CSS file contents, flagged as unescaped output). Fixed in the stripped source, not hidden: the inline-CSS function was removed and the stylesheet is now enqueued with wp_enqueue_style — esc_html() was not used because it would corrupt the CSS (> selectors and " attribute selectors). Retest after the fix: 0 errors / 0 warnings.
  • Smoke test on the fresh site: shortcode renders (business and client fields, line items, Add item, Download / Print PDF, all assets enqueued including the stylesheet), no email form; database still only the 12 standard WordPress tables after activation (no lead table).

Install
Download altus-invoice-generator-v1.0.1.zip below → WordPress → Plugins → Add New → Upload Plugin → Install Now → Activate → add [altus_invoice_generator] to any page.

Disclaimer
Free, "as is", WITHOUT warranty — see the README. Invoices produced by this tool are drafts/templates only — NOT legal, tax or financial advice. Check the tax and legal details before sending an invoice to a client, and have them reviewed by an accountant or other professional where it matters. Always back up your site before installing any plugin and test on staging where possible.

Licence: GPLv2 or later.