DEPRECATION WARNING

This documentation is not using the current rendering mechanism and will be deleted by December 31st, 2020. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Page / User TSconfig reference¶

The following TypoScript configuration can be used either as Page TSconfig or as User TSconfig.

tx_templavoila¶

Property

Property:

Data type

Data type:

Description

Description:

Default

Default:

Property

storagePid

Data type

integer

Description

Alternative storage page for DS/TO records. If set, DS/TO will be fetched from this page, not from the GRSP

Default

[tsconfig:tx_templavoila]

mod.web_txtemplavoilaplusLayout¶

Property

Property:

Data type

Data type:

Description

Description:

Default

Default:

Property

createPageWizard.fieldNames

Data type

list

Description

With this option you may specify a selection of field names of the pages table to be displayed in the create-new-page-wizard.The “*” value can be used to show all fields.

Example:

mod.web_txtemplavoilaplusLayout.createPageWizard {
fieldNames = hidden, title, author, description, abstract
}


This will create an editing form like this:

Default

hidden, title, alias

Property

enableDeleteIconForLocalElements

Data type

Integer

Description

With this option you can specify whether the page-module should render a delete icon for an element or whether the unlink icon should be used. Whenever you enable the delete icons there might still be situations where the unlink icon is the only appropriate option (e.g. if a element is only referenced on the page).

If you want to keep the unlink icons use the following setting:

enableDeleteIconForLocalElements = 0

If you want to provide the unlink icon and the delete icon side-by- side use:

enableDeleteIconForLocalElements = 1

If you want to avoid the unlink icon as often as possible and provide only the delete icon whenever possible use:

enableDeleteIconForLocalElements = 2

Default

0

Property

enableEditIconForRefElements

Data type

boolean

Description

If set, you get edit icon for referenced content elements

Default

Not set

Property

sideBarEnable

Data type

boolean

Description

Defines if the toolbar in the TemplaVoilà! Plus Page Module is visible or not. By default it is visible as a row of tabs.

Default

TRUE

Property

tabList

Data type

string

Description

Default

Property

showTabsIfEmpty

Data type

boolean

Description

If set, all Tabs are rendered even if they are empty

Default

FALSE

Property

disableContainerElementLocalizationWarning

Data type

boolean

Description

Container elements used with TemplaVoilà! Plus should not be localized. Therefore a warning is displayed if <langDisable> is false for such data structures. If localization was enabled on purpose this warning will be misleading of course and can be disabled by this setting.

Default

FALSE

Property

disableContainerElementLocalizationWarning_warningOnly

Data type

boolean

Description

Sometimes you might like to localize container elements with <langChildren> enabled. This is especially the case if the element is more than a container but also has content fields that need localization.

The problem is that only the default language values of the reference fields (non-content fields) is recognized by TemplaVoilà! Plus page module while in the frontend the rendering depends on inheritance and what other references someone might accidentally put into the reference fields of other languages! So, if you use localization for such mixed records, a) make sure inheritance is enabled (so for all languages the references set for default language is used) and b) that no references are localized (leave reference fields for other languages empty).

Default

FALSE

Property

disableElementMoreThanOnceWarning

Data type

boolean

Description

Elements which are used more than once on a page usually show a warning message. If users find this misleading this setting can be used to hide it.

Default

FALSE

Property

Data type

boolean

Description

Elements which referenced from other pages will show a notification message. If users find this misleading this setting can be used to hide it.

Default

FALSE

Property

Data type

string keyword

Description

If set to “free” the Page module will act according to a translation paradigm called “Free” (opposite to “Bound”) where you use the Page DS <langDisable> to indicate whether or not a page can be localized and there localizations of default language records are linked into separate content structures provided by the data structure either as Inheritance or Separate.

You should read the document “Localization Guide” which includes detailed information about these concepts.

Default

Property

disableDisplayMode

Data type

list of keywords

Description

In the “Bound” translation paradigm, you will see a selector box that allows you to filter which languages you see for editing. Here you can disable certain of the available options by setting keywords in this list.

Options are: default, selectedLanguage, onlyLocalized

Default

Property

hideCopyForTranslation

Data type

boolean

Description

If set, the links “Copy for translations” won’t be rendered in pafe module. This is useful if you configured a special translation model eg for seperate content and you don’t want the editor translating content elements

Default

Not set

Property

recordDisplay_tables

Data type

list of table names

Description

Comma-separated list of table name to shown in “Record list” tab. This feature requires TYPO3 version >= 4.0.5.

Record list allows to edit any record on the page without a need to switch to list module.

If this value is not set, record list will not be shown at all.

