.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ======================== DAM for Content Elements ======================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Lorenz Ulrich :Changed: 2012-07-20T22:19:14.810000000 :Author: The DAM development team :Email: typo3-project-dam@lists.netfielders.de :Info 3: :Info 4: .. _DAM-for-Content-Elements: DAM for Content Elements ======================== Extension Key: **dam\_ttcontent** Copyright 2003-2012, The DAM development team, 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 ----------------- **DAM for Content Elements 1** **Introduction 1** **Installation 1** **Reference usage 1** **Captions 2** .. _Introduction: Introduction ------------ This extension provides some functionality for the default content elements (tt\_content). While generally new content elements should be developed to support the DAM features, this extension can help to use a few features of DAM with the default content elements. .. _Installation: Installation ------------ The extension manager shows several options during installation. All options should be self explanatory. For more informations of the provided functionality have a look in the following sections. .. _Reference-usage: Reference usage --------------- The DAM system allows to use file references instead of the normal copy mechanism TYPO3 uses to bind files to content elements. The extension *Content/DAM reference usage* (dam\_ttcontent) is an **example** for that functionality. The extension provide the reference functionality for image files for the content elements *Image* and *Text w/image* . This is done by adding a field to these elements that allow to insert images as reference. |img-1| For frontend rendering this extension just add some TypoScript to the content elements rendering setup which passes the filenames to the rendering code. .. _Administration: Administration ^^^^^^^^^^^^^^ The extension just add a field in TCA and add some TypoScript setup to fetch the filenames for that field and pass it to the TS rendering setup. The rendering itself is not done by this extension. Therefore the principle can be adopted to all other content elements or plugin records. Important: When you use another extension which changes/replaces the image rendering already this solution might break the rendering so you have to adopt the TypoScript setup for the rendering setup. See ext\_localconf.php for a functionality sample. .. _Captions: Captions -------- When css\_styled\_content is used for rendering, this extension can change the rendering so caption and alt text's can be fetched from DAM for the content elements Image and Text w/image. The option 'Alternative CSS Styled Rendering' needs to be enabled while extension installation to activate this function. The default behavior is changed a little bit to provide such a functionality. Normally caption rendering don't have to be activated, because no caption will be rendered when no content is set (the caption field is empty). With DAM there's almost always a caption, so an option to disable caption rendering is needed. This is done by extending the *Align* field with the option *Hidden* . To make this option more visible the *Align* field, as secondary option, is configured to be visible always now. The fields for caption, alternative text and title text can be used to set default values which will be displayed for an item if no data is available from DAM. .. _img-2-Administration: |img-2| Administration ^^^^^^^^^^^^^^^^^^^^^^ To enable the rendering with DAM data the static template 'DAM: CSS Styled Content' needs to be activated in a template record. The TypoScript setup from this template has following behavior: - If “DAM images, captions” is activated in the Constant Editor, each image has the value of the DAM caption field with fallback to the DAM description field as caption. - If “DAM images, captions” is disabled, the value from the Captions field in the content record is used – one line per image. This is configured by TypoScript an can be overridden. See pi\_cssstyledcontent/setup.txt for the defaults. |img-3| DAM for Content Elements - 3 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 178 .. :id: Grafik1 .. :name: Grafik1 .. :vspace: 19 .. :width: 379 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 265 .. :id: Grafik2 .. :name: Grafik2 .. :vspace: 19 .. :width: 263 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :vspace: 19 .. :width: 102