README.txt 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. README file for the clone module for Drupal 7.x.
  2. The clone module allows users to make a copy of an existing node and then edit
  3. that copy. The authorship is set to the current user, the menu and url aliases
  4. are reset, and the (localized) words "Clone of" are inserted into the title to
  5. remind you that you are not editing the original node.
  6. Users with the "clone node" or "clone own nodes" permission can utilize this
  7. functionality. A "Clone content" local action link will appear on node pages.
  8. Depending on the setting you choose there are two possible actions that will
  9. occur when you click that tab. Each of these is a different cloning "method".
  10. The default method works by pre-populating the node form, rather than immediately
  11. saving a copy of the original node to the database. Thus, your node will not
  12. be saved until you hit "Submit" (just like if you went to node/add/x).
  13. The alternative method that may be selected immediately saves the node (by
  14. default the user must confirm this action on a confirmation form). This may
  15. work better in some cases, but also means that the copied node may immediately
  16. show up on the front page or in RSS feeds even while you are editing it.
  17. This module makes reasonable checks on access permissions. A user cannot clone
  18. a node unless they can use the input format of that node, and unless they have
  19. permission to create new nodes of that type based on a call to node_access().
  20. Settings can be accessed at admin/config/content/clone. On this page you can
  21. set whether the publishing options are reset when making a clone of a node.
  22. This is set for each node type individually.
  23. This module seems to work with common node types, however YMMV, especially with
  24. nodes that have any sort of image or file attachments. In all cases, but
  25. especially if you are using a complex (non-core) field or custom node type,
  26. you should evaluate this module on a test site with a copy of your database
  27. before attempting to use it on a live site. On the settings page you may choose
  28. node types to be omitted from the cloning mechanism - no users will be able
  29. to clone a node of an omitted type.
  30. This module makes no attempt to respect field-level permissions set via
  31. the Field Permissions module, or any other module that implements
  32. field-level permissions hooks. You should test your configuration
  33. carefully or not allow access to the clone functionality for non-admins if
  34. you rely on field-level permissions for important site features.
  35. To install this module, copy the folder with all the files to the
  36. /sites/all/modules OR /sites/default/modules directory of your Drupal
  37. installation and enable it at /admin/build/modules. Two new permissions are
  38. available, but there are no changes to the database structure.
  39. Note: this module originally derived from code posted by Steve Ringwood
  40. (nevets@drupal) at http://drupal.org/node/73381#comment-137714