This tutorial describes how to install the script under a Lunix based MidPhase hosting account. MidPhase uses CPanel, so these instructions can be useful for others who have CPanel based hosting.
Log into CPanel. You will see the following screen:
Note: The above screen is customized for MidPhase, it will look different on other hosting accounts, but the features / options will be basically the same.
Setup the database. Click on 'MySQL Databases'
You will see this screen:
The important things in the screen above are numbered in red.
#1 - Enter the name of the database. Choose a database name that you prefer. For example the name can be: board
#2 - Create a new username for the database. For example -
#3 - Add the user to the database created in step #2. Select the username and database name and click the 'Add user to DB' button.
*** Please take note of your [Database Name], [MySQL Host], [MySQL Username] and password for step 5, as shown in the following graphic:
Note: MySQL host may vary and may not be 'localhost' as shown on the screenshot. Please use the value that is shown by your hosting company.
Use an FTP client to upload the files to your server.
Any FTP client can be used. Here we show examples with FileZilla, a free FTP client that can be downloaded from here: http://filezilla-project.org/download.php?type=client
How to connect
When you log in to the server with FTP, you will see a list of directories. MidPhase and most other users: upload your files to the public_html directory. Files placed in to the public_html directory are visible to the web.
To upload the files, simply select the unzipped files on your computer on the left, right click, and then select 'upload'. (Do not select the top-most directory with the double periods ..)
Note: The screenshots here show FileZilla, but the files can be uploaded using any other ftp client.
Step 4 - setting permissions
Use the FTP client to set the file permissions.
Files in the main directory:
- rss.xml file
must be writeable. (chmod 666)
must be writeable. (chmod 777)
A note for Windows users: Chmod works only on UNIX type hosting accounts. If your hosting account is on a Windows server, then you will need to set the permissions from your hosting account's control panel. Please see your hosting manual or documenation for details on setting the permissions. You must give permissions for writing to the files above - the installation script will notify you if it does not have the correct permisons.
(Because MidPhase is Linux based, we need to set the permissions using chmod. Many FTP clients support this functionality from the pop-up menu shown by right-clicking the file or directory.)
Step 5 - Running the installation script
Go to the script's installation page, http://www.yourdomain.com/admin/install.php
Fill in the database details that you entered in step 2
Make sure to fill it in carefully.
Note: Please enter your database name, MySQL Host, MySQL Username and password as shown in step #2
Continue, filling in the rest of the form:
The script will automatically detect and recommend the paths and locations for you. Please copy and paste them in, but be careful to include the entire paths exactly, without any spaces or additional characters!
Click 'Continue' when done.
If the database connection is successful, the script will show this button:
Click the 'Install Database' button. This will install the database. Once successful, delete admin/install.php from your server.
You can now continue and log in to the Admin section. The default password is: ok
Please change the default password in the Main Config screen.
Step 6 - Configuring the job board
Finish off the rest of the configuration. Log into the admin http://www.yourdomain.com/admin/
The default password is: ok
Go to the Main Config and enter the remaining setup values:
1. Site's Name, Site Heading, Description, Keywords, Site Logo URL, Site Contact Email and Administrator's password.
2. Time zone & date format
3. Don't forget to change the default password!
Step 7 - After installation
That's it! The script is now installed. There are other things you can now do:
- Edit the language strings
- set the prices
- setup the payment modules
- customize forms & customize columns on the list
- customize categories
- Customize the Email Templates
Please refer to the manual for detailed instructions.
Additionally, it is recommended that you password protect your admin/ directory using .htaccess (This can be done using the 'Password Protect' feature in your hosting account's control panel)
The following screenshot shows the password protection page in Cpanel:
Cron Daemon is a tool on Unix type servers which allows you to schedule the running of tasks, chronologically. The job board needs to process the Outgoing Email queue every few minutes and process the email alerts every hour. Additionally, several other 'house keeping' tasks need to be performed. (Note: On Windows a similar tool exists in the System Tools folder called 'Scheduled Tasks')
It is recommended that you set up a Cron job / scheduled task for the Job Board. If your hosting company does not provide this service then the job board can emulate a cron job, although this approach is not recommended for large websites. You can turn cron emulation On / Off from the Main Config.
The script that needs to be scheduled to run every minute is called cron.php and it's located in the cron/ directory.
For more details about the cron jobs, please see the notes in the Admin under 'Cron Info'
Jamit Job Board -> Docs -> Installation Instructions