You are here

README.txt in Node Convert 6

Same filename and directory in other branches
  1. 7 README.txt
Welcome to Node Convert.

This module allows to convert one or many nodes between different node types.
It can transfer most cck fields, and node-specific options for book and forum types.
Support of more basic types will be in future releases.

Also the module provides an API for converting nodes and cck fields, hooks for processing
additional options of custom node types, integrates with hook_node_operations and Drupal's
Action API.

I. Single node conversion:
1) Set 'administer conversion' and 'convert to x', 'convert from y' permissions.
2) Go to /node/x/convert and follow the provided steps to convert the node.

II. Multiple node conversion (using hook_node_operations)
1) Set appropriate permissions.
2) Go to admin/build/node_convert_templates
3) Create a new template following the the provided steps.
4) Go to admin/content/node
5) Select the correct nodes.
6) Choose "Convert template: x" (based on the template name created above) from the update options.
7) Click Update.

III. Multiple node conversion (using Actions API + Views Bulk Operations)
Note: This requires the contributed modules Views and Views Bulk Operations

1) Set appropriate permissions.
2) Go to admin/build/node_convert_templates
3) Create a new template following the the provided steps (also check Create Action).
3) Create a new view with the options you require.
4) Select Views Bulk Operations as the style.
5) Configure all options as necessary
6) Select as an operation one of the convert templates.
Note: Most probably there will be duplicates of the same template, this is because
VBO uses both Actions API and hook_node_operations to show possible operations
7) Save the view. View it.
8) Select the necessary nodes and click the Convert x button.

Useful API calls:
node_convert_node_convert($nid, $dest_node_type, $source_fields, $dest_fields, $no_fields_flag, $hook_options = NULL);
node_convert_field_convert($nid, $source_field, $dest_field);
hook_node_convert_change($data, $op);

File

README.txt
View source
  1. Welcome to Node Convert.
  2. This module allows to convert one or many nodes between different node types.
  3. It can transfer most cck fields, and node-specific options for book and forum types.
  4. Support of more basic types will be in future releases.
  5. Also the module provides an API for converting nodes and cck fields, hooks for processing
  6. additional options of custom node types, integrates with hook_node_operations and Drupal's
  7. Action API.
  8. I. Single node conversion:
  9. 1) Set 'administer conversion' and 'convert to x', 'convert from y' permissions.
  10. 2) Go to /node/x/convert and follow the provided steps to convert the node.
  11. II. Multiple node conversion (using hook_node_operations)
  12. 1) Set appropriate permissions.
  13. 2) Go to admin/build/node_convert_templates
  14. 3) Create a new template following the the provided steps.
  15. 4) Go to admin/content/node
  16. 5) Select the correct nodes.
  17. 6) Choose "Convert template: x" (based on the template name created above) from the update options.
  18. 7) Click Update.
  19. III. Multiple node conversion (using Actions API + Views Bulk Operations)
  20. Note: This requires the contributed modules Views and Views Bulk Operations
  21. 1) Set appropriate permissions.
  22. 2) Go to admin/build/node_convert_templates
  23. 3) Create a new template following the the provided steps (also check Create Action).
  24. 3) Create a new view with the options you require.
  25. 4) Select Views Bulk Operations as the style.
  26. 5) Configure all options as necessary
  27. 6) Select as an operation one of the convert templates.
  28. Note: Most probably there will be duplicates of the same template, this is because
  29. VBO uses both Actions API and hook_node_operations to show possible operations
  30. 7) Save the view. View it.
  31. 8) Select the necessary nodes and click the Convert x button.
  32. Useful API calls:
  33. node_convert_node_convert($nid, $dest_node_type, $source_fields, $dest_fields, $no_fields_flag, $hook_options = NULL);
  34. node_convert_field_convert($nid, $source_field, $dest_field);
  35. hook_node_convert_change($data, $op);