You are here

README.txt in Node clone 5.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 5 README.txt
  3. 6 README.txt
  4. 7 README.txt
README file for the clone module for Drupal 5.x.

5.x-2.x branch.

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" permission can utilize this functionality for any
node, while users with "clone own nodes" permission can only clone content that
they are the author of (see below regarding other permission checks). A new
tab will appear on node pages with the word "Clone".  The -2.x branch of this
module 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).

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.  For the core Upload 
module and for the CCK Imagefield and Filefield modules, the node is proceesed 
before populating the form to make sure  about attachements on the original node
is removed. Otherwise, data corruption could occur. For other modules that add
attachements, you may have problems.  

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 user will be
able to  clone a node of an omitted type. 

To install this module, copy the folder with the .info and .module files to the 
/sites/all/modules  OR /modules directory of your Drupal installation and enable
it at /admin/build/modules.  A new permission is available, but there are no 
changes to the database structure. On the settings page you may choose
node types to be omitted from the cloning mechanism - no users will be able
to try to clone a node of an omitted type.

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.

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

An additional helper module, Clone Imagefield, is also present. If this module
is enabled, files attached using the CCK Imagefield module will be copied when
the clone is created.  Typically, this means the filename of the copy will have
a number appended to it to distinguish it form the original file.

Development of the Clone Imagefield module for 5.x sponsored by paulnem
(paulnem@drupal).

File

README.txt
View source
  1. README file for the clone module for Drupal 5.x.
  2. 5.x-2.x branch.
  3. The clone module allows users to make a copy of an existing node and then edit
  4. that copy. The authorship is set to the current user, the menu and url aliases
  5. are reset, and the (localized) words "Clone of" are inserted into the title to
  6. remind you that you are not editing the original node.
  7. Users with the "clone node" permission can utilize this functionality for any
  8. node, while users with "clone own nodes" permission can only clone content that
  9. they are the author of (see below regarding other permission checks). A new
  10. tab will appear on node pages with the word "Clone". The -2.x branch of this
  11. module works by pre-populating the node form, rather than immediately saving
  12. a copy of the original node to the database. Thus, your node will not be
  13. saved until you hit "Submit" (just like if you went to node/add/x).
  14. This module makes reasonable checks on access permissions. A user cannot clone
  15. a node unless they can use the input format of that node, and unless they have
  16. permission to create new nodes of that type based on a call to node_access().
  17. Settings can be accessed at admin/settings/clone. On this page you can
  18. set whether the publishing options are reset when making a clone of a node.
  19. This is set for each node type individually.
  20. This module seems to work with common node types, however YMMV, especially with
  21. nodes that have any sort of image or file attachments. For the core Upload
  22. module and for the CCK Imagefield and Filefield modules, the node is proceesed
  23. before populating the form to make sure about attachements on the original node
  24. is removed. Otherwise, data corruption could occur. For other modules that add
  25. attachements, you may have problems.
  26. In all cases, but especially if you are using a complex (CCK) or custom node
  27. type, you should evaluate this module on a test site with a copy of your
  28. database before attempting to use it on a live site. On the settings page you
  29. may choose node types to be omitted from the cloning mechanism - no user will be
  30. able to clone a node of an omitted type.
  31. To install this module, copy the folder with the .info and .module files to the
  32. /sites/all/modules OR /modules directory of your Drupal installation and enable
  33. it at /admin/build/modules. A new permission is available, but there are no
  34. changes to the database structure. On the settings page you may choose
  35. node types to be omitted from the cloning mechanism - no users will be able
  36. to try to clone a node of an omitted type.
  37. To install this module, copy the folder with all the files to the
  38. /sites/all/modules OR /sites/default/modules directory of your Drupal
  39. installation and enable it at /admin/build/modules. Two new permissions are
  40. available, but there are no changes to the database structure.
  41. The Clone module was originally derived from code posted by Steve Ringwood
  42. (nevets@drupal) at http://drupal.org/node/73381#comment-137714
  43. An additional helper module, Clone Imagefield, is also present. If this module
  44. is enabled, files attached using the CCK Imagefield module will be copied when
  45. the clone is created. Typically, this means the filename of the copy will have
  46. a number appended to it to distinguish it form the original file.
  47. Development of the Clone Imagefield module for 5.x sponsored by paulnem
  48. (paulnem@drupal).