A filter allowing you to insert a node wherever the InsertNode filter is available. It can be used to create macros, insert book links, create a link to a node showing its title, etc.
The complete documentation is now available at Made to Order Software:
It is important to read that documentation to be able to use this filter fully. It is powerful!
$node->title and version 1.4+
When adding support for the target option, we renamed the $node->title as $node->insert_node_title for the link and the title features. If you created a template for the title or link for your theme and made use of the $node->title and [node:123 title=...;] feature, then you will want to update your template with the new scheme. All other users are not affected, however we'll all benefit from the resulting optimizations.
Upgrading from 1.0/1.1 to 1.2 or a newer version
The module changed name from insert_node back to InsertNode. The following are instructions on how to properly handle the transition.
You can find some extras on my Linux website: http://linux.m2osw.com/insert_node
If you also have extras you want to share, send them my way!
For D5 users, this node: #395608: Process node content (eg CCK, filter tags) includes a patch to fix problems with CCK, Links and other fields that would otherwise not appear. However, it may generate some infinite loops.
Version 5.x with patch in #395608: Process node content (eg CCK, filter tags) can generate infinite loops and thus break your server.
Drupal 5.x not supported
Version 5.x has not been maintained for over 2 years. Some of the issues have now been marked as Closed (won't fix). If you start using the Drupal 5.x version, please check for All issues to find solutions. There are many issues with patches and links to this or that issue with solutions.
See http://drupal.org/node/87746 - where markfoodyburton took the code from.