171

Product support

Get help in the plugin support forum.

Categories

Design goals

You can create an unlimited number of invoices for users (customers). These invoices can be emailed or downloaded as PDF. It is also possible for users (customers) to pay these invoices using my FREE Briddle.Omnipay plugin and to use my Briddle.Members plugin to create recurring invoices.


Features

I want you to get excited about this plugin and I understand that that will only happen if you can really make it your own.

STATUS FEATURE
YES THOROUGHLY SUPPORTED
YES CONCISE DOCUMENTATION
YES MULTILINGUAL
YES PERMISSIONS
YES EXTENDABLE (USING EVENTS)
YES FULLY EDITABLE INVOICE TEMPLATE
YES INVOICES COMPONENT (show a list of invoices for a logged in user)
YES MAIL INVOICE
YES DOWNLOAD INVOICE AS PDF
YES ONLINE PAYMENTS USING MY FREE PLUGIN Briddle.Omnipay
YES RECURRING PAYMENTS USING MY PLUGIN Briddle.Members

You can complement and extend this plugin with various other (free and paid) plugins. See the documentation tab for more information.

Installation

You need an account on octobercms.com to install this plugin.

  1. Sign in and click on the Add to Project button on the product page for the plugin in the marketplace.
  2. Select the project you wish to add the plugin to (or create one).
  3. Make sure you install any 3rd-party plugins this plugin depends on
  4. Make sure you have attached this project to your website in the backend of your website in order to pull in the new plugin (Settings > Updates & Plugins). Don't worry, attaching or detaching your website to a project will never delete anything!
  5. Make sure you allow short_open_tag

Like this plugin?

Did you know that only about 30% of my plugins are paid (70% of my plugins are free) and that 30% of your purchase goes to help fund the October Project? If you purchase this plugin, you can help me to develop it further, provide support for it or make new plugins.

My other plugins include:

Edit invoice

Hello, I am Wiego Bergsma. Please start by reading the whole documentation! If you have any questions, find a bug or experience difficulties getting the plugin to work please use the Support Forum. Only leave a Review if you are happy with the plugin or are still unhappy with the plugin after reaching out to me in the Support Forum. Thank you! Wiego

Table of contents

Getting started

Please note that RainLab.User, RainLab.UserPlus are required for this plugin and that the RainLab.UserPlus plugin now requires RainLab.Location and RainLab.Notify. All these plugins are FREE.

  1. Add Briddle.Invoice to a project and attach it to your website (This plugin requires RainLab.User, RainLab.UserPlus, and the User Plus Plugin requires RainLab.Location and RainLab.Notify so add those first). All these plugins are FREE.
  2. Make sure you allow short_open_tag (this is the default PHP configuration)
  3. Go to Settings > Omnipay > Invoice settings to configure the plugin

Invoices component

This component lists unpaid invoices for a logged in user. Simply place the component on the page and specify a pay URL (without trailing slash). My FREE Briddle.Omnipay plugin will take care of the rest.

Customize invoice template

You can fully customize the invoice template in Settings > Omnipay > Invoice configuration

The following variables are available:

VARIABLE DESCRIPTION
{{ order }} Translation of "Invoice"
{{ date }} Translation of "Date"
{{ due }} Translation of "Due"
{{ customer }} Translation of "Customer"
{{ description }} Translation of "Description"
{{ quantity }} Translation of "Quantity"
{{ amount }} Translation of "Amount"
{{ vat }} Translation of "Vat"
{{ subtotal }} Translation of "Subtotal"
{{ tax }} Translation of "Tax"
{{ total }} Translation of "Total"
{{ invoice.id }} Invoice ID
{{ invoice.description }} Invoice description
{{ invoice.vat }} Invoice vat
{{ invoice.amount }} Invoice amount
{{ invoice.user.company }} Customer company
{{ invoice.user.name }} Customer company
{{ invoice.user.street_addr }} Customer company
{{ invoice.user.zip }} Customer company
{{ invoice.user.city }} Customer company
{{ invoice.user.country }} Customer company
{{ invoice.sent_at }} Invoice Sent date
{{ invoice.due_at }} Invoice Due date
{{ company_invoice_prefix }} Invoice prefix from settings
{{ company_logo }} Logo from settings
{{ company_name }} Company name from settings
{{ company_street_addr }} Company name from settings
{{ company_zip }} Company zip from settings
{{ company_city }} Company city from settings
{{ company_country }} Company country from settings
{{ company_conditions }} Company conditions from settings
{{ items }} Collection of invoice items (description, quantity, price, vat)

