.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================ PDF Controller 3 ================ :Created: 2010-10-13T21:40:33 :Changed by: dirk :Changed: 2015-11-30T17:21:46 :Classification: pdfcontroller :Description: http://typo3-pdfcontroller.de/ Offer a TYPO3 page for PDF download. Individual layout with background PDF file. Extra first page is possible. PDF Controller supports TYPO3 sessions and can used on restricted pages. The PDF Generator can handle responsive backend layouts and responsive grid elements - ready-for-use together with TYPO3 Start. The PDF engine is TCPDF. :Keywords: PDF, html2ps, postscript, tcpdf :Author: Dirk Wildt - Die Netzmacher :Email: http://wildt.at.die-netzmacher.de :Website: http://die-netzmacher.de :Language: en |img-1| |img-2| PDF Controller 3pdfcontroller |img-3| .. _PDF-Controller-3: PDF Controller 3 ================ http://typo3-pdfcontroller.de/ Offer a TYPO3 page for PDF download. Individual layout with background PDF file. Extra first page is possible. PDF Controller supports TYPO3 sessions and can used on restricted pages. The PDF Generator can handle responsive backend layouts and responsive grid elements - ready-for-use together with TYPO3 Start. The PDF engine is TCPDF. |img-4| Version: 4.2.0 - 2015-11-30 Extension Key: pdfcontroller Language: en Keywords: PDF, html2ps, postscript, tcpdf Copyright 2011-2015, Dirk Wildt - Die Netzmacher, This document is published under the Open Content License available from `http://www.opencontent.org/opl.shtml `_ The content of this document is related to TYPO3 a GNU/GPL CMS/Framework available from `www.typo3.org `_ .. _Table-of-Contents: Table of Contents ----------------- `PDF Controller 3 1 <#__RefHeading__1165_1172745218>`_ `Screen shots 3 <#__RefHeading__1513_1172745218>`_ `Frontend 3 <#__RefHeading__2937_720402256>`_ `Backend 4 <#__RefHeading__2939_720402256>`_ `Introduction 5 <#__RefHeading__2941_720402256>`_ `What does it do? 5 <#__RefHeading__1169_1172745218>`_ `Restrictions and Incapacities 5 <#__RefHeading__32862_1688561975>`_ `Manual as PDF file 5 <#__RefHeading__4972_871408798>`_ `Website 5 <#__RefHeading__3345_721202337>`_ `Forum 5 <#__RefHeading__3347_721202337>`_ `Installation 6 <#__RefHeading__26585_469190053>`_ `Controlling 7 <#__RefHeading__1525_2077445915>`_ `Workflow 7 <#__RefHeading__2943_720402256>`_ `Requirements 8 <#__RefHeading__1035_1830399870>`_ `PDF Properties 9 <#__RefHeading__4575_720402256>`_ `Layout Restrictions 10 <#__RefHeading__2951_720402256>`_ `CSS 10 <#__RefHeading__5346_492987965>`_ `HTML 12 <#__RefHeading__3876_908339063>`_ `Optimisation by the PDF Controller 13 <#__RefHeading__3104_720402256>`_ `Constant Editor 14 <#__RefHeading__4732_1907656381>`_ `PDF CONTROLLER - BUTTON 14 <#__RefHeading__4734_1907656381>`_ `PDF CONTROLLER - CONFIG 14 <#__RefHeading__4736_1907656381>`_ `PDF CONTROLLER – PAGES PDF 14 <#__RefHeading__4738_1907656381>`_ `PDF CONTROLLER – PAGES PRINT 14 <#__RefHeading__4742_1907656381>`_ `This effects the PAGE object pdfcontrollerPrint 14 <#__RefHeading__4671_94463037>`_ `PDF CONTROLLER – PAGES USER INTERFACE 14 <#__RefHeading__4744_1907656381>`_ `PDF CONTROLLER – URL 15 <#__RefHeading__4746_1907656381>`_ `PDF CONTROLLER – VIEW 15 <#__RefHeading__4748_1907656381>`_ `Reference 16 <#__RefHeading__2953_720402256>`_ `PAGE 16 <#__RefHeading__3960_1907656381>`_ `tt\_content 16 <#__RefHeading__4750_1907656381>`_ `tx\_pdfcontroller: PDF Controller User Interface 17 <#__RefHeading__5348_492987965>`_ `tx\_pdfcontroller\_pi2: PDF Controller Button 23 <#__RefHeading__32599_1688561975>`_ `Extensions 25 <#__RefHeading__3980_1907656381>`_ `Fonts 28 <#__RefHeading__3995_2130164496>`_ `Install custom fonts 28 <#__RefHeading__4611_720402256>`_ `Debugging 29 <#__RefHeading__4835_720402256>`_ `Mode 29 <#__RefHeading__2417_1445640533>`_ `DRS (Development Reporting System) 30 <#__RefHeading__2264_1636571778>`_ `3rd party! 31 <#__RefHeading__4577_720402256>`_ `Grid Elements 31 <#__RefHeading__4579_720402256>`_ `Organiser – TYPO3 for Lobby and Organisers 32 <#__RefHeading__4581_720402256>`_ `Slick – responsive Carousel and Slider 32 <#__RefHeading__4583_720402256>`_ `Start – Starter Kit for a responsive TYPO3 33 <#__RefHeading__4585_720402256>`_ `What's new 34 <#__RefHeading__7722_566939054>`_ `4.x 34 <#__RefHeading__4587_720402256>`_ `3.x 34 <#__RefHeading__4601_720402256>`_ `Upgrades 35 <#__RefHeading__4609_720402256>`_ `From 3.x to 4.x 35 <#__RefHeading__5352_492987965>`_ `From 2.x to 3.x 35 <#__RefHeading__4007_2130164496>`_ `Known Bugs 36 <#__RefHeading__6832_1502491801>`_ `Further Information 37 <#__RefHeading__7813_621543893>`_ `Other extensions published by Die Netzmacher 37 <#__RefHeading__7815_621543893>`_ `SEO - Search Engine Optimisation 38 <#__RefHeading__5477_2130164496>`_ `Credits 39 <#__RefHeading__3945_2075630830>`_ `Helpful suggestions 40 <#__RefHeading__32605_1688561975>`_ `Forum 40 <#__RefHeading__31134_1688561975>`_ `Change log 41 <#__RefHeading__28618_469190053>`_ `Illustration Index 44 <#__RefHeading__780_637468415>`_ `Alphabetical Index 45 <#__RefHeading__20259_1651812849>`_ .. _Screen-shots: Screen shots ------------ .. _Frontend: Frontend ^^^^^^^^ |img-5| Live - HTML: `http://die-netzmacher.de/ `_ - PDF: `http://die-netzmacher.de/?type=67425 `_ |img-5| Live - HTML: `http://die-exen.de/spieler/annika-pilstl/ `_ - PDF: `http://die-exen.de/spieler/annika-pilstl/?type=67425 `_ .. _Backend: Backend ^^^^^^^ |img-5| .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The PDF Controller 3 converts HTML to PDF. - The PDF Controller manages frontend user sessions.You can use the PDF Controller on pages which are restricted for frontend users. - The PDF Controller 3 has both plugins - a user interface and - a button - The button enables a quick start. - The PDF engine is TCPDF for TYPO3 (t3\_tcpdf) - The extension PDF Controller 3 Additional Fonts (pdfcontroller\_fonts) extends the default fonts of the PDF Controller 3. - You can extend the PDF Controller respectively TCPDF with your own fonts. - The PDF Controller 3 has support for some other extensions: - The PDF Controller 3 handles backend layouts and grid elements ready- for-use, if you are using Start – the Starter Kit for a responsive TYPO3. `:sup:`0` <#sdfootnote1sym>`_ - Organiser `:sup:`0` <#sdfootnote2sym>`_ news are ready-for-use. .. _Restrictions-and-Incapacities: Restrictions and Incapacities ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - The CSS compatibility is on a poor level. It is similar like CSS for HTML in e-mails (newsletters). - The PDF Controller respectevely TCPDF seems not to be able to care of a proper pagebreak in tables, if the content of a row hasn't enough space on the current page and content is mixed with text and images. Maybe there are some more incapacities. - The PDF Controller hasn't a ready-for-use TypoScript for TYPO3 file elements. - The PDF Controller isn't compatible with the former PDF Controller upto version 2.x. - The PDF Controller should run in TYPO3 7.x. But this isn't tested! .. _Play-with-it: Play with it! """"""""""""" Play with the PDF Controller at - `http://die-exen.de `_ - `http://die-netzmacher.de `_ .. _Manual-as-PDF-file: Manual as PDF file ^^^^^^^^^^^^^^^^^^ You find this manual as PDF file at - doc/manual.pdf - `http://typo3-pdfcontroller.de/typo3conf/ext/pdfcontroller/doc/manual. pdf `_ .. _Website: Website ^^^^^^^ The PDF Controller 3 has a website. Please visit `http://typo3-pdfcontroller.de/ `_ .. _Forum: Forum ^^^^^ The PDF Controller 3 has a forum (see Forum on page 40 below). .. _Installation: Installation ------------ - Install the extensions - TCPDF for TYPO3 (t3\_tcpdf) - PDF Controller 3 (pdfcontroller) - PDF Controller 3 Additional Fonts (pdfcontroller\_fonts) - Include the static TypoScript templates into the static template of your root page: - PDF Controller [1] (pdfcontroller) `:sup:`0` <#sdfootnote3sym>`_ - PDF Controller [1.1] +tt\_content optimising (pdfcontroller) `:sup:`0` <#sdfootnote4sym>`_ - ... - PDF Controller [2] Ext: Slick (pdfcontroller) `:sup:`0` <#sdfootnote5sym>`_ - PDF Controller [2] Ext: Start (pdfcontroller) `:sup:`0` <#sdfootnote6sym>`_ :sup:`,` `:sup:`0` <#sdfootnote7sym>`_ - PDF Controller [2.1] Ext: Start Gridelements (pdfcontroller) `:sup:`0` <#sdfootnote8sym>`_ - Create in your library folder (or everywhere) the page (not a folder!): PDF Controller - Add to the page PDF Controller the plugin PDF Controller User Interface.Check the first tab [Check!]. See details at section "Requirements" on page 8 below. - Add the plugin PDF Controller Button to the page, which should be downloadable as a PDF document. - Configure the plugin PDF Controller Button by the TypoScript Constant Editor. SeeCONSTANT EDITOR categories - [PDF CONTROLLER - PAGES USER INTERFACE] - [PDF CONTROLLER - URL] That's all. Test the PDF Controller 3: Click the PDF Controller button in your frontend. .. _Controlling: Controlling ----------- .. _Workflow: Workflow ^^^^^^^^ Usually you like to provide a PDF download for the content of your page but neither for the header nor for the footer nor for navigation elements. |img-5| |img-5| |img-5| .. _pdfcontrollerPrint: pdfcontrollerPrint """""""""""""""""" Therefor the PDF Controller arranges a PAGE object called pdfcontrollerPrint. It takes the content elements of the current page from the default column (colpos = 0). The pdfcontrollerPrint page has the typeNum 67426. You can see the PAGE pdfcontrollerPrint in the frontend by calling the current page with typeNum 67426 like http://my-domain.com/index.php?id=277&type=67426 if the current page is the page with the id 277. If you want to change the content, you have to edit the TypoScript of the PAGE object pdfcontrollerPrint. If you get an unexpected result in your PDF file, you should inspect the CSS code and HTML code of this page. Don't wonder: this page hasn't any HTML head by default. .. _pdfcontrollerPDF: pdfcontrollerPDF """""""""""""""" The PDF Controller User Interface is called on the current page by typeNum 67425. This page is called pdfcontrollerPDF. The PDF Controller button generates a link like http://my-domain.com/index.php?id=277&type=67425 There isn't any need to configure the PAGE object pdfcontrollerPDF. Don't touch this TypoScript code! .. _Requirements: Requirements ^^^^^^^^^^^^ There isn't any special system requirement. If you are using restricted pages – access for frontend users only – you have to set some TYPO3 frontend configurations for a proper session management. .. _Check-it-by-the-Plugin: Check it by the Plugin! """"""""""""""""""""""" You can check your system supported by the plugin PDF Controller 3 User Interface. See - first tab [Check!] and - the last tab [Debugging] .. _Check: [Check!] ~~~~~~~~ **Check for [FE][lockHashKeyWords]** [FE][lockHashKeyWords] must be empty. You can configure the property by - Modul: System > Install > All configuration - Look for "lockHashKeyWords" $TYPO3\_CONF\_VARS['FE']['lockHashKeyWords'] = ''; **Check for [FE][lockIP]** [FE][lockIP] must be 0. You can configure the property by - Modul: System > Install > All configuration - Look for "lockIP" $TYPO3\_CONF\_VARS['FE']['lockIP'] = ''; .. _PDF-Properties: PDF Properties ^^^^^^^^^^^^^^ You can controll PDF properties by - the plugin / flexform - the TypoScript Constant Editor and - TypoScript directly. .. _Plugin-Flexform: Plugin / Flexform """"""""""""""""" You can configure by the plugin /flexform in principle - path to your **PDF template file** - PDF **page margins** - PDF page margins for the fist page - Default **fonts** `:sup:`0` <#sdfootnote9sym>`_ - CSS properties for a **a** **-tag** - images **scaling factor** .. _Layout-Restrictions: Layout Restrictions ------------------- .. _CSS: CSS ^^^ The CSS compatibility is on a poor level. It is similar like CSS for HTML in e-mails (newsletters). .. _Any-CSS-by-default: Any CSS by default """""""""""""""""" Please take care of the default TypoScript configuration: pdfcontrollerPrint.config.disableAllHeaderCode is disabled by default.This effects both: - any CSS isn't included by default - pdfcontrollerPrint.includeCSS will ignored. .. _Include-your-CSS: Include your CSS """""""""""""""" .. _By-a-Content-Element-recommended: By a Content Element (recommended) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The recommended way for including your CSS is, to include it as a content element like in the sample below: pdfcontrollerPrint.10 { 10 = TEXT 10.value ( ) } .. _By-a-File-not-recommended: By a File (not recommended) ~~~~~~~~~~~~~~~~~~~~~~~~~~~ You may include a CSS file too. But the way below isn't recommended, because you are enabling the including of all header code and you can receive unwanted CSS data delivered by TYPO3 and TYPO3 extensions. pdfcontrollerPrint { config { disableAllHeaderCode = 0 } includeCSS { mycss = fileadmin/my.css } } If you like to include a CSS file, please check the rendered HTML code of the pdfcontrollerPrint page: It should not include any other CSS data. .. _CSS-properties: CSS properties """""""""""""" .. _Rules: Rules ~~~~~ The CSS compatibility is on a small level. It is similar like CSS for HTML in e-mails (newsletters). Please take care of some rules /\* \* Don't use: \* h1, h2 { ... \* Use only: \* h1 { ... \* h2 { ... \* \* Isn't supported: \* \* a \* \* color : Use the PDF Controller user interface (flexform). See tab [tags]. \* \* text-decoration : Use the PDF Controller user interface (flexform). See tab [tags]. \* \* border : There isn't any alternate. But see the details at margin below.For a border-top or a border-bottom you can use a empty line

 

