Installing the Third Party Web Apps

Installing the modometer Hit Counter

After you accept the license for the hitcounter you will see a form that will let you customize the counter.

• You must enter the absolute URL to the page that will contain the counter, for example http://www.yourdomain.com/index.html or http://download.yourdomain.com/download.php. This page should already exist.

• You can choose the font which the counter will use. Select a fontid from the "Font:" drop down box. Too see how each font looks like click the "Font Gallery" link.

• You can specify the size of the counter's digits in the "Number of digits:" box.

• To specify the digits color and background enter a hexadecimal value in the "Text color:" or "Background color:" boxes.

Once you've done customizing the counter click the "OK" button in the "New Hit Counter" form and you will be given the HTML which you should place in the page that will contain the counter. You should also see links to test or to reset the counter.

Installing phpGuestBook

Click the "More..." link in the "Scripts" group of CP's main screen. Then click the "Install" icon in the "Manage" column of the "Available 3rd Party Applications" table. After you accept phpGuestBook's license you should get to the "phpGuestBook Installer" screen.

This app requires a MySQL database so you should select a database+username combination from the dropdown box at the top of the "Setup Settings" form. phpGuestBook will then use that username to store its data in the database. The password will be filled out automatically so you don't need to enter it.

The next step is to select the subdomain where the app will be installed and a subfolder in that subdomain. For example if you select your main (www) subdomain and leave the default installation subfolder (guestbook) then the app will be installed in /home/yourusername/public_html/www/guestbook/ and will be accessible over the Internet thru the URL http://www.yourdomain.com/guestbook/

Each guestbook has an owner which is displayed in the title of the guestbook screen. The default value is the name you used when you registered at our site when you were purchasing your hosting package, but you can enter any value you like.

Once you click the "OK" button the application will be installed. You will remain in the Installer screen but you should see a message explaining if the installation was successful and if it was you should see a link to visit your newly installed guestbook. If you wish so you can perform another installation now.

Installing phpFormMail

This application will let you email the information submitted in a form you have on your site to one of the mailboxes in your hosting package. You can create the form with your favorite HTML authoring tool. By default a sample form will be generated by this installer that you can use as a reference when you create your own form.

Click the "More..." link in the "Scripts" group of CP's main screen. Then click the "Install" icon in the "Manage" column of the "phpFormMail" line of the "Available 3rd Party Applications" table. After you accept phpGuestBook's license you should get to the "phpFormMail Installer" screen.

There are a number of options you can customize to get the formmailer you need.

