2/2/2009

SiteGround Mambo Tutorial: Print Fri…

SiteGround Tutorials Mambo Tutorial
Mambo is one of the most popular Open Source Content Management Systems (CMS) on the web. SiteGround has created this Mambo tutorial based on the long experience we have with hosting Mambo sites. We are the World's leading Mambo host and have released a packful of Mambo resources available for the Mambo Community like FREE Mambo templates.

Mambo tutorial includes useful tips about:
How to install Mambo CMS on your website; Where to add meta data on your site for better search engine optimization; How to change Mambo templates; Links to FREE to download Mambo templates; How to manage your banner ads in Mambo; How to install Mambo addons Selection of the most popular Mambo components, modules and mambots; How to use search engine friendly (SEF) URL's with Mambo; How to add Google Adsense for Mambo; How to backup Mambo; How to upgrade Mambo; and more.. SiteGround has long experience in providing web space for Mambo sites. Our Mambo hosting package is the best choice for Mambo users for it offers the richest set of features, Mambo-expertized support team and lots of FREE Mambo resources.

How to install Mambo on your website? Get a FREE Mambo installation with SiteGround Mambo hosting Package!
SiteGround.com offers usage of the Fantastico auto installer for free with your account. This is a feature of the cPanel accounts manager, and can be easily found in the cPanel's main page: simply click the smiling face icon at the bottom row. ( ). Look for the Mambo Open Source link at the left part of the screen and click on it.

siteground.com/…/printtutorial.php

1/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

A short description will appear to the right. Click on the New Installation link.

You will be prompted to select a domain name, on which you Mambo will be installed. Please make sure that the domain name you have selected has already propagated to the account you are installing Mambo to, otherwise the style will not be applied to your pages and your images will not be displayed. If you would like Mambo to be the start page of your website, please leave the Install in directory box blank. If you are willing to have it in a specific directory, please type in the name of the folder you would like to have it in. In the Admin access data box type in the username for the administrator for your Mambo installation. The next box should contain the password for that user. Type the name of your website in the Site name box. You can also enter the Admin full name and the Admin e-mail in the respective boxes. Those will be used when sending system messages to your new or existing users. Finally, please set the language your Mambo should be using. In case the language of preference is not available in the dropdown selection, you can later on install a language module. When done entering these settings, please proceed by clicking the Install Mambo Open Source button below this panel.
siteground.com/…/printtutorial.php 2/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

On the next page you will see confirmation of the details: where will Mambo be installed, the database and the database username (please note those are created automatically and you do not have to do that by hand). The page may also contain notices on missing details or other system notices. Please do not ignore these! Please note that you cannot install more than one script in one and the same directory. If you agree to what you see, please click the Finish installation button.

On the third page you will see the confirmation for the installation and the addresses for accessing the installation. If you have selected to install Mambo in your root directory (so that it is the start page of your website) you will be able to access the site using the address below: http://yourdomain.com and the administrative interface will be found at: http://yourdomain.com/administrator/ In case you decided to have Mambo in a specific directory, e.g. 'mambo', you will be able to reach your
siteground.com/…/printtutorial.php 3/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

installation at: http://yourdomain.com/mambo/ Administrator login will be located at: http://yourdomain.com/mambo/administrator/
Please note that if you used www.yourdomain.com in the configuration, you will need to use www when accessing your administrator panel as well, otherwise you will lose functionality, including editing your content items.

Mambo Templates How to change Mambo Templates?
Now we can change the template of the website. If you like a template that is not included in the installation package, you can add it in the manner described below. First, you need to download the source file of the template (usually in zip format) to your local computer, and then go to the Installers menu in Mambo administrator and choose the first item - Universal.

siteground.com/…/printtutorial.php

4/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

You will be prompted to locate the template source file.

When done, please click Upload File and Install. Please wait for the confirmation message to appear, and then click Continue.

Now you need to go to the Template manager in order to make the new template the default for your website. Please, go to Site->Template Manager->Site Templates

siteground.com/…/printtutorial.php

