SuperAPI AI 工具集

perfex-pdf

办公与效率

查看项目

更新于 10-16 05:45

技能介绍

用途:在 Perfex CRM 中定制、覆盖或调试 PDF 输出,包括发票、报价、提案、合同、收款、对账单和贷项通知单。Perfex 通过 TCPDF 生成 PDF,模板位于 application/views/themes/perfex/views/,是调用 $pdf 对象的普通 PHP 文件。

主要能力:用 my_ 前缀覆盖约定(如 my_invoicepdf.php)在不改核心文件的前提下定制模板,可随核心升级保留;通过 TCPDF 方法设置字体、写 HTML、加页、设边距、输出单元格与图片;按语言选择字体(拉丁/西里尔用 freesans,阿拉伯语用 dejavusans,中日韩用 droidsansfallback);用 App_items_table 子类定制行项目表格;通过 pdf_construct、pdf_header、pdf_footer、pdf_close 等钩子介入生命周期;读取自定义字段并渲染;覆盖 PDF 标题语言串;配置 Logo、纸张尺寸与方向;Perfex 3.4.0+ 另有 JSON/XML 电子发票输出。

使用方式:复制核心模板并加 my_ 前缀放回同目录后编辑;自定义字体需用完整路径注册,如 $pdf->AddFont('brandsans', '', FCPATH . 'assets/themes/my_theme/fonts/brandsans.php'),且只注册实际使用的字重;行项目表格通过 items_table_class 过滤器返回自定义子类,覆盖 items()、html_headings()、pdf_headings()。

限制与注意:TCPDF 仅支持有限 HTML/CSS,无 flexbox、grid、float,布局用 table 与内联样式;HTML 须为合法 XHTML;Logo 路径须为绝对文件系统路径;阿拉伯语需 setRTL(true);空白 PDF 多为模板内 PHP 致命错误,可开启 development 环境查看;自定义默认字体不能在 pdf_construct 中注册,因默认 setFont() 已先执行。

适用场景:需要品牌化或本地化 Perfex 单据 PDF、调整行项目列、注入自定义字段的开发者。具体收费、价格与平台信息暂未提供。