Drupal 7 - How to load a template file from a module?

Question

I am trying to build my own module in Drupal 7.

So I have created a simple module called 'moon'

function moon_menu() {
  $items = array();
      $items['moon'] = array(
      'title' => '',
      'description' => t('Detalle de un Programa'),
      'page callback' => 'moon_page',
      'access arguments' => array('access content'),
      'type' => MENU_CALLBACK
  );

  return $items;
}

function moon_page(){


$id = 3;

$content = 'aa';

}

in moon_page() function, I like to load a custom template 'moon.tpl.php' from my theme file.

is this possible?

score 15 · Answer 1 · answered Mar 15 '11 at 03:12

15

/*
 * Implementation of hook_theme().
 */
function moon_theme($existing, $type, $theme, $path){
  return array(
    'moon' => array(
      'variables' => array('content' => NULL),
      'file' => 'moon', // place you file in 'theme' folder of you module folder
      'path' => drupal_get_path('module', 'moon') .'/theme'
    )
  );
}

function moon_page(){

  // some code to generate $content variable

  return theme('moon', $content); // use $content variable in moon.tpl.php template
}

answered Mar 15 '11 at 03:12

dobeerman

1,354
15
27

1

thankx, this helped me. But need some modification. in return array of moon_theme() funciton the array key 'file' should be repalced with 'template' otherwise it produce error in Drupal 6 – Muneer Nov 20 '11 at 06:20
2

'path' worked fine in drupal7, but when called with 'path', the file should literally be called 'theme/moon', without any extensions. if you use 'template', drupal7 searches for 'theme/moon.tpl.php'. – commonpike Jun 28 '13 at 14:38

score 10 · Accepted Answer · answered Mar 14 '11 at 22:11

10

For your own stuff (not overriding a template from another module)?

Sure, you only need to:

Register your template with hook_theme()
Call theme('moon', $args)

$args is an array that contains the arguments to the template as specified by your hook_theme() implementation.

answered Mar 14 '11 at 22:11

Berdir

6,881
2
26
38

// I just put print theme('moon',$content), but it displays a blank page. Am I doing something wrong here? – Moon Mar 14 '11 at 22:14
If you print something inside your page callback, it means "I do want *only* this to be printed. Example: A file, json, xml, ...". Use "return theme('moon', $args)" instead. Did you update the theme registry (re-save theme selection form or use devel.module). – Berdir Mar 14 '11 at 22:17

score 4 · Answer 3 · edited Oct 22 '12 at 12:56

4

For Drupal 7, it did not worked for me. I replaced line in hook_theme

'file' => 'moon', by 'template' => 'moon'

and now it is working for me.

edited Oct 22 '12 at 12:56

John Conde

217,595
99
455
496

answered Oct 22 '12 at 12:37

user1765355

41
3

score 3 · Answer 4 · answered Feb 12 '13 at 05:38

In drupal 7 I was getting the following error when using :

return theme('moon', $content);

Was resulting in "Fatal error: Unsupported operand types in drupal_install\includes\theme.inc on line 1071"

This was fixed using :

theme('moon', array('content' => $content));

score 0 · Answer 5 · answered Jun 08 '16 at 15:54

You may use moon_menu, with hook_theme

<?php

/**
 * Implementation of hook_menu().
 */
function os_menu() {
  $items['vars'] = array(
    'title' => 'desc information',
    'page callback' => '_moon_page',
    'access callback' => TRUE,
    'type' => MENU_NORMAL_ITEM,
  );
  return $items;
}

function _moon_page() {    
  $fields = [];
  $fields['vars'] = 'var';

  return theme('os', compact('fields'));
}

/**
 * Implementation of hook_theme().
 */
function os_theme() {
  $module_path = drupal_get_path('module', 'os');

  return array(
    'os' => array(
      'template' => 'os',
      'arguments' => 'fields',
      'path' => $module_path . '/templates',
    ),
  );
}

Drupal 7 - How to load a template file from a module?

5 Answers5

Linked