5/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

You need to select the template you have just uploaded and then click the Default icon at the top right. You will be able to immediately discover the differences.

This is the website before (using the default template of the installation)...

siteground.com/…/printtutorial.php

6/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

... and this is how your website would look if you installed the template we used...

Well done! You have successfully changed your Mambo template!

Mambo Languages
In order to install a new language pack to your application, you should first login to the Administrative panel. Once logged into it, please select the Installers tab and chose the first item - Universal.

siteground.com/…/printtutorial.php

7/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

When the page load, please click the Browse button and select the language file, which you would like to get installed in Mambo, and click the Upload File & Install button. Once the page loads up, the language file should be installed and you would be able to use it within the application. In order to do so, please use the Site tab - Language Manager

To make a given language the default one, please click the the desired language. Well done!

icon, which resides on the same line as

Mambo Administration - Global Configuration
Now we can proceed to tuning your Mambo, including changing the default language. Please visit the Global Configuration icon.

siteground.com/…/printtutorial.php

8/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

The Site tab allows you to: turn off your website (i.e to place it into a maintenance mode); customize the general error message (which is being used while there is an error which is preventing the application from loading properly); and choose a Site Name (Company Name) for your website - that would be the <title> tag of your website; turn on/off the Captcha authentication.

The Locale tab allows you to: specify locale different from the default one; change the TimeZone settings here, so if you are not located on the same one where our servers are located - you would be able to make your application show the correct time; select the language that the site will display - it can be picked up amongst the already installed and published language packs on your Mambo system.

siteground.com/…/printtutorial.php

9/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

The Content tab allows you to modify the general outlook of the generated pages of the CMS. For instance, you can choose whether to display the printer-friendly version link can be turned on or off for your content. For those of the options that have complicated names, additional information can be obtained when hovering with the mouse pointer over the blue circle at the end of each row.

Please, find below information about the other options in the Global configuration tab: Meta data, Mail, Stats Search Engine Friendly URLs
We do not recommend changing the default Database, Server, and Cache tabs, unless you know what you are doing. Any incorrect setting in these sections could render your Mambo powered website to be inaccessible.

Mambo Administration - Global Configuration
The Metadata tab allows you to add meta description for your website as well as keywords - entering these will allow your website to be easily discovered and listed by the search engines.

siteground.com/…/printtutorial.php

10/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

Mail tab contains settings for Mambo's mass mail function - that allows you to send messages to all your users. The default settings here are correct and tested to be working with installations on SiteGround servers - the only setting that you may decide to change is the sender e-mail address.

Changing the settings in the Cache tab can lead to security issues with user accounts (especially on publicly accessible computers) and are generally not recommended. The Statistics tab has three options. The website would mostly benefit from turning on the first one only, since the other two will collect large amounts of data that will remain on your disk quota.

siteground.com/…/printtutorial.php

11/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

Please, find below information about the other options in the Global configuration tab: Site, Locale, Content Search Engine Friendly URLs
We do not recommend changing the default Database, Server, and Cache tabs, unless you know what you are doing. Any incorrect setting in these sections could render your Mambo powered website to be inaccessible.

Mambo Administration - Global Configuration
Using Search engine friendly URL's in your Mambo system will let you gain higher positions in Google, Yahoo, MSN, etc. In order to install Search Engine Optmization module in Mambo you have to: Step 1: Navigate to: Site => Global Configuration => SEO. Then change 'Search Engine Friendly URLs:' to be Yes and Save the new settings

Step 2: Now, navigate to the folder on your account where Mambo is installed by using an FTP client (More information about installing, configuring and using an FTP client here.) And rename the file 'htaccess.txt' to .htaccess.
siteground.com/…/printtutorial.php 12/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

Congratulations! You have successfully activated the SEO option in your Mambo! Please, find below information about the other options in the Global configuration tab: Site, Locale, Content Meta data, Mail, Stats
We do not recommend changing the default Database, Server, and Cache tabs, unless you know what you are doing. Any incorrect setting in these sections could render your Mambo powered website to be inaccessible.

