Wiki source code of Upload

Show last authors
1 {{panel float="right"}}
2 (% class="block text-align-center%){{ficon name="XUpload" size="4em"/}}
3
4 (% class="block%)The icon for form elements of type //Upload//.
5 {{/panel}}
6
7 == Functionality ==
8
9 Form elements of type //Upload// add an upload element to the form for uploading files that will be send together with the form data when the form is submitted. You can also add a label in the properties panel [[//label//>>doc:Formcycle.Designer.Form.ElementProperties.Label]] of the {{designer/}}.
10
11 {{figure image="designer_element_upload_properties_base_en.png"}}
12 Additional base properties for upload elements, such as the image preview.
13 {{/figure}}
14
15 {{figure image="designer_element_upload_image_preview.png"}}
16 When the image preview is enabled and the user select an image, a thumbnail of that image is shown. When the user select a file other than an image, a general icon is shown.
17 {{/figure}}
18
19 {{internBaseOptionsElement page="base"}}
20 {{table dataTypeAlpha="0" colWidth="-500"}}
21 |=Name|=Description
22 |Image preview|When checked, displays a thumbnail of the file the user selected. For image files this is a scaled down version of that image. For other files, a file icon is shown.
23 |{{version major="7" minor="0" patch="11" /}} Automatic Upload|When enabled, selected files are uploaded automatically in the background. This can help to reduce the time it takes to submit the form.
24 {{/table}}
25 {{/internBaseOptionsElement}}
26
27 {{figure image="designer_element_upload_properties_constraints_en.png"}}
28 The constraints let you restrict the allowed file types and the maximum file size.
29 {{/figure}}
30
31 {{internBaseOptionsElement page="cond"}}
32 {{table dataTypeAlpha="0" colWidth="-500"}}
33 |=Name|=Description
34 |Max. size|Maximum size for the uploaded file in kilobytes.
35 |Extensions|Comma separated list of allowed file extensions the user may upload. Only files with the given extensions may be uploaded by users. File extenstions may start with or without a dot. For example //pdf// or //.pdf// will restrict uploads to PDF files.
36 {{/table}}
37 {{/internBaseOptionsElement}}
38
39 {{figure image="designer_element_upload_properties_label_de.png"}}
40 You can also specify a file name to be used instead of the original file name.
41 {{/figure}}
42
43 {{internBaseOptionsElement page="label"}}
44 {{table dataTypeAlpha="0" colWidth="-500"}}
45 |=Name|=Description
46 |File name|When no name is specified, the uploaded file will be saved with its original name. Otherwise, this name is used for saving the file on the server.
47 |{{version major="7" minor="0" patch="11" /}} Compress images|When enable, uploaded images are scaled and converted to the target format. The file that was originally uploaded is discarded, only the compressed image is saved. Should the compression fail unexpectedly (such as when the server does not support the file format), the original file is saved instead.
48 |Max. width|The maximum width of the compressed image. The image is scaled by an amount such that this width is not exceeded. If you enter a value of //0//, no restriction applies.
49 |Max. height|The maximum height of the compressed image. The image is scaled by an amount such that this height is not exceeded. If you enter a value of //0//, no restriction applies.
50 |Format|Target format of the image. When you select //automatic//, the system attempts to preserve the original format of the uploaded image.
51 |As PDF|When enabled, a PDF with the images is created, assuming a resolution of 150 dpi for the page size of the PDF.
52 {{/table}}
53 {{/internBaseOptionsElement}}
54
55 {{internBaseOptionsElement page="css"/}}
56
57 {{internBaseOptionsElement page="attr"/}}
58
59 {{internBaseOptionsElement page="avail"/}}
60
61 {{internBaseOptionsElement page="ronly"/}}
62
63 {{internBaseOptionsElement page="misc"/}}
64
65 {{content moveToTop="true"/}}