Skip to content

Commit 8b1d513

Browse files
committed
Update Panel files guide
1 parent 821e8be commit 8b1d513

File tree

1 file changed

+24
-7
lines changed
  • content/docs/1_guide/5_files/2_files-in-the-panel

1 file changed

+24
-7
lines changed

content/docs/1_guide/5_files/2_files-in-the-panel/guide.txt

+24-7
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Title: Files in the Panel
33
----
44
Text:
55

6-
## Uploading files via the Panel
6+
## Managing files in the Panel
77

88
Files can be uploaded to a page, the site or a user via the Panel using one of the following methods:
99

@@ -13,16 +13,33 @@ Files can be uploaded to a page, the site or a user via the Panel using one of t
1313

1414
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:
1515

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!
1721
(image: files-section.png)
1822

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

2127
(image: files-field.png)
2228

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

2533
(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
2643

2744
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.
2845

@@ -36,9 +53,9 @@ The upload dialog allows you to preview and edit the filenames of the files to u
3653
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.
3754
</since>
3855

39-
## Meta data blueprints for the Panel
56+
## File blueprints
4057

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`.
4259

4360
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.
4461

@@ -65,7 +82,7 @@ fields:
6582
type: textarea
6683
```
6784

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)
6986

7087
<since v="4.0.0">
7188
## Change file template

0 commit comments

Comments
 (0)