joseki/pdf-response

Pdf response extension for Nette Framework

Installs: 6 046

Dependents: 0

Stars: 13

Watchers: 5

Forks: 5

Language: PHP

v2.2.3 2015-01-13 20:38 UTC

README

Build Status

  • sends template as PDF output
  • works fine with both Nette 2.0.* and Nette 2.1.* and even Nette 2.2.*
  • no js support
  • nice api

Install

Installation via Composer.

{
    "require":{
        "joseki/pdf-response": ">= 2.1"
    }
}

How to prepare PDF from template

// in a Presenter
public function actionPdf()
{
    $template = $this->createTemplate();
    $template->setFile("/path/to/template.latte");
    $template->someValue = 123;
    // Tip: In template to make a new page use <pagebreak>

    $pdf = new Joseki\Application\Responses\PdfResponse($template);

    // optional
    $pdf->documentTitle = date("Y-m-d") . " My super title"; // creates filename 2012-06-30-my-super-title.pdf
    $pdf->pageFormat = "A4-L"; // wide format
    $pdf->getMPDF()->setFooter("|© www.mysite.com|"); // footer
}

Save file to server

public function actionPdf()
{
    $template = $this->createTemplate();
    $template->setFile("/path/to/template.latte");

    $pdf = new Joseki\Application\Responses\PdfResponse($template);

    $pdf->save("/path/to/directory"); // as a filename $this->documentTitle will be used
    $pdf->save("/path/to/directory", "filename"); // OR use a custom name
}

Attach file to an email

public function actionPdf()
{
    $template = $this->createTemplate();
    $template->setFile("/path/to/template.latte");

    $pdf = new Joseki\Application\Responses\PdfResponse($template);

    $savedFile = $pdf->save("/path/to/directory");
    $mail = new Nette\Mail\Message;
    $mail->addTo("john@doe.com");
    $mail->addAttachment($savedFile);
    $mailer = new SendmailMailer();
    $mailer->send($mail);
}

Force file to download

public function actionPdf()
{
    $template = $this->createTemplate();
    $template->setFile("/path/to/template.latte");

    $pdf = new Joseki\Application\Responses\PdfResponse($template);
    $pdf->setSaveMode(PdfResponse::DOWNLOAD); //default behavior
    $this->sendResponse($pdf);
}

Force file to display in a browser

public function actionPdf()
{
    $template = $this->createTemplate();
    $template->setFile("/path/to/template.latte");

    $pdf = new Joseki\Application\Responses\PdfResponse($template);
    $pdf->setSaveMode(PdfResponse::INLINE);
    $this->sendResponse($pdf);
}

Set a pdf background easily

public function actionPdf()
{
    $pdf = new Joseki\Application\Responses\PdfResponse('');
    $pdf->setBackgroundTemplate("/path/to/an/existing/file.pdf");

    // to write into an existing document use the following statements
    $mpdf = $pdf->getMPDF();
    $mpdf->WriteFixedPosHTML('hello world', 1, 10, 10, 10);

    // to write to another page
    $mpdf->AddPage();

    // to move to exact page, use
    $mpdf->page = 3; // = move to 3rd page

    $this->sendResponse($pdf);
}

Create pdf with latte only

public function actionPdf()
{
    $latte = new Latte\Engine;
    $latte->setTempDirectory('/path/to/cache');
    $latte->addFilter('money', function($val) { return ...; }); // formerly registerHelper()

    $latte->onCompile[] = function($latte) {
        $latte->addMacro(...); // when you want add some own macros, see http://goo.gl/d5A1u2
    };

    $template = $latte->renderToString("/path/to/template.latte");

    $pdf = new Joseki\Application\Responses\PdfResponse($template);
    $this->sendResponse($pdf);
}

See also