Online payments

Please use my FREE plugin Briddle.Omnipay to allow online payments.

Recurring invoices

Please use my plugin Briddle.Members to setup recurring invoices.

Available events

The following events are available to extend the functionality of this plugin:

STATUS EVENT
YES briddle.invoice.afterMail
YES eloquent.creating: Briddle\Invoice\Models\Order
YES eloquent.created: Briddle\Invoice\Models\Order
YES eloquent.saving: Briddle\Invoice\Models\Order
YES eloquent.saved: Briddle\Invoice\Models\Order
YES eloquent.updating: Briddle\Invoice\Models\Order
YES eloquent.updated: Briddle\Invoice\Models\Order
YES eloquent.deleting: Briddle\Invoice\Models\Order
YES eloquent.deleted: Briddle\Invoice\Models\Order
YES eloquent.creating: Briddle\Invoice\Models\Item
YES eloquent.created: Briddle\Invoice\Models\Item
YES eloquent.saving: Briddle\Invoice\Models\Item
YES eloquent.saved: Briddle\Invoice\Models\Item
YES eloquent.updating: Briddle\Invoice\Models\Item
YES eloquent.updated: Briddle\Invoice\Models\Item
YES eloquent.deleting: Briddle\Invoice\Models\Item
YES eloquent.deleted: Briddle\Invoice\Models\Item
YES eloquent.creating: RainLab\User\Models\User
YES eloquent.created: RainLab\User\Models\User
YES eloquent.saving: RainLab\User\Models\User
YES eloquent.saved: RainLab\User\Models\User
YES eloquent.updating: RainLab\User\Models\User
YES eloquent.updated: RainLab\User\Models\User
YES eloquent.deleting: RainLab\User\Models\User
YES eloquent.deleted: RainLab\User\Models\User

Available permissions

As always you can set permissions for this plugin in Settings > Administrators > Invoice

  • Manage orders
  • Manage settings

Available languages

This plugin can be translated in any language

This plugin supports the following languages out of the box:

  • english
1.3.0

Fixed preview view

Sep 11, 2019

1.2.9

Debugging

Sep 11, 2019

1.2.8

Some minor tweaks

Sep 10, 2019

1.2.7

Update to invoice item editor

Sep 10, 2019

1.2.6

Updated table briddle_invoice_items

Sep 10, 2019

1.2.5

Update to invoice item editor

Sep 09, 2019

1.2.4

Update to invoices component view

Aug 27, 2019

1.2.3

Bugfix

Aug 27, 2019

1.2.2

Added invoice summary to invoices list

Aug 25, 2019

1.2.1

Fixed bug in invoice_prefix on PDF invoices and added the Invoices component listing unpaid invoices for a user

Aug 25, 2019

1.2.0

Added briddle.invoice.afterMail event, default currency setting, editable invoice template

Aug 24, 2019

1.1.0

Added dependencies

Aug 23, 2019

1.0.12

Drop table briddle_invoice_statuses

Aug 23, 2019

1.0.11

Updated table briddle_invoice_orders

Aug 23, 2019

1.0.10

Updated table briddle_invoice_orders

Aug 23, 2019

1.0.9

Updated table briddle_invoice_orders

Aug 23, 2019

1.0.8

Updated table briddle_invoice_items

Aug 23, 2019

1.0.7

Created table briddle_invoice_statuses

Aug 23, 2019

1.0.6

Updated table briddle_invoice_items

Aug 23, 2019

1.0.5

Created table briddle_invoice_items

Aug 23, 2019

1.0.4

Updated table briddle_invoice_order

Aug 23, 2019

1.0.3

Updated table briddle_invoice_order

Aug 23, 2019

1.0.2

Created table briddle_invoice_order

Aug 23, 2019

1.0.1

Initialize plugin.

Aug 23, 2019