.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================ 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: EXT: dam\_ttnews ================ Extension Key: **dam\_ttnews** Copyright 2006-2011, Erich Bircher, 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: 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: Introduction ------------ .. _What-does-it-do: 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: Users manual ------------ - install DAM package - install extension - add Static Extension Template - configure extension .. _Configuration: 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: ((generated)) ^^^^^^^^^^^^^ .. _generated: ((generated)) """"""""""""" .. _Example: **Example** ~~~~~~~~~~~ plugin.tt\_news.newsFiles { stdWrap.wrap =
\|
labelStdWrap.cObject = TEXT labelStdWrap.cObject.field = title wrap =  \|  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 ^^^^^^^^^ \- Reference (TypoScript) .. ### BEGIN~OF~TABLE ### .. _mode: mode """" .. container:: table-row 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 .. ###### END~OF~TABLE ###### .. _Update: Update ------ .. _Migration-from-normal-media-fields-to-DAM-fields: 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: **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: 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: Known problems -------------- none .. _Todo: Todo ---- Optionsplitand full tt\_news Version 3 support .. _Changelog: 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 |img-1| EXT: dam\_ttnews - 3 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102