README

Magento 2 发票 PDF 生成器 - 帮助您自定义 Magento 2 的 PDF 模板。如果您已启用模板并设置了默认模板，系统将打印 PDF 模板。

如何使用该模块

从“添加新模板”按钮添加新模板。这会提示您一系列字段。

• 启用模板 - 您需要启用模板才能使用它；
• 默认模板 - 将模板设置为当前店铺的默认模板；
• 模板名称 - 这既是您的信息，也是模板描述；
• 网站模板 - 在此处选择您需要模板的网站；
• 模板正文、页眉和页脚是您可以添加将转换为 PDF 正文中的 HTML 的位置；
• 模板 CSS 文件允许您为 HTML 创建样式，如 "h1 {color:red;} h2 {color:blue}"，不要使用样式标签，它不是必需的。在正文您也可以指定像电子邮件模板中的 HTML；
• 模板设置用于塑造模板，使其符合您的要求。 "模板文件名" 可以从变量中生成，只要它们适用于文件命名 {{var invoice.increment_id}}-{{var invoice.id}}-file-invoice。 "模板纸张方向" 用于设置 PDF 的横版或竖版。如果您选择使用自定义格式，则 "自定义高度" 和 "自定义宽度"（以毫米为单位）将被使用。在这种情况下将忽略纸张方向和 "模板纸张格式"。如果模板具有标准格式，则 "模板纸张格式" 允许您将纸张设置为几种格式（A4、A5、A3、Letter 和 Legal）。其他设置是顶部、右侧、左侧和底部的边距（以毫米为单位）。如果页眉或页脚覆盖了您的正文，请增加顶部和底部边距以修复此问题。

该扩展将允许您利用电子邮件模板系统及其更多功能。您可以在模板中添加 phtml 文件以进行非常高级的配置 {模板处理错误} 和 {模板处理错误}。您还可以添加自己的项目处理布局，以便您可以按所需方式输出税款项目价格 ({{layout area="frontend" handle="sales_email_order_invoice_items" invoice=$invoice order=$order}})。

您还可以使用 trans 指令来本地化模板。

{{trans "Thank you for your order from %store_name." store_name=$store.getFrontendName()}}{{trans "Once your package ships we will send you a tracking number."}}

使用此扩展，您可以按需更改发票 PDF。PDF 生成器具有以下多个功能：

• 更改 Magento 发票 PDF 以满足您的需求；
• 向模板添加自定义 CSS 以进一步个性化 PDF；
• 为每个店铺添加具有不同设计和功能的模板；
• 使用变量更改 PDF 文件的文件名；
• 您可以以 PDF 附件的形式发送发票邮件；
• 您可以从系统配置区域启用或禁用 PDF；

有关变量系统，您可以在 此处 阅读 Magento 文档。我们使用完全相同的系统来生成变量。

支持的版本

• Magento 2.1.*
• Magento 2.2.*
• Magento 2.3.*

安装

您可以通过 composer 安装该模块，或者通过将其添加到 app/code 目录中手动安装。该模块可在 packagist.org 上找到

通过 composer

composer config repositories.magento2-pdf-generator2 git git@github.com:EaDesgin/magento2-pdf-generator2.git

composer require eadesignro/module-pdfgenerator

php bin/magento setup:upgrade

需求

• ~7.1.3|~7.2.0
• https://github.com/mpdf/mpdf - 用于生成PDF的库。

视频安装和使用