$Id: README.TXT,v 1.4 2006/00/07 18:39:17 dman Exp $

-------------------
-- attach.module --
-------------------

Description
-----------
Enable EXISTING upload files or resources to be attached to nodes as if they 
had been uploaded.

This module enhances (and requires) the upload.module.
It adds a 'local filepath' entry next to the usual browse/upload field. This 
field is integrated with the optional filebrowser.module to browse for the 
files.

Useful for migrating existing sites, file dumps, or dealing with content from
 sources other than just attachment uploads.

Multiple nodes can now be associated with one file.

(Beware - deleting either node currently removes the file entirely)

Requirements
------------
This module requires Drupal 4.7.

It only starts working if upload.module is enabled.

If a PATCHED version of filebrowser.module is available, the server filesystem
itself can be browsed to find the file. http://drupal.org/project/filebrowser
As of 7/7/2006 the patch for filebrowser.module is provided separate.

Installation
------------
No tables, no special requirements, but the attach.install script should run to
 ensure that the WEIGHT of this module is greater than that of upload.module. 

Currently there are no settings and no settings page.
User access rights need testing.

History
-------
Much of this was developed upon the framework of disknode.module by 
Michiel Hendriks < http://drupal.org/node/43600 > , however almost none of that
legacy now remains. The filenode browser was discarded in favour of the 
better-integrated filebrowser module, < http://drupal.org/project/filebrowser >
although I kept the shell of the template and CSS.

The code is trying to do just one thing, and avoided adding too many features 
or replacing work done before. Integrating with the established upload module 
(although a little too closely at points) was seen as better than branching in
any new directions.

TODO
----
Security, and possibly some finer control of what can be attached by who.
Currently publishes the entire files directory - this may not be always wanted.

@author Dan Morrison < http://coders.co.nz/ >