Reference¶
TSconfig
- tx_imagewidthspecificationwizard.
Property
hideFieldOnMatch
Data type
Boolean
Description
If true, the field »imagewidth« will be hidden from the backend as soon as the editor selects one of the default values
The field will reappear if the editor selects the option “Customized width” (or whatever label is set in property »ownValueLabel«)
Note:
This property will be true automatically if »ownValueDisabled« is true.
Default
1
Property
noValueDisabled
Data type
Boolean
Description
Removes the select field option to leave the field »imagewidth« empty.
Note:
Please keep in mind that this extension does not check the fields content, it removes the select field option only. So if you want to disallow an empty
field »imagewidth« and force the editor to select a value, then you will have to set the property »ownValueDisabled« to true as well.
Default
0
Property
ownValueDisabled
Data type
Boolean
Description
If true, the editor won’t be able to enter an individual value into the field »imagewidth«
Default
0
Property
noValueLabel
Data type
String
Description
Description for the option in the select field to clear the field »imagewidth«
Note:
With no width given the dimensions of the image will be calculated by TYPO3 automatically and the image won’t scale as long it is smaller than the maximum size set in TypoScript option »tt_content.image.20.maxW« (see css_styled_content)
Hint:
If the string is a reference to locallang label, then the extension will try to use that translation. The reference must consists of [fileref]:[labelkey], like:
LLL:fileadmin/templates/locallang.xml:noValueLabel
Default
LLL:EXT:imagewidthspecificationwizard/Resources/Private/Language/ locallang.xlf:tt_content.tx_imagewidthspecificationwizard.noValueLabel
Property
ownValueLabel
Data type
String
Description
Description for the option to choose an individual value
Default
LLL:EXT:imagewidthspecificationwizard/Resources/Private/Language/ locallang.xlf:tt_content.tx_imagewidthspecificationwizard.ownValueLabel
Property
sizes.[size]
Data type
Array
Description
Configure all available default sizes of the wizard
Syntax:
[size] = [description]
Example:
tx_imagewidthspecificationwizard {
sizes {
80 = Small image
160 = Medium image
420 = Large image
}
}
All descriptions can be a locallang reference, see »noValueLabel«
Default
(None)
Example¶
Example configuration for three default sizes:
tx_imagewidthspecificationwizard {
ownValueLabel = Enter an individual value
sizes {
75 = 75px - Teaser
120 = 120px - One third of the content
360 = 360px - Full content
}
}
Setting a default imagesize¶
If you want to set a default imagesize, then just use the TSconfig TLO TCAdefaults. Add this line to your user or page TSconfig to set a default size of 180 pixel:
TCAdefaults.tt_content.imagewidth = 180
If you have configured the wizard for new content element, then you might have to overwrite it’s settings like this:
mod.wizards.newContentElement.wizardItems.common.elements.textpic.tt_content_defValues.imagewidth = 180
templavoila.wizards.newContentElement.wizardItems.common.elements.textpic.tt_content_defValues.imagewidth = 180
mod.wizards.newContentElement.wizardItems.common.elements.image.tt_content_defValues.imagewidth = 180
templavoila.wizards.newContentElement.wizardItems.common.elements.image.tt_content_defValues.imagewidth = 180
In case you would like to force the editor to select a size out of your given values only, then you could use this configuration:
tx_imagewidthspecificationwizard {
noValueDisabled = 1
ownValueDisabled = 1
sizes {
75 = 75px - Teaser
120 = 120px - One third of the content
360 = 360px - Full content
}
}
TCAdefaults.tt_content.imagewidth = 120