How to use Mambo Media Manager?
In order to fully utilize the multimedia capabilities of Mambo, you can start using the Media Manager utility. You can find that in the Site menu. When you click it, a listing of the items will appear: both folders and separate images will be displayed. In order to select which folder you will be uploading to, you can use the Directory dropdown menu.

Under the file and folder list, you will be able to see three input boxes:

siteground.com/…/printtutorial.php

13/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

Upload allows you to select file and upload it to the image library (using the Browse button and then clicking the Upload icon in the top right corner).

The Code box displays the HTML code that allows you to link to the image from the library you have clicked on.

Through the Create Directory box you can create a new folder to which you are able to upload files. Type in the name of the directory and then click the Create icon at the top right corner menu.

siteground.com/…/printtutorial.php

14/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

In order to be able to upload to a certain directory, please click the folder image, under which the specific name appears:

the page will be refreshed and you will be able to upload directly to the respective folder. If you are willing to delete a file or an empty folder, you can click the trash-can image below the item you wish to delete. You will be prompted to confirm deletion.
Please note that in case the directory you are trying to delete is not empty you will be unable to remove it.

Mambo Content
Now it is time to add some content to your website! In order to create the desired hierarchy, you need first to gain understanding of the classes of content that are included in Mambo. Those are sections, categories and content items. The highest level in the hierarchy is represented by the sections. These can be managed through the Section Manager of the Content menu. Imagine the sections as the drawers in a cupboard that
siteground.com/…/printtutorial.php 15/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

contain the folders (categories), filled with articles (content items). If you are having a Mambo website about cars, you will have the sections 'Ford', 'Chevy' and 'Dodge'. The 'Ford' section will have categories 'Mustang', 'Thunderbird' and 'Taurus'. The 'Mustang' category will have content items 'V6GT', 'Steeda Q' and 'Shelby Cobra GT500'. The entire structure is much like a tree:

Mambo Content Structure - Sections, Categories, Content items
Please, find below information about the different content structures in Mambo: Mambo Sections Mambo Categories Mambo Content Items

Mambo Content
Let us first start with creating a section. To do that, please go to the Content menu and select the Section Manager option. Once in there, you will see the list of existing sections. Click the New icon in order to create your own section. In the fields that appear, fill in the details of the section: title, description, etc. When done, please click the Save icon at the top right. You will be taken back to the section list, which will now include the section you have just created. In order to link it to a menu you will need to click on its name and edit the linking properties (those preferences determine where in the menus should the section appear in the menus of your website).

Mambo Content
Next step in organizing the content in your website is creating the categories. To do that you need to go to the Category manager through the Content menu: There you will be able to see the existing categories, edit and manage those and create new ones. Click on the New icon to start the creation process and fill in the details required for the new category. It is important to select the parent Section for the new category, in order to have the proper content organization (or at least the one that you desire). Again, you can set the menu linking details after the category being saved.
siteground.com/…/printtutorial.php 16/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…
Please note that an empty secti on or an empty category will not show up in the menu. Each of these must have at least a single content item created and published.

Mambo Content
In order to create and publish a Content Item, please go to the Content menu and select All Content Items. All the items that have been included in Mambo article list to date will be displayed. You will be able to either edit and manage the existing ones, or create new ones by clicking the respective icon: The process of creating a new article is very similar to the one through which the sections and the categories are being created. This time you will need to select both the parenting section and category, in order to build the last level of the hierarchy. This time, instead of description you will be able to enter a short introductory text, that will appear in the main section or category page, or at the starting page of your website in case you publish the item to the front page of your Mambo. Again, you will be able to determine where does the item appear in menus, add pictures, manage authorship and publishing date, etc. When done, click the Save icon to complete the creation process. You will be able to see the new item listed in the Content manager. The last thing to go in order to have the item online is to publish it - just click on the red X and that will publish the article. You can also change the order in which the articles appear through clicking the up- and down-pointed triangles respectively. That can also be done through changing the number in the Order box that you see on the same line and then pressing the Enter key on your keyboard: the smaller the number in the box, the higher the article appears. The changes will automatically be applied and you will see the changes when the screen refreshes.

