Usage

Input Options

In Image+ you could control the final size and aspect ratio of selected images. There are several extended input options available for an Image+ TV:

Target Height/Width

Images can be constrained to a minimal height and/or width with Target height and Target width. If both values are set, the target aspect ratio of the output image is calculated with this values. Both fields have to be filled with an integer value.

Target Aspect Ratio

The aspect ratio for the output image could be restricted with Target Aspect Ratio. If target height and target width are set, this value is ignored and the calculated aspect ratio of target height and target width is used. The field has to be filled with a float value.

If you set only one value of Target Height or Target Width and leave empty Target Aspect Ratio, the size of the crop is not restricted to any aspect ratio.

Show Alt Tag Field

Image+ TVs can also contain an Alt Tag Field, which is an additional text input, that is stored with each image. It could be output alongside the image i.e. as an alt-tag or title-tag.

In order to output the alt text in a Image+ TV placeholder, you will need to select an chunk in the Output Options. You could also use the ImagePlus snippet and specify a template chunk in the snippet call options. The alt text is filled in the placeholder [[+alt]] in that chunk.

Show Caption Field

Image+ TVs can also contain an Caption Field, which is an additional text input, that is stored with each image. It could be output beneath the image i.e. in an additional caption div.

In order to output the caption in a Image+ TV placeholder, you will need to select an chunk in the Output Options. You could also use the ImagePlus snippet and specify a template chunk in the snippet call options. The caption is filled in the placeholder [[+caption]] in that chunk.

Show Credits Field

Image+ TVs can also contain an Credits Field, which is an additional text input, that is stored with each image. It could be output beneath the image i.e. in an additional credits div.

In order to output the credits in a Image+ TV placeholder, you will need to select an chunk in the Output Options. You could also use the ImagePlus snippet and specify a template chunk in the snippet call options. The credits are filled in the placeholder [[+credits]] in that chunk.

Context/System Settings

Each Image+ TV Input Option could be superceded by a context setting or a system setting. And context/system settings for a single TV could be defined, too.

There are predefined system settings in the imageplus namespace, that are empty or equal zero. If you enable one or fill it with a value, this setting will supercede the Input Options of all Image+ TVs. Context settings have to be created before usage.

The global context/system settings have the prefix imageplus. and the single TV context/system settings have the prefix imageplus.{tvname}.. {tvname} has to be replaced by the name of the template variable.

The order for those settings is ¹

• TV name based context setting
• TV name based system setting
• context setting
• system setting

In the imageplus.select_config system setting, you could create predefined crop sizes/aspect ratios with a helper grid. To force use the predefined sizes/ratios, you could enable the imageplus.force_config system setting.

Output Options

There are several extended output options available for of an Image+ TV:

Additional phpThumb Parameters

As default an Image+ TV returns an relative URL to an cropped (and maybe constrained) image that is scaled by phpThumb. With this output option, you could assign several additional phpThumb parameters, that are used to generate the thumbnail image.

Output Chunk

If you select an Output Chunk the TV output is rendered with that chunk. Select the chunk name from the dropdown. Several placeholders are possible in that chunk to customize the output:

All these placeholders could be used in the Snippet too.

Generate Thumb URL

If you create the thumbnail in output chunk i.e. by a pthumb output filter, you could disable the generation of the internal thumb URL.

Snippet

The snippet gives you a second option to render the TV value. With the template variable output, you are restricted to one output chunk per template variable, with the snippet you could be more flexiple use different output chunks. The following properties could be set in the snippet call:

Example

[[ImagePlus?
&tvname=`imageplus`
&docid=`1`
&options=`w=100`
&type=`tpl`
&tpl=`ImagePlus.demo`
]]

This snippet call outputs the content of the template variable with the name imageplus of resource 1 and the extended phpThumb option &w=100 (width: 100px) in the parsed ImagePlus.demo chunk.