CMS 32 minutes

Mambo User Manual – Part 3

Last updated: Author Jason Moth

Managing Templates & Modules Positions

The Template Manager provides a workbench for installing and manipulating templates. Administrators and Managers with special authorization to the Template Manager can edit the template. The initial view provides you with a list of the installed templates. A green ‘tick' will be shown adjacent to the name of the currently published template. Some supplied information about each template is also shown.

Templates are also assignable to different parts of your site, much like modules are. If you have several templates installed on your Mambo system, you can now take advantage of all of them. You are able to assign a template to a specific page (or pages) from Toolbar.

When you select a template to assign, you will be shown a list of pages to choose from. You can select multiple pages from the menu and assign them to a template. When assigned, the template will appear when a user clicks on these pages. This will override the default template.

If you want to remove an assigned template from one (or some) page(s), select the assigned template again (radio button), and click the Assign icon in the Toolbar. Now either deselect the items you do not want to be assigned for this template anymore or click “None” to completely remove the assignment for this template.

The Template Manager also allows you to switch the default template (using the Default button) which will appear on all pages for which specific assignment has not been made.

NOTE:  Both assigned and default template will get overridden by the Template Selector module, if used.

NOTE: The Administrator Templates can be switched by hitting the “Publish” icon as well. They are not assignable to pages in the Administrator.

Module Positions and Positions Preview

The Module Positions page allows you to enter details about the module positions you have used in your template. All the default module positions are already entered and, in general, it is unlikely you would need to change this.

Should you need positions that do not pre-exist in the default Mambo setup, you can simply add a new name of the module position and a description. The description is optional.

Once you have entered any additional positions you have created, click the “Save” icon in the Toolbar and the changes you have been made will be entered into Mambo. You are now able to assign modules to your newly created positions in the Module Manager.

The basic code to insert in your template (templates/name-of-your-template/index.php) to be able to assign modules to a specific position is:

<?php mosLoadModules ( 'position' ); ?>

….where the word ‘position' is to be changed to whichever position defined on this page.

If you wish to visualize your Template with blocks displaying the “Positions” used in the template assigned to your Home Page, then click “Site -> Preview -> Inline with Position”.

Managing Users

User Groups and Access Control

Mambo has two main hierarchies for User Groups: one for access to the front-end (so users can log in to the web site and view designated sections and pages) and one for back-end administration access.

The default groups provided are:

Public front-end:

  • Registered
  • Author
  • Editor
  • Publisher

Public back-end:

  • Manager
  • Administrator
  • Super Administrator

Registered Group

These Users are able to log into the Front-end website. Additional information (sections and pages) may be available to a user once logged in. In general, access provided to a parent group (like Registered) is inherited by the child groups (like Author) unless specifically denied by the Super Administrator.

Author Group

These Users are given access to submit new content and edit their own content items/pages by logging into the Front-end.

Editor Group

These Users are given access to submit and edit any content by logging into the Front-end.

Publishers Group

These Users are given access to submit, edit and publish any content by logging into the Front-end.

For information on the Administration user groups, see the section on Administrator Login. Content items, menu items, modules and components can be assigned an access control parameter. At this stage, there are only two available: Public and Registered. This means that anything assigned with Public access can be viewed or accessed by the anonymous web visitor. Anything assigned with Registered access can be viewed or accessed by anyone who has logged into the website in the Front-end and is one of the following types of Registered users: Author, Editor or Publisher.

Advanced Options

User Manager

The User Manager allows you to add, edit and delete users.

New User

There are two ways that users can be created on your site. Your visitors can create their own account by registering via your Login Form, or you can add your own Users if you want a selected group to visit your site or selected content pages.

User Groups

The groups available are fixed but have different levels of access control. The ‘Public front-end' and ‘Public back-end' groups are merely placeholders at this stage. They do not contribute to the access control system except that in the future, they will define the default access levels for anonymous users in the Front-end and Back-end systems.

There are four (4) front-end groups available:

  • Registered – This group allows the user to login to the Front-end interface.
  • Author – This group allows a user to post content, usually via a link in the User Menu.
  • Editor – This group allows a user to post and edit any content item from the Front-end.
  • Publisher – This group allows a user to post, edit and publish any content item from the Front-end.

