node.tpl.php

You are here

  1. 7 modules/node/node.tpl.php
  2. 7 themes/garland/node.tpl.php
  3. 7 themes/bartik/templates/node.tpl.php
  4. 4.7 themes/bluemarine/node.tpl.php
  5. 4.7 themes/engines/phptemplate/node.tpl.php
  6. 4.7 themes/pushbutton/node.tpl.php
  7. 5 themes/bluemarine/node.tpl.php
  8. 5 themes/garland/node.tpl.php
  9. 5 themes/pushbutton/node.tpl.php
  10. 5 themes/engines/phptemplate/node.tpl.php
  11. 6 modules/node/node.tpl.php
  12. 6 themes/pushbutton/node.tpl.php
  13. 6 themes/bluemarine/node.tpl.php
  14. 6 themes/garland/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 modules/book/book.module
Generates printer-friendly HTML for a node.
comment_links in modules/comment/comment.module
Helper function, build links for an individual comment.
comment_node_view in modules/comment/comment.module
Implements hook_node_view().
node_preview in modules/node/node.pages.inc
Generates a node preview.
theme_node_recent_block in modules/node/node.module
Returns HTML for a list of recent content.

File

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

Comments

If you need to access the original value (such as an integer) of a field (using the new fields api) as stored in the database (not the displayed value), you can access it from the $contents array.

Assuming you have a field called "work-type," where you want to access the number used in the database, instead of the text that will be visible to the user, you can access it like so:

$content['field_work-type']['#items']['0']['value'];

This assumes that there is only one item for this variable, if multilple, then you might use ['#items']['1']['value'] etc
**This may have negative security implications, if the values aren't sanitized (text etc.)

When you really want to take control of the output you can always override \modules\field\theme\field.tpl.php by copy and pasting this file in your theme folder (don't forget to clear Drupal cache after doing so). When you remove all the added HTML you will end up with a plain value minus the additional DIV soup.

After that you can simply call render($content['field_my_variable']) instead of $content['field_my_variable']['#items']['0']['value'] which I agree with some of you above, is really not a nice way of getting the plain value.

Please do understand the consequences of this action. It will mean that you need to take full control of all locations where variables are outputted and place your own HTML and css around them.

render($content['field_my_variable']) seems to only work on some node theme variables. For instance to render the authors name will now work with

   <?php print render($content['name']); ?>

but does as

<?php print $name; ?>

how do i retrived the taxonomy term id in node. and if possible, retrived the self and parent taxonomy term id and name.

how do i retrived the taxonomy term id in node. and if possible, retrived the self and parent taxonomy term id and name.

Just as a clarification for anyone else looking. The filename formatting for node specific content types tpl files is:

node--<machine name content type>.tpl.php

I got tripped up on that using only one dash :(

Thanks a bunch, that's actually what I came here for :)

Me too, thanks.

Thank you!

Many thanks for the great Documentation, i take the Bartik node.tpl.php is a real help!

I highly recommend doing this in your theme:

<?php
/**
* Implements hook_preprocess_node().
*/
function THEMENAME_preprocess_node(&$vars) {
 
 
// Add css class "node--NODETYPE--VIEWMODE" to nodes
 
$vars['classes_array'][] = 'node--' . $vars['type'] . '--' . $vars['view_mode'];
 
 
// Make "node--NODETYPE--VIEWMODE.tpl.php" templates available for nodes
 
$vars['theme_hook_suggestions'][] = 'node__' . $vars['type'] . '__' . $vars['view_mode'];

}

?>

Happy theming!

Hi,
I have created a content type named "Publications" which has an Entity reference field. Referenced Content are all unpublished.
I have Created a node template which displays fields from "Publications Content Type" including Entity Referenced Field. I get the fields values manually from $view object ($view-> result[]-> example_field ) in my template files.

Now when I try to visit the view page as anonymous there is no value for the Referenced Content field. but as admin user i get the right output

Is there any way I can get the unpublished field to appear to all users? I'm a bit lost and really don't know what to do.

Any help would be greatly appreciated. Thanks so much!