.For a border-left and a border-right you can use an empty column like , if it is within a table. \* \* line-height : There isn't any alternate. Internal note: :TODO: TCPDF::setCellHeightRatio( ) \* \* list-style-type : There isn't any alternate. Internal note: :TODO: TCPDF::setListIndentWidth( ), TCPDF::setLIsymbol( ) \* \* margin : Use TypoScript plugin.tx\_pdfcontroller.settings.pdf.css.margin \* You can add every tag \* Internal note: TCPDF::setHtmlVSpace( ) \* \* padding : There isn't any alternate. But see the details at margin above. \*/ .. _Sample: Sample ~~~~~~ body { color: green; font-family: helvetica; } h1 { color: orange; font-family: times; font-size: 24pt; text-decoration: underline; } h2 { color: brown; font-family: courier; font-size: 16pt; } p { color: red; font-family: helvetica; font-size: 12pt; } .. _Pagebreak: Pagebreak ~~~~~~~~~ @media print { h1 { page-break-before:always; } div { page-break-before:auto; } #content { page-break-before:avoid; } } CSS property explanation: `http://wiki.selfhtml.org/wiki/CSS/Eigenschaften/Druckausgabe `_ (German) .. _HTML: HTML ^^^^ HTML should be simple as possible. .. _DIV: DIV """ Don't try to configure DIV-tags. There isn't any chance. The will handled like P-tags. .. _TABLE: TABLE """"" .. _CAPTION: CAPTION ~~~~~~~ Avoid the TABLE property CAPTION. CAPTION will handled as a column – like a TD tag. CAPTION will destroy your TABLE layout. .. _Mixed-units: Mixed units """"""""""" Avoid to mix units! For example: It isn't recommended to use per cent and pixels for the width of TD-tags within the same TABLE. .. _Optimisation-by-the-PDF-Controller: Optimisation by the PDF Controller ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The PDF Controller optimises some HTML, if you include the static template: PDF Controller [1.1] +tt\_content optimising (pdfcontroller) .. _Images: Images """""" .. _Move-div-to-table: Move
to ~~~~~~~~~~~~~~~~~~~~~ Images are wrapped with
-tags by default. But
-tags are the proper one. See the TypoScript code snippet below. [globalVar = GP:type = {$plugin.pdfcontroller.pages.print.typeNum}] ## images tt\_content.image { 20 { 1 { layout { default { element := appendString (
) } } } layout { \# above-center default { value (
###IMAGES###
###TEXT###
) override > } \# above-right ... } renderMethod = simple rendering { simple { imageStdWrapNoWidth.wrap = \| imageStdWrap.dataWrap = \| caption.wrap =

