Check your version
This tutorial covers a topic in Drupal 7 which may or may not be the version you're using. We're keeping this tutorial online as a courtesy to users of Drupal 7, but we consider it archived.
Display custom content using a render array.
Goal
Output custom data from a module using a theme function, render array, and template file.
Prerequisites
You will need the following knowledge and skills. If you need a review, check out the Additional resources section at the bottom of this page.
- Have a page return custom content.
- Create a render array.
- Register and create theme functions.
Tasks
Create a menu hook to link to a callback which will contain the render array. The callback function should be in a new file.
Return a render array from the function with test content.
Register and call a theme function to display the user's favorite film.
Register and call a theme function for the favorite film component. Use a template file to display the components of the content.
Recap
- Custom pages can be created and returned by creating a render array.
- Custom theme functions can be registered in a custom module, using theme functions to contain markup, or template files to create markup.
Further your understanding
- Continue to the next lesson: Movie Project: Integrate Ajax Functionality.
Additional resources
- API Documenation: hook_theme (api.drupal.org)
- Documentation: Using the theme layer (Drupal.org)
- Video: Using the Drupal Render API (Drupalize.Me)
- Video: Integrating with the Theme System (Drupalize.Me)
