Joomla! Day UK 2009 Template Design

Joomla! Day UK 2009 Template Design Providing a flexible platform for digital publishing and collaboration. Chris Davenport Joomla! Core Team

Understanding templates Joomla has an incredibly powerful template system, yet surprisingly few template designers actually make use of this power.

Use a reset script ,[object Object],[object Object],[object Object],You can be clever and use the Joomla API: $reset = '/templates/' . $this->template . '/css/reset.css'; $this->addStylesheet( $this->baseurl . $reset );

Or use a CSS framework Examples: http://www.blueprintcss.org http://developer.yahoo.com/yui/grids/ http://elements.projectdesigns.org/ http://www.wymstyle.org/en/ http://www.yaml.de/en/ http://code.google.com/p/css-boilerplate/

Template execution Template execution is a two-phase process. Phase 1: All PHP code is executed. <?php ..... ?> Phase 2: All jdoc:include statements are replaced. <jdoc:include type=”...” /> See: http://docs.joomla.org/How_are_templates_executed%3F

Template execution <?php if ($this->countModules( 'left' )) : ?> <div id="leftcolumn"> <jdoc:include type="modules" name="left" style="rounded" /> </div> <?php endif; ?> <div id="leftcolumn"> <jdoc:include type="modules" name="left" style="rounded" /> </div> Before execution After Phase 1 In phase 1 all the PHP code is executed In phase 2 all the jdoc:include statements are replaced

<div id="leftcolumn"> <div class="module_menu"> <div> <div> <div><h3>Main Menu</h3> <ul class="menu"><li id="current" class="active item1"> ...... other HTML omitted ...... </div> </div> </div> </div> </div> Template execution After Phase 2

What does it mean? ,[object Object],[object Object],Example: <jdoc:include type="modules" name="<?php echo $module_position; ?>" /> More interesting example: <jdoc:include type="modules" name="left" style=”xhtml” attribs=”<?php echo $attribs; ?>” /> These attributes will be passed into the module chrome.

Module execution order ,[object Object],[object Object],[object Object]

Module chrome <jdoc:include type="modules" name="left" style="rounded" /> <jdoc:include type="module" name="mymenu" style="rounded" /> Applies to a module position Name of the module position Module chrome Applies to an individual module Name of the module

Module chrome – xhtml <div class="rightcolumn"> <div class="moduletable"> <h3>Popular</h3> <ul class="mostread"> <li class="mostread"> .... other HTML omitted .... </div> </div> In black is the raw module output In red is the chrome “wrapper”

Module chrome – rounded <div id="left"> <div class="module"> <div> <div> <div><h3>Main Menu</h3> <ul class="menu"><li id="current" class="active item1"> ...... other HTML omitted ...... </div> </div> </div> </div> </div> In black is the raw module output In red is the chrome “wrapper”

Module chrome / ** * Custom module chrome, echos the whole module in a <div> and the header in <h{x}>. The level of * the header can be configured through a 'headerLevel' attribute of the <jdoc:include /> tag. * Defaults to <h3> if none given */ function modChrome_beezDivision($module, &$params, &$attribs) { $headerLevel = isset($attribs['headerLevel']) ? (int) $attribs['headerLevel'] : 3; if (!empty ($module->content)) : ?> <div class="moduletable<?php echo $params->get('moduleclass_sfx'); ?>"> <?php if ($module->showtitle) : ?> <h<?php echo $headerLevel; ?>><?php echo $module->title; ?></h<?php echo $headerLevel; ?>> <?php endif; ?> <?php echo $module->content; ?> </div> <?php endif; } Gets header level from headerLevel attribute Applies header level to header tag

Module chrome <jdoc:include type=”modules” name=”left” style=”beezDivision” /> In the Beez template index.php: But try: <jdoc:include type=”modules” name=”left” style=”beezDivision” headerLevel=”2” /> This will give exactly the same output as style=”xhtml” This will wrap the title in <h2> tags instead of <h3> tags. To use this in your template just copy [joomla-root]/templates/beez/html/modules.php to [joomla-root]/template/[your-template]/html/modules.php If you already have a modules.php file, then just copy-paste the modChrome_beezDivision function into it.

Cascading module chrome function modChrome_sliders( $module, &$params, &$attribs ) { jimport('joomla.html.pane'); if ($attribs['allowAllClose'] == 'false') $attribs['allowAllClose'] = false; if ($attribs['startTransition'] == 'false') $attribs['startTransition'] = false; $sliders = &JPane::getInstance( 'sliders', $attribs ); echo $sliders->startPanel( $module->title, 'module' . $module->id ); echo $module->content; echo $sliders->endPanel(); } <jdoc:include type="modules" name="left" style="sliders rounded" /> Extra module chrome style added here

What can you access? JDocumentHTML Layout overrides have access to all variables in component and module views JSite JFactory The whole Framework API

Template parameters <?php if ($this->params->get( 'showComponent' )) : ?> <jdoc:include type="component" /> <?php endif; ?> You can access the template parameters using $this->params->get( 'param-name' ); $this in a template is a JDocumentHTML object. http://docs.joomla.org/JDocumentHTML

Document properties ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Collapsing module positions <?php if ($this->countModules( 'user1 or user2' )) : ?> <div class="user1user2"> <jdoc:include type="modules" name="user1" style="xhtml" /> <jdoc:include type="modules" name="user2" style="xhtml" /> </div> <?php endif; ?> Two module positions. Collapse only if neither module position has any modules enabled in it.

Collapsing module positions <?php if ($this->countModules( 'user1 or user2' )) : ?> <div class="user1user2"> <jdoc:include type="modules" name="user1" style="xhtml" /> <?php if ($this->countModules( 'user1 and user2' )) : ?> <div class="divider"></div> <?php endif; ?> <jdoc:include type="modules" name="user2" style="xhtml" /> </div> <?php endif; ?> Two module positions with a separator between them. Collapse only if neither module position has any modules enabled in it. But you only want the divider if both module positions have modules.

Using the application <?php $menu = & JSite::getMenu(); if ($menu->getActive() == $menu->getDefault()) { echo 'This is the front page'; } ?> How to determine if the user is viewing the front page <?php $menu = & JSite::getMenu(); if ($menu->getActive() == $menu->getDefault()) : ?> <div id="leftcolumn"> <jdoc:include type="modules" name="left" style="rounded" /> </div> <?php endif; ?>

Sections and categories $id = JRequest::getInt( 'id' ); $db =& JFactory::getDBO(); $query = 'SELECT cat.alias, sec.alias ' . 'FROM #__categories AS cat ' . 'LEFT JOIN #__content AS cont ON cat.id = cont.catid ' . 'LEFT JOIN #__sections AS sec ON sec.id = cont.sectionid ' . 'WHERE cont.id=' . (int)$id; $db->setQuery( $query ); $result = $db->loadRow(); if (is_array( $result )) { $cat = $result[0]; $sec = $result[1]; } <?php if ($sec == 'the-cms') : ?> <div id="thecms"> <jdoc:include type="modules" name="thecms" /> </div> <?php endif; ?>

Framework API Always use JFactory where you can. $doc =& JFactory::getDocument(); Use http://api.joomla.org and http://docs.joomla.org/Framework

JFactory ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Other useful API classes ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Joomla template design Questions?

Joomla! Day UK 2009 Template Design

Recomendados

Recomendados

Mais conteúdo relacionado

Mais procurados

Mais procurados (18)

Destaque

Destaque (6)

Semelhante a Joomla! Day UK 2009 Template Design

Semelhante a Joomla! Day UK 2009 Template Design (20)

Último

Último (20)

Joomla! Day UK 2009 Template Design