How to use Mambo Modules, Components and Mambots? Enhance your Mambo system with the most popular Mambo addons!
Until now we have been changing templates, adding content, uploading files, etc. How about adding extra functionality to your website? That can be easily done by installing three kinds of add-ons that you can integrate with your Mambo. Those are modules, components and mambots.
Components add functionality to the Mambo itself - e.g. content management functions, that cannot be

noticed directly, but help ordering and customizing your website.
Modules are used as a bridge between the Component and Mambo: you need a Module to enable a chosen Component on MOS. Mambots are add-ons for Mambo that perform a specific function when triggered without being displayed before your visitors. They can range from text-replacing to something as complicated as a template-management system. E.g. WYSIWYG editors are Mambots.

If you are willing to install an add-on of any of the kinds above you can do that very easy through Mambo administration interface. First of all you need to find and download the addon from a website with Mambo addons, such as MamboXchange website and save it to your local hard drive. Then, just select the Installers menu and the Universal tab from within your Administrative backend:

siteground.com/…/printtutorial.php

17/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

When in the installation page please find the zip source file and upload and install the add-on. In case of success you will be prompted to continue to the list of add-ons of this kind and manage your new addition according to the specific documentation. SiteGround has made a selection of the most popular Mambo components, modules and mambots our clients prefer to install on their Mambo sites. On the page you will find a short description of the Mambo addon plus a download link. SiteGround provides installation of Mambo components as part of its Exclusive Professional Services. Favorite Mambo addons:
Virtuemart SMF forum phpBB Forum Mambo Calendar Weather Module CMS Realty - Real Estate zOOm Gallery

Mambo Banner Component
Mambo allows you to easily remove or change the banner ads that are part of the default installation, or add and manage new ones to your preference. That can be done through the Components menu Banners tab and from the expended menu select Manage banners. In the banner list check the boxes in front of the two default banners and then click the Unpublish or the Delete icon at the top right... That's it :-) You can also add and remove the separate clients from Manage clients tab, just below the Manage banners one.

Mambo Polls Component
When installed, Mambo includes a poll. The Poll manager is what allows you to create, edit and remove polls from your website. Results are being automatically calculated and displayed on a separate page. In order to manage your polls, you need to reach the Poll manager You can do that by clicking on the Polls link in the Components menu:

You will be taken to a page, where at your first visit you will see a single poll: the one that comes by default with the Mambo installation. Clicking on the poll name will allow you to edit the questions and answers. You can replace those with your own, then save the survey. In case you are unwilling to have a poll on your website (at least for now) you can un-publish that by selecting the respective survey and click the respective icon. The poll will be immediately removed from the website, but will not be deleted. Thus you can take it back any time you want. To permanently remove a poll from your Mambo, please use the Delete icon.

Mambo Modules, Components and Mambots
siteground.com/…/printtutorial.php 18/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

Community Builder is a component for Mambo (Joomla) that extends the user management system of these applications. To install Community Builder for Mambo you have to: Step 1. Install the latest version of Mambo on your account. Find more information about how to install Mambo here. Step 2. Then, you have to download the Community Builder component. You can do that from here. Step 3. Now, you have to extract the file that you have just downloaded: Step 4. Then, please, navigate to the folder that you have just extracted. You should be seeing these files: The main Community Builder component is the file named: comprofiler.zip Step 5. Now, please open the Admin Panel of your Mambo installation and navigate to: Installers -> Universal. You should see: We will use the 'Upload Package File' option. Step 6. Click on the 'Browse' button and navigate to your: comprofiler.zip file, then click on the 'Upload File and Install' button:

