[1042] XOOPS模組開發進階
一、 快速匯出PDF
- 完整手冊:https://tcpdf.org/docs/srcdoc/tcpdf/class-TCPDF/
- HTML標籤索引:http://www.w3school.com.cn/tags/tag_table.asp
- 線上製作logo:http://www.qt86.com/random.php
- 建立空白PDF文件
include_once "header.php";
require_once(TADTOOLS_PATH.'/tcpdf/tcpdf.php');
$pdf = new TCPDF("P", "mm", "A4", true, 'UTF-8', false);
//PDF內容設定
$pdf->Output('通訊錄.pdf', 'D');
- 「$orientation」頁面方向,預設為P(直式),橫向為L,空值則自動判斷
- 「$unit」度量單位,pt、mm(預設)、cm、in
- 「$format」紙張大小,預設為A4
- 「$unicode」是否使用unicode,預設為true
- 「$encoding」文件編碼,預設為UTF-8
- 「$diskcache」使用磁碟快取,true會減少記憶體用量,但效能會變差,預設為false
- 「$pdfa」使用PDF/A模式(長期保存的電子文件格式),預設為false。
- Output的參數如下:
- (1) 「$name」檔名
- (2) 「$dest」輸出模式:「I: 在瀏覽器中呈現 (預設);D: 強制下載;F: 存在主機空間裡;S: 以文字方式傳回文件;FI: 等同F+I :FD: 等同F+D;E: 以郵件附件方式傳回文件。
- 常用基本架構:
$pdf->setPrintHeader(false); //不要頁首
$pdf->setPrintFooter(false); //不要頁尾
$pdf->SetAutoPageBreak(TRUE, PDF_MARGIN_BOTTOM); //設定自動分頁
$pdf->setFontSubsetting(true); //產生字型子集(有用到的字才放到文件中)
$pdf->SetFont('droidsansfallback', '', 12, '', true); //設定字型
$pdf->AddPage(); //新增頁面
- SetFont 的參數:
- (1) 「$family」字型名稱
- (2) 「$style」樣式:B粗、I斜、U底線、D刪除線、O上方線
- (3) 「$size」字型大小(預設為12pt)
- (4) 「$fontfile」字型檔
- (5) 「$subset」使用文字子集
- 將HTML轉為PDF
$pdf->writeHTML($html, $ln=1, $fill=0, $reseth=true, $cell =true, $align='');
- writeHTML的參數如下(有支援的網頁標籤:a, b, blockquote, br, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, img, li, ol, p, pre, small, span, strong, sub, sup, table, tcpdf, td, th, thead, tr, tt, u, ul):
- (1) 「$html」內容(屬性一定要用雙引號)
- (2) 「$ln」下一個元件的位置:「0(預設)右邊;1下行最左邊;2目前元件下方」
- (3) 「$fill」是否填色:「true為不透明;false透明」
- (4) 「$reseth」若true會重設並統一同一排格子的高度
- (5) 「$cell」自動增加內距
- (6) 「$align」對齊方向:「L;C;R」。
- HTML的表格可利用cellpadding來增加儲存格內距,用border來設定邊框。
- A4=210 x 297mm = 595 X 842 px (72 dpi),1mm=2.83px,1px=0.35mm
- 左右合併 colspan=3,上下合併rowspan=4
- 以網頁方式插入圖片:有支援「http://網址/圖檔」的方式,但若網址是localhost,圖片路徑需改用相對路徑。
<img src="../images/logo_example.png" border="0" height="41" width="41" />
- 設定頁面邊界,預設$right的值會等於$left,$ keepmargins為true會覆蓋頁面預設邊界
$pdf->SetMargins(20, 25);
$pdf->setHeaderMargin(10); //頁首上方與頁面頂端的距離
$pdf->setFooterMargin(20); //頁尾上方與頁面尾端的距離
- 設定頁首:
$pdf->setHeaderData($ln='', $lw=0, $ht='', $hs='', $tc=array(0, 0, 0), $lc=array(0, 0, 0));
$pdf->setFooterData($tc=array(0, 0, 0), $lc=array(0, 0, 0));
- (1) $ln:頁首圖片檔名(圖片目錄預設在tcpdf/images,可修改tcpdf_config.php的K_PATH_IMAGES設定重設圖片目錄)
- (2) $lw:頁首圖片寬度,單位mm
- (3) $ht:頁首文字標題
- (4) $hs:頁首小字說明
- (5) $tc:文字顏色,RGB以陣列呈現,如:array(0,64,255)
- (6) $lc:頁首橫線顏色
- 頁首字型:
$pdf->setHeaderFont(array('droidsansfallback', '', 12));
$pdf->setFooterFont(array('droidsansfallback', '', 12));
- (1) $font為一個陣列,如:array('字型名稱','字型樣式','字型大小')
- 1. 插入文字的三種方法:
$pdf->Cell($w, $h, $txt, $border, $ln, $align, $fill, $link, $stretch, $ignore_min_height, $calign, $valign);
$pdf->MultiCell($w, $h, $txt, $border, $align, $fill, $ln, $x, $y, $reseth, $stretch, $ishtml, $autopadding, $maxh, $valign, $fitcell);
$pdf->writeHTMLCell($w, $h, $x, $y, $html, $border, $ln, $fill, $reseth, $align, autopadding);
- 其中Cell()最常用,想像任何一段文字都放在一個可以指定寬高的格子中,但文字不會隨著格子寬度自動換行,而且文字可已設定隨格子大小來自動放大縮小。
- 若需要讓文字可以自動換行,請使用MultiCell(),一樣需指定格子寬高。
- writeHTMLCell()則是用座標來放文字,可以放在頁面的任何一個位置。
- (1) 「$w」寬、「$h」最小高度、「$border」框線:「0,1,T,R,B,L」
- (2) 「$ln」下一個元件的位置:「0(預設)右邊;1下行最左邊;2目前元件下方」
- (3) 「$align」對齊方向:「L,C,R,J」
- (4) 「$fill」是否填色:「true為不透明;false透明」
- (5) 「$link」加入連結
- (6) 「$stretch」延伸:0不延伸;1字大於格寬才縮放文字;2一律縮放文字到格寬;3字大於格寬才縮放字距;4一律縮放字距到格寬、「$ignore_min_height」自動忽略最小高度
- (7) 「$calign」格內對齊:「T格上,C格中,B格下,A字上,L字底,D字下」
- (8) 「$valign」垂直對齊:「T,C,B」
- (9) 「$reseth」若true會重設最後一格的高度
- (10) 「$autopadding」自動調整內距
- (11) 「$x、$y」左上角起始位置
- (12) 「$ishtml」請設為false
- (13) 「$maxh」高度上限(需>$h)
- (14) 「$fitcell」自動縮放字大小到格內
- (15) 「$html」內容(屬性一定要用雙引號)
- 設定文字陰影
$pdf->setTextShadow(array('enabled'=>true, 'depth_w'=>0.2, 'depth_h'=>0.2, 'color'=>array(196,196,196), 'opacity'=>1, 'blend_mode'=>'Normal'));
- 以物件方式插入圖片:
$pdf->Image($file, $x='', $y='', $w=0, $h=0, $type='', $link='', $align='', $resize=false, $dpi=300, $palign='', $ismask=false, $imgmask=false, $border=0, $fitbox=false, $hidden=false, $fitonpage=false, $alt=false, $altimgs=array());
- (1) $file:檔名或圖檔路徑
- (2) $x、$y:以左上角為起點的x,y座標位置
- (3) $w、$h:寬度、高度,若設0會自動偵測
- (4) $type:圖檔格式(大小寫不拘),支援GIF, JPEG, PNG, BMP, XBM, XPM等格式
- (5) $link:連結網址,或用AddLink()來新增連結
- (6) $align:對齊方向,T(上)、M(中)、B(下)、N(下一行)
- (7) $resize:若為true,會縮放原圖到$w 及 $h 指定的大小。
- (8) $dpi:縮放時用的解析度
- (9) $palign:水平對齊方向,L(左)、C(中)、R(右)
- (10) $ismask:若為true,則視該圖為遮罩
- (11) $imgmask:由此函數傳回圖片物件,或設為 false
- (12) $border:0(無邊框,預設)、1(加框)、L(左)、T(上)、R(右)、B(下),亦可用陣列來設定樣式,如:array('LTRB' => array('width' => 2, 'cap' => 'butt', 'join' => 'miter', 'dash' => 0, 'color' => array(0, 0, 0)))
- (13) $fitbox:若不為false,則縮放圖片至外層容器中,亦可用字元來指定縮放方式,如水平方向縮放 (L = 左, C = 中, R = 右) 或上下縮放(T =上, M =中, B =下)
- (14) $hidden:若為true,則不顯示圖片。
- (15) $fitonpage:如果為true,圖片大小調整為不超過頁面尺寸。
- (16) $alt:若為true,圖片將不會直接秀出,而是傳回圖片的ID。
- (17) $altimgs:交替顯示圖像的ID的數組。每個的替代圖像必須是一個數組,它有兩個值:一個整數,表示圖像ID(對圖像的方法的返回值)和一個布爾值,表示如果圖像是默認的打印。
- 請下載 pclzip.lib.zip,並解壓上傳到模組的class目錄下。
- 建立 dl.php,內容如下,並修改 $dir_name 及 $filename 的預設值即可。