TYPO3 cookbook http://www.typo3-unleashed.net/ The TYPO3 cookbook en TYPO3 cookbook http://www.typo3-unleashed.net/fileadmin/images/content/avatarsmall.gif http://www.typo3-unleashed.net/ 18 18 The TYPO3 cookbook TYPO3 - get.content.right http://blogs.law.harvard.edu/tech/rss Sat, 01 Mar 2008 16:39:00 +0100 Binding of localizations to Domain-Names http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2008/03/01/binding-of-localisations-to-domain-names.html Sometimes you want to select the active language of a website by a specific domain or subdomain... So check this out:

  1.  

  2. # setup for englisch :default

  3. config.baseURL = http://www.anydomain.com/

  4. config.language = en

  5. config.locale_all = en_UK

  6. config.htmlTagLangKey = en-UK

  7. config.sys_language_uid = 0 

  8.  

  9. # switch to french

  10. [globalString = IENV:TYPO3_REQUEST_HOST=http://www.anydomain.fr]

  11.   config.baseURL = http://www.anydomain.fr/

  12.   config.language = fr

  13.   config.locale_all = fr_FR

  14.   config.htmlTagLangKey = fr-FR

  15.   config.sys_language_uid = 1 

  16. [global]

  17.  

  18. # switch to german

  19. [globalString = IENV:TYPO3_REQUEST_HOST=http://www.anydomain.de]

  20.   config.baseURL = http://www.anydomain.de/

  21.   config.language = de

  22.   config.locale_all = de_DE

  23.   config.htmlTagLangKey = de-DE

  24.   config.sys_language_uid = 2 

  25. [global]

  26.  

Notice that the default language switch (HMENU, special = language) will not work with this setup. Maybe i will post a solution later.

]]> Sat, 01 Mar 2008 16:39:00 +0100 Localizing of TS-Objects http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2008/03/01/locallising-of-ts-objects.html You Sometimes want to localize a little more than just a text. So this methods allow you change... A simple way to change Objects based ob the active language is this:

  1.  

  2. page.30 = CASE

  3. page.30{

  4.   key.data =  TSFE:config|config|sys_language_uid

  5.  

  6.   default = TEXT

  7.   default.value = This is the default TEXT

  8.   default.typolink.parameter = 123

  9.  

  10.   1 = TEXT

  11.   1.value = Text in einer alternativen Sprache

  12.   1.typolink.parameter = 456

  13. }

  14.  

 

I personally prefer this second solution wich is based on the config.language property. It's more readable and will work in different typo3 setups wich might have different language id's:

 

  1.  

  2. page.40 = CASE

  3. page.40{

  4.   key.data = TSFE:config|config|language

  5.  

  6.   en = TEXT

  7.   en.value = This is the default TEXT

  8.   en.typolink.parameter = 123

  9.  

  10.   de = TEXT

  11.   de.value = Text in einer alternativen Sprache

  12.   de.typolink.parameter = 456

  13. }

  14.  

]]> Sat, 01 Mar 2008 16:15:00 +0100 Localizing texts in typoscript http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2008/03/01/localising-texts-in-typoscript.html If you are writing typoscripts you often include texts like "more info". In multi language sites... This is the most simple setup based on the config.language value. Notice that it will work with all stdWrap-properties:

  1.  

  2. page.10 = TEXT

  3. page.10 {

  4.   value = Text in default language

  5.   lang.de = Text in deutsch

  6. }

  7.  

 

If you need more translations and you want to seperate them from your ts-code try to use locallang.xml files like here:

  1.  

  2. page.20 = TEXT

  3. page.20.data = LLL:fileadmin/locallang_fe.xml:localisation_key

  4.  

locallang.xml

  1.  

  2. <?xml version="1.0" encoding="utf-8" standalone="yes" ?>

  3. <T3locallang>

  4.     <data type="array">

  5.         <languageKey index="default" type="array">

  6.                     <label index="localisation_key">Localised Key in Default Language</label>

  7.         </languageKey>

  8.         <languageKey index="de" type="array">

  9.                     <label index="localisation_key">Deutsche Übersetzung des Keys</label>

  10.          </languageKey>

  11.     </data>

  12. </T3locallang>

  13.  

]]> Sat, 01 Mar 2008 16:06:00 +0100 Switch between localizations based on the L-parameter. http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2008/03/01/switch-between-locallisations-based-on-the-l-parameter.html In multi language sites you often use the L parameter to switch the languages. Here is the complete ts-code:

  1.  

  2. config.language = en

  3. config.locale_all = en_UK

  4. config.htmlTagLangKey = en-UK

  5. config.sys_language_uid = 0

  6. config.linkVars := addToList(L) 

  7.  

  8.   # switch the german language based on the L parameter

  9. [globalVar = GP:L=1]

  10.   config.language = de

  11.   config.locale_all = de_DE

  12.   config.htmlTagLangKey = de-DE

  13.   config.sys_language_uid = 1 

  14. [global]

  15.  

]]> Sat, 01 Mar 2008 15:58:00 +0100 Basic localization setup http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2008/03/01/basic-locallisation-setup.html To successfully setup a non english site you have to adjust several settings in typoscript. Here is a list of them with explanation:

  1.  

  2. config.language = en

  3.  

 