\|

} } } } [global] .. _Constant-Editor: Constant Editor --------------- .. _PDF-CONTROLLER-BUTTON: PDF CONTROLLER - BUTTON ^^^^^^^^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _button-icon: button.icon """"""""""" .. container:: table-row Property button.icon Data type string Description Path to the button icon. Default: EXT:pdfcontroller/Resources/Public/Images/pdf.png .. ###### END~OF~TABLE ###### .. _PDF-CONTROLLER-CONFIG: PDF CONTROLLER - CONFIG ^^^^^^^^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _config-disableAllHeaderCode: config.disableAllHeaderCode """"""""""""""""""""""""""" .. container:: table-row Property config.disableAllHeaderCode Data type boolean Description disableAllHeaderCode: If is set, none of the features of the PAGE object is processed but the content of the page. There isn't nor -tag neither a default CSS among others. Default: 1 .. ###### END~OF~TABLE ###### .. _PDF-CONTROLLER-PAGES-PDF: PDF CONTROLLER – PAGES PDF ^^^^^^^^^^^^^^^^^^^^^^^^^^ This effects the PAGE object **pdfcontrollerPDF** .. ### BEGIN~OF~TABLE ### .. _pages-pdf-typeNum: pages.pdf.typeNum """"""""""""""""" .. container:: table-row Property pages.pdf.typeNum Data type string Description typeNum: type number for the PAGE, which generates the PDF. Recommended 67425. Use another number, if you are still using 67425. Default: 67425 .. ###### END~OF~TABLE ###### .. _PDF-CONTROLLER-PAGES-PRINT: PDF CONTROLLER – PAGES PRINT ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This effects the PAGE object **pdfcontrollerPrint** .. ### BEGIN~OF~TABLE ### .. _pages-print-typeNum: pages.print.typeNum """"""""""""""""""" .. container:: table-row Property pages.print.typeNum Data type integer Description typeNum: type number for the PAGE, which is optimised for printing. Recommended 67426. Use another number, if you are still using 67426. Default: 67426 .. _pages-print-header: pages.print.header """""""""""""""""" .. container:: table-row Property pages.print.header Data type string Description header: My header content. Default: See @ TypoScript at plugin.tx\_pdfcontroller.settinmgs.master\_templates.print... .. _pages-print-copyright: pages.print.copyright """"""""""""""""""""" .. container:: table-row Property pages.print.copyright Data type string Description copyright: Copyright in the footer. Default: \| © See @ Constant Editor category [PDF CONTROLLER - PAGES] > copyright \| .. _pages-print-strftime: pages.print.strftime """""""""""""""""""" .. container:: table-row Property pages.print.strftime Data type string Description time format: PHP function strftime. Example for German language: Gedruckt am %d.%m.%y um %T Uhr Default: printed at %y/%m/%d %T .. ###### END~OF~TABLE ###### .. _PDF-CONTROLLER-PAGES-USER-INTERFACE: PDF CONTROLLER – PAGES USER INTERFACE ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _pages-userinterface-pid: pages.userinterface.pid """"""""""""""""""""""" .. container:: table-row Property pages.userinterface.pid Data type integer Description Page ID\*: \*OBLIGATED: ID of the page, which contains the PDF user interface. .. ###### END~OF~TABLE ###### .. _PDF-CONTROLLER-URL: PDF CONTROLLER – URL ^^^^^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _url: url """ .. container:: table-row Property url Data type string Description Url\*: \*OBLIGATED: Domain of your website with ending slash. F.e: http://die-netzmacher.de/ Default: http://my-example.com .. ###### END~OF~TABLE ###### .. _PDF-CONTROLLER-VIEW: PDF CONTROLLER – **VIEW** ^^^^^^^^^^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _templateRootPath: templateRootPath """""""""""""""" .. container:: table-row Property templateRootPath Data type string Description Templates: Path to the templates Default: EXT:pdfcontroller/Resources/Private/View/Templates/ .. _partialRootPath: partialRootPath """"""""""""""" .. container:: table-row Property partialRootPath Data type string Description Partials: Path to the partials Default: EXT:pdfcontroller/Resources/Private/View/Partials/ .. _layoutRootPath: layoutRootPath """""""""""""" .. container:: table-row Property layoutRootPath Data type string Description Layouts: Path to the layouts Default: EXT:pdfcontroller/Resources/Private/View/Layouts/ .. ###### END~OF~TABLE ###### .. _Reference: Reference --------- .. _PAGE: PAGE ^^^^ .. _pdfcontrollerPDF: pdfcontrollerPDF """""""""""""""" .. ### BEGIN~OF~TABLE ### .. _pdfcontrollerPDF: pdfcontrollerPDF ~~~~~~~~~~~~~~~~ .. container:: table-row Property pdfcontrollerPDF Data type PAGE Description :: pdfcontrollerPDF < plugin.tx_pdfcontroller.settings.master_templates.pdf .. ###### END~OF~TABLE ###### .. _pdfcontrollerPrint: pdfcontrollerPrint """""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _pdfcontrollerPrint: pdfcontrollerPrint ~~~~~~~~~~~~~~~~~~ .. container:: table-row Property pdfcontrollerPrint Data type PAGE Description :: pdfcontrollerPrint < plugin.tx_pdfcontroller.settings.master_templates.print .. ###### END~OF~TABLE ###### .. _tt-content: tt\_content ^^^^^^^^^^^ .. _tt-content-image: tt **\_content.image** """""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _tt-content-image: tt\_content.image ~~~~~~~~~~~~~~~~~ .. container:: table-row Property tt\_content.image Data type Array Description :: [globalVar = GP:type = {$plugin.pdfcontroller.pages.print.typeNum}] ## images tt_content.image { 20 { 1 { layout { default { element := appendString (
) } } } layout { # above-center default { value (
###IMAGES###
###TEXT###
) override > } # above-right ... } renderMethod = simple rendering { simple { imageStdWrapNoWidth.wrap = | imageStdWrap.dataWrap = | caption.wrap =

