自定 PDF 嫌單

admin
會計與發票
4天前
9热度
0评论

你可以透過糢闆文件系統來自訂發票和報價嘅 PDF 文件。你可以喺啟動嘅 WHMCS 系統主題嘅 templates 目錄中搵到呢啲文件。

糢闆文件#

你可以自定義以下糢闆：

templates/viewinvoice.tpl 控制系統主題嘅發票糢闆。
templates/invoicepdf.tpl 控制發票嘅 PDF 版本。
templates/quotepdf.tpl 控制報價單 PDF。

標題同頁腳#

您可透過更新標題和頁腳模板，使標題或頁腳在多頁 PDF 發票或報價單的每一頁自動重複。

發票標題同尾注#

如果您的主題中存在呢啲文件，系統會喺每個渲染嘅 PDF 頁面上包含以下系統主題糢闆文件：

invoicepdfheader.tpl
invoicepdffooter.tpl

系統只需要相應嘅標題或尾注檔案。例如，若要在每頁上使用自定義尾注，請建立 invoicepdffooter.tpl 文件。你必須把呢啲文件存放喺與 invoicepdf.tpl 系統主題糢闆文件相同嘅目錄中。

在糢闆處理期間，Smarty 會為呢啲文件提供與它為 invoicepdf.tpl 提供嘅相同變量。

引用標題同頁腳#

如果您的主題中存在呢啲文件，系統將為每個渲染嘅 PDF 頁面包含以下糢闆文件：

quotepdfheader.tpl
quotepdffooter.tpl

系統只需要相應嘅標題或頁腳檔案。例如，若要在每頁上添加自定義頁腳，請建立 quotepdffooter.tpl 文件。你必須把呢啲文件存放喺與 quotepdf.tpl 糢闆文件相同嘅目錄中。

在糢闆處理期間，Smarty 將為呢啲文件提供與它為 quotepdf.tpl 提供嘅相同變量。

修改標誌#

PDF 嫌單同報價單上嘅標誌位於 /assets/img/ 文件夾內。若要更改此標誌，請將所需嘅標誌上傳至 /assets/img/ 文件夾。文件名應為 logo.jpg 或 logo.png 。

你可以更改 invoicepdf.tpl 標誌款式文件中嘅標誌圖嘅寬度。在行 10 ，調整閉括號 )); 之前嘅最後一個數字（ 75 ）。此變量定義圖像寬度。

編輯文字同內容 #

你可以透過添加或移除文字、更改布局或添加圖像和格式來自定 PDF 嫌單同報價單嘅内容。

要這樣做，請編輯活動糢闆文件夾中嘅 invoicepdf.tpl 或 quotepdf.tpl 系統主題糢闆文件。呢啲文件包含所有與 PDF 文件中嘅布局同顯示相關嘅代碼。

你需要對 PHP 編程有基本嘅瞭解，才能理解並修改呢啲文件。
系統使用 TCPDF 生成 PDF 文件。如需更多資訊，請參閱 TCPDF 網站。

添加自定字段#

若要在可打印單及 PDF 請款單中顯示自定字段，請前往設置（）>系統設置>自定字段。然後，選擇顯示于請款單。

以下變量可供喺 invoicepdf.tpl 文件中使用：

$invoiceid -請款單嘅 ID。
$invoicenum -開票嘅自定義編號。僅当你啟用咗形式發票或連續開票時才設置此項。
$datecreated -開票嘅創建日期。
$duedate -開票嘅到期日期。
$datepaid -若開票狀態為已支付，則顯示支付日期和時間。
$userid -客戶 ID 號碼。
$clientsdetails["firstname"] -客戶資料名稱。
$clientsdetails["lastname"] -客戶資料姓氏。
$clientsdetails["companyname"] -客戶資料公司名稱。
$clientsdetails["fieldname"] -其他客戶資料值，其中 fieldname 係該項目嘅名稱。
$customfields -組客戶自定義字段（例如， $customfields['Custom Field Name'] ）。如需更多信息，請參閱翻譯產品。
$subtotal
$tax
$taxrate
$credit
$total
$status -已付款、未付款或已取消。
$paymentmethod
$notes
$companyname -公司名稱。
$companyurl -默認網站 URL。
$companyaddress -公司地址。
$invoiceitems -組發票項目。

你可以通過喺 PHP 糢闆內執行 SQL 查詢嚟獲取更多數據。

修改或翻譯文件名#

發票同報價單有默認嘅文件名格式：

發票嘅默認文件名係 Invoice-xxx 。
單位格嘅默認文件名係 Quote-xxx 。

喺兩個文件名中， xxx 係發票或報價單嘅 ID。

若要更改或翻譯呢啲，請使用 WHMCS 語言檔案。當您這樣做時，請查找這些行：

$_LANG['invoicefilename'] = "Invoice-";
$_LANG['quotefilename'] = "Quote-";

縮小 PDF 文件大小#

WHMCS 產生嘅 PDF 文件中，絕大部分嘅文件大小來自嵌入嘅 UTF-8 字體檔案。由於 UTF-8 字符集支持嘅字符範圍廣泛，呢啲文件比例如使用 ISO-8859-1 字符集嘅檔案仲大。與 UTF-8 不同，ISO-8859-1 只支持 A - Z 、 a - z 、 0 - 9 等標準字符。

若冇客戶在其姓名或地址中使用特殊字符，系統面唔需要 UTF-8。你可以透過更改字體嚟縮小 PDF 文件嘅大小。

要這樣做，請喺設置（）>系統設置>常規設置中嘅發票選項卡中將 PDF 字體家族更改為 Helvetica。