System requirements
TYPO3 Version 4.2. or higher
Extension: dam Version 1.1.xx
Extension: dam_index Version 1.1.0 or higher
Extension: file_upload Version 1.1.0 or higher
static_info_tables Version 2.1.0 or higher
Php Version 5 or higher (due to TYPO3 4.2)
Tested with TYPO3 Version 4.2.6 and DAM 1.1.1
Installation process
This extension is not a “plug & play” extension. Please do every single step, to prevent a failure.
Take care that the dam extension is installed and works.
Install the extension dam_frontend via the extension manager
Include the static templates
Select template in the left main menue
Select the page with your main template (normally your startpage)
Click at “Click here to edit template record
Include the static templates: DAM Frontend Static TemplateDAM Frontend Fileliste
Now the extension should work.
The plugin “DAM Frontend Filelist” can be used very easily. Just place it at the page you like.
The plugin “DAM Fronend” has to be placed at least three times, with different views. You need at least the views: category tree, filelist and single view to have the descripted functionality.
All files will be delivered through a push file (pushfile.php). This file checks all categories a file belongs to. If there is a category where the user has no access right, the file won't be delivered.
To secure your fileadmin folder (or a subfolder of your taste), place file named .htaccess in this folder. Then write the following lines in the file:
Order deny,allow
Deny from all
These two lines will prevent unauthorized access to the files.
But be carefull: There can be problems, if you have some direct links to your fileadmin folder. E.G. stylesheet. Also can't file in protected folders be previewed in the backend, cause the backend uses a direct link.
plugin dam_frontend
The access model of the DAM_Frontend plugin is built on categories. You can assign groups for Read Access, Download Access and Upload Access.
If there is no group assigned to category, then all files, which use this category can be accessed. If there are more then one groups are assigned to a category, a user must be member of both groups to have access to the file.
Additional access right can be set in the dam record too.
Via typoscript you can restrict the file access additionaly. If you set the option
plugin.tx_damfrontend_pi1.filelist.security_options.showOnlyFilesWithPermission=1
then only files with permissions (in the dam record) are shown.
plugin dam_frontend_filelist
File are permission at the dam record are checked, but no category permission. So the editor has to take care of, what files are used for the frontend.
This section shows you possible classes to build up your own stylesheet. There two ways to use your own sylesheet. Disable the default CSS Style via TypoScript or don't use the static template (then you have to include the necessary typoscript by your own (see also section configuration).
Plugin DAM Frontend
Category tree:
.cattree td
.cattree img
.cattree td a img
a:link,
a:visited
.cattree td a
.cattree div.control
.tree_selectedCats
.tree_unselectedCats
Advanced Categorytree
treeBgWhite / treeBgGrey → div classes for the whole line acts as background
checkbox_grey / checkbox_green / checkbox_white → checkbox for the status: partly checked / checked and not checked
tree_open / tree_close: Settings to open / close the tree
Filelist
table.filelist
table.filelist td img
table.filelist td
table.filelist th
table.filelist td a img
Single view
table.file_singleView
table.file_singleView th
table.file_singleView td
table.file_singleView td.title
Category list
.delete_button a:link,
.delete_button a:visited
.delete_button a:hover
ul.foldout
ul.foldout li
Result list/
ul#browseresultlist
ul#browseresultlist li
Plugin DAM Frontend Filelist
li.ddl_file_list_item
dt.ddl_title
dd.ddl_description p
dd.ddl_description
div#content img
div .tx-damfrontend-pi2 a:link, a:visited
Nothing is displayed?Please check if you included the default typoscript in your typoscript template.
The extension seems to not work correct?: A: If you think the extension does not work, please check first the system log. If you find there parameter errors, you have to check your database structure (DAM records).