Project

General

Profile

RedmineAttachedFiles » History » Version 3

Etienne Massip, 2013-04-11 22:06

1 1 Mischa The Evil
h1. Redmine Attached Files
2
3
{{>toc}}
4
5
h2. Introduction
6
7 2 Mischa The Evil
Attached files can be added to different resources within the Redmine system:
8
* issues - using the [[RedmineAttachedFiles#Attach-files-form|"New File" form]] while adding/editing an issue
9
* documents - using the [[RedmineAttachedFiles#Attach-files-form|"New File" form]] while adding/editing a document
10
* forum messages - using the [[RedmineAttachedFiles#Attach-files-form|"New File" form]] while adding/editing a forum message
11
* wiki pages - using the [[RedmineAttachedFiles#Files-added-via-New-File|"New File" link]] at the bottom of the page
12 1 Mischa The Evil
13
h2. Usage
14
15
h3. Inline Images
16
17
Attached files can be shown within the parent page by targeting it's name via image url (i.e. @!attached_image!@).
18
19
h3. Non plain text files
20
21
Keep in mind there is a dedicated [[RedmineDocuments|documents]] module for storing technical and user documentation that can be linked via the [[RedmineWikis|wiki]] and a dedicated [[RedmineFiles|files]] module for publishing versions of the tracked project, as a bundle (release).
22
23
However, if that doesn't fit the bill, file upload support provides a way to distribute any file for user download.
24
25
h2. File storage
26
27 3 Etienne Massip
Uploaded attached files are stored in @<Redmine install dir>/files@ directory subdirectories named after the year the file has been uploaded.
28 1 Mischa The Evil
29
The uploaded file name is prefixed with a unique id based on it's parent for directory storage. Multiple files can be uploaded with the same name, however a link within the wiki will only show the most recently uploaded one.
30
31
h2. Attach files form
32
33
Regardless where an attached file is added, the input form is as shown below. Adding multiple attached files at once is possible using the "Add another file" link.
34
35
The optional description is used for an @alt@ text if the image is shown using @!image_url!@ within the parent.
36
37
!UploadFile.png!
38
39
h2. Files added via "New File"
40
41
At the bottom of many of the pages in Redmine is a "New File" link. Attaching a file makes that page the parent of the file and it is limited in scope to that page.
42
43
See the [[RedmineFiles#Usage|Usage]] section for more information.