This page is still a beta!

Core Documentation


Chapter 1. 

TypoScript Reference

Extension Key: doc_core_tsref

Language: en

Version: 4.6.0

Keywords: forAdmins, forIntermediates

Copyright 2000-2011, Documentation Team, <documentation@typo3.org>

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

Official documentation

This document is included as part of the official TYPO3 documentation. It has been approved by the TYPO3 Documentation Team following a peer-review process. The reader should expect the information in this document to be accurate - please report discrepancies to the Documentation Team (documentation@typo3.org). Official documents are kept up-to-date to the best of the Documentation Team's abilities.

Core Manual

This document is a Core Manual. Core Manuals address the built in functionality of TYPO3 and are designed to provide the reader with in-depth information. Each Core Manual addresses a particular process or function and how it is implemented within the TYPO3 source code. These may include information on available APIs, specific configuration options, etc.

Core Manuals are written as reference manuals. The reader should rely on the Table of Contents to identify what particular section will best address the task at hand.

1.1. Introduction

About this document

This document is a complete reference to all objects and properties of TypoScript as used in TYPO3 templates (and not in TSconfig).

For explanations about the syntax of TypoScript itself, please refer to the "TypoScript Syntax and In-Depth Study" manual.

This version is updated for TYPO3 version 4.6.

What's new

The main changes include the integration of the documentation of the content objects MEDIA, SWFOBJECT and QTOBJECT.

The new stdWrap properties "hash", "round" and "replacement" were added. stdWrap has been added to IMAGE.file.params and to all properties of the select object. The "case" property of stdWrap now has the new values "capitalize", "ucfirst" and "lcfirst".

The property config.minifyJS has been replaced by config.compressJs and config.minifyCSS has been replaced by config.compressCss. config.concatenateJsAndCss is now deprecated and has been replaced by two separate properties: config.concatenateJs and config.concatenateCss.

config.includeJSlibs, config.includeJS and config.includeCSS now offer additional subproperties in regards to compression.

The property config.cache, which can influence the cache lifetime of pages, has been appended.

Additionally various descriptions were improved and many smaller mistakes were fixed.

For more details about changes in the various TYPO3 versions please refer to the links below.

More information about changed properties

You can find a list of changes for more recent TYPO3 versions in the wiki:

http://wiki.typo3.org/Documentation_changes_in_4.2

http://wiki.typo3.org/Documentation_changes_in_4.3

http://wiki.typo3.org/Documentation_changes_in_4.4_and_4.5

http://wiki.typo3.org/Documentation_changes_in_4.6

Credits

The manual was originally written by Kasper Skårhøj. Over the years it has been maintained and updated successively by Michael Stucki, François Suter and Christopher Stelmaszyk.

Feedback

For general questions about the documentation get in touch by writing to documentation@typo3.org.

If you find a bug in this manual, please file an issue in this manual's bug tracker: http://forge.typo3.org/projects/typo3v4-doc_core_tsref/issues

Maintaining quality documentation is hard work and the Documentation Team is always looking for volunteers. If you feel like helping please join the documentation mailing list (typo3.projects.documentation on lists.typo3.org).

General information

Case sensitivity

All names and references in TypoScript are case sensitive! This is very important to notice. That means that:

myObject = HTML
myObject.value = <strong> HTML - code </strong>

is not the same as

myObject = html
myObject.Value = <strong> HTML - code </strong>

While the first will be recognized as the content-object "HTML" and will produce the desired output, the latter will not be recognized and will not output anything. Even if you wrote "HTML" in uppercase in the second example, it would still not work, because the property "value" is misspelled.

Always remember: In this manual the case of objects is important.