You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: content/docs/1_guide/5_files/2_files-in-the-panel/guide.txt
+24-7
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ Title: Files in the Panel
3
3
----
4
4
Text:
5
5
6
-
## Uploading files via the Panel
6
+
## Managing files in the Panel
7
7
8
8
Files can be uploaded to a page, the site or a user via the Panel using one of the following methods:
9
9
@@ -13,16 +13,33 @@ Files can be uploaded to a page, the site or a user via the Panel using one of t
13
13
14
14
Depending on the context, as an editor you then click the `Add` button in a pages section, or select the upload option from the dropdown in a files or textarea field:
15
15
16
-
### Files section
16
+
(tabs…)
17
+
18
+
=== Files section
19
+
20
+
A (link: docs/reference/panel/sections/files text: files section) helps you manage the files belonging to pages or the site: upload, delete, sort and replace. A files section does not store anything in your content file!
17
21
(image: files-section.png)
18
22
19
-
### Files field
23
+
=== Files field
24
+
25
+
A (link: docs/reference/panel/fields/files text: files field) allows you to select one or multiple files out the ones queried as options. The selected file references are stored in the content file of the model in which the field is used. The files field also offers the option to upload files.
20
26
21
27
(image: files-field.png)
22
28
23
-
### Textarea field
29
+
=== Textarea field
30
+
31
+
The (link: docs/reference/panel/fields/textarea#file-upload-and-select text: textarea field) has an upload option to quickly upload files you want to link to in your content.
24
32
25
33
(image: textarea-field.png)
34
+
(…tabs)
35
+
36
+
## Deleting files
37
+
38
+
Files can be deleted via the delete option in a files section, or via the file view.
39
+
40
+
Note that if you unselect a file in a **files field**, this file is not deleted from the parent model.
41
+
42
+
## File names
26
43
27
44
Kirby will convert the filename of your uploaded file to ASCII characters. This ensures that the filename is URL-safe and can be accessed correctly. After the conversion, the file will be checked against Kirby's internal validation rules as well as against custom rules that were defined in the blueprint. If the file validates, it will be uploaded.
28
45
@@ -36,9 +53,9 @@ The upload dialog allows you to preview and edit the filenames of the files to u
36
53
In your file blueprints, you can also set (link: docs/reference/panel/blueprints/file text: options for optimizing uploaded files). These options will be applied directly after upload, and they are a great way to avoid huge original files in the content folder.
37
54
</since>
38
55
39
-
## Meta data blueprints for the Panel
56
+
## File blueprints
40
57
41
-
Meta data fields for files to be used in the Panel are defined in (link: docs/reference/panel/blueprints/file text: file blueprints). They are stored in `/site/blueprints/files`.
58
+
Metadata fields for files to be used in the Panel are defined in (link: docs/reference/panel/blueprints/file text: file blueprints). They are stored in `/site/blueprints/files`.
42
59
43
60
Depending on whether you use a files section or one of the fields to upload files, the way how you assign a file blueprints to a file, differs slightly, see field/section links at the top of this page for details.
44
61
@@ -65,7 +82,7 @@ fields:
65
82
type: textarea
66
83
```
67
84
68
-
For details of creating a file blueprint, see the (link: docs/reference/panel/blueprints/file text: files blueprint options)
85
+
For details of creating a file blueprint, see the (link: docs/reference/panel/blueprints/file text: file blueprint options)
0 commit comments