Download the PHP package sylius/invoicing-plugin without Composer

On this page you can find all versions of the php package sylius/invoicing-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Please rate this library. Is it a good library?

All versions of invoicing-plugin with dependencies

Informations about the package invoicing-plugin

Invoicing Plugin

This plugin creates an invoice related to the order.

SyliusInvoicingPlugin creates new immutable invoice when the order is in given state (default: created) and allows both customer and admin to download invoices related to the order.

Business value

The primary aim of Invoicing Plugin is to create a document representing Customer's will to buy particular products and pay for them.

An Invoice can also be treated as a proof of placing an Order. Thus, it is downloadable as .pdf file and can be sent to Customer manually by the Administrator or automatically once an Order is paid.

Additional feature of the plugin that fulfills Invoicing domain is the ability to set billing data on a Seller.

Installation

  1. Require plugin with composer:

    Remember to allow community recipes with composer config extra.symfony.allow-contrib true or during plugin installation process

  2. Apply migration to your database:

  3. Check if you have wkhtmltopdf binary. If not, you can download it here.

In case wkhtmltopdf is not located in /usr/local/bin/wkhtmltopdf modify the WKHTMLTOPDF_PATH environment variable in the .env file:

  1. If you want to generate invoices for orders placed before plugin's installation run the following command using your terminal:

Beware!

This installation instruction assumes that you're using Symfony Flex. If you don't, take a look at the legacy installation instruction. However, we strongly encourage you to use Symfony Flex, it's much quicker! :)

Extension points

Majority of actions contained in SyliusInvoicingPlugin is executed once an event after changing the state of the Order on winzou_state_machine is dispatched.

Here is the example:

Code placed above is a part of configuration placed in config.yml file. You can customize this file by adding new state machine events listeners or editing existing ones.

Apart from that an Invoice model is treated as a Resource.

You can read more about Resources here:

http://docs.sylius.com/en/latest/components_and_bundles/bundles/SyliusResourceBundle/index.html.

Hence, template for displaying the list of Invoices is defined in routing.yml file:

Another aspect that can be both replaced and customized is displaying Invoices list on Order show view. Code responsible for displaying Invoices related to the Order is injected to existing Sylius template using Sonata events. You can read about customizing templates via events here:

http://docs.sylius.com/en/latest/customization/template.html

Invoicing Plugin renders invoices grid using a certain pattern, including displaying a dot next to channel in which an invoice as issued. The dot's color is dependant on a property defined on Channel entity or, if not provided, a global parameter named default_channel_color.

Like any other parameter, default_channel_color can also be overwritten in your config.yml file.

Invoices files

By default, when the order is paid, an immutable Invoice pdf file is saved on the server. The save directory is specified with %sylius_invoicing.invoice_save_path% parameter, that can be overridden if needed.

There is no direct relation between Sylius\InvoicingPlugin\Entity\Invoice entity and its file. It's resolved based on the Invoice::$number, which is defined in Sylius\InvoicingPlugin\Provider\InvoiceFileProviderInterface service. By overriding this service, you can change a logic that is used to retrieve the invoice file.

Fixtures

You can add ShopBillingData fixtures into a yaml to add Channel ShopBillingData info to your installation. More instructions on the fixtures configuration instructions.

Security issues

If you think that you have found a security issue, please do not use the issue tracker and do not post it publicly. Instead, all security issues must be sent to [email protected].


Version
Requires php Version ^7.4 || ^8.0
knplabs/knp-snappy-bundle Version ^1.8
ramsey/uuid Version ^3.9
sylius/grid-bundle Version ^1.7
sylius/resource-bundle Version ^1.6
sylius/sylius Version ^1.9.1 || [email protected]
symfony/config Version ^4.4 || ^5.2
symfony/dependency-injection Version ^4.4 || ^5.2
symfony/form Version ^4.4 || ^5.2
symfony/framework-bundle Version ^4.4 || ^5.2
symfony/http-foundation Version ^4.4 || ^5.2
symfony/http-kernel Version ^4.4 || ^5.2
symfony/messenger Version ^4.4 || ^5.2
symfony/options-resolver Version ^4.4 || ^5.2
symfony/routing Version ^4.4 || ^5.2

The package sylius/invoicing-plugin contains the following files

Loading the files please wait ....