Working with files¶
- Working with files
- List view
- Uploading files
- Indexing files
You can browse through the file tree using the module Media -> File. You will see a file browser column and a list of files in the main view.
The Media -> File module gives you access to three views:
The default view (list view) shows you the filename, type, date, size and file rights.
You can adjust the number of files you want to see on a single page (20, 50, 100, 200) and there are several options available to change the display of the file list.
You can perform various actions on a media record by clicking one of the icons to the right. Depending on the file type and file rights, some icons may be 'grayed out'.
Edit meta data¶
Editing a media record brings up a form in which you can add all the meta data you want to a record. This form is spread over several tabs.
General information can be added here like title, description, keywords, location, category etc.
The field Title is primarily used in the backend. It will be shown in the Media->List module and in the Element browser. To get your media items displayed in a meaningfull (alphabetical) order for a portrait of Albus Dumbledore we suggest a title like Dumbledore Alfred.
A note on filenames and Title: When you upload a file, the autoindexing feature of DAM will try to make a title out of the filename. In that process, the underscore (_) will be replaced by a blank space. So, if you want to save time here, name your file
The field Caption is intended for frontend output, for a portrait of Dumbldore this would be "Prof. Dr. Alfred Dumbledore".
The field called Source/Original location can be used to store the location of the original file. For example a photo CD name like 'Groovy Photos CD 3'.
The usage of the field Ident key highly depends on what you are doing on your website. The abbreviation SKU you find here means stock keeping unit. Two possible examples:
- In case you offer eBooks on your website, the ISBN number could go here.
- In case you display images of your products, the product number would be a choice.
The extra data is used by the extension cc_metaexif to store EXIF information present in some image files.
Show the file¶
Download or view the file in a new window.
Edit the file¶
Edit the file in an editor (if there is an editor available for this filetype). If the file is in a text format, an editor will allow you to directly edit the file.
Display information about record¶
This view is the same as the 'edit meta data' view. The only difference is that here you are only allowed to view the information and not edit it.
Rename the file¶
You can rename your file. You can change the title of the file, the filename and the download name.
Replace the file¶
You can replace the file with another file. The file meta data will be automatically updated.
Delete the file¶
When clicking the delete icon, you will be presented with a dialog that asks for your confirmation.
This dialog will show you if and where the record is used.
Deleting a file will remove the file and all meta data associated to it. So be sure to read this dialog carefully before you delete any file.
You can delete, copy and move more than one file at once by enabling 'batch edit options' in the 'options' menu. When you enable batch edit options, a checkbox appears at the beginning of every media record. You can select files by checking the checkboxes or you can click the check icon at the lower right to check or uncheck all.
By clicking the icon, you can check or uncheck all checkboxes at once.
After choosing the files you want to perform a command on you need to choose a command.
You can also specify if you want the command to be executed for all the files in the list or only the files you have selected.
In case you chose the 'move' or the 'copy' command, you will need to specify a target directory.
And after you have chosen a target directory, you will be asked to confirm your command.
Be careful when batch delteing files! A warning about references to the records is not yet given. If you want to know where your media record is used, use the normal delete operation, not the batch deletion operation.
Uploading files is pretty straight forward. It works the same as in the old Web->File module.
After uploading your file, it will be automatically indexed. After upload you are given the posibillity to add / change meta data by 'processing' uploaded files. This is usefull if you have just batch uploaded a lot of pictures from a certain holiday trip you all want to have the same category for example.
If you use DAM with TYPO3 4.3, you can use the new Flash uploader to upload more than one file at once. You can enable the Flash uploader in your user settings under “Edit & Advanced functions”. After enabling the Flash uploader, you can use it by clicking the button in the docheader.
The dam media browser can only see files that have been indexed. This means you can only use 'already indexed' files in your content.Indexing features:
- mass indexing of files and folder
- apply rules while indexing (eg. assign category from folder name)
- preset meta data before indexing
- set preset meta data not to be overwritten while indexing
- save index setup as preset
If you upload files using Media->File->Upload, those files will be indexed automatically. After upload you can add more metadata to the files by 'processing' them.
There are several cases in which you need (or want) to manually index files.
Fresh DAM installation with existing files¶
If you already have a lot of files on your system however, you will have to manually index those files.
Files not added using upload feature¶
Files not added to the filesystem using DAM upload will not be auto indexed. Files may be added to the fileadmin uing FTP or certain directories in the fileadmin may be 'mounts' from filesystems on other machines. Files added without TYPO3 knowing about them will not be indexed automatically.
NOTE! Take care when using remote filesystems for storing files used in DAM. Adding files is fine, but removing files is not yet detected.
If you do add files outside of TYPO3's knowledge, you may be interested in the dam_cron extension.
A new metadata extension has been installed¶
After installing a new metadata extension, you may want to re-index all your files so the new extension can extract new valuable metadata from your files and add that data to the existing record.
New indexing run¶
- Go to Media->File->Indexing (or Media->Indexing)
- Select the folder that contains the files you want to index and click Next
Options¶In step 2 you can configure the indexing run:
- Index subfolers
- Use folder names as categories: this is usefull when indexing a structured file tree into DAM
- Re-index: only missing metadata is added
- Dry run
Indexing field predefinition¶
If you do not want certain fields to be extracted from the media, you can predefine those values here. Check the box for the fields you want set fixed. You can add more fields to this form by adding the field names to $TCA['tx_dam']['txdamInterface']['index_fieldList'] you can do this in /typo3conf/extTables.php. If you would also like to set the user group directly when indexing, add the following line to your /typo3conf/extTables.php file:
$TCA['tx_dam']['txdamInterface']['index_fieldList'] .= ',fe_group';
Indexing setup summary¶