Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source Magazine

1.4. Adminstration

Installation

System requirements

  1. TYPO3 Version 4.2. or higher

  2. Extension: dam Version 1.1.xx

  3. Extension: dam_index Version 1.1.0 or higher

  4. Extension: file_upload Version 1.1.0 or higher

  5. static_info_tables Version 2.1.0 or higher

  6. 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.

  1. Take care that the dam extension is installed and works.

  2. Install the extension dam_frontend via the extension manager

  3. Include the static templates

  1. Select template in the left main menue

  2. Select the page with your main template (normally your startpage)

  3. Click at “Click here to edit template record

  4. 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.

Protecting files in fileadmin

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.

Permission model

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.

CSS Style

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

  1. Category tree:

  2. .cattree td

  3. .cattree img

  4. .cattree td a img

  5. a:link,

  6. a:visited

  7. .cattree td a  

  8. .cattree div.control

  9. .tree_selectedCats

  10. .tree_unselectedCats

  11. Advanced Categorytree

  12. treeBgWhite / treeBgGrey → div classes for the whole line acts as background

  13. checkbox_grey / checkbox_green / checkbox_white → checkbox for the status: partly checked / checked and not checked

  14. tree_open / tree_close: Settings to open / close the tree

  15. Filelist

  16. table.filelist

  17. table.filelist td img

  18. table.filelist td

  19. table.filelist th

  20. table.filelist td a img

  21. Single view

  22. table.file_singleView

  23. table.file_singleView th

  24. table.file_singleView td

  25. table.file_singleView td.title

  26. Category list

  27. .delete_button a:link,

  28. .delete_button a:visited

  29. .delete_button a:hover

  30. ul.foldout

  31. ul.foldout li

  32. Result list/

  33. ul#browseresultlist

  34. ul#browseresultlist li

Plugin DAM Frontend Filelist

  1. li.ddl_file_list_item

  2. dt.ddl_title

  3. dd.ddl_description p

  4. dd.ddl_description

  5. div#content img

  6. div .tx-damfrontend-pi2 a:link, a:visited

FAQ

  1. Nothing is displayed?Please check if you included the default typoscript in your typoscript template.

  2. 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).