Define wich localization mark will be used by typo3. Especially the predefined translations of extensions will use this setting. But you also can use this in your own extensions and typoscript.

 

  1.  

  2. config.locale_all = en_UK

  3.  

 

Set the PHP-Locale. This setting will be used by all localized php function like stftime. Especially the displaying of dates is customized this way

 

  1.  

  2. config.htmlTagLangKey = en-UK

  3.  

 

Setting the language key for the html/xml document means being nice to search engines because they dont have to guess the language of your site. So just do it.

 

  1.  

  2. config.sys_language_uid = 0

  3.  

]]> Sat, 01 Mar 2008 15:42:00 +0100 How to enable entities in headlines http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2007/05/30/how-to-enable-entities-in-headlines.html I want to use entities like "€" in my headlines but it is always displayed as "&euro;".... Just enter the following line to your TypoScript Setup:

  1.  

  2. lib.stdheader.10.setCurrent.htmlSpecialChars = 0

  3.  

]]> Frontend thomas@typo3-unleashed.net Wed, 30 May 2007 08:52:00 +0200 An easy way to image menus http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2007/04/14/an-easy-way-to-image-menus.html I want to create a menu with TYPO3 with images, but I don't want any creating or processing. This is very easy to achieve. The following TypoScript creates a menu that creates a an image tage instead of a simple text. The images are located in the fileadmin directory.

  1.  

  2. lib.navIcon = HMENU

  3. lib.navIcon    {

  4.   special = directory

  5.   special.value = 183

  6.   1 = TMENU

  7.   1    {

  8.     noBlur = 1

  9.     NO    {

  10.       allWrap = |<br />

  11.       stdWrap.cObject = COA

  12.       stdWrap.cObject    {

  13.         10 = TEXT

  14.         10.wrap = <img src="fileadmin/templates/images/icon_|.gif" alt="

  15.         10.data = field:alias

  16.                

  17.         20 = TEXT

  18.         20.wrap = |"

  19.         20.data = field:subtitle

  20.                

  21.         30 = TEXT

  22.         30.wrap = title="|" />

  23.         30.data = field:subtitle

  24.       }

  25.     }

  26.   }

  27. }

  28.  

The alt and title attribute of the image are filled with the alias and subtitle of the page that is linked. You can see the result in the top right corner of this page.

]]> Menus thomas@typo3-unleashed.net Sat, 14 Apr 2007 10:20:00 +0200 Short DBAL how-to http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2007/04/13/short-dbal-how-to.html This very short how-to shows you how you can setup a TYPO3 Installation that runs with DBAL on a... This very short how-to shows you how you can setup a TYPO3 Installation that runs with DBAL on a postgreSQL database.

It's highly recommend, that you use this to start from cratch. This is NO tutorial how to migrate any existing site to another database!

Step 1

Install TYPO3 as usual with a normal mysql database

Step 2

Log into the system and install the extensions "adodb" and "dbal". These extension are delivered with the TYPO3 source package.

Step 3

Log into your postgreSQL database and create a new database. In this case the database is called "typo3_db". You should also create user that has access to the new database.

You can try to create the database from within the install tool. But I don't know if that works. I didn't tried it.

Step 4

After you have created the database. Go to the console and edit the localconf.php in your typo3conf folder.

Here you have to configure which driver should be used for the default database. Your code could look like this:

  1.  

  2. $TYPO3_CONF_VARS['EXTCONF']['dbal']['handlerCfg'] = array (

  3.         '_DEFAULT' => array (

  4.                 'type' => 'adodb',

  5.                 'config' => array (

  6.                         'driver' => 'postgres7',

  7.                 )

  8.         )

  9. );

  10.  

  11. $typo_db_username = 'typo3';

  12. $typo_db_password = 'typo3';

  13. $typo_db_host = 'localhost';

  14. $typo_db = 'typo3_db';

  15.  

For a detailed description of the properties, read the DBAl manual.

Step 5

