CMS 13 minutes

Mambo User Manual – Part 2

Last updated: Author Jason Moth

Site Preview

A Site Preview function has been provided to enable you to view the progress of your work on your site. Choosing “Site –> Preview” from the Administrator menu gives you three choices:

  • new window
  • in-line
  • in-line with positions

Choosing any of these options, the home page of your site is displayed. The first choice, “New Window” opens a new window to view the front-end of your site.

The second choice, “In-line”, lets you view your Front-end of your site inside an IFrame window within the existing window of your browser.

The third choice, “in-line with positions”, shows your home page template with the names of the various blocks (“User”, “Right”, “Left”, “Debug”) displayed rather than the material that goes into those blocks.

Site Statistics

There are three statistical analysis reports available:

  • Browser
  • OS (Operating System)
  • Domain Statistics

NOTE:  Many of these items are not activated by default. You can activate them in the Global Configuration if they are not!

Browser statistics

These statistics are provided on the first tab. By default, the results are sorted by the browser name in ascending order. Browser statistics shows you which browser the user has been using when browsing the site.

NOTE: These stats are only as a guideline as some browsers can fool such detection scripts to appear as another browser than it actually is.  This may be because some sites only allows Internet Explorer to view, then the not-Internet-Explorer browser pretends like it is Internet Explorer and is still able to view the site.

Click the icon beside the column heading to toggle between ascending and descending order.

You may also sort by the relative percentage of the results. Click the icon next to the ‘%' column heading to toggle between ascending and descending order. To re-sort by the browser name, simply click again the icon next to the column heading.

Operating System statistics

These statistics are shown on the second tab. You may sort the results in a similar manner to that for the Browser statistics (either by Operating System name or by percentage).

These stats tell which Operating System the user was running when browsing the site. As with the browser statistics, you can never be sure that these are 100% correct. But, they are much more reliable than Browser stats. Again, use these stats as a guideline.

Top Level Domain statistics

These statistics are shown on the third tab. You may sort the results in a similar manner to that for the Browser statistics (either by Domain name, or percentage).

Page Impressions:  This report shows the most viewed Content Items.

Search Text: This report shows a list in ascending order of the Items submitted in the Front-end search feature that have been entered by users. Columns show the text, the number of times it has been searched for and the number of results that would be returned for that text or phase.

Analysis of these results will allow you to tune your site to allow visitors to find possibly obscure or miscategorized content. For example, misspelled or pluralized or singular words may be added to the Meta Data (keywords or description) to supplement phrases or words in the body text of the Content Item.

It would be silly to write an article like ‘We have the following job/jobs/job vacancies …' Instead you can add ‘jobs', ‘job vacancies' or even ‘josb' (misspelled) to the Meta Data of the Content Item to improve the search characteristics of your site.

This is forgotten by many, but if done properly, it can give the site's owner or webmaster valuable information about the visitors to the site.

More information on how to analyze Mambo search engine results can be found in the next section.

Search Engine Text

This page lists the logged search text that visitors have used on your site. The list shows:

  • Search Text: This is the string or phrase the site visitor entered.
  • Times Requested: This is the number of times this text has been entered.
  • Results Returned: This is the number of search items that would appear if you performed the search now.

Some results to look at are words or phrases that are commonly searched for, but return no results. You should assess whether you have content that is applicable. If necessary, add keywords using the Meta Info tab for that content item.

Other results to look for are misspelled words or related words. For example, if a common search word is ‘dark' but it is commonly misspelled as ‘drak' then you may consider putting ‘drak' in the keywords section. You may also have content about a waste facility where you might add common alternative terms in the meta keywords such as ‘trash' or ‘dump'.

You must enable the “Log Search Strings” option in the “Statistics” tab of Global Configuration for this data to be collected.

Media Manager

The initial view of the Media Manager screen presents all existing root directory media folders and images along with three text input fields. This manager allows you to perform 3 basic tasks:

  • Create (and remove) directories for your media files
  • Upload media content to any folder, or delete existing media files
  • Retrieve the code (full URL) needed to use the media in your site

To create a new directory

In the Create Directory text box, enter a name for the new directory, and then click the ‘Create' icon on the toolbar. The directory will then be created and available to you for storing your files. This will be a sub-directory under the main directory (initial view). It will be shown as a new folder in the Media Manager window.

NOTE: Creating directories is only possible if your server has ‘safe mode off'!  (You can check this setting from the Menu: System / System? Information: PHP settings). If “Safe Mode” is on, you can ask to have this turned off by your Internet Service Provider. If this setting is ‘ON', you will have to create your directories using your FTP software.

You can delete a directory by clicking on the ‘Trash Can' icon under the image of the corresponding folder. Clicking the ‘Folder' icon itself will switch to the contents of that directory.

Uploading a file

To upload a file, either enter the location of the files on your hard drive into the text box, or click the ‘Browse' button. The ‘Browse' button will open a new pop-up window, from which you can navigate to the location on your hard drive to the file that you want to upload. Select the directory that you wish to upload the file to. Click the ‘Upload' icon in the Toolbar.  Your image or document will upload and then be available in the chosen directory.

Deleting a file

To Delete a file, click the ‘Trash Can' icon under the image of the file in the Media Manager window.

Retrieve a file's hyperlink

Click the pencil icon of the file in the Media Manager screen.  This will enter the hyperlink code into the ‘Code' field'. This can then be used by copying and pasting the code into e.g., a content item or module text box.

