There may be times when you want to include a module inside an article or into multiple articles.

For example, you have an illustration, or a menu, or a set of links that you would like to place into several articles AND you want to be able to change the content of the module and have it update in all of the articles without having to open and edit each individual article.

You could just put the module into a pre-defined position on the side, top or bottom of the article, but you may want to have this item right in the middle of you article(s).

What you can do is use where mycustomposition name is the position name that you assigned to the module NOT the title of the module. By using this method, you do not have to edit the index.php file or the templateDetails.xml file. You don't have to add this custom module into the pre-defined module positions. You can style this module position in your CSS stylesheet by giving the module a custom class name, then target that class in the CSS. You do need to still need to assign the proper pages under the Menu Assignment tab when you create the module.

Step by step example:

Step 1: Be sure that the Plug-in that allows this functionality is Enabled.

Extensions -> Plug-in Manager -> Content - Load Modules -> Details Tab

enabled

Be sure the Status is set to Enabled

Step 2: Create you module.

Extensions -> Modules -> New

For this example, we will use Custom HTML, but this could be applied to many other Module Types.

Go ahead and put whatever you wish into the module and give it a Title. Also enter the Menu Assignment page and click the checkboxes next to the appropriate pages. Remember, you can only assign modules to pages that were defined as Menu Items under Menus.  You cannot assign a module to an article that is not also somehow included in a Menu Item either as a Single Article or in a Category List or Category Blog.

Step 3: Within the Module Manager for your new module, under the Details tab, you will see the Position option. If you pull down the selector you will see a list of pre-defined positions for every template that you have with your Joomla 3 installation. You will also see any other custom positions that may have been used previously.

You can select from the pull down list or you can type in a new position name in the text box next to Position.

Lets give this position a name of linkblock. This is an arbitrary name and you can use whatever you want (no spaces or special characters), but choose something unique so that it is not confused with some other name used in Joomla. Hit Enter for the position name to be assigned.

Step 4: Still in the Module Manager for your new module, give this module a Module Class Suffix in the Advanced Options of the Options tab so that you can style it in your CSS. You don't have to do this, but if you want the module to stand out somehow or have special characteristics, this is how you would set that up. Enter your class name in the text box next to Module Class Suffix.

Note: if you just enter the class name in the text box, Joomla adds it onto the end of custom. For example you put menubox in the text box for Module Class Suffix, Joomla will rename that to custommenubox. This is important to know when you are styling it in your CSS. If you do not want Joomla to add custom to the beginning of your class name, simply put a space in front off your class name when you enter it into the text box.

You also can add an additional class name in here, just separate the class names with a space. Joomla will not add custom to the beginning of the second class or any other additional class names.

Select Save & Close after you have created your module and assigned a custom position name.

Step 5: Enter the position into your article. Simply open up your article(s). Within the article, at the point that you wish to place your module, type in:

{loadposition linkblock}

Where linkblock is the name of the custom position - put what ever you chose to use for the custom position name.

If the article is included in a Menu Item, then this module should now appear within the page when you navigate or refresh that page.


Has BJ.Zemplate.com helped you with understanding Joomla?

If you would like to make a small contribution to help fund this resource, that would be great, but do not feel obligated in any way.

Donation Amounts


Still not finding a special topic?

Use Google's Search function below for search the content of bj.zemplate.com.