= sfTCPDFPlugin =

`sfTCPDFPlugin` class provides abstraction for the [http://www.tecnick.com/public/code/cp_dpage.php?aiocp_dp=tcpdf TCPDF library].
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 [http://sourceforge.net/project/showfiles.php?group_id=128076 TCPDF library]

  * 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 [http://snippets.coilblog.com/sfTCPDF/test hello world] and the [http://snippets.coilblog.com/sfTCPDF/test2 full 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 [http://www.symfony-project.com/forum/index.php/f/12/ plugin section] of the forum
  * You can find also contact me on IRC or by email (check README file)

COil :)