Xoops Modules

 

 

Overview

Xoops comes with a number of installable "modules" as standard which don't need to be uploaded to the server. Each module performs a specific function, and has its own backend administration. These modules are installed simply by clicking on an appropriate install icon.

To find the Xoops modules admin go to got to your site administration link, and let your mouse hover over the System Admin icon--then choose Modules. This where you install the standard modules that come with Xoops. You can also rename modules in this section. This module name will appear as a link to the module in your  Main Menu.

Other non-standard modules you have downloaded are uploaded to the www.yoursite.com/modules folder. These uploaded modules will automatically appear in the bottom section of the Xoops Modules administration section after upload.

Example Modules

NEWS

Users can submit content for admin approval or automatic approval can also be setup for user groups if desired. News categories and sub-categories are also easily defined within Xoops, which assists with the efficient management of content.

NEW FORUMS

Interactive message boards often called Forums where users can post topics and reply to topics online. Posted messages appear in a threaded or "flat" format.

ARTICLES & CONTENT

Many article or content modules are available for download which are not at the time of writing provided with the standard installation. Each content module has its own specific range of features. Webmasters normally choose the content module which suits their preferences.

Most of these article or content "wrapping" modules come with a "what you see is what you get" (wysiwyg ) editor. Text can be copied and pasted from text editors like MS Word; or, existing HTML code can be pasted from applications like DreamWeaver or FrontPage.

Other freely available modules include web links, downloads, contact, polls, FAQ, photo-galleries, business directories, chat scripts, and weblogs to name a few. Recently some powerful popular programs like Coppermine gallery, Invisionboard forums, and Oscommerce for online shops has been successfully integrated into Xoops

List of Modules

How to install an Xoops Module

To install a module that is already included with the Xoops distribution, go to your Xoops site administration, and then System Admin-->Modules

This takes you to the Xoops Modules Administration screen.

Look for the bottom section of the screen below the submit icon, and you will see icons like these.

Module Version Action
1  
1.1  
1.1  
1  

To the right of the module you wish to install ( below the Action column) you will see the install icon which looks like this:

Install Icon

Click this Icon to install the desired module. You will then be presented with a screen like this:


Contact Us

Press the button below to install this module

Click the install button, then you will get a message like this:

Installing Contact Us


Version: 1

Module data inserted successfully. Module ID: 4
Adding templates...
  Template contact_contactusform.html added to the database. (ID: 91)
  Template contact_contactusform.html compiled.
Setting group rights...
  Added admin access right for Group ID 1
  Added user access right for Group ID: 1
  Added user access right for Group ID: 2

Module Contact Us installed successfully.


Back to Module Administration page

Uninstall a module:

Module Version Last Update Active Order
(0 = hide)
Action

1 2004/3/14 17:37
   

1.1 2004/3/14 17:43
 

To Uninstall a module you must first deactivate the modules before the uninstall icon will apear. To deactivate go to the Active column, and take out the checkmark to the right of the module, see the box in yellow above.

Then click the "Submit" button, you will see a page with content like this:

System No Change 1
News Deactivate

1

Click Submit again, then this confirmation will appear

Module News deactivated successfully.


Back to Module Administration page

Go back to the module admin page and an uninstall icon will appear next to the deactivated module.


1 2004/5/12 18:51
  

Uninstall icon

Click this icon to uninstall the deactivated module. The uninstall process will delete any tables from your Xoops database, but not delete the files from your server. To delete the files from your server go to:

www.yoursite.com/modules

Open up this folder and find the folder with the name of the module you just deleted and delete it from your server. This folder can be left on the server for later reinstallation.


How to upload and install a non-standard xoops module

To install a module not included with the Xoops distribution the required module must be downloaded and extracted to your local computer and then uploaded to to this folder:

www.yoursite.com/modules

Ensure the correct folder and file structure is used when uploading. Some downloaded modules have the module folder within another folder i.e.

nameofmodule V2,1
nameofmodule (choose this one)

Each module will have a file called xoops_version.php inside the root module folder, upload the folder with this file directly inside.

Remember to read any "Read Me" text files or Install instructions which may include extra tips on installing a particular module.

After you upload the module folder and its contents, go to your site admin and then System Admin-->Modules to install the module.

The uploaded module icon will appear automatically in this section. Then just follow the normal install procedure demonstrated HERE


How to change the name of the link in main menu

To change the name of a modules navigation link in the Xoops Main Menu go to System Admin-->Modules and look for the Name field just below the icon for the Module you wish to change i.e.

News

Change the name to anything you wish, and then click "Submit" and confirm your settings.


How to hide an installed module link in the main menu

To hide a link to a module in the main menu go to System Admin-->Modules and look for the Order ( 0=Hide )  column to the right of the module. Change the "1" to a "0" (Zero). Although the link is hidden in the main menu the module is still active.


How do I make a module the default launch module

To do this go to System Admin->Preferences--> General Settings and go to:

Module for your start page i.e.

Module for your start page

Choose your default module and then click Go at the bottom of the page to confirm your settings.


How do I update a module?

After you have uploaded your updated module files to your server, go to your Xoops site administration, and then to System Admin-> Modules. Now look for the name of the module you wish to update, and click the update icon to the right.

Hint- Let your mouse hover over the icons to the right and a hint will appear which says "update".

Update icon


Where can I download Xoops Modules?

Xoops Downloads

List of Modules

 


 

 

jackj macambridge.com