Re-add old blog posts from Astro

source/_posts/adding-custom-theme-templates-drupal-7.md

@@ -0,0 +1,84 @@
+---
+title: Adding Custom Theme Templates in Drupal 7
+date: 2012-04-19
+excerpt: >
+    Today, I had a situation where I was displaying a list of teasers for news
+    article nodes. The article content type had several different fields assigned
+    to it, including main and thumbnail images. In this case, I wanted to have
+    different output and fields displayed when a teaser was displayed compared to
+    when a complete node was displayed.
+tags:
+    - drupal
+    - drupal-planet
+---
+
+Today, I had a situation where I was displaying a list of teasers for news
+article nodes. The article content type had several different fields assigned to
+it, including main and thumbnail images. In this case, I wanted to have
+different output and fields displayed when a teaser was displayed compared to
+when a complete node was displayed.
+
+I have previously seen it done this way by adding this into in a node.tpl.php
+file:
+
+```php
+if ($teaser) {
+  // The teaser output.
+}
+else {
+  // The whole node output.
+}
+```
+
+However, I decided to do something different and create a separate template file
+just for teasers. This is done using the hook_preprocess_HOOK function that I
+can add into my theme's template.php file.
+
+The function requires the node variables as an argument - one of which is
+theme_hook_suggestions. This is an array of suggested template files that Drupal
+looks for and attempts to use when displaying a node, and this is where I'll be
+adding a new suggestion for my teaser-specific template. Using the `debug()`
+function, I can easily see what's already there.
+
+```php
+array (
+  0 => 'node__article',
+  1 => 'node__343',
+  2 => 'node__view__latest_news',
+  3 => 'node__view__latest_news__page',
+)
+```
+
+So, within my theme's template.php file:
+
+```php
+/**
+ * Implementation of hook_preprocess_HOOK().
+ */
+function mytheme_preprocess_node(&$variables) {
+  $node = $variables['node'];
+
+  if ($variables['teaser']) {
+    // Add a new item into the theme_hook_suggestions array.
+    $variables['theme_hook_suggestions'][] = 'node__' . $node->type . '_teaser';
+  }
+}
+```
+
+After adding the new suggestion:
+
+```php
+array (
+  0 => 'node__article',
+  1 => 'node__343',
+  2 => 'node__view__latest_news',
+  3 => 'node__view__latest_news__page',
+  4 => 'node__article_teaser',
+)
+```
+
+Now, within my theme I can create a new node--article-teaser.tpl.php template
+file and this will get called instead of the node--article.tpl.php when a teaser
+is loaded. As I'm not specifying the node type specifically and using the
+dynamic <em>\$node->type</em> value within my suggestion, this will also apply
+for all other content types on my site and not just news articles.