Now, you should wait up to 1 minute until the installation process is finished. At the end, you should see this screen: and you should see these red lines: 1.) create /home/petar/public_html/mambo//includes/domit/ directory 2.) chmod it to 777 3.) copy corresponding content of a mambo 4.5.2 directory. But there is nothing to worry about - when we integrate Community Builder with Mambo 4.6.1 we need to download Mambo 4.5.2 (Download Mambo 4.5.2 from here). Then extract the .zip file and navigate to includes folder: Step 7. Now, you have to upload the folder named: domit from the includes folder of your Mambo 4.5.2 to the includes folder of your SiteGround Mambo installation. You can do that by using an FTP client: More information about installing, configuring and using an FTP client you can find by visiting our great tutorial at: That's it - you have successfully installed Community builder on your account. Please note that Community Builder comes with 3 modules: You can intall them by the same way: Mambo admin panel => Installers => Universal:

After the successfully installation of every module you should see this screen:
siteground.com/…/printtutorial.php 19/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

Step 8. After you have installed Community Builder you can configure it by using: Components => Community Builder: You can manage its modules by using: Modules => Site Modules: Well done! You are ready!

Google AdSense and Mambo How to use Google AdSense with Mambo: AdSense Mambot Installation and Setup
If you would like to use Google AdSense on your Mambo site you would have to add some functionality to your Mambo Administration tool. First of all you need to download the necessary application. Please find and download the Adsense Mambot from here. Please, save it on your local drive, from where you can upload it to your Mambo site later on. As you can see the application is a Mambot, so, you need to upload it in your Mambots menu. Please select Universal from within the Installers Menu. Now, click the Browse button and select the file which you already downloaded - the Adsense Mambot and press Upload File and Install. Now you can see the new Mambot in your Mambots list. Next, please select Site Mambots from your Mambots menu: Find the Google Adsense Mambot link (please note it could be on your 2nd page) and click it. Here you need to enter you Google AdSense data so that you are able to display Google Ads on your Mambo site. Next to each item from the Parameters section there is a more Info button. Please, take the necessary data from your Google Adsense html code. Include Google AdSense in your Content Include Google AdSense in the Side Columns

How to use Google AdSense with Mambo? Include Google AdSense in your Content
Once you are ready with Adsense Mambot setup, you can include Google Ads right into your Web site Content by pasting {mosgoogle} inside your content: Mambot Usage : {mosgoogle} in content or AutoAds "ON" displays a Google Ad as specified in paramenters. You can also use {mosgoogle left}, {mosgoogle right}, {mosgoogle none} and {mosgoogle center} if you want the ad align differently from the set parameters. Add a channel id after the align param or only channel id to select individual channels for your ads
siteground.com/…/printtutorial.php 20/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

You can choose to display Ads or AdLinks, Collapse empty ads or replace them with an alternate ad or color"

Now Save it and you will see your Google Ads in your site content. Include Google AdSense in the Side Columns

How to use Google AdSense with Mambo? Include Google AdSense in the Side Columns
If you would like to include Google ads in the side columns (where to the left is the Main Menu and to the right is the Poll in the default Mambo installation) you would need to: Step 1. Create a new Module from the Module menu: Select Site Modules: Create a new Module: Step 2. Publish the "No WYSIWYG Editor" and unpublish the "WYSIWYG Editor" if applicable. Select Site Mambots from the Mambots menu: Publish the No WYSIWYG Editor: Unpublish the WYSIWYG Editor if available in the list of Mambots. Step 3. Copy and paste your AdSense code in the New Module content section Select Site Modules: Choose the New Module we have created (Ads by Google): Copy and paste Google Adsense code in the Content section:

Now press Save and you can see AdWords on your site:
siteground.com/…/printtutorial.php 21/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