|

} } } } [global] .. ###### END~OF~TABLE ###### .. _tx-pdfcontroller-PDF-Controller-User-Interface: tx\_pdfcontroller: PDF Controller User Interface ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ plugin.tx\_pdfcontroller.settings is the former plugin.tx\_pdfcontroller\_pi1. .. _settings-flexform: settings.flexform """"""""""""""""" .. ### BEGIN~OF~TABLE ### .. _flexform: flexform ~~~~~~~~ .. container:: table-row Property flexform Data type array Description All values of the flexform can processed and changed by TypoScript. This is a sample for changing the path to PDF template. The path is configured by the flexform and is by default: typo3conf/ext/pdfcontroller/Resources/Public/Pdf/typo3-pdfcontroller.p df If you want to become familiar with **all available flexform values** , please take alook into the files of the folder: Configuration/Flexforms/Pdf/\*.xml **Sample** The snippet below enables to use a PDF draft for a job depending on the company, who offers the job. Each company has a different logo. If a company uid isn't defined in the TypoScript, there will be an error prompt in the frontend. :: plugin.tx_pdfcontroller { settings { flexform { template { filepath = TEXT filepath { data = GP:tx_browser_pi1|jobUid } filepath > filepath = CONTENT filepath { table = tx_org_headquarters select { pidInList = {$plugin.org.sysfolder.headquarters} join = tx_org_mm_all ON tx_org_mm_all.uid_local = \ tx_org_headquarters.uid where { data = GP:tx_browser_pi1|jobUid noTrimWrap = |tx_org_mm_all.uid_foreign = | \ AND tx_org_mm_all.table_local = 'tx_org_headquarters' \ AND tx_org_mm_all.table_foreign = 'tx_org_job'| } orderBy = tx_org_headquarters.title } // tx_org_news.title croped and linked renderObj = CASE renderObj { key { field = uid } default = TEXT default { value = Company {field:title} (uid #{field:uid}) isn't part \ of TypoScript. Please see: Home/Jobs/Detail [109] > \ +ext_pdfcontroller_074 noTrimWrap = |: || insertData = 1 } 8 = TEXT 8 { value = fileadmin/jobofferByCompany08.pdf } 12 = TEXT 12 { value = fileadmin/jobofferByCompany12.pdf } ... } } } } } } .. ###### END~OF~TABLE ###### .. _settings-master-templates: settings.master\_templates """""""""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _master-templates: master\_templates ~~~~~~~~~~~~~~~~~ .. container:: table-row Property master\_templates Data type array Description :: plugin.tx_pdfcontroller { settings { master_templates { pdf = PAGE pdf { config { ... <- Please inspect code by the TypoScript Object Browser } typeNum = {$plugin.pdfcontroller.pages.pdf.typeNum} 10 = COA 10 { ... <- Please inspect code by the TypoScript Object Browser } } print = PAGE print { config { ... <- Please inspect code by the TypoScript Object Browser } typeNum = {$plugin.pdfcontroller.pages.pdf.typeNum} 10 = COA 10 { ... <- Please inspect code by the TypoScript Object Browser } } } } } .. ###### END~OF~TABLE ###### .. _settings-pdf-content-footer: settings.pdf.content.footer """"""""""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _pdf-content-footer: pdf.content.footer ~~~~~~~~~~~~~~~~~~ .. container:: table-row Property pdf.content.footer Data type array Description :: plugin.tx_pdfcontroller { settings { pdf { content { // empty statement for proper comments only footer { } // placeholders: %page% for the current page, %pages% for the number of pages footer = TEXT footer { // placeholders: %page% for the current page, %pages% for the number of pages value = page %page% from %pages% lang { de = Seite %page% von %pages% en = page %page% from %pages% } wrap =
|
} } } } } .. ###### END~OF~TABLE ###### .. _settings-pdf-css-margin: settings.pdf.css.margin """"""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _pdf-css-margin: pdf.css.margin ~~~~~~~~~~~~~~ .. container:: table-row Property pdf.css.margin Data type array Description :: plugin.tx_pdfcontroller { settings { pdf { css { margin { // bottom, top div = div { // value: 0, times: 0 bottom = bottom { value = 0 times = 0 } // value: 0, times: 0 top = top { value = 0 times = 0 } } // bottom, top h1 < .div // bottom, top h2 < .div // bottom, top h3 < .div // bottom, top ol < .div ol { // value: 1, times: 3 bottom = bottom { value = 1 times = 3 } } // bottom, top p < .div // bottom, top ul < .ol } } } } } .. ###### END~OF~TABLE ###### .. _settings-pdf-filename: settings.pdf.filename """"""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _pdf-filename: pdf.filename ~~~~~~~~~~~~ .. container:: table-row Property pdf.filename Data type COA Description :: plugin.tx_pdfcontroller { settings { pdf { filename = COA filename { // page : title 10 = TEXT 10 { stdWrap { data = page : title htmlSpecialChars = 1 } wrap = | } // date 30 = TEXT 30 { data = date : U strftime = %Y%m%d%H%M%S wrap = _| } // extension pdf 50 = TEXT 50 { value = pdf wrap = .| } } } } } .. ###### END~OF~TABLE ###### .. _settings-pdf-pageproperties: settings.pdf.pageproperties """"""""""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _pdf-pageproperties: pdf.pageproperties ~~~~~~~~~~~~~~~~~~ .. container:: table-row Property pdf.pageproperties Data type array Description :: plugin.tx_pdfcontroller { settings { pdf { pageproperties { // page : author documentAuthor = CONTENT documentAuthor { table = pages select { where = 1 OR (uid = {page:uid} AND pid >= 0) where { insertData = 1 } max = 1 } renderObj = TEXT renderObj { field = author } } // page : keywords documentKeywords < .documentAuthor documentKeywords { renderObj { field = keywords } } // page : description documentSubject < .documentAuthor documentSubject { renderObj { field = description } } // page : title documentTitle < .documentAuthor documentTitle { renderObj { field = title } } } } } } .. ###### END~OF~TABLE ###### .. _settings-pid-userinterface: settings.pid.userinterface """""""""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _pid-userinterface: pid.userinterface ~~~~~~~~~~~~~~~~~ .. container:: table-row Property pid.userinterface Data type integer Description :: plugin.tx_pdfcontroller { settings { pid { userinterface = {$plugin.pdfcontroller.pages.userinterface.pid} } } } .. ###### END~OF~TABLE ###### .. _settings-typeNum: settings.typeNum """""""""""""""" .. ### BEGIN~OF~TABLE ### .. _typeNum: typeNum ~~~~~~~ .. container:: table-row Property typeNum Data type array Description :: plugin.tx_pdfcontroller { settings { typeNum { pdf = {$plugin.pdfcontroller.pages.pdf.typeNum} print = {$plugin.pdfcontroller.pages.print.typeNum} } } } .. ###### END~OF~TABLE ###### .. _view: view """" .. ### BEGIN~OF~TABLE ### .. _view: view ~~~~ .. container:: table-row Property view Data type array Description :: plugin.tx_pdfcontroller { view { templateRootPath = {$plugin.tx_pdfcontroller.view.templateRootPath} partialRootPath = {$plugin.tx_pdfcontroller.view.partialRootPath} layoutRootPath = {$plugin.tx_pdfcontroller.view.layoutRootPath} } } .. ###### END~OF~TABLE ###### .. _tx-pdfcontroller-pi2-PDF-Controller-Button: tx\_pdfcontroller\_pi2: PDF Controller Button ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _button: button """""" .. ### BEGIN~OF~TABLE ### .. _button: button ~~~~~~ .. container:: table-row Property button Data type IMAGE Description :: plugin.tx_pdfcontroller_pi2 { button = IMAGE button { wrap = |  file = {$plugin.pdfcontroller.button.icon} altText { stdWrap { cObject = TEXT cObject { value = Download content as PDF file lang { de = Inhalt als PDF-Datei herunterladen en = Download content as PDF file } } } } titleText < .altText imageLinkWrap = 1 imageLinkWrap { enable = 1 typolink { parameter { cObject = COA cObject { // url 10 = TEXT 10 { data = page:uid } // target 20 = TEXT 20 { value = _blank noTrimWrap = | "|"| } // class 30 = TEXT 30 { value = - noTrimWrap = | "|"| } // title 40 = TEXT 40 { value = Download content as PDF file lang { de = Inhalt als PDF-Datei herunterladen en = Download content as PDF file } noTrimWrap = | "|"| } } } additionalParams = &type={$plugin.pdfcontroller.pages.pdf.typeNum} // #i0024, 150904, dwildt, 4+ addQueryString = 1 addQueryString { exclude = id, cHash } ATagParams = rel="nofollow" } } } text = TEXT text { ... <- See next section below } } .. ###### END~OF~TABLE ###### .. _text: text """" .. ### BEGIN~OF~TABLE ### .. _text: text ~~~~ .. container:: table-row Property text Data type TEXT Description :: plugin.tx_pdfcontroller_pi2 { text = TEXT text { value = PDF Download lang { de = PDF Download en = PDF Download } typolink { ... <- See typolink from button in the section from above } } } .. ###### END~OF~TABLE ###### .. _Extensions: Extensions ^^^^^^^^^^ .. _Grid-elements-by-Start: Grid elements (by Start) """""""""""""""""""""""" .. _start-gridelements-1-to-6: start.gridelements.1 to 6 ~~~~~~~~~~~~~~~~~~~~~~~~~ .. ### BEGIN~OF~TABLE ### .. _start-gridelements-x: start.gridelements.x '''''''''''''''''''' .. container:: table-row Property start.gridelements.x Data type array Description :: start.gridelements { 1 { columns.default.wrap.noTrimWrap = || columns.default.wrap2 = | wrap.stdWrap.cObject.10.value = |
} ... } tt_content.gridelements_pi1.20.10.setup.1 < start.gridelements.1 tt_content.gridelements_pi1.20.10.setup... < start.gridelements... .. ###### END~OF~TABLE ###### .. _start-structure-inlineCss: start.structure.inlineCss ~~~~~~~~~~~~~~~~~~~~~~~~~ .. ### BEGIN~OF~TABLE ### .. _structure-inlineCss: structure.inlineCss ''''''''''''''''''' .. container:: table-row Property structure.inlineCss Data type array Description :: start { structure { inlineCss { pdfcontroller = TEXT pdfcontroller { value ( ) } } } } .. ###### END~OF~TABLE ###### .. _Slick-responsive-Carousel-and-Slider: Slick – responsive Carousel and Slider """""""""""""""""""""""""""""""""""""" .. _tt-content-slickslideshow: tt\_content.slickslideshow ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. ### BEGIN~OF~TABLE ### .. _tt-content-slickslideshow: tt\_content.slickslideshow '''''''''''''''''''''''''' .. container:: table-row Property tt\_content.slickslideshow Data type Array Description :: [globalVar = GP:type = {$plugin.pdfcontroller.pages.print.typeNum}] ## images tt_content.slickslideshow { 20 { 1 { layout { default { element := appendString (
) } } } layout { default { value (
###IMAGES###
###TEXT###
) override > } } renderMethod = simple rendering { simple { imageStdWrapNoWidth.wrap = | imageStdWrap.dataWrap = | caption.wrap =

|

} } } } [global] .. ###### END~OF~TABLE ###### .. _Start-Starter-Kit-for-a-responsive-TYPO3: Start – Starter Kit for a responsive TYPO3 """""""""""""""""""""""""""""""""""""""""" .. _PAGE: PAGE ~~~~ .. ### BEGIN~OF~TABLE ### .. _pdfcontrollerPrint: pdfcontrollerPrint '''''''''''''''''' .. container:: table-row Property pdfcontrollerPrint Data type PAGE Description :: pdfcontrollerPrint > pdfcontrollerPrint < plugin.tx_pdfcontroller.settings.extensions.start.master_templates.print .. ###### END~OF~TABLE ###### .. _settings-extensions-start-master-templates-print: settings.extensions.start.master\_templates.print ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. ### BEGIN~OF~TABLE ### .. _master-templates-print: master\_templates.print ''''''''''''''''''''''' .. container:: table-row Property master\_templates.print Data type PAGE Description :: plugin.tx_pdfcontroller { settings { extensions { start { master_templates { print = PAGE print { ... -> Please inspect it by the TypoScript Object Browser } } } } } } .. ###### END~OF~TABLE ###### .. _Fonts: Fonts ----- .. _Install-custom-fonts: Install custom fonts ^^^^^^^^^^^^^^^^^^^^ This is an example for TTF-fonts (True Type Fonts) only. See details at: - `http://www.tcpdf.org/fonts.php `_ - typo3conf/ext/t3\_tcpdf/tcpdf/tools/convert\_fonts\_examples.txt .. _Create-a-font-directory: Create a font directory """"""""""""""""""""""" Create a font directory like - fileadmin/myfonts `:sup:`0` <#sdfootnote10sym>`_ - typo3conf/ext/myextension/fonts `:sup:`0` <#sdfootnote11sym>`_ .. _Sample-directories: Sample directories """""""""""""""""" - TCPDF tools/var/www/mytypo3/typo3conf/ext/t3\_tcpdf/tcpdf/tools$ - TTF-files source folder (input folder in the samle below: -i)~/Downloads/ - TTF-files destination folder (output folder in the samle below: -o)/var/www/mytypo3/typo3conf/ext/pdfcontroller\_fonts/fonts .. _Move-ttf-to-TCDF-font-definition-files: Move \*.ttf to TCDF font definition files """"""""""""""""""""""""""""""""""""""""" `name@server `_ :/var/www/mytypo3/typo3conf/ext/t3\_tcpdf/tcpdf/tools$ \ ./tcpdf\_addfont.php -b -t TrueTypeUnicode -f 32 \-o /var/www/typo3\_62.local/typo3conf/ext/pdfcontroller\_fonts/fonts \ -i ~/Downloads/Noto\_Sans/NotoSans-BoldItalic.ttf .. _Update-the-PDF-Controller-Interface: Update the PDF Controller Interface """"""""""""""""""""""""""""""""""" Tab [Fonts] > field "Relative path to my fonts directory" Enter your path. I.e: fileadmin/myfonts `:sup:`0` <#sdfootnote12sym>`_ .. _Run-the-PDF-Controller: Run the PDF Controller """""""""""""""""""""" Run the PDF Controller in the frontend once. .. _Remove-installed-Fonts: Remove installed Fonts """""""""""""""""""""" - Remove the extension PDF Controller Fonts (pdfcontroller\_fonts) - Update the extension TCPDF for TYPO3 (t3\_tcpdf) .. _Debugging: Debugging --------- You can get a report for debugging and development purposes in the frontend and the backend. Please us the tab [Debugging] of the plugin of the PDF Controller 3 User Interface. If you are enabling the DRS (Development Reporting System), you will get a report in the devlog. `:sup:`0` <#sdfootnote13sym>`_ .. _Mode: Mode ^^^^ .. _Production-default: Production (default) """""""""""""""""""" Get your website content as PDF file. .. _Test-Display-HTML: Test: Display HTML """""""""""""""""" Get your website content as HTML file. You can check, which HTML will delivered to the PDF generator. .. _Test-TCPDF-example-61-XHTML-CSS-HTML: Test: TCPDF example 61 "XHTML+CSS" (HTML) """"""""""""""""""""""""""""""""""""""""" TCPDF provides a lot of samples on the TCPDF website. This test enables you to check, if your server generates the needed HTML of the TCPDF webiste. You can compare the HTML code – especially the CSS code – with the HTML code, which you are using for PDF generating. If something isn't running proper, maybe you are able to find the unproper HTML code or the unproper CSS code. .. _Test-TCPDF-example-61-XHTML-CSS-PDF: Test: TCPDF example 61 "XHTML+CSS" (PDF) """""""""""""""""""""""""""""""""""""""" TCPDF provides a lot of samples on the TCPDF website. This test enables you to check, if your server generates the same PDF like the server of the TCPDF webiste. It should be the same PDF file. If it isn't, maybe the PDF Controller doesn't run proper. PDF file for comparison: `http://www.tcpdf.org/examples/example\_061.pdf `_ .. _Development-Display-TypoScript: Development: Display TypoScript """"""""""""""""""""""""""""""" This dsiplays the TypoScript, which is the base for TYPO3 for rendering the HTML or PDF file. If something isn't running proper, maybe you are able to find the unproper TypoScript code. .. _DRS-Development-Reporting-System: DRS (Development Reporting System) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You need the extension Developer Log (devlog) If you are enabling the DRS (Development Reporting System), you will get a report in the devlog. .. _Disabled-recommended: Disabled (recommended) """""""""""""""""""""" Any prompt won't sent to devlog. .. _All-errors-warnings-and-infos: All: errors, warnings and infos """"""""""""""""""""""""""""""" The PDF Controller sends all prompts to devlog. .. _Session-management: Session-management """""""""""""""""" The PDF Controller sends prompts to devlog in context with the session management. The PDF Controller prompts the URL with theFE\_SESSION\_KEY among others, if a fe\_user is logged in. You can check, if this URL is proper: - Take a browser without any current session. - Copy this URL into the address field of the Browser. - If the Browser displays the content for fe\_users, which are logged in, everything seem's to be proper. - If it displays content for fe\_users, which aren't logged in, the URL isn't proper. .. _3rd-party: 3rd party! ---------- The PDF Controller supports third party extensions respectevely third party extensions supports the PDF Controller. Suppor means: - Usually the HTML code is optimised for a responsive layout. - But TCPDF can't handle the CSS of a responisve layout in principle. The PDF Controller optimise HTML and CSS of the third party extension from below. Optimisation doesn't mean, that you will get a one-to-one layout. .. _Grid-Elements: Grid Elements ^^^^^^^^^^^^^ The PDF Controller optimises the HTML of the grid elements, if they are arranged by Start – Starter Kit for a responsive TYPO3. The optimisation is ready-to-use. If you are using your own grid elements, you can adapt the PDF Controller to you needs by configuring your TypoScript. |img-5| .. _Organiser-TYPO3-for-Lobby-and-Organisers: Organiser – TYPO3 for Lobby and Organisers ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The news modul of the Organiser – TYPO3 for Lobby and Organisers – has a template for the PDF Controller. A TYPO3 integrator hasn't nothing to do: news in list views and news in single views are optimised for the PDF Controller by default. See samples for a list view: - HTML: `http://die-netzmacher.de/news/ `_ - PDF: `http://die-netzmacher.de/news/?type=67425 `_ Select a news from the list view, to check a single view in HTML and PDF. If you are using the Organiser, you need it from version 7.5.x |img-6| |img-7| |img-8| |img-9| Illustration above: organiser news list view in HTML (left) and as PDF file .. _Slick-responsive-Carousel-and-Slider: Slick – responsive Carousel and Slider ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you like to optimise content, which is delivered by Slick – responsive Carousel and Slider –, please use the static template PDF Controller [2] Ext: Slick (pdfcontroller) .. _Start-Starter-Kit-for-a-responsive-TYPO3: Start – Starter Kit for a responsive TYPO3 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you like to optimise content, which is delivered by Start – Starter Kit for a responsive TYPO3 –, please use the static templates - PDF Controller [2] Ext: Start (pdfcontroller) - PDF Controller [2.1] Ext: Start Gridelements (pdfcontroller) |img-5| .. _What-s-new: What's new ---------- .. _4-x: 4.x ^^^ .. _Flexform-values: Flexform values """"""""""""""" [4.2.0] Flexform values got the TypoScript property Content Object. See the sample at: Reference: pdfcontrollerPDF on page 16 above .. _Grid-Elements: Grid Elements """"""""""""" [4.1.1] Template for the Grid Eelements of Start – Starter Kit for a responsive TYPO3. .. _Session-handling: Session handling """""""""""""""" [4.0.0] The PDF Controller handels sessions. You can use it on restricted pages. .. _Slick-responsive-Carousel-and-Slider: Slick – responsive Carousel and Slider """""""""""""""""""""""""""""""""""""" [4.1.2] Template for Slick – responsive Carousel and Slider. .. _Start-Starter-Kit-for-a-responsive-TYPO3: Start – Starter Kit for a responsive TYPO3 """""""""""""""""""""""""""""""""""""""""" [4.1.1] Template for Start – Starter Kit for a responsive TYPO3. .. _tt-content-optimisation: tt\_content optimisation """""""""""""""""""""""" [4.1.0] Template .. _TYPO3-7-x: TYPO3 7.x """"""""" [4.0.0] The PDF Controller should run in TYPO3 7.x. But this isn't tested! .. _3-x: 3.x ^^^ .. _Corporate-Design: Corporate Design """""""""""""""" [3.1.0] Background of any generated PDF is a PDF file. This PDF file can designed individually. .. _Extra-first-page: Extra first page """""""""""""""" [3.1.0] Background of any generated PDF is a PDF file. If your PDF file contains two pages, the first page is only used for the first page of the generated PDF file. .. _TCPDF: TCPDF """"" [3.1.0] New PDF engine tcpdf. .. _Upgrades: Upgrades -------- .. _From-3-x-to-4-x: From 3.x to 4.x ^^^^^^^^^^^^^^^ .. _Save-plugin-values-before-the-Upgrade: Save plugin values before the Upgrade """"""""""""""""""""""""""""""""""""" Please save your plugin values, before you upgrade the PDF Controller by the extension manager. .. _TypoScript: TypoScript """""""""" TypoScript is moved from plugin.tx\_pdfcontroller\_pi1 to plugin.tx\_pdfcontroller.settings. Keep it in mind, if you have to update the setup of your TypoScript. .. _Plugin: Plugin """""" Set selected plugin to [PDF Controller: User Interface]. Compare the saved plugin values from above with the current plugin values. Adapt the current values to your needs. .. _From-2-x-to-3-x: From 2.x to 3.x ^^^^^^^^^^^^^^^ The PDF Controller 3 has a new PDF engine: TCPDF. The former engine was HTML2PS. Therefor an upgrade isn't possible. Sorry for the trouble. .. _Known-Bugs: Known Bugs ---------- See `https://forge.typo3.org/projects/extension-pdfcontroller/issues `_ .. _Further-Information: Further Information ------------------- .. _Other-extensions-published-by-Die-Netzmacher: Other extensions published by Die Netzmacher ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - |img-10| +AOE Linkhandler Configurator: Configure the AOE linkhandler supported by userinterfaces. Out-of-the-box templates for cal, org, tt\_news and tt\_products. Don't edit page TSconfig any longer. `http://typo3.org/extensions/repository/view/linkhandlerconf/ `_ - |img-11| autositemap: A smart site-map optimised for the footer. It groups menus in columns. Great menus will get two columns. Configuration is based on TypoScript HMENU. `http://typo3.org/extensions/repository/view/autositemap/ `_ - |img-12| Browser – TYPO3 without PHP. Develop your TYPO3 extension 8 times faster! You need one line TypoScript for a result list with a search form, a record browser and an index browser. Images are wrapped self-acting. SEO, Search Engine Optimization, is integrated. `http://typo3-browser.de/ `_ - |img-13| Caddy – the TYPO3 shopping cart. You can use it for your own needs. You need a database with products or any other items only. You can install Caddy out of the box with one mouse click – see Quick Shop below. `http://typo3-caddy.de/ `_ - |img-13| Deal! – TYPO3 Quick Shop interface for the marketplace ebay. Manage all items with TYPO3 and publish it on ebay. Amazon is under construction. `http://typo3-deal.de/ `_ - |img-14| Duty – collection of helpful scheduler tasks. Here: remove deprecated files from directories. `http://typo3.org/extensions/repository/view/duty/ `_ - |img-15| Flip it! offers lovely and smooth page flip transitions. It enables you to run over pages in PDF documents like in a real magazine. It is based on flash. Flipt it! can convert PDF documents to swf files automatically. `http://typo3.org/extensions/repository/view/flipit/ `_ - |img-16| Jobmarket is a catalogue with job offers. Views, the a-z-browser, the page-browser, the search, social bookmarks and a lot of other stuff can configured by the Browser plugin with the mouse. `http://typo3-job-market.de/ `_ - |img-17| Organiser – TYPO3 for the lobby and the organisers. Handle news, events, staff, headquarters, locations, workshops and a calendar with one extension. Sell online tickets! Install the Organiser with one mouse click! `http://typo3-organiser.de/ `_ - |img-13| Quick Shop – the fastest shop in the history of TYPO3. Install it with one mouse click! Quick Shop is based on the browser (see above) and powermail. `http://typo3-quick-shop.de/ `_ - |img-3| PDF Controller: Offer a TYPO3 page for PDF download. Individual layout with background PDF file. TYPO3 sessions are supported. Handling of responsive backend layouts and grid elements possible. PDF engine is TCPDF. `http://typo3-pdfcontroller.de/ `_ - |img-18| Radial Search (Umkreissuche) – Enable the browsing through your data by geo location. 'Your data must have a latitude and a longitude. Address data can geocoded automatically by the Browser - TYPO3 without PHP. `http://typo3.org/extensions/repository/view/radialsearch/ `_ - |img-18| Route – Publish your routes with GoogleMaps or OpenStreetMap. Routes have points of interest (POI). You can categorise and filter both: routes and POI. Address data can geocoded automatically. `http://typo3-route.de/ `_ - |img-19| seo\_dynamic\_tag: Search Engine Optimization for the title tag, the canonical tag and the meta tags author, description and keywords. Configuration by a user interface. `http://typo3.org/extensions/repository/view/seo\_dynamic\_tag/ `_ - |img-20| Slick - jQuery Carousel: Fully responsive. Scales with its container. Separate settings per breakpoint. Uses CSS3 when available. Swipe enabled. Desktop mouse dragging. Infinite looping. Fully accessible. `http://typo3-slick.de/ `_ - |img-21| Start is installing and managing a responsive TYPO3. Provides a dozen ready-to-use backend layouts and some grid-layouts. Template is included for a responsive newsletter. Based on the responsive framework Foundation (Zurb). `http://start-typo3-responsive.de/ `_ - |img-22| TSconfig Pages and Users by extManager (extkey: tsconf): Configure the the eight most commonly used TSconfig porperties with the mouse - like page tree uids, activated extended view, activated clipboard, ... `http://typo3.org/extensions/repository/view/tsconf/ `_ .. _SEO-Search-Engine-Optimisation: SEO - Search Engine Optimisation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You are optimising your website for search engines in principle, that your content will be found and indexed in a meaningful context. But if your are offering an HTML page for PDF download and for optimised printing, you don't like the a twice or triple indexing - because of performance. .. _rel-nofollow: rel="nofollow" """""""""""""" Links to the pdf controller shouldn't indexed by default. The tag has the property rel="nofollow" This effects that search engines doesn't follow the link - they don't download your PDF document. They don't index it. That's what you want. If you have a need to index PDF documents by search engines, please remove the TypoScript ATagParams. See the snippet below. .. _TypoScript-snippet: TypoScript snippet ~~~~~~~~~~~~~~~~~~ plugin.tx\_pdfcontroller\_pi2 { button = IMAGE button { ... imageLinkWrap { enable = 1 typolink { ... ATagParams = rel="nofollow" } } } } .. _Credits: Credits ^^^^^^^ .. _Netconsult-AG: Netconsult AG """"""""""""" [3.0.0] Thanks to the Netconsult AG, who contracted a part the integration of TCDPDF for TYPO3 (t3\_tcpdf) into the PDF Controller. NetConsult AG, Bern, Switzerland `http://www.netconsult.ch/ `_ .. _typo3-lisardo-de: typo3-lisardo.de """""""""""""""" [2.0.0] Peter Linzenkirchner contracted a part of the 2.0 upgrade: `http://www.typo3-lisardo.de/ `_ .. _web-arts-ch: web-arts.ch """"""""""" [2.0.0] Angelo Previtali contracted a part of the 2.0 upgrade: `http://www.web-arts.ch/ `_ .. _TYPO3-Security-Team: TYPO3 Security Team """"""""""""""""""" [1.1.1] Thanks to the TYPO3 Security Team for a commendable support - especially to Franz G. Jahn. .. _Helpful-suggestions: Helpful suggestions ------------------- .. _Forum: Forum ^^^^^ If you have helpful suggestions, feel free to publish any question, bug or code snippet on `http://forum.typo3-pdfcontroller.de/ `_ Posts are welcome in English and German. .. _Change-log: Change log ---------- 4.2.0 **Feature** \* #i0038: Flexform values got the TypoScript property Content Object 4.1.6 **Improvement** \* #i0037: locallang\* #i0036: Manual: section upgrade 3.x -> 4.x 4.1.5 **Improvement** \* #i0035: favicon\* #i0034: Improvement tt\_content.image caption 4.1.4 **Improvement** \* #i0033: Extension description 4.1.3 **Improvement** \* #i0031: tt\_content optimisation: image caption got the wrap

