Embedding a 'Related Content' block in your Drupal nodes
Many of my favorite websites offer a nice little feature, immediately following the body of the page, that highlights 3-5 "possibly related" stories or blog posts. I wanted to do this on OSC and some other sites, but found that it's difficult to add regions inside of nodes—the closest I could get with the default theme/block behavior is to have it appear after comment section, which is too far down the page to be relevant.
I decided to use the Featured Content module to create my blocks, as it offers a good amount of customization as to what kind of algorithms it uses to find related nodes... performance considerations aside. There are other ways to go about creating lists of related nodes, but this was quick and easy.
Adapting a solution I found here, I created a simple function inside my template.php file that allowed me to print a block from inside my node.tpl.php template.
Inside template.php:
<span style="color: #000000"><span style="color: #0000BB"><?php<br></span><span style="color: #FF8000">/**<br> * Helper function for retrieving block code for insertion into templates.<br> *<br> * @see http://drupal.org/node/753516#comment-2769068<br> */<br></span><span style="color: #007700">function </span><span style="color: #0000BB">osc_block_retrieve</span><span style="color: #007700">(</span><span style="color: #0000BB">$module</span><span style="color: #007700">, </span><span style="color: #0000BB">$delta</span><span style="color: #007700">) {<br> </span><span style="color: #0000BB">$block </span><span style="color: #007700">= (object) </span><span style="color: #0000BB">module_invoke</span><span style="color: #007700">(</span><span style="color: #0000BB">$module</span><span style="color: #007700">, </span><span style="color: #DD0000">'block'</span><span style="color: #007700">, </span><span style="color: #DD0000">'view'</span><span style="color: #007700">, </span><span style="color: #0000BB">$delta</span><span style="color: #007700">);<br> </span><span style="color: #0000BB">$block</span><span style="color: #007700">-></span><span style="color: #0000BB">module </span><span style="color: #007700">= </span><span style="color: #0000BB">$module</span><span style="color: #007700">;<br> </span><span style="color: #0000BB">$block</span><span style="color: #007700">-></span><span style="color: #0000BB">delta </span><span style="color: #007700">= </span><span style="color: #0000BB">$delta</span><span style="color: #007700">;<br> return </span><span style="color: #0000BB">theme</span><span style="color: #007700">(</span><span style="color: #DD0000">'block'</span><span style="color: #007700">, </span><span style="color: #0000BB">$block</span><span style="color: #007700">);<br>}<br></span><span style="color: #0000BB">?></span></span>
Inside node.tpl.php:
<span style="color: #000000"><span style="color: #0000BB"><?php<br> </span><span style="color: #007700"><?</span><span style="color: #0000BB">php </span><span style="color: #007700">if (</span><span style="color: #0000BB">$page</span><span style="color: #007700">): </span><span style="color: #0000BB">?></span></span><br> <div class="block-in-node"><br> <span style="color: #000000"><span style="color: #0000BB"><?php </span><span style="color: #007700">print </span><span style="color: #0000BB">osc_block_retrieve</span><span style="color: #007700">(</span><span style="color: #DD0000">'featured_content'</span><span style="color: #007700">, </span><span style="color: #DD0000">'1'</span><span style="color: #007700">); </span><span style="color: #0000BB">?></span></span><br> </div><br> <span style="color: #000000"><span style="color: #0000BB"><?php </span><span style="color: #007700">endif; </span><span style="color: #0000BB">?></span></span><br>?>
I chose to rank related nodes first by similar taxonomy terms, then by how many views the node received (I'm using the statistics module on this site).
Alternatively, you could do one of the following to accomplish the same kind of thing:
- Set up a region inside your nodes, in the node.tpl.php file. This seems to be a little burdensome, though, unless you're planning on doing many different things inside said region(s).
- Use the Panels module to add blocks inside of nodes, or in a different kind of page layout.