Platinum sponsors
This is the default configuration for this plugin.
includeLibs.tx_damfilelinks = EXT:dam_filelinks/class.tx_damfilelinks.php
tt_content.uploads.20{dam=USER
dam{userFunc=tx_damfilelinks->getMedia
use=1
damIdentField=tx_damfilelinks_filelinks
damFieldFirst=1
damTitle=file_name,title
damSize=file_size
damFileName=file_name
damFilePath=file_path
damDescription=description
damDescription.overrideOriginalDescription=0
additional=yes
additionalField=media
additionalPath=uploads/media/
additionalDescription=imagecaption
additionalDescription_ifElementEmpty < tt_content.uploads.20.description_ifElementEmpty
sys_language_mode=normal
}
}
properties:
tt_content.uploads.20.userFunc and tt_content.uploads.20.use are not needed after version 0.3.0 and can be removed.
With:
damTitle=file_name,title
damSize=file_size
damFileName=file_name
damFilePath=file_path
damDescription=description
can you set in which tx_dam fields are the title, size, filename, path and description are stored. If you enter more then one field(e.g. "...damTitle=file_name,title"), the last non-empty field is used.
With:
additional=yes
additionalField=media
additionalPath=uploads/media/
additionalDescription=imagecaption
can you define if the original field should be used and if yes which field is it and which path have the files stored in this field. The property additional can have this options: yes,none.
The additionalDescription define in which field is the default description saved.(see the picture abowe)
You can define in damDescription fields in there the description from dam is stored. If the additionalDescription for a file is empty the damDescription field will be used. So the additionalDescription has default bigger priority. If you want to change the priority – so that the damDescription field will be used and the additionalDescription field will be used only if the damDescription field is empty you can do that with this typoscript:
tt_content.uploads.20.dam.damDescription.overrideOriginalDescription=1
If the damDescription field is empty and the additionalDescription field is empty the additionalDescription_ifElementEmpty property will be used. For more informations about additionalDescription_ifElementEmpty property see the manual to “CSS styled Filelinks - description_ifElementEmpty”.
(To use the damDescription property you need at least CSS styled Filelinks v. 0.0.10)
(To use the additionalDescription_ifElementEmpty property you need at least CSS styled Filelinks v. 0.1.4)
The property:
use=1
should be always 1. It is necessary for the CSS styled Filelinks extension. If you set this to 0 the dam will not be used(this property is not needed after version 0.3.0).
If the additional property is set to yes with the property:
damFieldFirst=1
can you set the order from original files and dam files in frontend. If this option is set to 1 the original fields will be placed after the dam files. To use this property you need at least CSS styled Filelinks v. 0.0.9.
With user defined placeholders can you assign tx_dam fields to markers from css_filelinks.
tt_content.uploads.20.layout{userMarker{dam{FILECREATE=date_cr,date_mod
FILECREATE.stdWrap=1
FILECREATE.stdWrap.date=d.m.Y – H:i
AUTOR=autor
}
}
}
layout.userMarker.dam.USRMARKER = tx_dam table field names separed by ','
You can use stdWrap properties. To activate this you must add stdWrap=1 at first to the marker.(See FILECREATE definition.)
More about the use from dam userMarker can you find in CSS styled Filelinks manual.
The only thing the user has to do is to set the damIdentField to his templavoila-fieldname and add
<TypoScript>
10<tt_content.uploads.20
10.dam.damIdentField = field_name
</TypoScript>
to his FCE definition.
with this option:
tt_content.uploads.20.dam.sys_language_mode=
can you select how this extension handle multilanguage DAM elements. There are this posible values
value | description |
|---|---|
disabled | The extension will always show elements in default language. You can use this option if you don't need multilanguage support for DAM elements and you will save process time needet to find translations to shown elements. By this setting the extension will not search for localisations. |
normal | The extension will shown all records. If a record is translated the translation will be shown. |
strict | This extension will shown only records in actual language. All records there don't have translation will not be shown. |
Into this field can you enter a directory and all files from this directory will be shown so you don't need to add eachfile separately. This field can belong to the DAM field or to the normal Field. If you enter a directory into this field the files inserted to field to which the “Read from path” belong will be ignored.
The value can be exploded by "|" into parameters:
1: The path. You can use * symbol as replacement for one or more characters.
2: comma-list of allowed extensions (no spaces between); if empty all extensions goes.
3: sorting: name, size, ext, date
4: reverse: Set to "r" if you want a reversed sorting
Example:
Example | Result |
|---|---|
“fileadmin/myOrder/|jpg,gif,png|name|r” | all jpg,gif and png files from fileadmin/myOrder directory sorted by name reverse. |
“fileadmin/*|jpg,gif,png|name|r” | all jpg, gif and png files from fileadmin directory and all subdirectories from fileadmin sorted by name reverse. |
