node.tpl.php

  1. 7.x drupal/modules/node/node.tpl.php
  2. 7.x drupal/themes/bartik/templates/node.tpl.php
  3. 7.x drupal/themes/garland/node.tpl.php
  4. 5.x drupal/themes/garland/node.tpl.php
  5. 5.x drupal/themes/engines/phptemplate/node.tpl.php
  6. 5.x drupal/themes/pushbutton/node.tpl.php
  7. 5.x drupal/themes/bluemarine/node.tpl.php
  8. 6.x drupal/themes/garland/node.tpl.php
  9. 6.x drupal/themes/pushbutton/node.tpl.php
  10. 6.x drupal/themes/bluemarine/node.tpl.php
  11. 6.x drupal/modules/node/node.tpl.php

Default theme implementation to display a node.

Available variables:

  • $title: the (sanitized) title of the node.
  • $content: An array of node items. Use render($content) to print them all, or print a subset such as render($content['field_example']). Use hide($content['field_example']) to temporarily suppress the printing of a given element.
  • $user_picture: The node author's picture from user-picture.tpl.php.
  • $date: Formatted creation date. Preprocess functions can reformat it by calling format_date() with the desired parameters on the $created variable.
  • $name: Themed username of node author output from theme_username().
  • $node_url: Direct URL of the current node.
  • $display_submitted: Whether submission information should be displayed.
  • $submitted: Submission information created from $name and $date during template_preprocess_node().
  • $classes: String of classes that can be used to style contextually through CSS. It can be manipulated through the variable $classes_array from preprocess functions. The default values can be one or more of the following:

    • node: The current template type; for example, "theming hook".
    • node-[type]: The current node type. For example, if the node is a "Blog entry" it would result in "node-blog". Note that the machine name will often be in a short form of the human readable label.
    • node-teaser: Nodes in teaser form.
    • node-preview: Nodes in preview mode.

    The following are controlled through the node publishing options.

    • node-promoted: Nodes promoted to the front page.
    • node-sticky: Nodes ordered above other non-sticky nodes in teaser listings.
    • node-unpublished: Unpublished nodes visible only to administrators.
  • $title_prefix (array): An array containing additional output populated by modules, intended to be displayed in front of the main title tag that appears in the template.
  • $title_suffix (array): An array containing additional output populated by modules, intended to be displayed after the main title tag that appears in the template.

Other variables:

  • $node: Full node object. Contains data that may not be safe.
  • $type: Node type; for example, story, page, blog, etc.
  • $comment_count: Number of comments attached to the node.
  • $uid: User ID of the node author.
  • $created: Time the node was published formatted in Unix timestamp.
  • $classes_array: Array of html class attribute values. It is flattened into a string within the variable $classes.
  • $zebra: Outputs either "even" or "odd". Useful for zebra striping in teaser listings.
  • $id: Position of the node. Increments each time it's output.

Node status variables:

  • $view_mode: View mode; for example, "full", "teaser".
  • $teaser: Flag for the teaser state (shortcut for $view_mode == 'teaser').
  • $page: Flag for the full page state.
  • $promote: Flag for front page promotion state.
  • $sticky: Flags for sticky post setting.
  • $status: Flag for published status.
  • $comment: State of comment settings for the node.
  • $readmore: Flags true if the teaser content of the node cannot hold the main body content.
  • $is_front: Flags true when presented in the front page.
  • $logged_in: Flags true when the current user is a logged-in member.
  • $is_admin: Flags true when the current user is an administrator.

Field variables: for each field instance attached to the node a corresponding variable is defined; for example, $node->body becomes $body. When needing to access a field's raw values, developers/themers are strongly encouraged to use these variables. Otherwise they will have to explicitly specify the desired field language; for example, $node->body['en'], thus overriding any language negotiation rule that was previously applied.

See also

template_preprocess()

template_preprocess_node()

template_process()

5 theme calls to node.tpl.php
book_node_export in drupal/modules/book/book.module
Generates printer-friendly HTML for a node.
comment_links in drupal/modules/comment/comment.module
Helper function, build links for an individual comment.
comment_node_view in drupal/modules/comment/comment.module
Implements hook_node_view().
node_preview in drupal/modules/node/node.pages.inc
Generates a node preview.
theme_node_recent_block in drupal/modules/node/node.module
Returns HTML for a list of recent content.
339 string references to the theme hook from node.tpl.php

Note: this list is generated by looking for the string for this theme hook, so it may include some references that are not actually using this theme hook.

AdminMetaTagTestCase::testMetaTag in drupal/modules/system/system.test
Verify that the meta tag HTML is generated correctly.
AggregatorRenderingTestCase::testBlockLinks in drupal/modules/aggregator/aggregator.test
Adds a feed block to the page and checks its links.
AJAXMultiFormTestCase::setUp in drupal/modules/simpletest/tests/ajax.test
Sets up a Drupal site for running functional and integration tests.
bartik_preprocess_node in drupal/themes/bartik/template.php
Override or insert variables into the node template.
BlockCacheTestCase::testCachePerPage in drupal/modules/block/block.test
Test DRUPAL_CACHE_PER_PAGE.

