Ensuring 'txt' is used as the default extension when a field configuration is not...
[project/filefield.git] / README.txt
CommitLineData
8a3bf923 1// $Id$
d93afe47 2
8a3bf923
NH
3FileField provides an "File" field type to CCK. It provides many advantages over
4the Drupal core "Upload" module including:
d93afe47 5
8a3bf923
NH
6 * Per-field upload control (file extensions, file size).
7 * Per-node upload size limits.
8 * Multiple fields per content type.
9 * Customizable paths for saving uploads (plus token support for dynamic paths).
10 * Icons for uploaded file types.
d93afe47 11
8a3bf923
NH
12FileField was written by Darrel Opry (dopry).
13Maintained by Nathan Haug (quicksketch) and Andrew Morton (drewish).
a9804949 14
8a3bf923
NH
15Dependencies
16------------
17 * Content
a9804949 18
8a3bf923 19FileField also provides additional features when used with the following:
a9804949 20
8a3bf923
NH
21 * ImageField (See an image preview during editing.)
22 * Token (Generate dynamic paths when saving images.)
23 * ImageCache (Create thumbnails of images on output.)
24
0532922a
NH
25If your site is any larger than a personal blog, you should definitely install
26the following modules to increase the security and stability of your uploads.
27
28 * Transliteration (Convert unsafe characters to file system safe names.)
29 * MimeDetect (Check the content of files to ensure they match the extension.)
30
8a3bf923
NH
31Install
32-------
33
341) Copy the filefield folder to the modules folder in your installation.
35
362) Enable the module using Administer -> Site building -> Modules
37 (/admin/build/modules).
38
393) Create a new file field in through CCK's interface. Visit Administer ->
40 Content management -> Content types (admin/content/types), then click
41 Manage fields on the type you want to add an file upload field. Select
42 "File" as the field type and "File" as the widget type to create a new
43 field.
0532922a
NH
44
454) Upload files on the node form for the type that you set up.