Download the PHP package pyromn/pdf-gift-card without Composer
On this page you can find all versions of the php package pyromn/pdf-gift-card. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package pdf-gift-card
PDF Gift Card
Changes:
- PHP 8.3 Support
- PSR-4 compatible
- Available as composer package
- Dependencies are coming via composer
PHP Compatibility
| PHP | PDF Gift Card |
|---|---|
| 8.3 | 1.0.0. |
Introduction
PHP Gift Card is a simple object oriented PHP class to generate beautifully designed gift cards, quotes or orders with just a few lines of code. Brand it with your own logo and theme color, add unlimited items and total rows with automatic paging. You can deliver the PDF ouput in the user's browser, save on the server or force a file download. PHP Gift Card is fully customizable and can be integrated into any well known CMS.
Multi-languages & Currencies
PHP Gift Card has built in translations in English, Dutch, French, German, Spanish and Italian (you can easily add your own if needed) and you can set the currency needed per document.
Additional Titles, Paragraphs And Badges
Extra content (titles and multi-line paragraphs) can be added to the bottom of the document. You might use it for payment or shipping information or any other content needed.
Installation
Examples
There are 3 examples included in the examples/ folder of this repo:
- simple.php
- example1.php
- example2.php
- change_timezone.php
Create A New Gift Card
TODO: After code review, update README documentation with new consts.
Make sure that the default php date timezone is set before using the class.
In this simple example we are generating an card with custom logo and theme color. It will contain 2 products and a box on the bottom with VAT and total price. Then we add a "Paid" badge right before the output.
Documentation
Create Instances
| Parameter | Type | Accepts | Note |
|---|---|---|---|
| size | string | A4 (default) Letter Legal |
Set your document size |
| currency | string | any string (e.g. "$", "£", "€") | Set the currency that you want to use |
| language | string | en (default), nl, fr, de, es, it | A language that exists in the inc/languages folder |
Number Formatting
How do you want to show your numbers?
| Parameter | Type | Accepts | Note |
|---|---|---|---|
| decimalpoint | string | Commonly used is '.' (default) or ',' | What string to use for decimal point |
| seperator | string | Commonly used is '.' or ',' (default) | What string to use for thousands separator |
| alignment | string | 'left' (default) or 'right' | Where to show the currency symbol |
| space | boolean | true (default) or false | Show a space between currency symbol and price |
| negativeParenthesis | boolean | true or false (default) | Remove the negative sign and wrap in parenthesis |
Color
Set a custom color to personalize your cards.
Add Logo
| Parameter | Type | Accepts | Note |
|---|---|---|---|
| image | string | Local path or remote url of the image | Preferably a good quality transparant png image |
| maxwidth (optional) | int | The width (in mm) of the bounding box where the image will be fitted in | |
| maxheight (optional) | int | The height (in mm) of the bounding box where the image will be fitted in |
Document Title
Order Number
Date
Due Date
Issuer Information
Set your company details.
Client Information
Flip Flop
Switch the horizontal positions of your company information and the client information. By default, your company details are on the left.
Issuer and Client header titles
Hide the issuer and client header row
Adding Items
Add a new product or service row to your document below the company and client information. PHP Invoice has automatic paging so there is absolutely no limit.
name(string)
A string with the product or service name.description(string|false)
A string with the description with multi-line support. Use either<br>or\nto add a line-break.quantity(decimal|false)
An integer with the quantity for of this line.vat(string|decimal|false)
Pass a string (e.g. "21%", or any other text you may like) or a decimal if you want to show an amount instead (e.g. 124.30). A numeric value will be formatted as "money" automatically.price(decimal|false)
A decimal for the unit price.discount(string|decimal|false)
Pass a string (e.g. "10%", or any other text you may like) or a decimal if you want to show an amount instead (e.g. 50.00) Note: the final output will not show a discount column unless any of the products haven't set a discount.total(decimal|false)
A decimal for the total product or service price.
The fields description, quantity, vat, price, discount and total are all optinoal. To disable any of this for an invoice line, pass false for the corresponding argument.
Item line description font size
Change the font size for the product description. Default is 7
Adding Totals
Add a row below the products and services for calculations and totals. You can add unlimited rows.
- name {string} A string for the display name of the total field.
- value {decimal} A decimal for the value.
- background {boolean} Optional. Set to true to set the theme color as background color of the row.
Adding A Badge
Adds a badge to your invoice below the products and services. You can use this for example to display that the invoice has been payed.
badge {string} A string with the text of the badge.
It is possible to set the color of the badge as the second parameter:
CSS color names ('red', 'cyan', 'fuchsia', etc) are NOT supported
Add Title
You can add titles and paragraphs to display information on the bottom part of your document such as payment details or shipping information.
title {string} A string with the title to display in the badge.
Add Paragraph
You can add titles and paragraphs to display information on the bottom part of your document such as payment details or shipping information.
Paragraph {string} A string with the paragraph text with multi-line support.
Use either <br> or \n to add a line-break.
Change a Language Term on the fly
You can change a Language Term with this method. This overwrites the Term from the Language File.
Footer
A small text you want to display on the bottom left corner of the document.
note {string} A string with the information you want to display in the footer.
Rendering The Card
- name {string} A string with the name of your card. Example: 'card.pdf'
- output {string} Choose how you want the card to be delivered to the user.
The following options are available:
I(Send the file inline to the browser)D(Send to the browser and force a file download with the name given by name)F(Save to a local file. Make sure to set pass the path in the name parameter)S(Return the document as a string)
