Configuration¶

Target group: Developers, Integrators

How is the extension configured? Aim to provide simple instructions detailing how the extension is configured. Always assume that the user has no prior experience of using your extension.

Try and provide a typical use case for your extension and detail each of the steps required to get the extension running.

Typical Example¶

Do we need to include a static template?
For example add a code snippet with comments

Minimal example of TypoScript:

Code-blocks have support for syntax highlighting
Use any supported language

plugin.tx_myextension.settings {
   # configure basic email settings
   email {
      subject = Some subject
      from = someemail@domain.de
   }
}

TypoScript Reference¶

Possible subsections: Reference of TypoScript options. The construct below show the recommended structure for TypoScript properties listing and description.

When detailing data types or standard TypoScript features, don’t hesitate to cross-link to the TypoScript Reference as shown below.

See Hyperlinks & Cross-Referencing <https://docs.typo3.org/typo3cms/HowToDocument/WritingReST/Hyperlinks.html> for information about how to use cross-references.

See the Settings.cgf file for the declaration of cross-linking keys. You can add more keys besides tsref.

Properties¶

Property	Data type	t3tsref:stdwrap	Default
allWrap	t3tsref:data-type-wrap	yes	`<div>\|</div>`
subst_elementUid	t3tsref:data-type-boolean	no	0
wrapItemAndSub	t3tsref:data-type-wrap

allWrap ¶

plugin.tx_extensionkey.allWrap = t3tsref:data-type-wrap

Wraps the whole item.

subst_elementUid ¶

plugin.tx_extensionkey.subst_elementUid = t3tsref:data-type-boolean

If set, all appearances of the string {elementUid} in the total element html-code (after wrapped in allWrap) are substituted with the uid number of the menu item. This is useful if you want to insert an identification code in the HTML in order to manipulate properties with JavaScript.

wrapItemAndSub ¶

plugin.tx_extensionkey.wrapItemAndSub = t3tsref:data-type-wrap

Wraps the whole item and any submenu concatenated to it.

FAQ¶

Possible subsection: FAQ