#### Step Three --- Installing modules

##### Overview

A game console without game software is not really that useful. Similarly, XOOPS Cube Legacy without modules is not particularly useful. Modules are what provide the functionality of your site, a forum, news area, images to be shared, wiki for collaborative documentation and so on. It is only after you install some modules that your site really comes into its own. In this section you will install two modules for your baseball site.

##### Step Three (1) --- How to install modules

In short, you need some modules and an FTP client to upload them to your site. First up, you need to get some modules. You do have to be a bit careful here as there are lot of modules around for XOOPS-based systems. XOOPS Cube Legacy 2.1 runs the following modules.

- XOOPS Cube Legacy 2.1 Modules
- XOOPS 2.0.x JP Modules
- XOOPS 2.0.9 Modules

XOOPS Cube Legacy has a compatibility feature which emulates XOOPS2 JP. This ensures that most XOOPS2 JP modules and XOOPS 2.0.9 modules will work on XOOPS Cube Legacy.

###### Get new modules

We will walk through installing a couple of specific modules very soon but when it is time to go looking for your own modules, where do you get information about modules? xoopscube.org and Wiki page are good sources for modules, as well as for themes. Both themes and modules are usuallly distributed in compressed files so you will need utility software to unzip, unpack etc the files you do download. Once you have found a module, download it to your computer and decompress it so that you have a decompressed module directory on your computer. This directory should include xoops_version.php or package.ini.php.

###### Upload modules to your site

Now you have to upload the directory of the decompressed module to the /modules directory under the root directory of your XOOPS Cube Legacy. Keep in mind the following directory tree.

Warning again! It is very common to upload an extra directory as the following diagram shows. Remember that the directory you want to upload should include xoops_version.php or package.ini.php.

##### Step Three (2) --- Install forum module

Your site plan consists of news and a forum. First, let's install the forum module. There are a lot of forum modules --- vB-like, guestbook-like and many others. You should choose your favorite module. For this example, we will install the "newbb" module. It's an older and not so good module perhaps but it's easy to install and explain. Newbb used to be the standard forum module of XOOPS2. Now there are better ones available, --- newbb2, xhnewbb and d3forum.

###### Upload newbb

Download the archive and unzip it. Then upload the directory you unzipped, as explained above.

###### Install module

Click "Module Installation" in the control menu of the Legacy System module in the left block of the control panel.

You will see the list of uninstalled modules. Whenever you upload a module directory, it's icon will appear in this list.

Find the row with the forum module (newbb) and click the install-icon on that row.

You will now see a confirmation screen. Confirm that the module you want to install is newbb, then click "submit". Your screen will display a list of events related to tables being made in your system database. Once installed, you will see a new control menu for this module in the left hand column of the Control Panel.

###### newbb settings

Go to your homepage to confirm that newbb is now installed. You should see the link in the Main Menu. The module has indeed been installed and now all you have to do is change the settings. Most modules need additonal settings before they can be used effectively. Most modules also have a help file with them and that is the best place to start. (Sorry but newbb doesn't have any documents...)

Head over back to the Control Panel (Admin side) and expand the Forum control menu by clicking the [+] icon. Now click Add Category.

Create three categories called "MLB", "Minor League" and "Oregon".

Next, create forums in these categories. Click Add Forum in the control menu.

Inside the "MLB" category, create forums for "2006 League", "Team Information" and "Reports on games". In the "Minor League" category, create theh same forums. In "Oregon", create a "Local Baseball team" forum and an "Oregon Baseball forum".

Newbb is now ready to talk baseball! Go to your homepage and have a look.

##### Step Three (3) --- Install a news module

The other plan for your site is a news module. The administrator posts important information in the news module; site news, news on players from Oregon and other items.

There areof course a lot of different news modules as well as forum modules. For this exercise, for the same reasons we chose newbb, we have chosen to use the "news" module. "News" was the standard news module of XOOPS2. Again it is now old and perhaps not so good anymore, but it's easy to install and explain.

###### News settings

Find a copy of the "News" module. Download and decompress it, and then upload it to your XOOPS Cube Legacy installation. install it in the same way you installed "NewBB" above. Now you need to look at the settings for "News" as you did for newbb. Let's have a look.

Again, go to the Admin side's control panel and expand the control menu for your "News" module. Click Topic Manager.

Add two topics, one called "Site News" and the other "Oregon Players News".

Now let's delete the example topic called "XOOPS", which was created by the news module by default. In Topic Manager, choose "XOOPS" then click
.

Then, click
.

##### Step Three (4) --- How to control the order of the modules

Go to the homepage now and check the position in the main menu of the two modules you installed. You should find that the forum module is above the news module, in the main menu block.

By using Module Management it is possible to control the display order of the modules in much the same way as you controlled the order of blocks. All you have to do is enter a value for the weight of each module. In the admin side, in the left column of the Control Panel, click to expand the Legacy System control menu and then click on Module Management.

You will see the list of installed modules.

Give the forum module a weight of 10 and the news module a weight of 5.

Then click
. The confirmation screen is displayed. Confirm and click
again.

###### TIPS: How to rename modules

The display of the main menu block isn't always what you want. "News" and "Forum" ... these names aren't very kind to visitors. You can rename them easily in the Module Management section. Simply type a new name under the module icon.

###### dirname

Modules have two names, "title" and "dirname". You are free to change the "title" as this is what will be displayed user side. It was the "title" that you changed just now. "dirname" is the term that the system uses and refers to "directory name". It is impossible to rename the "dirname" of most modules. It is a good thing to keep in mind as a basic feature of XOOPS Cube Legacy.

##### Step Three (5) --- Let's finish the top page

###### Add new blocks for the forum and news

Lastly, let's add new blocks to the top page so our visitors can see the latest posts. Once again, in the Legacy System control menu, go to Block Installation. You will see some new blocks which were added when we installed the newbb and news modules. Most modules have one or more blocks that can be used to provide specialised content related to the module. If a module does have blocks, they are added to the available list automatically. Now, let's install the "Recent Topics" block of the newbb module.

And then let's install the "Recent News" block of the news module.

Set the blocks up as follows:

- Set the side to "Center block - center".
- Set the Target modules to "Toppage" only.
- Set the Target groups to all groups.

###### Control the order of the blocks in the center column

Go to Block Management. Set the weight of the custom block "Welcome!!" to 5. Input 10 for the weight of the "Recent News" block and then input 15 for the weight of the "Recent Topics" block. Finally click
.

##### Summary

The XOOPS Cube Legacy standard package was not designed to be a complete system in itself, either for for users or administrators. But by simply finding and installing suitable modules, your site will become extremely powerful, very easily. Remember, too that each module not only brings its own functionality but it's own blocks as well.

GO TO FINAL STEP