swiss-payment-slip/swiss-payment-slip-pdf

An abstract base class for creating Swiss payment slips with reference number (ESR) or without (ES) using a pdf engine

0.15.0 2020-01-22 16:19 UTC

This package is auto-updated.

Last update: 2024-12-07 13:01:18 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 want to create Swiss payment slips as PDF files in your PHP code base but want to use neither FPDF nor TCPDF, then you can use this project.

How to use

[TODO] If you need help, ask for help.

How to extend for custom needs

[TODO] If you need help, ask for help.

Installation

Requirements

Composer

Just install composer on your system, if not already there. Then create a composer.json file in your project's root folder and copy the following into it:

{
    "require": {
        "swiss-payment-slip/swiss-payment-slip-pdf": "*"
    }
}

After that you can install the package using

$ php composer.phar install

in your project's root folder.

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 examples to showcase how to use this middleware class
  • Add 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

SwissPaymentSlipPdf is licensed under the MIT License - see the LICENSE file for details.