There are three (3) administration section groups that allow access to Mambo:

  • Manager – This group allows access to content creation and other system information.
  • Administrator – This group allows access to most administration functions.
  • Super Administrator – This group allows access to all administration functions.

To learn how to manage, add and edit your registered User list, click this Help Screen link.

Add or Edit Users

The User Manager screen is used to either add a new user or edit an existing one.

Toolbar Icons:

  • Save: Lets you save the creation/modification and return to User Manager.
  • Apply: Saves the creation/modification and keeps the screen open for editing.
  • Cancel: Cancels the action and lets the User checked-in.

User Details:

  • Name: Type here the name of the user as it will be listed in the User Manager.
  • Username: Type here The Username as it has to be entered for login.
  • Email: Type here the user's e-mail address.
  • New Password: Type here the user's password.
  • Verify Password: Type here the user's password.
  • Group: Choose here a type of user.
  • Block User: Prevents or lets user login.
  • Receive Submission Emails: Enable or not an e-mail be sent to the administrator when the user has submitted some content.
  • Register Date: Displays the date the user has been registered.
  • Last Visit Date: Displays the date on which this user has last logged in.

Contact Information:

This information is only present when editing a user and only if the contact has been created in the Contacts Component and linked to the user (Components -> Contact -> Manage Contacts). If this has been done, the information will be displayed and a link at the bottom of the box provides a direct access to the Edit Contact page for that contact.

User Registration Activation

By default, when a visitor wants to register an account with your site, they are prompted for Name, Username, E-mail and Password.

When the visitor submits the registration request, the account is created but the user cannot log in until activated. An E-mail with the activation link is sent to the email address provided by the visitor. When the mail is received, the user will click the activation link, the account will be activated and the user will now be able to log in.

This feature has several advantages:

  • It verifies that the visitor exists and has a valid e-mail address.
  • It gives the user the ability to choose their password at registration.
  • It gives the Site Administrator a better overview of activated and non-activated accounts. A non-activated account will appear as blocked and never signed in. As such, it is easy to track and delete.
  • It gives the Administrator a better overview of activated and non-activated accounts. A non-activated account will appear as blocked and never signed in. As such, it is easy to track and delete.

The option for Registration Activation is found in Global Configuration under the Site tab. See the option for “Use New Account Activation”. If you disable user activation, visitors will be able to login immediately after they created an account.

There is also an option called “Require Unique Email”. When enabled, this option will assure that a single e-mail address can be registered only once.

The Special User Parameter

Any user created as Author, Editor, Publisher, Manager, Administrator or Super Administrator is considered a Special User.

The administrator has given them access to submit news, articles, FAQ's and Web Links.

These Special Users are the only ones able to access an item with the ‘Special' access parameter. Special users are the only ones to see on-screen menu items or entire menus with the ‘Special' access parameter.

It is especially useful when publishing the User Menu Module. The entire module may be hidden from any ‘Public' or ‘Registered' user by specifying its access as ‘Special'.

To configure this, go to the Administrator Menu (which is the admin control panel) and choose Modules on the menu bar, then click ‘Site Modules'. Then double click ‘User Menu' to edit. Now choose access level: ‘Special'

You could also decide to have only some items of the User Module configured with the ‘Special' access. A ‘Registered' user may have access to the ‘Details' menu item but not to the ‘Submit News', ‘Submit Web Link?' or ‘Check-in My Items' menu items.

In order to get this result, the User Menu Module should be configured with a ‘Registered' access level and the specific menu items with the ‘Special' access level.

In order to configure the menu items of the User Menu, go to the Administrator Menu and choose Menu on the menu bar, click ‘User Menu'. Specify for each item the access level desired.

The result of this last configuration will be that only users whom you have defined as ‘Special' can see the related Menu Items and submit from the Front-end, while ‘Registered' users may have access to their ‘Details' only and ‘Public' users may not see the menu at all.

Managing Your Menus

Navigation and access to content in your website is provided through menus.

‘Menus' in Mambo are groups of links to sections, categories, content items, components or external pages. These links are called ‘Menu Items'. Each menu must have an identification name which is only used internally by Mambo. A menu only becomes visible on a site if it has a published mod_mainmenu module which references it.

A menu in Mambo is defined by 4 kinds of parameters.

