README

从https://github.com/EaDesgin/magento2-pdf-generator2 分支，以支持Magento 2.4及以上版本。

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文件以进行非常高级的配置 {Error in template processing} 和 {Error in template processing})。您可以添加自己的项目处理布局，以便您可以根据需要输出税收项目价格 ({{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.4.*

安装

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

通过composer

composer require synoptik-labs/magento2-pdf-generator2

php bin/magento setup:upgrade

需求

• php ~7.4.0|~8.1.0|~8.2.0