... See full list

File

drupal/modules/node/node.tpl.php
View source
  1. <?php
  2. /**
  3. * @file
  4. * Default theme implementation to display a node.
  5. *
  6. * Available variables:
  7. * - $title: the (sanitized) title of the node.
  8. * - $content: An array of node items. Use render($content) to print them all,
  9. * or print a subset such as render($content['field_example']). Use
  10. * hide($content['field_example']) to temporarily suppress the printing of a
  11. * given element.
  12. * - $user_picture: The node author's picture from user-picture.tpl.php.
  13. * - $date: Formatted creation date. Preprocess functions can reformat it by
  14. * calling format_date() with the desired parameters on the $created variable.
  15. * - $name: Themed username of node author output from theme_username().
  16. * - $node_url: Direct URL of the current node.
  17. * - $display_submitted: Whether submission information should be displayed.
  18. * - $submitted: Submission information created from $name and $date during
  19. * template_preprocess_node().
  20. * - $classes: String of classes that can be used to style contextually through
  21. * CSS. It can be manipulated through the variable $classes_array from
  22. * preprocess functions. The default values can be one or more of the
  23. * following:
  24. * - node: The current template type; for example, "theming hook".
  25. * - node-[type]: The current node type. For example, if the node is a
  26. * "Blog entry" it would result in "node-blog". Note that the machine
  27. * name will often be in a short form of the human readable label.
  28. * - node-teaser: Nodes in teaser form.
  29. * - node-preview: Nodes in preview mode.
  30. * The following are controlled through the node publishing options.
  31. * - node-promoted: Nodes promoted to the front page.
  32. * - node-sticky: Nodes ordered above other non-sticky nodes in teaser
  33. * listings.
  34. * - node-unpublished: Unpublished nodes visible only to administrators.
  35. * - $title_prefix (array): An array containing additional output populated by
  36. * modules, intended to be displayed in front of the main title tag that
  37. * appears in the template.
  38. * - $title_suffix (array): An array containing additional output populated by
  39. * modules, intended to be displayed after the main title tag that appears in
  40. * the template.
  41. *
  42. * Other variables:
  43. * - $node: Full node object. Contains data that may not be safe.
  44. * - $type: Node type; for example, story, page, blog, etc.
  45. * - $comment_count: Number of comments attached to the node.
  46. * - $uid: User ID of the node author.
  47. * - $created: Time the node was published formatted in Unix timestamp.
  48. * - $classes_array: Array of html class attribute values. It is flattened
  49. * into a string within the variable $classes.
  50. * - $zebra: Outputs either "even" or "odd". Useful for zebra striping in
  51. * teaser listings.
  52. * - $id: Position of the node. Increments each time it's output.
  53. *
  54. * Node status variables:
  55. * - $view_mode: View mode; for example, "full", "teaser".
  56. * - $teaser: Flag for the teaser state (shortcut for $view_mode == 'teaser').
  57. * - $page: Flag for the full page state.
  58. * - $promote: Flag for front page promotion state.
  59. * - $sticky: Flags for sticky post setting.
  60. * - $status: Flag for published status.
  61. * - $comment: State of comment settings for the node.
  62. * - $readmore: Flags true if the teaser content of the node cannot hold the
  63. * main body content.
  64. * - $is_front: Flags true when presented in the front page.
  65. * - $logged_in: Flags true when the current user is a logged-in member.
  66. * - $is_admin: Flags true when the current user is an administrator.
  67. *
  68. * Field variables: for each field instance attached to the node a corresponding
  69. * variable is defined; for example, $node->body becomes $body. When needing to
  70. * access a field's raw values, developers/themers are strongly encouraged to
  71. * use these variables. Otherwise they will have to explicitly specify the
  72. * desired field language; for example, $node->body['en'], thus overriding any
  73. * language negotiation rule that was previously applied.
  74. *
  75. * @see template_preprocess()
  76. * @see template_preprocess_node()
  77. * @see template_process()
  78. *
  79. * @ingroup themeable
  80. */
  81. ?>
  82. <div id="node-<?php print $node->nid; ?>" class="<?php print $classes; ?> clearfix"<?php print $attributes; ?>>
  83. <?php print $user_picture; ?>
  84. <?php print render($title_prefix); ?>
  85. <?php if (!$page): ?>
  86. <h2<?php print $title_attributes; ?>><a href="<?php print $node_url; ?>"><?php print $title; ?></a></h2>
  87. <?php endif; ?>
  88. <?php print render($title_suffix); ?>
  89. <?php if ($display_submitted): ?>
  90. <div class="submitted">
  91. <?php print $submitted; ?>
  92. </div>
  93. <?php endif; ?>
  94. <div class="content"<?php print $content_attributes; ?>>
  95. <?php
  96. // We hide the comments and links now so that we can render them later.
  97. hide($content['comments']);
  98. hide($content['links']);
  99. print render($content);
  100. ?>
  101. </div>
  102. <?php print render($content['links']); ?>
  103. <?php print render($content['comments']); ?>
  104. </div>

Related topics