2 parameters are accessed through the Menu Manager only:

  • The Menu Name (this is the identification name used by Mambo to identify this menu within the code. It must be unique. It is recommended to use no space within this name as this name does not show on the site.)
  • The Menu Items associated to a particular menu.  These are the links to various types of content in your site

1 parameter may be created through the Menu Manager and may be changed in the ‘Modules Manager [site]': Modules -> Site Modules:

  • The Module Title (title of the mod_mainmenu Menu Module as it will appear on the page if you choose to show it). Each menu created in Mambo is only visible via a module (a ‘module’ in Mambo is a container that can be displayed anywhere your site's template allows it to be displayed),

1 series of parameters concern the Menu Module itself:

  • They are accessed through the ‘Modules Manager [site]': Modules -> Site Modules. The parameters that can be edited in the module are Title, Position of the menu on the page, Access, Publishing, Menu Name (which menu as defined in the Menu Manager is associated to this module), Style, which page(s) you wish the menu to show on, etc.

Note:  If multiple copies of a Menu Module associated to the same Menu exist and all are deleted, it will not delete the Menu as defined in the Menu Manager (including its ‘Menu Items’).

This means you may have a Menu associated to different Menu Modules displaying the same Menu Items.

Main Menu and Other Menus

Multiple instances of this module are permitted, (for example, the User Menu, Other Menu or Top Menu which are installed by default in Mambo). Each mod_mainmenu uses a specific Menu Name and has its own Menu Items.  To create a new instance of mod_mainmenu, click the radio button and then click the “Copy” icon in the toolbar.  This creates an identical mainmenu module under a new name.  You can then rename it, modify its menu items and edit the parameters.

Details

Title: Type the name of the module title to display on the Front-end of your site.

Show title: Choose if the Title will display or not on the Front-end of your site.

Position: Choose which of the positions available the module will display on the Front-end of your site.

Module order: Choose the order the module will appear among modules assigned to the same page on the Front-end of your site, in the same position.

Access Level: Choose which Users can view this module. Public, Registered or Special.

Published: Choose if the module contents will be published or not on the Frontend of your Web site (if the chosen Position is available in the template).

ID: This is the ID number for the module item. This is auto-allocated by the Mambo system when the module is saved.

Pages / Items: Choose which pages the module should be displayed on in the Front-end of your site.

Parameters

Menu Class Suffix: Type (if needed) a suffix to be applied to the CSS class of the Menu Items (mainlevel and sublevel).

Module Class Suffix: Type (if needed) a suffix to be applied to the CSS class of (table.moduletable).  This allows individual module styling.

Menu Name: Type the name of the menu as defined in the Menu Manager. This menu contains the Menu Items that will display on your site.

Menu Style: Three styles of menu are provided with Mambo. Vertical, Horizontal and Flat List.

  • The Vertical menu displays its Menu Items vertically in a table format. It may display sublevels menus if desired. These are presented in an indented form.
  • The Horizontal Menu honors only the first level items and produces a horizontal collection of menu items separated (if desired) by a Spacer as defined below. It is displayed in a table format.
  • The Flat List is a type of Menu displayed in a list format (<li> tags). Depending on the CSS, it may display horizontally or vertically. It does not display sublevels.

Enable Cache: Select to cache or not the content of this module.

Show Menu Icons: Choose to Show or Hide the menu icons you have specified for your Menu Items.

Menu Icon Alignment: Choose which alignment to display these icons if checked to show.

Expand Menu: Choose to displays or not permanently the sublevel menus for the chosen menu as defined in the Menu Manager (only for Vertical Menus).

Indent Image: Choose which indent system to use. It could be None, provided by the template, be the default Mambo system or customized with the following parameters “Indent Image 1 to 6”.  This lets you choose a specific image for each menu level (the images must be in the images/M_images folder to be available as a choice).

Spacer: Choose a character to act as spacer in a Horizontal menu. It is often a “|” or a “-“.

End Spacer: Choose a character to act as a spacer for the end of the menu.

Menu Manager

Go to Menu-> Menu Manager.

There is a list of existing Menus already defined on your site.

Add / Edit Menu Items

You may add or edit Menu Items for each of the menus showing on the Menu Manager list page. From the Menu Manager window, click the icon under the heading ‘Menu Items’ for the Menu you want to edit, or alternatively go to ‘Menu->the-menu-you-choose-to-edit (all Menus have a direct link to this function in the drop-down under ‘Menus’.)  A ‘Menu Manager [the-menu-you-choose-to-edit]’ window will display, with a list of all Menu Items associated to this Menu.

Each Menu Item operates independently from other Menu Items, so changing the parameters of one item in no way affects the display or parameters of other Menu Items.

Adding a Menu Item

1. Click on the ‘New’ icon in the toolbar. It opens a ‘New Menu Item’ window with a list of the Menu Item Types and a description of each of them through a mouseover of the ‘Information’ icon.

2. Once the choice has been made and the ‘Next' icon has been clicked, a new window opens with the name ‘Add Menu Item:: The-type-of-link-chosen’.

This window is divided into 2 main parts: ‘Details’ and ‘Parameters’. These vary in function depending the type of Menu Item chosen. Some ‘Details’ parameters can also be edited through the list in the Menu Manager as described before under ‘Headings’. Some parameters may show only after clicking the ‘Apply’ icon (or ‘Save’ icon, but this would not be convenient as you would have to edit again the Menu Item Link from the Menu Manager).

Here is a list of available Menu Items:

Content:

  • Blog – Content Category
  • Blog – Content Category Archive
  • Blog – Content Section
  • Blog – Content Section Archive
  • Link – Content Item
  • Link – Static Content
  • List- Content Section
  • Table – Content Category

Components:

  • Component
  • Link – Component Item
  • Link – Contact Item
  • Link – Newsfeed
  • Table – Contact Category
  • Table – Newsfeed Category
  • Table – Web Link Category

Link:

  • Link – Component Item
  • Link – Contact Item
  • Link – Content Item
  • Link – Newsfeed
  • Link – Static Content
  • Link – URL

Miscellaneous:

  • Separator / Placeholder
  • Wrapper

Managing your Home page using the Frontpage Component

First of all, we will explain the concept of ‘Home page’ and ‘the ‘FrontPage Component' in Mambo as many people easily confuse these two concepts.

Home page

One way to think about the concept of ‘Home page' is the place a user begins. When a visitor types in your URL of your site, ‘www.mysite.com’ or when they navigate from another site, the ‘Home page' is usually the first page they visit.  The Home page itself is the first published item located in the ‘mainmenu' section of the Menu Manager.

NOTE: Your “Home page” is the same as your “Front page”.

Even if the ‘mainmenu' Module is NOT published, your ‘Home page' will still display the Menu Item on top of the ‘mainmenu' list of Items.

FrontPage Component

The FrontPage Component publishes content to your Home page (as long as the Front Page Component is the first Menu Item in your Main Menu).  You can assign any Content Item to the Home page by checking the parameter “FrontPage” within the “Edit” Content Item page (in the Back-end as in the Front-end of your site).

The default configuration sets the link to the ‘FrontPage Component' to the first published item in the ‘mainmenu' menu. But, as any other component, it may be placed anywhere in your menus.

How to edit or create a link to the FrontPage Component in any menu:

There are 2 ways to create such a link:

Go to MenuManager -> [the-menu-you-want-to-edit].

1. Create a ‘Component' Menu Item and choose the ‘FrontPage Component' in the drop-down (See Chapter on Menus). Details and Parameters to edit are described below.

2. Create a Link-Component Item and choose the ‘FrontPage Component' in the drop-down. It adds a link to the FrontPage Component that automatically reflects the parameters of the original as defined in the “Component” menu item. You may NOT edit parameters for this type of link. The “Link – Component Item” is useful if you want the FrontPage Component to appear in more than one menu and just want to change the ‘Details’ parameters for that component while keeping the general parameters as defined in the FrontPage Component Menu Item. One aspect is added to the ‘Details’ function. It is the possibility of opening the link in a certain type of window.

If you have not defined parameters for the ‘Component' FrontPage Component Menu Item, the default parameters will be used instead

Using the FrontPage Component when syndicating your site

If you wish to syndicate your site, the feed you provide is taken from the FrontPage Component assigned content items as listed in the FrontPage Manager, even if the component is NOT assigned to your Home Page or has no published module. Parameters for display are available by editing the ‘Syndicate' component.

Creating/Editing and Managing Content

The Content of your Mambo site is managed in the various Content Managers in the Content menu item on the horizontal Menu bar.  They are: Content by Section, All Content Items, Static Content Manager, Section Manager, Category Manager, Frontpage Manager and Archive Manager.

Content by Section

News Section:

In the default set-up, the News section contains a single category, called Latest News. Additional categories can be added using the Category Manager. A News item is the same as any other content item in structure (title, intro text and main body text).  Publishing items in the News section means that they are displayed in the Latest News modules (see Modules) which controls the way the content items are displayed.

Newsflash Section:

In the default set-up, the Newsflash section contains a single category, also called Newsflash.  Additional categories can be added using the Category Manager. A Newsflash item is the same as any other content item in structure (title, intro text and main body text). Publishing items in the Newsflash sections means that they are displayed in the Newsflash modules (see Modules) which controls the way the content items are displayed.

FAQs Section:

FAQs are Frequently Asked Questions. In this section you can publish your FAQs and their responses in an orderly fashion. In the default set-up, the FAQs section contains a single category called, “Example FAQs”.  Additional categories can be added using the Category Manager. An FAQs item is the same as any other content item in structure (title, intro text and main body text).

All Content Items:

Click on this link to be able to view all of your content items.  You can filter them for specific searches.

Static Content Manager

The Static Content Manager is used to create and edit your content you have classified as ‘static’ (which means that it will change infrequently and only the main site Administrators will update it) .  Static content is used for content items that do not fit into the usual section/category/item structure and will not be displayed as ‘blog’ or ‘table’ displays on the user pages of the site.

There are restrictions on the use of content held as Static Content:

  • Static content has no section/category structure – all content is held at the same ‘level’.
  • Static content can not be displayed in the Front Page Manager.
  • Modules can not be assigned to pages containing static content and so text should only be placed in Static Content if it is to have the Modules displayed with it that appear on ‘All pages’ (see Modules)

Section Manager

The Section Manager is used to create sections for your content or to edit the details of existing sections. Sections will not be visible on your site unless the section has a published category in it and that category has a published item.

The Sections created and their status (published/unpublished) is shown in the Section manager. A section can have description text and an image associated with it.

Category Manager

The Category Manager is used to create categories for your content or to edit the details of existing categories.  Categories will not be visible on your site unless the category is in a published section and that category has a published item.

The categories created and their status (published/unpublished) is shown in the Category Manager. A category can have description text and an image associated with it.

Frontpage Manager

The Frontpage Component shows all the published content items from your site marked ‘Show on Frontpage (see Creating Items for more information). The Frontpage is similar to a blog content section with a special feature. The special feature is that you can display any content within your site on the Frontpage regardless of which section/category the content belongs. So you are not limited to only displaying one particular category on the Front page e.g. News, but you can display items from any content section such as News, Articles, or anything else you have published.

Adding content to the Frontpage

To add content to the Frontpage you must set the corresponding flag within the content editing. To add the content to the Frontpage you either mark it in the overview table of your items or check the box for “Show on Frontpage” within the content editing form.

Management of your Frontpage

Select Components > Frontpage from the menu. This page shows you a list of the content items marked for the Frontpage.

Manage Items

Within this overview you can Publish, Unpublish, Archive, sort your display order, and Delete the Content Items, that are located on the Frontpage.

Configuring the Frontpage

You may configure the display of the Frontpage by editing the menu item associated with it. You may configure:

  • the total number of Items to display on the Frontpage
  • the number of Items to display with the introduction text shown
  • the text to display as a header to all the of displayed Items
  • the text to be displayed if there are no Items found to be displayed for the Frontpage
  • the ordering of the Frontpage Items

Archive Manager

The Archive manager shows all your content that you have ‘archived’ (see Content Manager).  The Archive Manager allows you to restore or to trash your archived content.

Managing Components

Components are content specialized elements or applications. Mambo includes some core components and supports the possibility to enhance its features with additional 3rd party components. The built-in components, which are included with Mambo, are part of the core features. You will find third party components at www.mamboforge.net, as well as at various third party developer and community sites.

Additional configuration and help is usually provided within the component itself.

Components are modular in nature, which makes it possible to enhance the features of Mambo in any direction.

A component is typically linked to a Menu item. Visitors and/or Users are able to view the content of the component by clicking on the link of this Menu item. It is usually displayed in the main content area of the site.

Components that are included with Mambo are:

  • Banners
  • Contacts
  • Newsfeeds
  • Polls
  • Web Links

The following describes the components bundled with Mambo.

Banner Component

This component allows you to display banners in rotation on your site. It also allows some advanced features such as impressions management and custom code. Banners can be displayed on your site by simply publishing the banner once it has been created through the process below. It is also necessary to note that banners can be turned off in the Global Configuration (enabled by default) and their location is dependent upon the template being used for your site.

Banner Manager

In this section, you control the actual banners. These are the graphical advertisements or messages that appears in a certain parts of your Mambo site.

Banner Client Manager

This section allows you to set up accounts for clients that you are extending the privilege of banner placement to.

NOTE: Flash type banners may have possible issues with the Mambo Banner Component.

Contact Manager Component:

This Contact component can be found in the Admin Section by navigating on the Menu Bar to the menu item Components > Contact. This takes you to the Contact Manager screen.

The Contact Manager component provides you with the ability to manage a list of contacts for your site. Visitors can find you or your organization's contact information including name, mailing address, telephone and fax number. They can contact you or your organization by filling out the simple contact form and clicking the ‘Send' icon.

You can have more than one contact item. Your visitors will select the contact from a drop down list when they are on the Contact Us page in the Front-end of your site. If you have only one contact then there is no drop down list.

Examples for different contacts would be to have separate contacts for sales, enquiries, or different departments within the organization, therefore making the contacting process more efficient.

Based on the standard list, you can manage all contacts within your database. Use the toolbar to create a New contact, Edit or Delete a contact. The information within the contact form is standardized. For each contact that has an email address, a contact form is automatically created. All published contacts will be shown in a dropdown list. You choose the default contact which will be first on the list in the dropdown list.

Newsfeed Component

Newsfeeds are a way of sharing content between different sites. A growing number of content providers share parts of their content via RSS newsfeeds.

This sharing method is meant for creating a news introduction in the way the provider wants it and it normally has a link to the provider's web site. With some exceptions, such as moreover.com, you rarely have any control over how the newsfeeds will be displayed, links, colors etc, or where these links will go.

The Newsfeed component gives you the ability to manage the existing newsfeeds, place them into Categories, and also change the linking information required to receive the newsfeeds from the different providers.

To share the content of your site you can integrate the Newsfeeds module into your template which makes your own news available to others.

Newsflash Component

A Newsflash is a dynamic message displayed on your site. It is often displayed in a text box to attract attention on your Front page. It gives your visitors a small piece of information, such as important news. You can have one Newsflash item or several.

If you have several, the Newsflash component will randomly pick one every time a page is generated. You can have several Newsflash modules attached to various pages on your Web site.

Poll Component

This component allows you to manage and create different polls for your visitors. The questions you ask can be useful for information purposes.

Displaying polls on your site:

After publishing the poll you need to activate the Polls module. You can choose where you would like the poll to be published and on which page. The module will also provide a link to show the results of your poll.

Syndication Component

The Syndication Component is used to publish a ‘newsfeed' of your ‘public' content items which you have published to your Front page in the Front-end of Mambo.

Editing your Syndication Settings:

To edit your Syndication settings, select Components > Syndication from the top menu in you Admin panel. Edit all fields to your preference then click the ‘Save' icon at the top right hand corner of your screen.

Web Links Component

The Web Links component is a collection of links such as favourite links, Mambo links, or whatever you like. The component makes it possible to count the number of clicks for each link and registered users can submit new links from the Front-end.

Management of Web Links

To manage Web Links in the Administrator menu, select Components > Web Links. The sub menu provides you with two options to manage the Links, Items and Categories. For details on how to set this up, please check the information about setting up categories and items in the Content Section of this manual.

Displaying of Web Links in the Front-end: To display the Web Links in the Front-end, you include the component in your menu structure. You must also ensure that it is published.

NOTE:  Please refer to other Chapters for more information about Frontpage, Statistics, Templates, Modules, and Menus.

Managing Modules

Modules are used to display various information and/or interactive features throughout your Mambo Site.

A Module can contain just about anything from simple plain text, to HTML, to complete standalone Third Party applications. Modules can also display interactive content, such as polls, tagboards, latest news, newsfeeds and more. Site Modules are different from Administrator Modules because they display their content on the Front-end of your site while Admin Modules pertain to various Administrative (or Back-end) tasks and/or features.

Modules can be created by you (custom/user module) or downloaded and installed.

The management of the modules is always done in the Administrator (Admin Section). Go to Modules > Module Manager on the Menu Bar. There you can Install/Uninstall a module and modify the common configurations such as: the Name, the page/s it should appear on, the area it should be placed in, and the access level. From the list choose the module you want to configure.

The Module Manager is at first set to display a certain number of modules. At the bottom of the list you may see a pagination feature, which will allow you to navigate to the next set of modules in the list. You can also set the number of modules displayed on a page by selecting the number in the drop down box on the right of the screen.

Here you may find a list of all site modules instances set by default when installing Mambo. Each refers to a specific module type as defined above. Under the specific list headings are displayed the status of the Modules installed on your system.

Modules are defined by a Type (ex: mod_mainmenu). Many instances of a same module may be created by copying a specific module type, giving it a different title and different parameters to fit your needs.

You may create a custom module with a “User” Type by clicking on the ‘New' icon. This is a very useful module which may be used to display Content (this content is not related to Sections, Categories or Static Content Items) or RSS Feed. It can be used as a text box or image module or even to include customized code.

The following Site Modules are bundled with Mambo:

  • Archive
  • Latest News
  • Login Form
  • Main Menu
  • Popular
  • Newsflash
  • Who's Online
  • Polls
  • Random Image
  • Related Items
  • Syndicate
  • Sections
  • Statistics
  • User  (Custom & RSS Feeds)
  • Template Chooser
  • Wrapper

Managing Mambots

Mambots are functional units of code that support the operation of Mambo. They have many different purposes and functions and are grouped together for easier management. For example, there are Mambots that only operate on content items, others provide search capabilities, etc. In some groups, any number of Mambots can be published at once, while in others (for example, the WYSIWYG editors) only one can be active. In some groups ordering is important, for example, in the content group, the Image Replacement Mambot (mosimage) must be first (top of the listing), and the Pagination Mambot (mospaging) must be last.

The following list outlines the Mambots available in their different groups.

Content Mambots

Any number of Mambots can be published in this group. These Mambots operate on Content Items before they are displayed. They typically replace some sort of shorthand {tag} with other information.

MOS Image

This is an image placement Mambot. {mosimage} tags are replaced with images that you have selected when creating and/or editing a content item. Tags are replaced on a queuing basis. If there are more tags than images defined, the excess tags are ignored. Likewise, if there are more images listed than there are tags, then the excess images are ignored.

This Mambot is for those who like to work without a WYSIWYG Editor as it a convenient way to insert images into the content item.  Others who use a WYSIWYG Editor, still prefer using this mambot to insert images instead of the insert Image icon in the WYSIWYG Editor.  This is a personal preference.

Legacy Mambot Includer

This Mambot allows for the handling of Mambots designed for version 4.5 of Mambo.  If you do not have any pre-version 4.5.1 Mambots installed, this Mambot can be safely unpublished.

Code Support

The code support Mambot renders any text within a pair of {moscode}…code…{/moscode} tags as php code.

SEF

The Search Engine Friendly Mambot makes links in content compatible with installed SEF support.  It operates directly on the HTML within the item and does not require a special tag.

MOS Rating

This Mambot provides for the voting/rating of content items.

Email Cloaking

This Mambot rewrites all email addresses within a content item to ‘cloak' them from unwelcome spambots.

MOS Pagination

This Mambot breaks content items into pages and assembles a Table of Contents.

Search Mambots

Search Mambots add the ability to search all of the different components of Mambo. Basic searching is provided for:

  • Content items
  • Web Links
  • Contacts
  • Content Categories
  • Content Sections

Any number of search Mambots can be published at any one time.

Editor Mambots

Editor Mambots provide support for installable WYSIWYG editors.

Only one editor Mambot can be published at a time. This setting should be changed in the Site > Global Configuration page, rather than on the Mambot Manager page. You can also select to deactivate any WYSIWYG editors, which leaves you with a standard HTML textarea.

Editor Extension Mambots

Editor Extension Mambots allow for additional controls to be included for editing content. For example, icons are placed within or under the editor to insert {mosimage} and {mospaging} tags into your content. (I and P).

Leave a reply
Comment policy: We love comments and appreciate the time that readers spend to share ideas and give feedback. However, all comments are manually moderated and those deemed to be spam or solely promotional will be deleted.