Mambo Backup
In order to backup your Mambo application you have to: Step 1. Backup all your files Backup all of your files and folders inside your Mambo installation. You can do that by downloading them via your favourite FTP client. For example if you have installed Mambo in the folder named: 'mambo1' you have to download the entire 'mambo1' folder: Step 2. Backup/Export your database Then, you have to export your Mambo database. You can do that by using PHPMyAdmin. Find out how to reach the PHPMyAdmin here. Now you need to find which database your Mambo installation uses. You can find that by using: Cpanel -> File Manager and navigate to the configuration.php file in your Mambo directory. Click on the file and from the file menu the right choose the Edit File link. Please, find the following variable: $mosConfig_db The value of this variable will show you which database does your Mambo installation use - e.g.: $mosConfig_db = 'username_mamb1'; In this example, you would need to backup/export the mamb1 database. Please, click here to find out how to backup/restore your MySQL database. Once you have the Mambo installation files and the database exported on your hard drive, you have your Mambo backed up! Congratulations!

Mambo Upgrade If you have installed Mambo via Fantastico:
You have to open Cpanel => Fantastico => Mambo Open Source and if there is a new version of Mambo, Fantastico will give you an 'Upgrade' button. You will be able to upgrade Mambo by clicking on that button:

If you have installed Mambo manually, you have to upgrade it manually.
We will show you how to upgrade Mambo: Step 1. We assume that you have already installed an old version of Mambo on your account. Now, you have to download an upgrade package. After you've downloaded the file, you have to extract
siteground.com/…/printtutorial.php 22/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

it: Step 2. Backup your site (both database & site files). Learn how to backup of your Mambo website. Step 3. Take your site offline: Site -> Global Configuration -> Site -> Site Offline (YES) and click Save: Step 4. Then, you have to remove the following files and whole directories in your current Mambo installation by using your FTP client: Directories: /includes/patTemplate /includes/domit /help Files: /includes/mamboxml.php /globals.php /administrator/includes/auth.php /administrator/components/com_weblinks/weblinks_item.xml /administrator/components/com_languages/admin.languages.html.php For example if you have installed Mambo in the folder named: 'mambo1' on your account, you have to remove: public_html/mambo1/includes/patTemplate public_html/mambo1/includes/domit public_html/mambo1/help and public_html/mambo1/includes/mamboxml.php public_html/mambo1/globals.php public_html/mambo1/administrator/includes/auth.php public_html/mambo1/administrator/components/com_weblinks/weblinks_item.xml public_html/mambo1/administrator/components/com_languages/admin.languages.html.php Step 5. Now, you have to run the SQL statements from the corresponding file which should be in the upgrade folder via your normal database interface (i.e.) phpMyAdmin. (We will show you how to do it via PHPMyAdmin) You will need to replace #__ with whatever your table prefix is. By default the Mambo table prefix is set to mos_. Here are the SQL statements that you have to run (The #__ is renamed to mos_). As we have already mentioned - you can run these SQL statements by using PHPMyadmin that comes with your CPanel.

congfiguration.php
Now you need to find which database your Mambo installation uses. You can find that by using: Cpanel -> File Manager and navigate to the configuration.php file in your Mambo directory. Click on the file and from the file menu the right choose the Edit File link. Please, find the following variable: $mosConfig_db The value of this variable will show you which database does your Mambo installation use - e.g.: $mosConfig_db = 'username_mamb1'; Step 6. Now navigate to your Mambo database in PHPMYadmin, go to the 'SQL' tab and paste the
siteground.com/…/printtutorial.php 23/24

2/2/2009

SiteGround Mambo Tutorial: Print Fri…

SQL statements in the blank box, named Run SQL query/queries on... Step 7. Upload all files inside the Patch_xxx_to_xxx folder (on your computer) into your Mambo installation on your hosting account. Let them overwrite the existing files. You can do that by using an FTP client. Step 8. Open your configuration.php file and if your $mosConfig_lang = 'english'; change it to $mosConfig_lang = 'en'; To do that you can use the File manager (see the step above). Step 9. If you are using SEO then remove your old .htaccess file and rename the new htaccess.txt file to .htaccess. Step 10. Bring your site back online: Site->Global Configuration->Site Offline (NO). Step 11. Remove the upgrade folder. Well done! You have successfully upgraded your Mambo system! Please, feel free to contact us if you have any questions or recommendations about this tutorial at: tutorials 'at' siteground.com

siteground.com/…/printtutorial.php

24/24