\|

4.1.2 **New Features** \* #i0030: slick optimisation for tt\_content.images **Improvement** \* #i0029: tt\_content optimisation added for image layout: 1, 2, 8, 9, 10, 17, 18\* #i0028: td.space for grid elements **Bugfix** \* #i0027: was missing in typoscript for grid elements 4.1.1 **New Feature** \* #i0025: Support for Start: grid layouts\* #i0024: addQueryString **Improvement** \* #i0023: Flexform tab sDEF is removed\* #i0022: Suggests pdfcontroller\_fonts 4.1.0 **New Feature** \* #i0021: Constant for config.disableAllHeaderCode\* #i0020: Template for tt\_content optimisation\* #i0019: Support for startEffected files:\* Configuration/TypoScript/Extensions/Start (new)\* Resources/Private/Extensions/Start/Templates (new) 4.0.6 **Improvement** \* #i0018: Check for [ 'FE' ][ 'lockIP' ]\* #i0017: \_ffValue: error prompt\* #i0016: Labeling \*.xlf 4.0.5 **Improvement** \* #i0015: Update Manual 4.0.4 **Improvement** \* #i0014: Flexform with DRS 4.0.3 **Update** \* #i0013: Manual with CSS sample for images 4.0.2 **Update** \* #i0012: Manual with CSS sample 4.0.1 **Bugfix** \* #i0011: XML: missing tagResources/Private/Language/de.locallang\_db.xlf 4.0.0 **Major Features** \* #i0010: Preparation for TYPO3 7.x\* #i0009: Session handling 3.1.1 **Improvement** \* #i0008: Constant Editor: new property url. **Bugfix** \* #i0007: PHP Warning: in\_array() expects parameter 2 to be array,null given in Classes/Userfunc/Flexforms/Controller.php line 181 3.0.0 **Feature** \* #i0005: Constant Editor: page.pdf\_button. Id of the page, which contains the PDF Controller button.Moved\* plugin.tx\_pdfcontroller\_pi2.page.pdf\_controller > plugin.pdfcontroller.pages.userinterface.id\* plugin.tx\_pdfcontroller\_pi2.realUrl.print > plugin.pdfcontroller.realUrl.print\* plugin.tx\_pdfcontroller\_pi2.typeNum.print > plugin.pdfcontroller.pages.print.typeNum 2.0.4 **Manual** \* #i0004: Update 2.0.3 **SECURITY FIX!** \* #i0003: Fix against Cross-Site ScriptingDone by Christian Bernet, `http://www.bernetimux.ch/ `_ 2.0.2 **Bugfix** \* #i0001: Class t3lib\_extMgm is moved to \TYPO3\CMS\Core\Utility\ExtensionManagementUtility **Improvement** \* #i0002: state is moved from alpha to beta 2.0.0 **Major Feature** \* #62278: Upgrade TYPO3 6.2#62285: PHP 5.4 E\_ALL & ~E\_STRICT#62289: PHP 5: Call to undefined method FPDF::GetFontAscender()#62281: Warning in case of [FE][pageNotFoundOnCHashError]#53019: Depracted require() functions for Typo3 6.2\* #47107: Manual: Configuration in case of HTML5 (HTML4) 1.4.3 **Manual** \* #00000: Note frontend user sessions 1.4.1 **Bugfix** \* #00000: Wrong TypoScript snippet is now proper in the manual 1.3.0 **Bugfix** \* #36862: Additional Parameter has to encoded since TYPO 4.6Marker ###ADDITIONALPARAMS### is handled by rawUrlEncode( )Effected file:\* pi2/class.tx\_pdfcontroller\_pi2.php **Improvement** \* #00000: Two master template are added. One for a rawUrlEncode case, one for a realUrl case.\* #00000: DRS got prompts for marker and typolink\* #00000: Manual is updated 1.2.1 **Bugfix** \* #36857: Missing index in systemcheck.php: JPG SupportEffected file:\* res/html2ps\_v2043/public\_html/demo/systemcheck.php 1.2.0 **New Features** \* #36513: Enable Batch ProcessingCoded by Jonas Goetze http://forge.typo3.org/users/4345\* #36228: Display PHP error messages – configurable by the plugin / flexformCoded by Ulfried Herrmann http://herrmann.at.die-netzmacher.de 1.1.4 **Bugfix** \* #34939: Get rid of PHP notice logsThanks to Alexander Krimm for the bug report 1.1.3 **Improvement** \* #34858: Usage of $ICON\_TYPES is deprecated since 4.4.Thanks to Rene Staecker http://forge.typo3.org/users/1993 1.1.2 **Bugfix** \* #00000: SQL error in the query in context with development toolsThanks to Borries Jensen, who send the Bugfix. \* #00000: After clearing the dirs cache, out and temp each folder get a file index.html 1.1.1 **New Feature** \* #33851: SEO rel="nofollow" **Improvements** \* #00000: pi1/flexform\_locallang.xml 1.1.0 **Security fix** 1.0.1 **Improvements** \* #32516: Systemcheck should check fonts in directory of pdfcontroller\_fonts\* #32513: typeNum print template is configurable by the TypoScript constant editor\* #32482: PDF Controller suggests to install Fonts **Bugfixes** \* #32518: Wrong field name for proxy in the flexform. Thanks to Borries Jensen\* #31191: Missing folders temp and out. Thanks to Borries Jensen\* #31190: Parameter are missing - without RealURL only. Thanks to Borries Jensen 1.0.0 **Initial release** .. _Illustration-Index: Illustration Index ------------------ Illustration 1: PDF Controller 3: Responsive TYPO3 to PDF 3 Illustration 2: Example for more than one page: first page can designed differently. 3 Illustration 3: PDF Controller 3 flexform 4 Illustration 4: index.php?id=x&type=0 7 Illustration 5: ... &type=67426 7 Illustration 6: ... =67425 7 Illustration 7: The PDF Controller 3 can move responsive HTML output to PDF, which is based on one of the six grid elements provided by Start. 31 Illustration 8: The PDF Controller 3 can move responsive HTML output to PDF, which is based on one of the 12 backend layouts provided by Start. 33 .. _Alphabetical-Index: Alphabetical Index ------------------ 67425 typeNum 7, 14 67426 typeNum 7, 14 Bugs 36 Button icon 14 IMAGE 23 TEXT 24 config disableAllHeaderCode 14 CSS 10 a 9, 11 align 25 border 11 Content Element 10 csc-header 25 disableAllHeaderCode 10 div 19 File 10 h1 19 h2 19 h3 19 HTML 12 inlineCss 25 line-height 11 list-style-type 11 margin 11, 19 ol 19 Own CSS 10 p 19 padding 11 Pagebreak 11 properties 11 rules 11 Sample 11 table 25 text-align 25 ul 19 Development Production 29 Test HTML 29 TCPDF sample 29 TypoScript 29 DRS 30 FE\_SESSION\_KEY 30 Session management 30 filename 20 Flexform 9 Typoscript 17 Fluidtemplates Constant Editor 15 Fonts 28 default fonts 9 PDF Controller Additional Fonts 6 footer 18 Forum 40 Grid elements 25, 31 tt\_content 25 HTML 12 CSS 10 DIV 12 TABLE 12 CAPTION 12 units 12 Images 13 Scaling factor 9 tt\_content 16 margin CSS 19 master-templates 18 PAGE 18 pdf 18 print 18 Organiser 32 PAGE master-templates 18 pdfcontrollerPDF 7, 16 Constant Editor 14 pdfcontrollerPrint 7, 16 Constant Editor 14 PDF Controller Additional Fonts 6 PDF Properties a-tag 9 author 21 default fonts 9 description 21 documentAuthor 21 documentKeywords 21 documentSubject 21 documentTitle 21 images scaling factor 9 keywords 21 page margins 9 pageproperties 21 PDF template 9 title 21 pdfcontrollerPDF Constant Editor 14 typeNum 14 pdfcontrollerPrint Constant Editor 14 copyright 14 header 14 Start 27 strftime 14 typeNum 14 Plugin 9 Requirements Check 8 lockHashKeyWords 8 lockIP 8 Plugin 8 SEO 38 nofollow 38 Session management 30 Slick 32 Start 33 master 27 pdfcontrollerPrint 27 TCPDF 6 tt\_content gridelements 25 image 13, 16 Slick 26 slickslideshow 26 typeNum 22 67425 7, 14 67426 7, 14 TypoScript flexform 17 Templates 6 url 15 User interface pid 14, 21 view 22 `0 <#sdfootnote1anc>`_ You need Start from version 2.0.2. Currently it is a developer version only. Therefor it isn't available in the TYPO3 repository but in the SVN repository. `https://forge.typo3.org/projects/extension-start/wiki `_ . I try to publish Start 2.0.2 in the TER soon. `0 <#sdfootnote2anc>`_ Organiser – TYPO3 for the Lobby and the Organisers: `http://typo3-organiser.de `_ `0 <#sdfootnote3anc>`_ Position must be below the templates of CSS Styled Content and Grid Elements. `0 <#sdfootnote4anc>`_ Optional: moves
to in the image content element. Only in context with generating PDF. `0 <#sdfootnote5anc>`_ Position must be below the templates of Slick. `0 <#sdfootnote6anc>`_ Oprional: moves
to
in the fluid templates of the extension TYPO3 responsive Starter (start). Only in context with generating PDF. `0 <#sdfootnote7anc>`_ Position must be below the templates of Start. `0 <#sdfootnote8anc>`_ Recommended, if you are using the grid elements, which are delivered by Start. `0 <#sdfootnote9anc>`_ Default fonts are used, if there isn't set any font by CSS `0 <#sdfootnote10anc>`_ The absolute path must contain letter in lower case only! `0 <#sdfootnote11anc>`_ dito `0 <#sdfootnote12anc>`_ dito `0 <#sdfootnote13anc>`_ You need the extension Developer Log (devlog) 45 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.jpeg .. :border: 0 .. :height: 20 .. :name: Grafik1 .. :width: 69 .. |img-3| image:: img-3.png .. :align: texttop .. :border: 0 .. :height: 16 .. :name: graphics3 .. :width: 18 .. |img-4| image:: img-4.png .. :align: bottom .. :border: 0 .. :height: 302 .. :name: graphics5 .. :width: 341 .. |img-5| image:: data: :alt: Frame1 .. :align: bottom .. :name: Frame1 .. |img-6| image:: img-6.png .. :align: bottom .. :border: 0 .. :height: 302 .. :name: graphics11 .. :width: 77 .. |img-7| image:: img-7.png .. :align: bottom .. :border: 0 .. :height: 113 .. :name: graphics13 .. :width: 88 .. |img-8| image:: img-8.png .. :align: bottom .. :border: 0 .. :height: 113 .. :name: graphics21 .. :width: 80 .. |img-9| image:: img-9.png .. :align: bottom .. :border: 0 .. :height: 113 .. :name: graphics22 .. :width: 80 .. |img-10| image:: img-10.png .. :border: 0 .. :height: 16 .. :name: graphics1 .. :width: 18 .. |img-11| image:: img-11.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics37 .. :width: 18 .. |img-12| image:: img-12.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics4 .. :width: 18 .. |img-13| image:: img-13.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics15 .. :width: 16 .. |img-14| image:: img-14.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics12 .. :width: 16 .. |img-15| image:: img-15.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics48 .. :width: 18 .. |img-16| image:: img-16.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: Grafik5 .. :width: 18 .. |img-17| image:: img-17.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics2 .. :width: 16 .. |img-18| image:: img-18.png .. :align: bottom .. :border: 0 .. :height: 18 .. :name: graphics16 .. :width: 18 .. |img-19| image:: img-19.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics20 .. :width: 16 .. |img-20| image:: img-20.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics26 .. :width: 16 .. |img-21| image:: img-21.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics28 .. :width: 18 .. |img-22| image:: img-22.png .. :align: bottom .. :border: 0 .. :height: 16 .. :name: graphics18 .. :width: 16