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: dam_ttnews¶

Author:	Kasper Skårhøj
Created:	2002-11-01T00:32:00
Changed:	2011-03-11T16:04:33.450000000
Author:	Erich Bircher
Email:	typo3@internetgalerie.ch
Info 3:
Info 4:

EXT: dam_ttnews¶

Extension Key: dam_ttnews

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: dam_ttnews 1

Introduction 1

Users manual 1

Configuration 1

Update 2

Set image caption, alt text and title tag values 3

Known problems 3

Todo 3

Changelog 3

Introduction¶

What does it do?¶

Adds DAM support for the image and the media fields in tt_news records
Update script for migration of existing (non-DAM) tt_news records
Fully configurable with tt_news typoscript properties
Mode switch, which allows to output image captions, title tag and alt text directly from DAM meta data.

Users manual¶

install DAM package
install extension
add Static Extension Template
configure extension

Configuration¶

Configuration via Extension Manager:

DAM Media Field: If this is set, the Image and the Media Field of a News record will be replaced by a DAM-Field

Original Media Field: If this is set, the original media fields will also be displayed. Can be used for migration to the new media fields.

Configuration via Constant Editor:

Withplugin.dam_ttnews.modea mode can be set that influences, which values for the image captions, image alt texts and image titles are set for image output.

mode = 0 : Image captions, image alt text and image title tag are set from the fields in the tt_news record

mode = 1 : If values are set in the tt_news record fields, they are used, otherwise values from DAM meta data are used

mode = 2 : Image captions, image alt text and image title tag are set directly from the according meta data fields in the selected DAM record, ignoring the fields of the tt_news record.

Configuration of the output of news files :

This can be done via standart tt_news newsfiles typoscript configuration (see tt_news manual).

((generated))¶

Example¶

plugin.tt_news.newsFiles {

stdWrap.wrap = <dd>|</dd>

labelStdWrap.cObject = TEXT

labelStdWrap.cObject.field = title

wrap =  <b>|</b> 

target = _blank

icon = 1

icon_link = 1

size = 1

size.bytes = 1

size.bytes.labels = Byte| KB| MB| GB

size.wrap = (|)

}

Configuration of news images :

The extension supports standard typoscript configuration of tt_news image configuration (see tt_news manual) and also thel10n_mode_imageExcludesetting in the tt_news extension configuration.

Reference¶

- Reference (TypoScript)

mode¶

Property

mode

Data type

integer

Description

Sets mode for the source of the image caption, image alt text and the image title tag. 0=take from news record 1=If empty take from DAM 2=Take from DAM

Default

0

Update¶

Migration from normal media fields to DAM fields¶

If dam_ttnews gets freshly installed on a typo3 site with existing tt_news records, the image and file entries get lost. If there are just a few then the old image and media field can be displayed via the extension manager configuration settings of dam_ttnews ( Original Media Field ). Now the image and file references can be added manually.

If there are a lot of tt_news entries, there is a script which allows to import the references to the new DAM fields.

To use the script go to the extension manager and select damtt_news. If there are image or file references in the standard fields, which are not yet migrated, then it is possible to select the “UPDATE!” command in the pulldown selector on top of the extension manager. After selecting “UPDATE!” a list with all “lost” image and file references is dispplayed and can be individually selected to be migrated.

Update from old dam_ttnews versions to dam_ttnews versions >= 0.1.12¶

In old dam_ttnews versions the display configuration of the news files had to be made over the plugin.dam_ttnews configuration array. In versions 0.1.12 and above the extensions takes the configuration array directly from tt_news. Thus all configuration has to be changed to the tt_news array and the new static template of dam_ttnews has to be added in the template.

example:

old dam_ttnews typoscript code (<0.1.12):

plugin.dam_ttnews.newsFiles.icon= 1

new typoscript code (>=0.1.12):

plugin.tt_news.newsFiles .icon = 1

Set image caption, alt text and title tag values¶

There are different possibilites to set the values for the image captions, alt texts and title tags.

It can be done by entering text directly in the according fields in tt_news. (plugin.dam_ttnews.mode has to be 0 or 1)
If DAM record contains meta data, this texts can be selected and copied to the desiered news fields with the help of the “DAM Information “ field inside the tt_news record form. (plugin.dam_ttnews.mode has to be 0 or 1)
If tt_news field values are set (not empty), they can be displayed, otherwise values form DAM meta data are taken (plugin.dam_ttnews.mode = 1)
Values are taken directly from DAM meta data ( plugin.dam_ttnews.mode = 2)

If image alttext and image title text fields do not appear, you have to select the “Show secondary options (palettes)” checkbox at the bottom of a news record.

Known problems¶

none

Todo¶

Optionsplitand full tt_news Version 3 support

Changelog¶

Version 0.1.12

support of noImage_stdWrap
support of same i10n modes like tt_news (exclude and mergeIfNotBlank for images and mergeIfNotBlank for files)
support of translated DAM meta data.
configure extension with tt_news typoscript properties
possibilities to set mode for image captions, alt text and title tag to get values either from tt_news fields or from DAM
added manual

EXT: dam_ttnews - 3