pixiucz / invoices
空
1.13
2017-12-04 09:23 UTC
Requires
- barryvdh/laravel-dompdf: ^0.8.0
- twig/twig: *
This package is not auto-updated.
Last update: 2024-09-21 16:43:57 UTC
README
- 通过Composer安装包
composer require pixiucz/invoices
- 然后,在你的
config\app.php
(Laravel)中或October的Plugin.php
的boot方法中注册InvoicesServiceProvider
Pixiucz\Invoices\InvoicesServiceProvider::class,
- 安装后,你需要运行迁移 – 要么通过运行
php artisan migrate
或者使用提供的cli命令
php artisan invoices:migrate
(此命令将只迁移包的表)
- 你必须创建至少一个命名模式,该模式将在发票中使用。你可以使用以下方式创建模式
php artisan invoices:makePattern “name_of_pattern” “pattern”
- 你的模式必须是包含两个槽位(-> {year} 正确的年份将被插入和 {number} 用于发票号码)的字符串。
- 示例
php artisan invoices:makePattern "eshop" "My-eshop-invoice-{year}/{number}"
基本用法
- 一旦实例化,
InvoiceGenerator
提供公共方法generateInvoice
- 此方法需要两个参数,另外两个是可选的
- String 模式(发票行)的名称(必需)
- Array 所有你想在提供的模板中打印的变量。(必需)
- String 你的
htm
文件的路径,该文件将作为模板使用。此模板应使用Twig语法,并且至少定义{{ invoice_number }}
,在生成的发票号码将打印的地方。(可选) - int 发票号码,这将绕过内部发票号码生成器(可选)
- 方法返回包含
'invoice_number'
和渲染的'pdf'
键值对的数组。
示例
$invoice = $invoiceGenerator->generateInvoice("eshop", $templateVariables);
变量数组的格式(所有都是可选的)
- 公司
- 名称
- 邮编
- 地址
- ico
- dic
- ic_dph
- 银行
- 账户号码
- iban
- swift
- 送货地址
- 名
- 姓
- 地址
- 邮编
- 城市
- 国家
- 账单地址
- 名
- 姓
- 地址
- 邮编
- 城市
- 国家
- ic
- dic
- 更新时间
- 变体
- 变体
- ean
- 名称
- 数量
- 价格
- 不含税价格
- 不含税总和
- 税
- 总和
- …
- 变体
- 送货选项
- 名称
- 价格
- 不含税价格
- 税
- 总和
- 不含税总和
- 仅税总和
- 总和
- 货币(货币符号)
- 状态 [‘已取消’,‘已退款’] -> 如果都不是,请留空