# sfTCPDFPlugin

`sfTCPDFPlugin` class provides abstraction for the [TCPDF library](http://www.tecnick.com/public/code/cp_dpage.php?aiocp_dp=tcpdf).
The main interest of this FPDF extension resides in the fact that it handles any UTF8 strings.

## Installation

  * Install the plugin

      
        symfony plugin-install http://plugins.symfony-project.com/sfTCPDFPlugin
      

  or download it and unzip in your /plugins directory

  * Download the [TCPDF library](http://sourceforge.net/project/showfiles.php?group_id=128076)

  * Unzip it inside the **/plugins/sfTCPDFplugin/lib** folder

At this point, you should have a **tcpdf** folder in **/plugins/sfTCPDFPlugin/lib**

  * Copy the files in **/web/sfTCPDFPlugin** directly to your application **/web** directory

  * Clear you cache

      
        symfony cc
      

## Configuration

  * Set **sf_tcpdf_dir** in your **config.php** application if TCPDF library is not inside the **/plugins/sfTCPDFplugin/lib** folder (check **/plugins/sfTCPDFPlugin/config/config.php**)

  * If you want to have custom settings for each generated PDF check **/plugins/sfTCPDFPlugin/config/config.php** and **tcpdf/config/tcpdf_config.php**).

  * If you want to run the tests, enable the **sfTCPDF** module in your **settings.yml** file, then call **sfTCPDF/test** or **sfTCPDF/test2**

## Usage

  * 1 - Hello World test (sfTCPDF/test)

      
      /**
       * Hello world test
       */
      public function executeTest()
      {
        // pdf object
        $pdf = new sfTCPDF();
    
        // settings
        $pdf->SetFont("FreeSerif", "", 12);
        $pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT);
        $pdf->setHeaderFont(array(PDF_FONT_NAME_MAIN, *, PDF_FONT_SIZE_MAIN));
        $pdf->SetHeaderData(PDF_HEADER_LOGO, PDF_HEADER_LOGO_WIDTH, PDF_HEADER_TITLE, PDF_HEADER_STRING);
        $pdf->setFooterFont(array(PDF_FONT_NAME_DATA, *, PDF_FONT_SIZE_DATA));
        $pdf->SetHeaderMargin(PDF_MARGIN_HEADER);
        $pdf->SetFooterMargin(PDF_MARGIN_FOOTER);
    
        // init pdf doc
        $pdf->AliasNbPages();
        $pdf->AddPage();
        $pdf->Cell(80, 10, "Hello World !!! & é € U û いろは");
    
        // output
        $pdf->Output();
        return sfView::NONE;
      }
      

  * 2 - Full test (sfTCPDF/test2, check **/plugins/sfTCPDFPlugin/actions/actions.php**)

## Changelog

### 1.5.3

  * Initial version for TCPDF 1.53 TC030

### 2007-06-04 | 1.5.4 Stable

  * Fix Full test (sfTCPDF/test2)
  * Customize Plugin is now possible

### 2008-01-21 | 1.5.5 Stable

  * Change the constant FPDF_FONTPATH to K_PATH_FONTS for work with the last version of TCPDF (Garfield-fr)
  
## Demo

  * You can find the [hello world] and the [http://snippets.coilblog.com/sfTCPDF/test2 full test](http://snippets.coilblog.com/sfTCPDF/test) on my blog.

## Notes

  * I seems there are problems with the TCPDF class when using PHP 5.1.x
  * I am searching beta testers to get some feeback. (C0il on IRC on, comment on my blog or whatever you want !)

### TODO

### Plugin support

  * Please report bugs/feeback in the [plugin section](http://www.symfony-project.com/forum/index.php/f/12/) of the forum
  * You can find also contact me on IRC or by email (check README file)

COil :)