mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-15 12:37:14 +01:00
106 lines
4.4 KiB
Markdown
106 lines
4.4 KiB
Markdown
|
SwissPaymentSlipFpdf - Swiss Payment Slips with FPDF
|
||
|
|
====================================================
|
||
|
|
|
||
|
|
[](https://travis-ci.org/ravage84/SwissPaymentSlipFpdf)
|
||
|
|
[](https://scrutinizer-ci.com/g/ravage84/SwissPaymentSlipFpdf/build-status/master)
|
||
|
|
[](https://scrutinizer-ci.com/g/ravage84/SwissPaymentSlipFpdf/?branch=master)
|
||
|
|
[](https://scrutinizer-ci.com/g/ravage84/SwissPaymentSlipFpdf/?branch=master)
|
||
|
|
[](https://packagist.org/packages/swiss-payment-slip/swiss-payment-slip-fpdf)
|
||
|
|
[](https://packagist.org/packages/swiss-payment-slip/swiss-payment-slip-fpdf)
|
||
|
|
|
||
|
|
Do you need to create Swiss payment slips (called ESR) as PDF files in a project of yours?
|
||
|
|
Then you found the right place, read on...
|
||
|
|
|
||
|
|
By the way if you don't like [FPDF](http://www.fpdf.org) or don't want to use it for whatever reason,
|
||
|
|
checkout [SwissPaymentSlipTcpdf](https://github.com/ravage84/SwissPaymentSlipTcpdf/).
|
||
|
|
|
||
|
|
How to use
|
||
|
|
----------
|
||
|
|
|
||
|
|
Just install the the package (see [Installation](https://github.com/ravage84/SwissPaymentSlipFcpdf#installation))
|
||
|
|
and check out the contained examples in the
|
||
|
|
[examples folder](https://github.com/ravage84/SwissPaymentSlipFcpdf/tree/master/examples).
|
||
|
|
|
||
|
|
How to extend for custom needs
|
||
|
|
------------------------------
|
||
|
|
|
||
|
|
[TODO]
|
||
|
|
If you need help, ask for help.
|
||
|
|
|
||
|
|
Installation
|
||
|
|
------------
|
||
|
|
|
||
|
|
### Requirements
|
||
|
|
|
||
|
|
- PHP 5.3.x+
|
||
|
|
- [SwissPaymentSlip](https://github.com/ravage84/SwissPaymentSlip/) (automatically installed by Composer)
|
||
|
|
- [SwissPaymentSlipPdf](https://github.com/ravage84/SwissPaymentSlipPdf/) (automatically installed by Composer)
|
||
|
|
|
||
|
|
### Composer
|
||
|
|
|
||
|
|
Just [install composer](http://getcomposer.org/doc/00-intro.md#system-requirements) on your system, if not already there.
|
||
|
|
Then create a [composer.json](http://getcomposer.org/doc/04-schema.md) file in your project's root folder
|
||
|
|
and copy the following into it:
|
||
|
|
|
||
|
|
```JSON
|
||
|
|
{
|
||
|
|
"require": {
|
||
|
|
"swiss-payment-slip/swiss-payment-slip-fpdf": "*"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
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](http://sprain.ch/blog/downloads/class-esr-besr-einzahlungsschein-php/) about the class he made for that.
|
||
|
|
On his [Github project's page](https://github.com/sprain/class.Einzahlungsschein.php) I found
|
||
|
|
[Peter Siska's](https://github.com/peschee) [pull request](https://github.com/sprain/class.Einzahlungsschein.php/pull/5).
|
||
|
|
His pull request introduced PSR-0 compatibility and he created a composer package on [Packagist](http://packagist.org/).
|
||
|
|
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
|
||
|
|
- Write tests
|
||
|
|
- Release the stable release of the API
|
||
|
|
|
||
|
|
Submitting bugs and feature requests
|
||
|
|
------------------------------------
|
||
|
|
|
||
|
|
Bugs and feature request are tracked on [GitHub](https://github.com/ravage84/SwissPaymentSlipFpdf/issues).
|
||
|
|
|
||
|
|
Author
|
||
|
|
------
|
||
|
|
|
||
|
|
This project was created by [Marc Würth](https://github.com/ravage84).
|
||
|
|
See Background Story for more details.
|
||
|
|
|
||
|
|
License
|
||
|
|
-------
|
||
|
|
|
||
|
|
SwissPaymentSlipFpdf is licensed under the MIT License.
|
||
|
|
See the [LICENSE](https://github.com/ravage84/SwissPaymentSlipFpdf/blob/master/LICENSE) file for details.
|
||
|
|
|
||
|
|
Thanks to
|
||
|
|
---------
|
||
|
|
|
||
|
|
- <http://ansuz.sooke.bc.ca/software/ocrb.php> for OCRB font
|
||
|
|
- <http://blog.fruit-lab.de/fpdf-font-converter/> for FPDF font converter
|