README

Sulu bundle that integrates Swiss QR bill generation for saved contacts. Implementation uses the schoero/swissqrbill package (https://github.com/schoero/swissqrbill).

Installation

This bundle requires PHP 8.2 and Sulu 2.6.

1. Open a command console, enter your project directory and run:

composer require linderp/sulu-swiss-qr-bill-bundle

If you're not using Symfony Flex, you'll also need to add the bundle in your config/bundles.php file:

return [
    //...
    Linderp\SuluSwissQRBillBundle\SuluSwissQRBillBundle::class => ['all' => true],
];

1. Register the new routes by adding the following to your routes_admin.yaml:

SuluSwissQRBillBundle:
    resource: "@SuluSwissQRBillBundle/Resources/config/routes_admin.yml"

1. Add the file config/packages/sulu_swiss_qr_bill.yaml with the following configuration:

sulu_swiss_qr_bill:
  iban: 'CH5604835012345678009'
  name: 'Example'
  street: 'Nowherestreet 23'
  buildingNumber: null
  postalCode: 9999
  city: 'Somewhere'
  country: 'CH'

1. Reference the frontend code by adding the following to your assets/admin/package.json:

"dependencies": {
    "sulu-swiss-qr-bill-bundle": "file:../../vendor/linderp/sulu-swiss-qr-bill-bundle/Resources/js"
}

1. Import the frontend code by adding the following to your assets/admin/app.js:

import "sulu-swiss-qr-bill-bundle";

1. Build the admin UI:

cd assets/admin
npm run build

Usage

• Go to Contacts and select one or more contacts.
• Use the toolbar action Generate Swiss QR Bills to download a qr-bills.zip.