This page is still a beta!

1.2. Site developer's manual

Meant for people developing TYPO3 websites. Does not require PHP knowledge.

Page / User TSconfig reference

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

tx_templavoila

Property:

Data type:

Description:

Default:

storagePid

integer

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

[tsconfig:tx_templavoila]

mod.web_txtemplavoilaM1

Property:

Data type:

Description:

Default:

createPageWizard.fieldNames

list

With this option you may specify a selection of field names of the pages table to be displayed in the create-new-page-wizard.

Example:

mod.web_txtemplavoilaM1.createPageWizard {

 fieldNames = hidden, title, author, description, abstract

}

This will create an editing form like this:

hidden, title, alias

enableDeleteIconForLocalElements

Integer

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

0

enableEditIconForRefElements

boolean

If set, you get edit icon for referenced content elements

Not set

sideBarEnable

boolean

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

TRUE

sideBarPosition

string

Defines the position of a toolbar within the TemplaVoila Page Module. Possible values: toptabs, toprows, left

toptabs  generates a toolbar on top of the page module's content with dynamic tabs which allow you to switch between the different option categories.

toprows also generates a toolbar on the top of the page, but uses rows which can be expanded and collapsed instead of tabs.

left instead creates a sidebar at left part of the page module. This sidebar may be shown and hidden by clicking at the little plus / minus sign at the upper right corner of the sidebar.

Note: The menu items which are available in this toolbar depend on the extensions you have installed as they provide the functionality.

toptabs

showTabsIfEmpty

boolean

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

FALSE

disableContainerElementLocalizationWarning

boolean

Container elements used with TemplaVoila 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.

FALSE

disableContainerElementLocalizationWarning_warningOnly

boolean

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 TemplaVoila 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).

FALSE

translationParadigm

string keyword

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.

disableDisplayMode

list of keywords

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

hideCopyForTranslation

boolean

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

Not set

recordDisplay_tables

list of table names

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.

Not set

recordDisplay_maxItems

integer

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.

10

recordDisplay_alternateBgColors

boolean

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

False

additionalDoktypesRenderToEditView

list of doktypes

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_txtemplavoilaM1 {
  additionalDoktypesRenderToEditView = 254
}

blindIcons

list of keywords

Following icons can be blinded:

new,edit,copy,cut,ref,paste,pasteAfter,pasteSubRef,browse,delete,makeLocal,unlink,hide

Example:

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

stylesheet

string

Alternative CSS stylesheet for the pagemodule. Path must be relative to the typo3-directory.

Example:

mod.web_txtemplavoilaM1 {
  stylesheet = ../fileadmin/css/tvpagemodule.css
}

javascript

Array

Additional javascript files for the pagemodule. Path must be relative to the typo3-directory.

Example:

mod.web_txtemplavoilaM1.javascript {
  file1 = ../fileadmin/templates/js/jquery.js
  file2 = ../fileadmin/templates/css/backend.js
}

useLiveWorkspaceForReferenceListUpdates

boolean

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

debug

boolean

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

[tsconfig:mod.web_txtemplavoilaM1]

mod.web_txtemplavoilaM2

Property:

Data type:

Description:

Default:

templatePath

List of directories

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

Example:

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

Templates

dsPreviewIconThumb

string

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_txtemplavoilaM2.dsPreviewIconThumb = 120x80

toPreviewIconThumb

string

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_txtemplavoilaM2.toPreviewIconThumb = 120x80

newTVsiteTemplate

string

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

Example: mod.web_txtemplavoilaM2.newTVsiteTemplate = fileadmin/my_new_tv_site.xml

hideNewSiteWizard

boolean

If set, the “New Site Wizard” won't be rendered

Not set

[tsconfig:mod.web_txtemplavoilaM2]

Plugin “pi1” attributes

Property:

Data type:

Description:

Default:

TSconst.[constant-name]

string

Defining constants for Data Structure constants. see “<T3Data Struction> extensions” section

dontInheritValueFromDefault

childTemplate

string

Keyword which is used to look for a child-template record.

By default “print” is a value you can set. This is also set automatically when “&print=1” is found in the URL

The value is matched with the content of “rendertype” so if you want other values than “print” to be available you simply add new items to that selector box and use conditions in the TypoScript Template to detect the circumstance that should set this value.

More explainations later

disableExplosivePreview

boolean

If set, the popup information boxes in the frontend will not appear in FE preview mode.

FALSE

disableErrorMessages

boolean

If set, no error messages will be displayed in the frontend.

Example:

plugin.tx_templavoila_pi1.disableErrorMessages = 1

FALSE

[tsref:plugins.tx_templavoila_pi1]