[VtigerCRM][模組] PDF Marker！Vtiger PDF的客制化設計

話說前篇在處理PDF的版面調整時碰到很大的問題，當我翻遍整個Vigter論壇幾乎每個外國人都說何不使用PDF Marker模組。原本抱持著"原味才夠香"的心態想試試，結果整個程式相依性太高太廣不易修改。結果使用PDF Marker卻覺得真是偉大的模組套件～

PDF Marker有授權板跟免費版兩種，差別在於能否在一個模組表單李建立多個不同樣板範本供選擇輸出。授權版本大概要一千塊台幣，如果沒有太多需求而言免費版挺夠用了。

PDF Marker是協助將四個表單(發貨單/Invoice、銷售訂單/Sales Order、採購訂單/Purchase Order、報價單/Quotes)做PDF設計，設計時只用到HTML/CSS2就能輕鬆設計完成。同時能自動根據不同的翻譯語言做報價單更換，此外也能設定輸出的紙張類型，除了不支援CSS3讓我頭痛外，其他沒有什麼太大缺點。

Step 1. 安裝
請直接到PDF Marker官方網站下載免費版 for Vtiger 5.4.0，下載後同樣根據Vtiger的模組上傳方式進行安裝動作。同樣的沒有支援繁中包，所以我另外做一個中文化的PDF Marker for v5.4.0供給使用下載
PDF Marker for vtiger 5.4.0


當整體安裝完畢，請跟著提示步驟完成。最後可透過工具->PDF Marker對四個表單做設計，設計時一樣分為Header、Body、Footer進行

安裝完畢，在工具列多一個PDF Makrer可選擇

以報價單為例，有各屬性與函數可插入HTML/CSS使用

Step2. 修改簡體變繁體
事實上當我使用PDF Marker時一直會當成簡體字型輸出，使得我的PDF不能正常顯示預設的繁體字型，目前還不清楚為什麼這樣(請高手協助)。如果你沒有使用簡體PDF的需求，請跟我一起強迫中文都是繁體輸出吧

修改 /modulesPDFMaker/mpdf/config_cp.php

  else if ($country == "CN") {  
   if ($adobeCJK) {  
   //$unifonts = "gb,gbB,gbI,gbBI";  
   $unifonts = "big5,big5B,big5I,big5BI";  //強迫改為Big5成為繁體  
   }  

PS: 根據網友william Hsiao說明，在安裝完畢後建議重啟IIS確保正常。

---

調整PDF Marker的小數點問題
有人來問如何調整小數點，可透過各個PDF模板當中的參數來設定，以報價單為例請參考圖片解說：

範例中的PDF數字格式為台灣貨幣設定

---

在PDF Marker上增加可判斷的參數
使用PDF Marker雖然可以採HTML搭配各個參數函式來設計，但如果要使用一個具備條件功能的函式似乎只有付費版的才行。譬如在報價單上，如果沒有折扣值則不顯示，反之當折扣值成立才顯示。實際上我有去試用付費版的功能說真的介面很雜亂且功能性都不太符合期待，而且為了條件式折扣這個需求要我花錢這打破我的底線( 本人幫公司架Web到目前為止還沒花過錢呢)，不如改個方法使用內建的Workflow來滿足這個需求吧！

以下以報價單為例，希望有條件的根據是否為０來取決於顯示折扣欄位：

1. 首先，你需要在報價單的Layout佈局設計上新增一個區塊，並且該區塊內新增兩個自定義字段分別做為Workflow的『折扣標題』以及『折扣金額』。
2. 新增一個工作流於報價單內，實施每當折扣為0的工作事項並且在每次保存記錄的時候。條件為Discount Amount equal 0，任務建立兩筆為 折扣標題 = null 與 折扣金額 = null
3. 再新增一個工作流於報價單內，實施每當折扣不為0的工作事項並且在每次保存記錄的時候。條件為Discount Amount does not equal 0，任務建立兩筆為 折扣標題 = '折扣' 與 折扣金額 = discount Amount
4. 接著在PDF Marker上，將這兩個自定義字段擺放想條件顯示的HTML位置上。
5. 接著試著使用報價單去使用折扣功能，看看表格內的自訂區塊之兩筆欄位是否正確判斷產生期盼的效果。PDF功能滿足後，再回到佈局將該區塊隱藏避免USER勿觸。

透過Workflow來辦到要不要印數據出來

設置任務裡，要null的寫法

設置任務裡，要顯示值的寫法

---

增加PDF Marker的紙張類型
原本公司都用EXCEL做為出貨單人工填寫，因此期盼透過Vtiger CRM來產生。在免費版的PDF Marker當中只有內建的A3-A6以及LETTER與LEGAL可用。公司的報表紙為中一刀，沒有多餘的考量只能自己增加一個中一刀來用，當然付費版好像也有，不過改Code比較快

修改/modules/PDFMaker/EditPDFTemplate.php

 $Formats = array("A3"=>"A3",  
          "A4"=>"A4",  
          "A5"=>"A5",  
          "A6"=>"A6",  
          "Letter"=>"Letter",  
          "LETTERHALF"=>"LETTERHALF",  
          "Legal"=>"Legal");  

修改modules/PDFMaker/mpdf/mpdf.php

                case 'SRA3': {$format = array(907.09,1275.59); break;}  
                case 'SRA4': {$format = array(637.80,907.09); break;}  
                case 'LETTER': {$format = array(612.00,792.00); break;}  
                case 'LETTERHALF': {$format = array(612.00,396.00); break;}  
                case 'LEGAL': {$format = array(612.00,1008.00); break;}  
                case 'EXECUTIVE': {$format = array(521.86,756.00); break;}  
                case 'FOLIO': {$format = array(612.00,936.00); break;}  

這裡的單位為point，而一英吋為72point~

---