NOTE: Make sure your files have the correct file extension for their image or document type.  This will help you to organize the images or files within the Media Manager into appropriate directories.

Upload and Manage Media Files

The Media Manager enables you to organize your media files within Mambo for use in various articles on your website.

Directory: The drop-down box displays the folder you are in. A forward-slash (/) denotes you are in the root or top of the Media Manager directory structure.

Upload: Enter the file’s location or click the ‘Browse' button and select the file that you want to upload from your PC or workstation. Next, in the ‘Directory' drop-down box, select the directory that you wish to upload the file to and click the ‘Upload' icon. A message confirming the success of the upload will display and the file will appear in the Media Manager gallery window.

Code: Clicking the thumbnail image or the pencil icon under it in the Media Manager window will enter the hyperlink code in the ‘Code' text field. This can be copied for pasting, for example, into a News item or other item appearing on the Frontend of your Web site.

Create Directory: Enter a name for the new directory in the ‘Create Directory' text box and click the ‘Create' icon on the toolbar. The new directory will be created and will be available for storing files.

Delete: To delete a file or a directory, click the ‘Trash Can' icon under the image of the file in the Media Manager window. A directory must be empty before it can be deleted.

Language Manager

The Language Manager allows you to maintain the installed language files for Mambo.

Installed Languages – This list shows all of the currently installed Mambo Languages with a tick next to the currently active one.

Installing/Uninstalling Front End language file

There are two ways to install a Language file or a Template using the Mambo administration system.  All methods assume the file you want to install is already stored on your local drive.

To Upload a Language file or Template:

If your server has GZip support with PHP, you will be able to upload a zipped package file that will be installed automatically. “Browse” to the location of the element (zipped package file of a Language file or Template) on your computer. Then click the “Upload File & Install” icon.

To Install From a Directory

If you don't have GZip support then you must unpack the zipped file onto your local drive before uploading it. Unzip the archive into a folder on your local drive and upload the unpacked archive files to your host's server. Type the location of this file (it must be the absolute location) then click the ‘Install' icon.

To Uninstall

If you want to delete any language go to the menu item Site-> Language Manager-> Site Languages and use the “Delete” icon.

If you want to delete any template go to menu item SIte->Template Manager-> Site Templates or ->Administrator Templates and use the “Delete” icon.

Editing Front End language files

The Language Manager page shows a list of the Languages for the core text on the Frontend of your site.


Publish:  To Publish a language, select the radio button next to the name of the language and click the “Publish” icon.

New: Click the “New” icon to upload/install a new language to your site. You will be then taken to the Install/Uninstall screen.

Edit: Click the name of the category to Edit the details, or select the radio button next to the name and click the “Edit” icon. Here is where you edit the Frontend language file.

Delete: To delete a language, select the radio button next to the name and click the “Delete” icon. You will be asked to confirm the delete operation. Select the “Yes” icon to delete the client or the “No” icon to cancel. The language file will be deleted from the server.

Help:  Click the “Help” icon to view the Help Screen to get explanations of this screen.


Language: This column shows the name of the languages installed.

Published: This column shows the active language that is published.

Version: This column shows the version of the language file.

Date: This column shows the date of the language file.

Author: This column shows the author of the language file.

Author Email: This column shows author's email address, if available.

Trash Manager

Basically, the Trash Manager restores or deletes items that have been trashed, similar to the Recycle Bin application in many operating systems.

You can move Content, Category, Section or Menu Items to the Trash Manager by clicking the ‘Trash' icon in the Toolbar.  Within the Trash Manager you can then either restore the item to its original place or delete it permanently.

This is for security purposes so that you don't accidentally permanently delete an item. When you select the items for removal, you get a pop message asking if you are sure you want the items deleted permanently from the Trash Manager.

In the Trash Manager, you have 2 tabs:

  • Content Items
  • Menu Items

And 2 options:

  • Restore
  • Delete.

Restore:  You can restore any number of items in one go. Merely tick the items to be restored, then click the “Restore” icon. You will then receive a prompt asking if you wish to continue. Click “YES” and the item is restored to its original section and category as an unpublished item.

Delete:  You can delete any number of items in one go. Merely tick the items to be deleted then click the “Delete” icon. This will take you to the “Delete” confirmation page. Here you will see the number of items to be deleted and their item names. If you wish you can click the “Cancel” icon or click on the “Delete” box.

When you click on the “Delete” box, a final alert asks for confirmation and notifies you that the item is being deleted permanently.

This will actually delete the item permanently from the database, and leave no trace behind. A restoration of this item will be impossible from the Mambo database, unless you have a backup of it somewhere.

NOTE:  If you delete a Mambot, Component or Module, you can't recover it through the Trash Manager.

Additional Information

The Trash Manager screen shows a list of the Content Items that are in the ‘Trash bin'.

If your list is long, you may enter text in the “Filter” box to refine the list based on whether the text is found in the title of any item in the trash bin. Type in any text and press ‘Enter'.

Title: This is the title of the trashed item.

Section: This is the section of the trashed item.

Category: This is the category of the trashed item.

ID: This is the ID of the trashed item.

Restore: To Restore one or more items, select the checkbox(es) next to the title of the item(s) and click the ‘Restore' icon.

Delete: To delete an item PERMANENTLY from the database, select the checkbox next to the title and click the ‘Delete' icon. You will be asked to confirm the delete operation. Select ‘Yes' to delete the content item or ‘No' to cancel.

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.