• Target subdomain and folder - where the formmailer is to be installed. For example if you select your main (www) subdomain and leave the default installation subfolder (formmail) then the formmailer script will be installed in /home/yourusername/public_html/www/formmail/formmail.php and will be accessible over the Internet thru the URL http://www.yourdomain.com/formmail/formmail.php

  If you choose a sample form to be generated it will be at /home/yourusername/public_html/www/formmail/formmail.html (URL will be http://www.yourdomain.com/formmail/formmail.html)

• Generate Sample Form - If you leave the default ("Yes") a sample page will be generated that contains a form which will demonstrate how to use the formmail.php script. In most cases you will design your own HTML page that will contain the form in order to match the look and feel of your site. You can use the HTML code of the form from the generated sample page as reference.

All other fields in the form are optional and you only need to change them if you chose a sample page to be generated.

• Mailbox to receive form data: - The submitted contents of the form will be mailed to this address. You can only mail the data to a mailbox on our server. If you need the results to be mailed to an external email address you can setup email forwarding for the local receiving mailbox.

• Mailbox to receive a CC copy of the form data: - A copy of the submitted data can optionally be sent to another mailbox whithin your hosting package.

• Priority of received mails: - You can optionally request that email messages generated by the formmailer will be marked as high priority mail. The default is not to mark them.

• Subject of the received mails: - You can specify an arbitary subject that the messages you receive from the formmailer will have.

• Allow customers to change the subject: - This will add a "Subject:" field to the generated sample HTML page. The customers will be able to specify the subject then when they fill out the form.

• On success redirect to URL: - The formmailer script will redirect the user to this URL if the form was processed successfully and the respective email message was successfully sent to you. This is an absolute URL like http://www.yourdomain.com/thank-you-for-your-feedback.html.

• Comma separated list of required form fields: - The formmailer will refuse to run if one of the fields you specify here are omitted by the customer who fills out the form.

• When required fields are not entered redirect to URL: - Specifies what the formmailer should do if one of the mandatory fields specified with the previous option are missing. The default behavior is a vanilla black and white page listing the required form fields that were omitted and advising the user to go back and fillout those fields.

  If you wish so you can design your own error page that will match the look and feel of your site. You should enter then the absolute URL of that error page here, for example http://www.yourdomain.com/required-fields-are-missing.html

Once you click the "OK" button the application will be installed. You will remain in the Installer screen but you should see a message explaining if the installation was successful and if it was you should see a link to visit your newly installed formmail page. If you wish so you can perform another installation now.

Installing phpBB Bulletin Board System

Click the "More..." link in the "Scripts" group of your Control Panel's main screen. Then click the "Install" icon in the "Manage" column of the "phpBB" line of the "Available 3rd Party Applications" table. After you accept phpBB's license you should get to the "phpBB Installer" screen.

Our automated tool makes installing phpBB really simple. All you have to do is select a database/username combination from the "Database User and Name:" dropdown box and a subdomain and subfolder where the phpBB files should go.

Click the "OK" button to install the app. If installation is successful you should see a link you could visit to test your new phpBB installation. You should also see the "Setup Settings" form again which you can use to perform another phpBB installation.

By default an administrator account with username "admin" is created in the new bulletion board. The password for this account is the same as your package password.

To customize your phpBB installation log into phpBB with the admin account and click the "Go to Administration Panel" link near the bottom of the screen.

For more information on using phpBB please refer to the official user guide available at the project site.

Installing HtDig Search Engine

This tool will help you add content indexing and search facilities to your site. This is implemented using the HtDig third-party applications which we have tried to integrate into our system.

If you're still interested in installing HtDig on your account here is how to do it.

• Click the "More..." link in the "Scripts" group of your Control Panel's main screen. Then click the "Install" icon in the "Manage" column of the "HtDig" line of the "Available 3rd Party Applications" table. After you accept HtDig's license you should get to the "Site Search Engine" screen.

• Select subdomains to be indexed - check the respective subdomains and click the "Save" button. This will generate the respective htdig configuration files in /home/yourusername/htdig/.

• Customize Configuration Files - You can (optionally) modify htdig's configuration manually to suit your particular needs, see the official HtDig documentation

• Rebuild Indexes - This will invoke the respective HtDig commands that will load all HTML files in the selected subdomains and index their contents. This may take a while for large sites. You should come back here and rebuild the search indexes from time to time as the contents of your site change. You will not be allowed to rebuild indexes more than once in thirty minutes in order to avoid resource starvation on the server.

• Sample Search Form and Script - click the "Sample search script" link. You should see links to a sample search form ("Search form HTML code") and search script ("Search script / results page") Click both links and study the example code carefully and use them as reference to develop your own search form and your own PHP script to process the form and display the search results.

  Optionally you can save the samples to a subdomain, (perhaps) customize them and use them. Use the "Install the search scripts into a subdomain" for this.

If you decide to take advantage of the HtDig feature we provide we recommend that you visit the HtDig official site and get familiar with the official documentation.

Installing WordPress Publishing System

WordPress is an excellent choice for your blog. To install it click the "More..." link in the "Scripts" group of your Control Panel's main screen. Then click the "Install" icon in the "Manage" column of the "WordPress" line of the "Available 3rd Party Applications" table. After you accept the license you should get to the "WordPress Installer" screen. If you have insalled phpBB before you will notice that the procedure is very similar.

Our automated tool makes installing WordPress really simple. All you have to do is select a database/username combination from the "Database User and Name:" dropdown box and a subdomain and subfolder where the WordPress files should go.

Click the "OK" button to install the app. If installation is successful you should see a link you could visit to test your new WordPress installation. You should also see the "Setup Settings" form again which you can use to perform another WordPress installation.

By default an administrator account with username "admin" is created in the new WordPress installation. The password for this account is the same as your package password.

To customize your installation log into WordPress with the admin account and click the "Options" link in the navigation bar near the top of the screen.

For more information on using WordPress please refer to the official user guide wiki available at the project site.