Created: 2008-09-30 06:24
Updated: 2015-11-05 05:50



Created by: Andrew Neil Version: 1.0 Contact: andrew.jr.neil AT gmail DOT com

This is an extension for Radiant CMS that allows you to manage movies from services such as youTube, Vimeo etc. It adds a 'Movies' tab to the Radiant admin, where you can create, edit or destroy movies. It also creates a MoviePage, which provides additional Radius tags making it easy to create a listings page of your movies. Each movie can be accessed at a virtual page, whose URL appears like a child page of the MoviePage


This extension is hosted on github. If you have git installed, then cd to the root of your radiant project and issue this command:

git clone git://github.com/nelstrom/radiant-movies-extension.git vendor/extensions/movies

If you don't have git, then you can instead download the tarball from this URL:


and expand the contents to your-radiant-project/vendor/extensions/movies.

Once you have the extension added to your radiant project, you can run the rake task:

rake (production) radiant:extensions:movies:install

# this is equivalent to running the following two tasks:
rake (production) radiant:extensions:movies:migrate
rake radiant:extensions:movies:update

Restart your Radiant, and you should be good to go.


Movies tab

In the Radiant admin area, you should find an extra "Movies" tab. Click this to reveal a list of movies. You can add a new movie by clicking the "New movie" button. Existing movies can be edited by clicking on their title text, or removed from the system by clicking the "Remove" link.

The following fields are available for movies:

  • title - the title of the movie
  • url - the code used to embed movies from youTube, Vimeo etc.
  • description - you can enter a description
  • status - can be set to visible or hidden.

Services such as youTube, Vimeo etc. usually provide a snippet of code which you can copy and paste into any HTML document to embed the movie. This is code should be pasted directly, as is, into the URL field.

Movies page

When the movies extension is installed, a new page type called "Movie" becomes available. It is recommended that you create one page of this type. Each movie entered into the system should be visible in its own virtual page. These virtual pages look as though they are children of the movie page, but they don't exist in the sitemap. So if you have a sitemap like this:

Title             path      class
-----             ----      -----
Home              /         <normal>
  \_ About        /about    <normal>
  \_ Movies       /movies   Movie

and the following movies:

id  Title                 status
--  ------------------    ------
1   Radiant Screencast    Visible
2   Gitcast               Visible
3   CakePHP Screencast    Hidden
4   Railscast             Visible

Then the virtual pages for the movies would exist at the following paths:


The Movie page has a few additional Radius tags, to let you manipulate the movies in the system. Documentation for these tags can be accessed directly from within the Radiant page editing form, by clicking the 'Available tags' link.

In particular, it is worth noting that tags referencing movie (as opposed to the plural movies) are intended to reference the movie of the current page, if it is a virtual page.

The following example demonstrates a simple movie listings page:

<ul id="movies">
    <li class="movie">


  <div id="movie-wrapper">

  <div id="movie-description">

All pages

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more