DjangoTemplates Plugin

  • Tags : scaffolding, templating, binding
  • Latest : not provided
  • Last Updated: 31 December 2009
  • Grails version : *
  • Authors : Daiji Takamori
0 vote
Dependency : 
compile ":DjangoTemplates Plugin:not provided"

Summary

Description

DjangoTemplates Plugin

This is a simple plugin to provide Django-style templates. This was created upon a suggestion by one of the devs that having the functionality of Django's templates would be handy.

Author: Daiji Takamori - http://grails.snowmochi.com/ Plugin Package: http://grails.snowmochi.com/grails-DjangoTemplates-0.1.zip

Installation

To install the DjangoTemplates plugin type this command in your project's root folder: 

grails install-plugin /path/to/grails-DjangoTemplates-0.1.zip
At the moment you'll then need to compile the Java classes in the plugin by running 
grails package
I plan on addressing this issue later.

Usage

Create a template as you normally would. If you want to create a layout, remember to prefix the name with an underscore. If you are using a relative path then you will need to prefix the path with an underscore instead. Use <g:declareBlock> to define a section of replaceable GSP.

In your views (or even in another template), use <g:extends> where you'd like to extend a given template. Replace the sections you'd like to replace using <g:block>, even with other GSP, if you'd like.

Taglib API

g:declareBlock

The following (defined in a template) will define a block named "section" with default content "Some default content". 

<g:declareBlock name="section">Some default content</g:declareBlock>

g:extends and g:block

The following will extend a template named "_templatepath.gsp" in the current directory, but replaces the section named "section" with "Replaced default content". The template is prefixed with "Some pretext" and suffixed with "Some posttext". 

Some pretext
<g:extends template="templatepath">
	<g:block name="section">Replaced default content</g:block>
</g:extends>
Some posttext