Attention
TYPO3 v8 has reached its end-of-life March 31st, 2020 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.
There is no further ELTS support. It is recommended that you upgrade your project and use a supported version of TYPO3.
tags¶
Used to create custom tags and define how they should be parsed. This is used in conjunction with parseFunc.
The best known is the "link" tag, which is used to create links.
Property
(array of strings)
Data type
cObject
Description
Every entry in the array of strings corresponds to a tag, that will be parsed. The elements must be in lowercase.
Every entry must be set to a content object.
"current" is set to the content of the tag, eg <TAG>content</TAG>: here "current" is set to "content". It can be used with stdWrap.current = 1.
Parameters:
Parameters of the tag are set in $cObj->parameters (key is lowercased):
<TAG COLOR="red">content</TAG>
This sets $cObj->parameters[color] = red.
$cObj->parameters[allParams] is automatically set to the whole parameter-string of the tag. Here it is ' color="red"'
Special properties for each content object:
[cObject].stripNL: Boolean option, which tells parseFunc that newlines before and after the content of the tag should be stripped.
[cObject].breakoutTypoTagContent: Boolean option, which tells parseFunc that this block of content is breaking up the nonTypoTag content and that the content after this must be re-wrapped.
Examples:
tags.bold = TEXT
tags.bold {
stdWrap.current = 1
stdWrap.wrap = <p style="font-weight: bold;"> | </p>
}
tags.bold.stdWrap.stripNL = 1
This example would e.g. transform <BOLD>Important!</BOLD>
to <p style="font-weight: bold;">Important!</p>
.
[tsref:->tags]
Example:¶
This example creates 4 custom tags. The <LINK>-, <TYPOLIST>-, <GRAFIX>- and <PIC>-tags:
<LINK> is made into a typolink and provides an easy way of creating links in text.
<TYPOLIST> is used to create bullet-lists.
<GRAFIX> will create an image file with 90x10 pixels where the text is the content of the tag.
<PIC> lets us place an image in the text. The content of the tag should be the image-reference in "fileadmin/images/".
tags {
link = TEXT
link {
stdWrap.current = 1
stdWrap.typolink.extTarget = _blank
stdWrap.typolink.target = {$cLinkTagTarget}
stdWrap.typolink.wrap = <p style="color: red;">|</p>
stdWrap.typolink.parameter.data = parameters : allParams
}
typolist < tt_content.bullets.default.20
typolist.trim = 1
typolist.field >
typolist.current = 1
grafix = IMAGE
grafix {
file = GIFBUILDER
file {
XY = 90,10
100 = TEXT
100.text.current = 1
100.offset = 5,10
}
}
# Transforms <pic>file.png</pic> to <img src="fileadmin/images/file.png" >
pic = IMAGE
pic.file.import = fileadmin/images/
pic.file.import.current = 1
}