Default

Not set

Property

recordDisplay_maxItems

Data type

integer

Description

Maximum number of records to display. If this values is not set, value from $TCA is used. If value in$TCA is not set, default is used.

Default

10

Property

recordDisplay_alternateBgColors

Data type

boolean

Description

If set to 1, forces to alternate background colors for records

Default

False

Property

Data type

list of doktypes

Description

Comma-separated list of doktypes that should be rendered to the edit view. This is useful if you use a sysfolder as container for content elements. To enable the edit view for the sysfolder use this pageTS:

mod.web_txtemplavoilaplusLayout {
}


Default

Property

blindIcons

Data type

list of keywords

Description

Following icons can be blinded:

Example:

mod.web_txtemplavoilaplusLayout {
blindIcons = browse,edit,new
}


Default

Property

stylesheet

Data type

string

Description

Alternative or additional CSS stylesheet for the pagemodule. Path must either contain an extension key using “EXT:foo” notation or must be relative to the typo3-directory.

Example – to replace the main TemplaVoila stylesheet:

mod.web_txtemplavoilaplusLayout {
}


Example – to add further CSS files without replacing the main stylesheet:

mod.web_txtemplavoilaplusLayout.stylesheet {
file1 = EXT:/res/css/file1.css
}


Default

Property

javascript

Data type

Array

Description

Additional javascript files for the pagemodule. Path must either contain an extension key using “EXT:foo” notation or must be relative to the typo3-directory.

Example:

mod.web_txtemplavoilaplusLayout.javascript {
}


Default

Property

Data type

boolean

Description

Any modification to reference lists will be made in Live Workspace. Setting is used to avoid competitive list edits in multiple workspaces.

For details see: http://bugs.typo3.org/view.php?id=13165

Default

Property

debug

Data type

boolean

Description

For develop: with debug flag set the javascript won’t be loaded minified.

Default

Property

Data type

boolean

Description

Use this setting to provide the option to turn on the outline view also for non admins.

Default

Not set

Property

keepElementsInClipboard

Data type

boolean

Description

Use this setting to change to clipboard behaviour. After elements are copied or referenced they won’t be removed from the clipboard.

Default

Not set

Property

previewTitleMaxLen

Data type

integer

Description

Limit the size of the title for the content elements.

Default

50

Property

previewDataMaxLen

Data type

integer

Description

Limit the size of the text within the preview-area of an content element.

Default

2000

Property

previewDataMaxWordLen

Data type

integer

Description

Limit the size of single words within the preview text. This is supposed to avoid that long words “stretch” the element too much

Default

75

Property

enableContentAccessWarning

Data type

boolean

Description

A messages is shown whenever an editor opens the page-module without proper permissions to edit the content of the page, modify the pages table ir modify the pages “Content” field. This setting can be used to disable these messages.

Default

true.

Property

Data type

Integer

Description

Set the to “1” if you want to show the localization link in the page- module for all FCEs with langDisabled = 1 setting.

Default

0

Property

Data type

string

Description

Set to “false” if you want to allow regular users to create separate page structures for different languages (if “inheritance” is used).

Set to “fallback” if you allow users to see inherited structures but restrict structure creation.

Set to “strict” if only admins should be able to see and edit separate structures.

Default

fallback

[tsconfig:mod.web_txtemplavoilaplusLayout]

mod.web_txtemplavoilaplusCenter¶

Property

Property:

Data type

Data type:

Description

Description:

Default

Default:

Property

templatePath

Data type

List of directories

Description

List of paths to directories inside fileadmin/ where templates can be found. Must be accessible by the users file mounts.

Example:

mod.web_txtemplavoilaplusCenter.templatePath = templates,templates/special,templates/main

Default

Templates

Property

dsPreviewIconThumb

Data type

string

Description

If set, the previewIcon for DS record is displayed as thumb

dsPreviewIconThumb = 1 will use predefined thumb size (56x56)

dsPreviewIconThumb = [width]x[height] will resize it to given size.

Example:

mod.web_txtemplavoilaplusCenter.dsPreviewIconThumb = 120x80

Default

Property

toPreviewIconThumb

Data type

string

Description

If set, the previewIcon for TO record is displayed as thumb

toPreviewIconThumb = 1 will use predefined thumb size (56x56)

toPreviewIconThumb = [width]x[height] will resize it to given size.

Example:

mod.web_txtemplavoilaplusCenter.toPreviewIconThumb = 120x80

Default

Property

newTVsiteTemplate

Data type

string

Description

Path to the xml template for the “New Site Wizard”. The original used xml template is located in mod2/new_tv_site.xml,