No start the installer and go to the "Database analyser" and click on "Compare". After executing the operations, you can also import some static data if you need that. If not you are done, and your TYPO3 installation should run on postgreSQL.

]]> General thomas@typo3-unleashed.net Fri, 13 Apr 2007 16:12:00 +0200 Setting up print and PDF link http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2006/04/12/setting-up-print-and-pdf-link.html How can I add a printlink and / or an PDF link to website? To add those links you have to install two extensions. For printlinks you'll need the extension "make_printlink" and for PDF you'll need "pdf_generator". After you have installed them adde the following code to your TypoScript Setup:

  1.  

  2. ### printlink and pdf export

  3. temp.printAndPdf = COA

  4. temp.printAndPdf {

  5.   ### Printlink

  6.   10 = USER_INT

  7.   10.userFunc = tx_open_printlink

  8.   20 = TEXT

  9.   20.value = <img src="fileadmin/images/template/print.gif" alt="print page" border="0" />&nbsp;print</a>&nbsp;/&nbsp;

  10.  

  11.   ### PDF Link

  12.   30 = USER_INT

  13.   30.userFunc = tx_pdfgenerator->openPdfLink

  14.   40 = TEXT

  15.   40.value = <img src="fileadmin/images/template/pdf.gif" alt="PDF version" border="0" />&nbsp;PDF</a>

  16. }

  17.  

 

You can now insert the content of temp.printAndPdf into a marker like this:

  1.  

  2. page.10.marks.PRINTANDPDF < temp.printAndPdf

  3.  

]]> Frontend thomas@typo3-unleashed.net Wed, 12 Apr 2006 10:15:00 +0200 Basic RealURL setup http://www.typo3-unleashed.net/nc/cookbook_recipe/date/2006/04/12/basic-realurl-setup.html I don't want this ugly index.php?id=123 type of URLs anymore. How can I change this to have... For doing this you can use the extension "realurl". In cooperation with the Apache rewrite module It translates nice structurized URL paths into a format that TYPO3 can understand.

 

Step 1 - setup mod_rewrite

To tell mod_rewrite to pass everything not under typo3 which is not a file, dir or symlink to index.php for rewriting put this in your .htaccess. (NOTE: this is not necessary with current version of the provided .htaccess ... you will just need to enable (rename)) it..

  1.  

  2. RewriteEngine On

  3. RewriteRule ^typo3$ - [L]

  4. RewriteRule ^typo3/.*$ - [L]

  5. RewriteCond %{REQUEST_FILENAME} !-f

  6. RewriteCond %{REQUEST_FILENAME} !-d

  7. RewriteCond %{REQUEST_FILENAME} !-l

  8. RewriteRule .* index.php

  9.  

 

Step 2 - Prepare template setup

Put this in your root template setup

  1.  

  2. config.simulateStaticDocuments = 0

  3. config.baseURL = localhost/devsite

  4. config.tx_realurl_enable = 1

  5.  

NOTE: since Typo3 3.8.1 config.baseURL has to be the URL to your site and can not be 1 ... see http://wiki.typo3.org/index.php/TYPO3_3.8.1 for details. The documentation both in the TSRef and the RealURL manual is outdated on this matter.

 

Step 3 - Configure extension in localconf.php

Insert this into your localconf.php to get off the ground quickly

  1.  

  2. $TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT'] = array(

  3.         'preVars' => array(

  4.                 array(

  5.                         'GETvar' => 'L',

  6.                         'valueMap' => array(

  7.                                 'dk' => '1',

  8.                         ),

  9.                         'noMatch' => 'bypass',

  10.                 ),

  11.         ),

  12.         'fileName' => array (

  13.                 'index' => array(

  14.                         'page.html' => array(

  15.                                 'keyValues' => array (

  16.                                 'type' => 1,

  17.                                 )

  18.                         ),

  19.                         '_DEFAULT' => array(

  20.                                 'keyValues' => array(

  21.                                 )

  22.                         ),

  23.                 ),

  24.         ),

  25.         'postVarSets' => array(

  26.                 '_DEFAULT' => array (

  27.                         'news' => array(

  28.                                 array(

  29.                                         'GETvar' => 'tx_mininews[mode]',

  30.                                         'valueMap' => array(

  31.                                                 'list' => 1,

  32.                                                 'details' => 2,

  33.                                         )

  34.                                 ),

  35.                                 array(

  36.                                         'GETvar' => 'tx_mininews[showUid]',

  37.                                 ),

  38.                         ),

  39.                 ),

  40.         ),

  41. );

  42.  

For further detail of this extension please see the realurl manual available here: http://typo3.org/documentation/document-library/extension-manuals/realurl/current/view/toc/0/

]]> Frontend martin.adler@gmail.com Wed, 12 Apr 2006 09:34:00 +0200