DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: Rename Form-Field-Label via PageTS

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed:2007-09-18T18:04:48
Author:Malte Jansen
Email:m a i l ( a t ) m a l t e j a n s e n . d e
Info 3:
Info 4:

EXT: Rename Form-Field-Label via PageTS

Extension Key: maja_labelrename

Documentation for Version: 0.0.4

Copyright 2007, Malte Jansen, <m a i l ( a t ) m a l t e j a n s e n . d e>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents

EXT: Rename Form-Field-Label via PageTS 1

Introduction 1

What does it do? 1

Users manual 1

Reasons for the usage of this Extension: 1

Priorities of the different Label-Inputs: 1

Hint (for Typo3 4.1.x) 1

Configuration 2

Direct Renaming (Fields) 2

Table Renaming (Fields) 2

Localconf Replacing (Fields, Items & Div-Tabs) [beta Version] 2

Examples 3

Known problems 3

To-Do list 3

Changelog 3

Introduction

What does it do?

Adds the support for renaming/overriding the field-label via TCEFORM in PageTS.

Users manual

Reasons for the usage of this Extension:

  • With the extension you can use one extension or table for several purposes, which is not possible with one label-value. Now you can have a one label per System-Page.
  • You do not have to change anymore the locallang_db.xml or locallang_db.php for renaming a field. So it is pretty easy to update extensions without overwriting your labels in the Locallang.

Priorities of the different Label-Inputs:

(From high to low)

  • page:TCEFORM.[table].[field]->TCEFORM_confObj
    
  • page:TCEFORM.[table]->TCEFORM_table
    
  • page:TCEFORMS.LOCALLANG.[number]->LOCALLANG_conf [beta Version]
    
  • $TCA[$table]["type"]
    
  • $TCA[$table]["columns"][$column]["label"]
    

Hint (for Typo3 4.1.x)

If you add the dependencies of this extensions to your extension with the Locallang. This Extension will be installed automatically, when you install your extension. So you cannot forget this extension. ;-)

Configuration

This Documentation is should be used together with the “doc_core_tsconfig”. All Properties belong to chapter “Page TSconfig”

Direct Renaming (Fields)

This is the easiest way to use this extension.

->TCEFORM_confObj
  • Additional properties for the TCEFORM configuration object (all properties see EXT:doc_core_tsconfig).
  • TCEFORM.[table].[field] -> TCEFORM_confObj
label

Property

label

Data type

Value

Description

A label can be any value or declare a Locallang-Label

Default

[page:TCEFORM.(tablename).(field)]

Examples
TCEFORM.[table].[field].label = New Label

Create your own small extension (e.g. with the Kickstarter) with one or more locallang-files.

TCEFORM.[table].[field].label = LLL:EXT:your_extension/locallang_db.xml:table.field

Table Renaming (Fields)

This is the comfortable way to replace a whole Locallang. You can also rename fields like “hidden”.

->TCEFORM_tableConf

Additional properties for the TCEFORM configuration object (all properties see EXT:doc_core_tsconfig).

TCEFORM.[table] -> TCEFORM_tableConf

locallang

Property

locallang

Data type

Value

Description

Must be a declaration of a Locallang-Label. This function overwrites every Field-Label starting with “LLL:EXT:”, so you can also rename fields like “hidden” etc.

Notice: You cannot replace Item- and Div-Labels.

Default

[page:TCEFORM.(tablename)]

Examples
TCEFORM.[table].locallang= LLL:EXT:your_extension/locallang_db.xml

Localconf Replacing (Fields, Items & Div-Tabs) [beta Version]

The is the comfortable way to replace a whole Locallang. You can also rename fields like “hidden”.

The function is using a XCLASS, so be aware that there could be some trouble, if there is another XCLASS for the “t3lib_TCEforms”

->TCEFORM

Additional properties for the TCEFORM configuration object

LOCALLANG.[number]

Property

LOCALLANG.[number]

Data type

Value,

->LOCALANG

Description

Extra configuration for the whole Locallang in the TCEforms.

The Value must be a declaration of a Locallang--File.

The [number] must be replaced by any integer.So you can compare the LOCALLANG-Object with the COA-Object.

Default

[page:TCEFORM]

->LOCALLANG

The first property is “replace” a whole file, but there are other possibilities like wrapping field after processing with filter. If your have a wish or idea what you can do with the Field-Label, write a mail to me.

replace

Property

replace

Data type

Value

Description

The Value must be a declaration of a Locallang-File.

If a label/item is not set in the new Locallang-File, the old one is used.

Default

[page:TCEFORM.LOCALLANG.(number)]

Examples
LOCALLANG.1 = LLL:EXT:any_extension/locallang_db.xml
LOCALLANG.1.replace = LLL:EXT:my_extension/locallang_db.xml
LOCALLANG.2 = LLL:EXT:any_extension/locallang_db2.xml
LOCALLANG.2.replace = LLL:EXT:my_extension/locallang_db2.xml

Examples

See Configuration.

Known problems

There should be no problems.

To-Do list

None

Changelog

Version 0.0.4

Added: Replacing a whole Locallang-File with Items and Div-Tabs for one Page via TS.

Version 0.0.3

Added: Replacing a whole Locallang-File for one Page via TS.

Version 0.0.2

Added this documentation.

Version 0.0.1

Created extension

img-1 EXT: Rename Form-Field-Label via PageTS - 3