User Guide

Index

1. Introduction
2. What is Modules Anywhere?
3. How to use it (syntax)
   1. Single module
   2. Module positions
   3. Overruling HTML styles
   4. Overruling Module parameters
4. Editor Button
5. Settings
6. Requirements
7. Installation
   1. NoNumber Extension Manager
   2. Joomla! Extension Manager
8. Uninstallation

1) Introduction

This guide provides in-depth information about Modules Anywhere and will tell you:

• what it does
• how to install it
• how to set-up and use it

2) What is Modules Anywhere?

Modules Anywhere is a Joomla! system plugin (and editor button plugin).
You can place modules anywhere in your site, including within 3rd party components, modules and even inside other articles.

You can, for instance, place the module ‘My Module’ in an article by simply placing:

{module My Module}

3) How to use it (syntax)

You can place modules via Modules Anywhere by using plugin style tags right into your WYSIWYG editor.

To place a single article, you can use the {module} tag.

You can also place complete module positions by using the {modulepos} tag.

Note: You should place the tags into the normal WYSIWYG view of your editor and NOT in the HTML/code view.

3.1) Single module

The syntax is very simple. You tell the {module} tag which module to show simply by using the title or id of the module:

{module Some module}
{module 123}

3.2) Module positions

The {modulepos} tag works very much like the {loadposition} plugin in Joomla's core. But it works better :)
The main difference is that you can use the {modulepos} tag anywehre you can enter text, so not only in articles.

Just add the position name inside the {modulepos} tag, like:

{modulepos position-7}

3.3) Overruling HTML styles

You can easily place the module (or module position) with another style than you have set as default (default is 'none'). Just add it after the name, separated with a bar:
{module Main Menu|division}

What HTML styles (chrome) you can use, depends on your template.

The Joomla template Beez comes with the HTML styles division and tabs.
The Joomla 3 template Prostar comes with the HTML style well.

3.4) Overruling Module parameters PRO ONLY

You can also overrule module parameters via the {module} tag. This way you can have one module displayed in different ways, with different settings just by overruling the settings via the tag.
You can overrule any parameters you can find in the module edit screen (in the administrator).

{module Main Menu|moduleclass_sfx=red|some_other_setting=123}

So you can easily switch on/off the title with:

{module Articles from Category|showtitle=0}

Or change the number of displayed items in a listing module with something like:

{module Latest News|count=10}

You should use the ids of the parameter fields. This is the part in the brackets in the field name: jform[xxx]

4) Editor Button

You can enter the tags directly into your content. However, to save time typing and remembering what the exact syntax is, Modules Anywhere comes with a handy editor button.

You can use this editor button (located below the text input area) to place an {module} or modulepos tag into your article (or other editor fields).

You can customise the default tag settings in the Modules Anywhere system plugin settings.

5) Settings

Modules Anywhere is packed with options, giving you control over how it works and behaves. Here is the full list of the options you can find in the Modules Anywhere system plugin settings:

6) Requirements

Modules Anywhere will only work correctly if your setup meets these requirements:

• Up-to-date version of Joomla! 1.5 or 2.5 or 3.x
• PHP 5.3+ No PHP 5.2 support
• PHP mbstring (Multibyte String) functions enabled
• MySQL 5+

Important: I can only provide support for setups that:

• meet the above requirements;
• do not have extension files or Joomla! core files which have been altered in any way.

7) Installation

You can either install Modules Anywhere by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful NoNumber Extension Manager.

Note: When updating Modules Anywhere, you do not need to uninstall it first. The package will update all the files automatically.

Keep in mind that when you update to a major new version (or uninstall first), you might loose some configuration settings.

7.1) NoNumber Extension Manager

It is very easy to install/update any NoNumber Extension using the NoNumber Extension Manager.

Please see the User Guide for the NoNumber Extension Manager for more detailed information...

7.2) Joomla! Extension Manager

To install via the Joomla! Extension Manager, just follow these steps (based on Joomla 2.5 setup):

1. Download the extension zip.
2. Log into your Joomla administrator
3. In the menu, choose: Extensions >> Extension Manager
4. Under 'Upload Package File' select the extension zip.
5. Click on 'Upload & Install'

If you have problems installing Modules Anywhere, please try the manual installation process as described here: docs.joomla.org/Installing_an_extension

8) Uninstallation

You can either uninstall Modules Anywhere by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the PRO version of the powerful NoNumber Extension Manager.

If you no longer use any NoNumber extensions, you can also uninstall the NoNumber Framework plugin by using the Joomla! core extension manager.