Counting modules in a given module position: Difference between revisions

From Joomla! Documentation

Chris Davenport (talk | contribs)
m Added div's to code sample.
Chris Davenport (talk | contribs)
No edit summary
Line 1: Line 1:
<includeonly>== Counting Modules in a given Module position ==</includeonly>
The countModules method can be used within a template to determine the number of modules enabled in a given module position.  This is commonly used to include HTML around modules in a certain position only if at least one module is enabled for that position.  This prevents empty regions from being defined in the template output and is a technique sometimes referred to as “collapsing columns”.
The countModules function can be used within a template to determine the number of modules enabled in a given module position.  This is commonly used to include HTML around modules in a certain position only if at least one module is enabled for that position.  This prevents empty regions from being defined in the template output and is a technique sometimes referred to as “collapsing columns”.


For example, the following code includes modules in the 'user1' position only if at least one module is enabled for that position.  
For example, the following code includes modules in the 'user1' position only if at least one module is enabled for that position.  

Revision as of 22:52, 7 September 2008

The countModules method can be used within a template to determine the number of modules enabled in a given module position. This is commonly used to include HTML around modules in a certain position only if at least one module is enabled for that position. This prevents empty regions from being defined in the template output and is a technique sometimes referred to as “collapsing columns”.

For example, the following code includes modules in the 'user1' position only if at least one module is enabled for that position.

<?php if ($this->countModules( 'user1' )) : ?>
  <div class="user1">
    <jdoc:include type="modules" name="user1" style="rounded" />
  </div>
<?php endif; ?>