swiss-payment-slip/swiss-payment-slip

A library for creating Swiss payment slips (ESR)

0.13.1 2020-02-17 17:48 UTC

This package is auto-updated.

Last update: 2024-11-18 21:11:57 UTC


README

Travis Build Status Scrutinizer CI Build Status Scrutinizer CI Code Coverage Scrutinizer CI Code Quality Total Downloads Latest Stable Version

Do you need to create Swiss payment slips (called ES or ESR) as PDF files in a project of yours? Then you found almost the right place, go to SwissPaymentSlipFpdf or SwissPaymentSlipTcpdf.

If you need to include some basic logic for Swiss payment slips in your PHP code base then you are probably right though...

The partial and unfinished support for the red payment slip was dropped in version 0.13.0 due to lack of demand.

How to use

Just install the the package (see Installation) and check out the contained examples in the examples folder.

If you need help for extending and/or customizing the library to your needs, just ask for help.

Installation

Requirements

  • PHP 5.6.x+

Composer

To add this library to your project through Composer, install Composer on your system first, then initialize a composer.json file and then execute the following from within your project's folder:

$ php composer.phar require "swiss-payment-slip/swiss-payment-slip"

Background Story

In february 2013 I was looking for a solution to create swiss payment slips for a project I had to do at my work place. After a short Google search I came across Manuel Reinhard's blog post about the class he made for that. On his Github project's page I found Peter Siska's pull request. His pull request introduced PSR-0 compatibility and he created a composer package on Packagist. So I tried Peter's version and it suited my basic needs.

BUT since the customer I was working for used custom designed payment slips I couldn't use Manuel's/Peter's script since it wasn't flexible enough. Now I had to decide whether I want to "just" change the script to fit my needs or to rewrite it and make it as flexible as possible. I decided myself for the latter.

TODOs

  • Improve code documentation
  • Add more examples/improve existing ones, showcase disabling the various field blocks better
  • Improve the tests
  • Release the stable release of the API

Submitting bugs and feature requests

Bugs and feature request are tracked on GitHub.

Author

This project was created by Marc Würth. See Background Story for more details.

License

SwissPaymentSlip is licensed under the MIT License. See the LICENSE file for details.

Thanks to