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