Adding Generic CGI Scripts

Owners of Unix accounts can use simple CGI wizards to enhance their sites with the following scripts:

• phpBB forum (requires MySQL)
• mnoGoSearch utility to search your site (requires MySQL)

---

• Fixing broken scripts

All CGI scripts for a particular site are stored in the cgi-bin directory, unless specified otherwise. If you accidentally delete any files in the cgi-bin directory, you can recover them by going to the Web Options page and clicking the Restore to default link. Your existing files remain untouched, so you will not lose your changes. To get rid of undesirable changes in the script files, delete these files and then click the Restore to default link on the Web Options page. Also, use the Restore to default link to fix your temporary index page to default.
See the Contents of Your Home Directory chapter of this manual for more information on the files and catalogues not to be deleted.

phpBB Forum

(both for Unix and Windows based accounts)

Add the phpBB forum (distributed according to phpBB License Agreement). It is a high powered, fully scalable, and highly customisable bulletin board package. phpBB has a user-friendly interface, simple and straightforward administration panel, and helpful FAQ.

phpBB Key Features:

• Unlimited forums and posts
• Multiple language interface
• Private or public forums
• Powerful search utility
• Private messaging system
• Complete customisation with templates
  

phpBB files are stored in a separate directory for each of your sites.

To add phpBB forum to your site, do the following:

1. Select Domain Info in the Domain Settings menu.
2. Click the Edit icon in the Web Service field.
3. On the Web Service page, scroll down to find the phpBB option and turn it on:



4. Agree with charges, if any.
5. Go through the installation wizard. You'll be prompted to select from the existing MySQL databases to use with phpBB or create a new one:

   

   WARNING: Assigning a previously created MySQL database to be used for phpBB needs, you will remove contents of all its tables.

6. Choose or create a MySQL user to access and manage MySQL DB you have allocated for use with phpBB.
7. Click the Setup icon to install the script:



8. You'll be taken to the phpBB admin control panel, where you can start configuring the forum to your liking.
   * If you are taken to the setup page again, click the Fix button. This will reset the config.php script which contains settings to access php BB MySQL db.

mnoGoSearch

If you are running a Unix-based account, you can enhance your site with mnoGoSearch, a utility that searches your site by keywords.

Enabling mnoGoSearch

To enable mnoGoSearch, do the following:

1. Select Domain Info in the Domain Settings menu.
2. Click the Edit icon in the Web Service field.
3. On the Web Service page, scroll down to find the mnoGoSearch option and turn it on:



4. Agree with charges, if any.
5. Go through the wizard. You'll be prompted to select from the existing MySQL databases or create a new one to be used by mnoGoSearch:

   

   WARNING: Assigning a previously created MySQL database to be used for mnoGoSearch needs, you will remove contents of all its tables.

6. Choose or create a MySQL user to access and manage MySQL DB you have allocated for use with mnoGoSearch.
7. Go to your search page by clicking the View icon:

To make it available to the Internet users, put a link to your mnoGoSearch page on your site's pages.
* Note: It will take some time to index your site pages and get your search working.

Adding mnoGoSearch URLs

Starting with version 2.5, H-Sphere supports adding mnoGoSearch URLs directly from your Control Panel. This will improve the process of your site indexing, and therefore the search results.

To add an URL:

1. Select Domain Info in the Domain Settings menu.
2. Click the Edit icon in the Web Service field.
3. On the Web Service page, scroll down to find the mnoGoSearch option
4. Click the Add URL icon:



5. You'll be prompted to enter the URL you want to add:



6. The URL will appear on the Web Services page, in the mnoGoSearch section:

You can extend your mnoGoSearch capabilities (e.g.: set local charset) by editing file indexer.conf. To learn how to work with indexer.conf, refer to indexer.conf-dist which can be found in the /'account'/fe_mnogosearch/'domain'/ directory.
* If you mishandle anything, you can always restore mnoGoSearch configuration to the default by clicking the Edit icon, but all your custom settings will be lost.

Fixing Broken Scripts

If you have accidentally deleted any of your CGI scripts and/or the index page (index.html), you can restore them to default. To get rid of any undesirable changes in you CGI scripts and go back to the default settings, delete the unnecessary files and restore the scripts.

To fix/restore the scripts:

1. Select Domain Info in the Domain Settings menu.
2. Click the Edit icon in the Web Service field.
3. On the Web Service page, click the Restore to default link.