TypoScript Template Reference
8.7
Introduction
What is TypoScript?
Templating methods in TYPO3
Using and setting TypoScript
Entering and structuring TypoScript templates
Inclusions
Template Analyzer
Constants
Defining constants
Example
Using constants
Example
The Constant Editor
Default values
Comment Syntax
cat
Predefined categories
Custom categories
Subcategories
Predefined subcategories
Custom subcategories
Ordering
type
label
Register
Defining registers
Example
Debugging / Analyzing
Analyzing defined constants
Finding errors
Debugging
Glossary
Simple data types
align
boolean
case
date-conf
degree
dir
function name
getText
field:
parameters:
register:
leveltitle, leveluid, levelmedia:
levelfield:
date:
page:
pagelayout:
current:
level:
GP:
getenv:
getIndpEnv:
TSFE:
DB:
file:
fullRootLine:
LLL:
path:
cObj:
session:
debug:
global:
flexform:
GraphicColor
HTML code
HTML-color
imageExtension
imgResource
integer
linkWrap
list
margins
page_id
path
pixels
positive integer
resource
rotation
space
strftime-conf
string
<tag>
< tag >-data
< tag >-params
target
UNIX-time
VHalign
wrap
x,y,w,h
Top-level objects
CONFIG & config
Properties
Property details
absRefPrefix
additionalHeaders
admPanel
ATagParams
baseURL
beLoginLinkIPList
beLoginLinkIPList_login
beLoginLinkIPList_logout
cache
cache_clearAtMidnight
cache_period
compressCss
compressJs
concatenateCss
concatenateJs
concatenateJsAndCss
content_from_pid_allowOutsideDomain
contentObjectExceptionHandler
debug
defaultGetVars
disableAllHeaderCode
disableBodyTag
disableCharsetHeader
disableImgBorderAttr
disablePageExternalUrl
disablePrefixComment
disablePreviewNotification
disableLanguageHeader
doctype
doctypeSwitch
enableContentLengthHeader
extTarget
fileTarget
forceTypeValue
formMailCharset
ftu
headerComment
htmlTag_dir
htmlTag_langKey
htmlTag_setParams
htmlTag_stdWrap
index_descrLgd
index_enable
index_externals
index_metatags
inlineStyle2TempFile
intTarget
language
language_alt
linkVars
locale_all
lockFilePath
message_page_is_being_generated
message_preview
message_preview_workspace
metaCharset
moveJsFromHeaderToFooter
MP_defaults
MP_disableTypolinkClosestMPvalue
MP_mapRootPoints
namespaces
no_cache
noPageTitle
pageGenScript
pageRendererTemplateFile
pageTitle
pageTitleFirst
pageTitleSeparator
removeDefaultCss
removeDefaultJS
removePageCss
sendCacheHeaders
sendCacheHeaders_onlyWhenLoginDeniedInBranch
spamProtectEmailAddresses
spamProtectEmailAddresses_atSubst
spamProtectEmailAddresses_lastDotSubst
sword_noMixedCase
sword_standAlone
sys_language_isocode
sys_language_isocode_default
sys_language_mode
sys_language_overlay
sys_language_uid
titleTagFunction
tx_[extension key with no underscores]_[*]
typolinkCheckRootline
typolinkEnableLinksAcrossDomains
typolinkLinkAccessRestrictedPages
typolinkLinkAccessRestrictedPages_addParams
USERNAME_substToken
USERUID_substToken
xhtmlDoctype
xmlprologue
constants
Properties
Property details
(array of keys)
_GIFBUILDER
module
PAGE & page
Multiple pages
Guidelines
Properties
Property details
1,2,3,4…
bodyTag
bodyTagAdd
bodyTagCObject
bodyTagMargins
config
CSS_inlineStyle
cssInline
footerData
frameSet
headerData
headTag
includeCSS.[array]
includeCSSLibs.[array]
includeJS.[array]
includeJSFooter.[array]
includeJSFooterlibs.[array]
includeJSLibs.[array]
inlineLanguageLabelFiles
inlineSettings
javascriptLibs
jsFooterInline
jsInline
meta
shortcutIcon
stdWrap
stylesheet
typeNum
wrap
plugin
Properties
Property details
userFunc
_CSS_DEFAULT_STYLE
_CSS_PAGE_STYLE
_DEFAULT_PI_VARS.[piVar-key]
_LOCAL_LANG.[lang-key].[label-key]
temp, styles & lib
tt_*
resources
sitetitle
types
cObject
Content objects (general information)
PHP information
REUSING cOBJECTS
Note:
Example:
CASE
Example:
COA, COA_INT
Examples:
CONTENT
Comprehensive example
select
table
renderObj
slide
wrap
stdWrap
CONTENT object example 1
CONTENT object example 2
EDITPANEL
Example:
FILE
Example:
FILES
Special key: “references”
Examples:
Usage with files
Usage with references
Usage with sliding
FLUIDTEMPLATE
Properties
templateName
template
file
templateRootPaths
layoutRootPath
layoutRootPaths
partialRootPath
partialRootPaths
format
extbase.pluginName
extbase.controllerExtensionName
extbase.controllerName
extbase.controllerActionName
variables
settings
dataProcessing
stdWrap
Example:
HMENU
Example:
The .special property
special = directory
special = list
special = updated
Example for special = updated:
special = rootline
Example for special = rootline:
special = browse
special = keywords
special = categories
special = language
Example:
special = userfunction
Example: Creating hierarchical menus of custom links
IMAGE
layoutKey
layout
layout.layoutKey
layout.layoutKey.element
layout.layoutKey.source
sourceCollection
dataKey
dataKey.if
dataKey.pixelDensity
dataKey.width
dataKey.height
dataKey.maxW
dataKey.maxH
dataKey.minW
dataKey.minH
dataKey.quality
dataKey.*
Examples:
Standard rendering
Responsive/adaptive rendering
IMG_RESOURCE
LOAD_REGISTER
Example:
RECORDS
Properties
Introduction
Property details
source
categories
tables
conf
dontCheckPid
wrap
stdWrap
Examples
Selection with source
Selection with source II
Selection with categories
RESTORE_REGISTER
Example:
SVG
Example:
TEMPLATE
Example:
TEXT
Examples:
USER and USER_INT
userFunc
(properties you define)
stdWrap
Examples:
Example 1
Example 2
Example 3
Example 4
MENU
Common properties
Common item states for TMENU, GMENU and IMGMENU
[menu object].sectionIndex
The data-record /Behind the scene
GMENU
Additional properties for Menu item states
TMENU
TMENUITEM
IMGMENU
IMGMENUITEM
JSMENU
JSMENUITEM
Example:
Other Object Types
carray
Properties
Property details
(stdWrap properties…)
(TDParams)
1,2,3,4…
meta
Properties
array of key names
GIFBUILDER
GIFBUILDER
Note on (+calc)
_GIFBUILDER top level object
Object names in this section
TEXT
SHADOW
EMBOSS
OUTLINE
BOX
ELLIPSE
Example:
IMAGE
EFFECT
Syntax:
Example:
WORKAREA
CROP
SCALE
ADJUST
Example:
NON-Gifbuilder Objects
IMGMAP
Functions
addParams
Example:
cache
Examples:
cache as first-class function:
Calc
Calculating values (+calc)
How value is calculated
calc usage example
encapsLines
Example:
Example:
filelink
altText
ATagBeforeWrap
ATagParams
emptyTitleHandling
file
icon
icon_link
icon_image_ext_list
icon_thumbSize
iconCObject
labelStdWrap
longdescURL
path
removePrependedNumbers
size
stdWrap
target
titleText
typolinkConfiguration
wrap
Filelink Example
HTMLparser
HTMLparser_tags
if
Explanation
Examples:
imageLinkWrap
Properties
Property details
enable
file
width
height
effects
Example for effects
sample
alternativeTempPath
title
bodyTag
wrap
target
JSwindow
JSwindow.expand
JSwindow.newWindow
JSwindow.altUrl
JSwindow.altUrl_noDefaultParams
typolink
directImageLink
linkParams
stdWrap
What it does
Implementation
Examples for imageLinkWrap
Basic example: Create a link to the showpic script
Basic example: Link directly to the original image
Example: Larger display in a popup window
Example: Printlink
Example: Images in lightbox “fancybox”
Example: Images in lightbox “TopUp”
imgResource
Examples
makelinks
numberFormat
Examples:
numRows
optionSplit
Introduction
PHP-Code
Terminology
Mainparts
Subparts
Full example to see how it works
Three by three items
The optionSplit ruleset
More Examples
Three by two items
Three by one items
Two by three items
Two by two items
Two by one items
One by one items
One by two items
One by three items
One by four items
More examples: Tricky stuff
Three items A, no item R, three items Z
One item A, no item R, one items Z
One item A, one (unexpected!?) item R, one item Z
More
Test Code 1 (TypoScript)
Test Code 1 Result
Test Code 2 (TypoScript)
Test Code 2 Result
parseFunc
Example:
replacement
Examples:
round
Examples:
select
Comprehensive example
uidInList
pidInList
recursive
orderBy
groupBy
max
begin
where
languageField
includeRecordsWithoutDefaultTranslation
selectFields
join, leftjoin, rightjoin
markers
split
Example:
strPad
Examples:
stdWrap
Example
Content-supplying properties of stdWrap
Getting data
setContentToCurrent
addPageCacheTags
setCurrent
lang
data
field
current
cObject
numRows
filelist
preUserFunc
Override and conditions
override
preIfEmptyListNum
ifNull
ifEmpty
ifBlank
listNum
trim
strPad
stdWrap
required
if
fieldRequired
Parsing data
csConv
parseFunc
HTMLparser
split
replacement
prioriCalc
char
intval
hash
round
numberFormat
date
strftime
strtotime
age
case
bytes
substring
removeBadHTML
cropHTML
stripHtml
crop
rawUrlEncode
htmlSpecialChars
encodeForJavaScriptValue
doubleBrTag
br
brTag
encapsLines
keywords
innerWrap
innerWrap2
addParams
filelink
preCObject
postCObject
wrapAlign
typolink
TCAselectItem
spaceBefore
spaceAfter
space
wrap
noTrimWrap
wrap2
dataWrap
prepend
append
wrap3
orderedStdWrap
outerWrap
insertData
postUserFunc
postUserFuncInt
prefixComment
editIcons
editPanel
cache
debug
debugFunc
debugData
tags
Example:
typolink
Examples
Resource references
Handler syntax
page
file
folder
Using link handlers
Conditions
About The Syntax Of Conditions
General syntax
Example
Trimming, braces and condition operators
Examples
Test day of month and month
Test day of month
Test month and day of month
Condition reference
language
Syntax:
Comparison:
IP
Syntax:
Comparison:
Examples:
hostname
Syntax:
Comparison:
applicationContext
Syntax:
Comparison:
Examples:
hour
Syntax:
Comparison:
Examples:
minute
Syntax:
Comparison:
month
Syntax:
Comparison:
year
Syntax:
Comparison:
dayofweek
Syntax:
Comparison:
dayofmonth
Syntax:
Comparison:
dayofyear
Syntax:
Comparison:
usergroup
Syntax:
Comparison:
Example:
loginUser
Syntax:
Comparison:
Example:
Example:
page
Syntax:
Comparison:
Example:
treeLevel
Syntax:
Comparison:
Example:
PIDinRootline
Syntax:
Comparison:
Example:
PIDupinRootline
Syntax:
Comparison:
compatVersion
Syntax:
Comparison:
globalVar
Syntax:
Comparison:
Examples:
globalString
Syntax:
Comparison:
Examples:
Important note on globalVar and globalString
Examples:
Examples:
Custom Conditions
Syntax:
Comparison:
Examples:
userFunc
Syntax:
Comparison:
Examples:
Appendix A – PHP include scripts
Including your script
$content
$conf
White spaces
$GLOBALS[‘TSFE’]->set_no_cache()
Example:
$this->cObjGetSingle(value, properties)
Example:
$this->stdWrap(value, properties)
Example:
Internal variables in the main frontend object, TSFE
Global variables
About This Manual
Credits
Contribute
Contact
Sitemap
Linktargets
Targets For Cross-Referencing
TypoScript Template Reference
Docs
»
Simple data types
»
positive integer
Edit me on GitHub
Next
Previous
positive integer
¶
Data type
positive integer / posint / int+
Examples
42, 8, 9
Comment
Positive integer
Versions
Project
Home
Contact
Discussions
Issues
Repository
Downloads
Related Links
v: 8.7
Comment
Positive integer