
README file for the clone module for Drupal 7.x.

The clone module allows users to make a copy of an existing node and then edit
that copy. The authorship is set to the current user, the menu and url aliases
are reset, and the (localized) words "Clone of" are inserted into the title to
remind you that you are not editing the original node.

Users with the "clone node" or "clone own nodes" permission can utilize this
functionality. A new tab will appear on node pages with the word "Clone".
Depending on the setting you choose there are two possible actions that will
occur when you click that tab. Each of these is a different cloning "method".

The default method (used in the 5.x-2.x branch also) works by pre-populating the
node form, rather than immediately saving a copy of the original node to the
database.  Thus, your node will not be saved until you hit "Submit" (just like
if you went to node/add/x).

The alternative method that may be selected immediately saves the node (by
default the user must confirm this action on a confirmation form). This may
work better in some cases, but also means that the copied node may immediately
show up on the front page or in RSS feeds even while you are editing it.

This module makes reasonable checks on access permissions.  A user cannot clone
a node unless they can use the input format of that node, and unless they have
permission to create new nodes of that type based on a call to node_access().

Settings can be accessed at admin/settings/clone.  On this page you can
set whether the publishing options are reset when making a clone of a node.
This is set for each node type individually.

This module seems to work with common node types, however YMMV, especially with
nodes that have any sort of image or file  attachments.   In all cases, but
especially if you are using a complex (CCK) or custom node type, you should
evaluate this module on a test site with a copy of your database before
attempting to use it on a live site. On the settings page you may choose
node types to be omitted from the cloning mechanism - no users will be able
to clone a node of an omitted type.

This module makes no attempt to respect field-level permissions set via
CCK's Content Permissions module, or any other module that implements
CCK field-level permissions hooks. You should test your configuration
carefully or not allow access to the clone functionality for non-admins if
you rely on field-level permissions for important site features.

To install this module, copy the folder with all the files to the
/sites/all/modules  OR /sites/default/modules directory of your Drupal
installation and enable it at /admin/build/modules.  Two new permissions are
available, but there are no changes to the database structure.

Note: this module originally derived from code posted by Steve Ringwood
(nevets@drupal) at http://drupal.org/node/73381#comment-137714
