/[drupal]/contributions/modules/image_import/README.txt
ViewVC logotype

Contents of /contributions/modules/image_import/README.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.4 - (show annotations) (download)
Fri Mar 17 13:59:55 2006 UTC (3 years, 8 months ago) by syscrusher
Branch: MAIN
CVS Tags: HEAD
Changes since 1.3: +6 -0 lines
File MIME type: text/plain
Updated documentation to note that this module's conversion to Drupal 4.7
is still a work in progress, and to fix a path error per issue #48381.
1 $Id$
2
3 IMPORTANT NOTE: Conversion of this module to Drupal 4.7 is NOT YET COMPLETE.
4 This version is an interim commit of work in progress, and not yet fully
5 functional.
6
7
8 image_import.module Allows mass import of images and, optionally, captions
9 into Drupal installations using the improved image
10 module from James Walker (drupal.org name "walkah").
11
12 Author: Scott Courtney (drupal.org name "syscrusher")
13 email: scott (at) 4th (dot) com
14
15 License: GNU General Public License (GPL) http://gnu.org/
16
17 Status: BETA release for initial testing
18
19 Prerequisites: upload.module, image.module ("walkah" version
20 required), and Drupal 4.6, all configured and
21 working properly. Previous versions of Drupal
22 are not supported.
23
24 Features:
25
26 * Number of images that can be imported is limited only by the system's
27 speed and settings (such as PHP's maximum script execution time).
28
29 * Fully supports and exploits free-tag vocabularies using Morbus Iff's
30 patch, if available. Also works correctly without that patch.
31
32 * Unlike previous image import code, this module can do a "fast import"
33 while also individually captioning images. For each image being
34 imported, the module looks for a file whose name matches but whose
35 extension is one of several typical text file types. If found, that
36 file's contents will be used to automatically create a teaser and
37 body (description) for the image.
38
39 * Optionally deletes the uploaded files (including caption files), to
40 prevent the next import run from accidentally importing them again
41 as duplicate nodes.
42
43 * System administrators can force the deletion of uploaded files.
44
45 * To support systems where users have individual upload directories,
46 the module can be configured to insert the Drupal username into
47 the import directory path. It can also optionally *not* do this
48 for the special case of the system user (uid=1). There is also
49 a way to have the module remove spaces from the usernames.
50
51 * Users with appropriate permissions, as defined by the site owner,
52 can override the import path for their images.
53
54 * Extensive descriptions and help for all administrative and
55 user-accessible form fields.
56
57 * A separate detailed help page (Drupal path node/add/image_import/help)
58 provides a step-by-step guide to using the module, with the instructions
59 customized based on the individual user name and security privileges as
60 well as various site-wide settings from image_import and the modules
61 it uses internally.
62
63 * Optional throttle mode ensures that each image node is created with
64 a different timestamp, since some galleries use this for sorting
65 them.
66
67 * Optional time limit on import helps prevent script timeout errors in
68 situations where the Drupal administrator does not have control over
69 PHP settings. The user can restart the import where it left off, to
70 continue importing images. (This feature only works if the images are
71 being deleted during import.)
72
73 * Optional debug mode provides verbose diagnostics to help isolate
74 problems with file permissions and similar issues.

  ViewVC Help
Powered by ViewVC 1.1.2