jamit job board 2.8.x series

Jamit Software – Jamit Job Board Installation & Configuration

1

Jamit Job Board 2.8.x series By Jamit Software

http://www.jamit.com.au

Updated 2006-Oct-14 Installation & Configuration Manual.

For the latest information see: http://www.jamit.com.au/

Installation & Customization instructions The following installation instructions are general instructions for most servers. For more specific instructions for Linux/Cpanel beased hosting with screenshots, please see http://www.jamit.com.au/job-board-install.htm 1. Uncompress all the files, keeping the directory structure intact. Upload the files to

your server. • Give write permission (chmod 666) to the following files:

config.php header.php footer.php rss.xml payment/logs.txt lang/english.php

• Give write permission (chmod 777) to the following directories: upload_files/docs/ upload_files/docs/temp/ upload_files/images/ upload_files/images/thumbs cache/

- The files should be uploaded with an FTP client, see

http://www.jamit.com.au/job-board-install.htm as an example. - PHP must be able to read and write to the above files & directories - The job board can be uploaded to the main document directory, or to a sub

directory, such as ‘jobs/’ 2. Create a new database on your MySQL server. (You may choose any name for the

database). Assign a username to this database. The database username must have permissions to create / modify tables.


2

3. Go to the Jamit Job Board Administration panel: Open your web browser and go to the admin/install.php script, relative to where you uploaded the job board.

4. Enter your MySQL Database hostname, database name, username and password.

Enter your paths and locations. The script will recommend the settings for you.

a) Site’s HTTP URL – The URL to your job board b) Image path – The full path to upload_files/images/ directory c) Images URL – The URL to the upload_files/images directory d) Files path – The full path to upload_files/docs/ directory e) Files URL – The full path to upload_files/docs directory f) The path to the Image Magick ‘convert’ executable file. You may skip and set

this setting later in the Main Config.

Click the “Continue” button.


3

5. Once your database connection is configured, click “Install Database”. Your

database will be installed.

6. Go to the Main Configuration. The Main Configuration allows you to configure the static website variables such as: Directory names, Logos, Enable / disable features, Mail Server, and other settings. Edit your main configuration variables carefully, and save when done. The Main Configuration section is described in more detail later in this document. 7. Edit Email templates. Look at each email template, and customize for your

website.

• You may test your website at this point. Check that confirmation email are sent out correctly when a signs up, that the posting system works, that the application email is working, etc. The Email Templates are described in more detail later in this document.

Your job board is now installed. You may test it, or continue with customization (See the Configuration sub-menu in the Administration Panel):

8. Languages:

Here is how to set up a new language:

NOTE: If you want your job board to be only in a single language, set your desired language as default, and de-activate all other languages. Also, go into the Main Configuration, and turn off the options for users selecting a new language.

TIP: Do you want to edit some of the strings / wording of the job board? You can use the Translation Tool to do this. Just choose your desired language and click on the Translation tool link.


4

a. Create a new file with any name that describes your language. For example, if you are creating Japanese, then name this file japanese.php

b. Place the new language file in the lang/ directory. This file needs write permissions (chmod 666) so that it can be edited using the Translation tool.

c. Go to the Languages screen from the Administration panel. Use the form to add a new language.

d. Use the translation tool to translate from English to your desired language. See the later sections of this manual for a more detailed description of the language functions.

9. Edit Categories. You may start by editing the various categories for the job

Postings. Some categories were included as an example. You may delete these categories and include your own. The Category editing section is described in more detail later in this document.

10. Customize Forms (and edit the Codes). The Posting Form, Resume Form and Profile can be edited from the web without any custom programming. The current forms are given as an example. You may delete/edit all the fields for your own purposes. Careful, the changes that are made here result in permanent changes to the database structure! The Form Customization section is described in more detail later in this document.

11. Customize the header and footer. You can edit the header.php and footer.php

files manually or from the web. Make sure to back-up these files before modifying. See further notes about preserving the JavaScript functionality embedded in header.php and footer.php . Some knowledge of PHP and HTML is required for this step. This step can be done via the web from the “Main Config” screen, or using your favorite text editing app.

TIP: After modifying the form fields, always remember to click “Save Changes”. NOTE: You may notice reserved form fields are marked with an “R”. These fields are reserved by the system, and must exist on the form. Click on the “R” icons to find out what they are used for. Further explanation of reserved fields is given in this document.


5

NOTE: It’s recommended to include the following at the top of the file in header.php: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> The <HEAD></HEAD> tag at least should contain the following: <head> <link rel=StyleSheet type="text/css" href="main.css" > <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> <meta name="description" content="<?php echo SITE_DESCRIPTION; ?>"> <meta name="keywords" content="<?php echo SITE_KEYWORDS; ?>"> <title><?php if ($TITLE=='') {$TITLE= SITE_HEADING;} echo $TITLE; ?></title> </head>


6

12. You may want to replace some of the original graphics with your own graphics.

These are in /images directory. • If you want to use your own map, replace the small-map.gif with your own

map image. Yellow-pin.gif can also be replaced • Replace the logo.gif image • Replace the default logo for the RSS feeds. The maximum width and height

for the RSS logo is 144 x 400 13. Customize prices and products for Posting and Subscriptions. 14. Set up cron/cron.php script to run on a Cron Job. For more information about setting up a Cron job, please see the ‘Cron Info’ section in the Admin. The page gives further explanation and it also suggests some useful commands that you can use.

16. Install and Configure Payment Methods. 17. You’re welcome to modify the source! 16. IMPORTANT: Secure the admin/ directory to be password protected. If you are

using Apache web server, this is done using a .htacess and .htpasswd file. With

Tip: Most PHP / MySQL hosting packages allow you to edit Cron-Jobs via the web console. This is the icon for Cron-Jobs in the popular CPanel web hosting control panel:

If you do not have Cron available, then please turn on Cron Emulation in the main config.


7

some hosting providers, this can be easily done using the administration features found in CPanel / Plesk / Ensim etc.


8

Administration Panel – Overview Please see the Administrator’s Manual for complete user guide of features. This document only covers the Configuration & Customize Forms sections.

Employer Admin - Allows Administrators to maintain employer accounts. You can

edit Employer’s accounts, change their passwords, delete their accounts and modify posting credits. Accounts need to be suspended before they are deleted.

Candidate Admin - Allows Administrators to maintain candidate accounts. You can

edit Candidate’s accounts, change their passwords and delete their accounts. Accounts need to be suspended before they are deleted.

- Browse and Edit uploaded resumes. Job Post Admin

- List / Edit / Approve / Disapprove and delete job advertisements. Purge expired posts from the database.

Orders - Allows you to view and manage job posting orders and

subscription orders. Also you can view the transaction history form here.

Website Reports - View the payment module log and see who’s online.

Price Admin - If you enable the PayPal IPN, go here to configure your products - Create and Edit Job Posting plans. Packages can be configured for

standard posts and Sponsored posts, and vary on how many credits can be purchased

- Create and Edit subscription plans for viewing resumes. Plans vary depending on duration.

Newsletters - Send newsletters to employers and candidates

Outgoing Email - View the outgoing email queue of email that is on the queue and

email that was sent. Run the Resume Alerts and Email Alerts. Configuration

- Main Configuration (Configure, Website name & details, database, files and locations, PayPal, Email Server, etc. etc.)

- Payment Modules – Install and enable payment modules. - Edit Categories – these are used on forms, and on main page for

job posts. - Edit Codes – these are used on forms as <select> fields (eg AU =

Australia), Radio buttons and Check boxes - Languages – Insert / Activate / deactivate languages. - Email Templates – Customize your correspondence. - MOTD – Insert a ‘Message Of the Day’ for users who log in

Customize Forms - Posting Form – Add / Edit / Delete form fields - Resume Form – Add / Edit / Delete form fields - Profile Form – Add / Edit / Delete form fields - Employer Signup Form – Add / Edit / Delete form fields - Candidate Signup Form – Add / Edit / Delete form fields


9


10

Main Configuration

Options on this page affect the running of the entire website, including the paths, database settings, look-and-feel, business logic, and more.

Note: Make sure that config.php, header.php and footer.php have write permissions turned on (chmod 666) when editing this form. You should turn off write permissions after editing this form.

1. Website – Board’s Name and Headings

a. Site Name – Your website title

b. Site Heading – Shown on the <head> tag for the front page

c. Site Description – Shown on the front page

d. Site Keywords – Placed in META tag for search engines

e. Site Logo URL – Logo URL, displayed when logging in / logging out of the website

f. Site Contact Email – Administrator’s Email Address. Notification emails and other messages are sent to this email address.


11

2. Paths and Locations Edit the paths and locations to the job board’s resources. The job board will try to detect the correct paths, and highlight them as ‘Recommended’ at the bottom of the field. Sometimes the job board will display warnings in red if it detects an incorrect path.

a. Boards HTTP URL – The full URL to your job board

b. Candidate’s folder – The name of your candidate’s directory.

c. Advertiser’s folder name – The name to your advertiser’s directory.

d. Images Path – The full path to the images directory on the server.

e. Images URL – Images path, as seen from the browser

f. Files Path – The full path to the directory where uploaded documents are stored on the server.

g. Files URL – Files path, as seen from the browser

h. Path to Image Magick ‘convert’ executable – This should point to the ‘convert’ command line program. ImageMagick is available for Windows and *nix here: http://www.imagemagick.org/script/index.php

i. Path and Filename to RSS feed – The full path to the file on your server. The rss.xml file is the default filename.


12

3. MySQL Settings You may edit the following values:

a. MySQL database username

b. MySQL database name

c. MySQL database host

d. MySQL database password

4. Cache Settings – Yes / No. Once you have installed the job board and you are familiar with it, you may try to turn on this feature to help increase performance. This feature tries to minimize the amount of SQL queries required per page refresh by saving some frequently access data in a file. This feature is considered Beta in the 2.8.x series.

5. Cron Emulation Settings – Yes / No. If your hosting account does not support Cron / scheduled taks, then turn this feature on. Otherwise please see the Cron Info section in the Admin about setting up a cron job.

6. Features – Disable / Enable Optional Features

This allows you to switch different features of the job board.

a. Enable Map – If enabled, a map will be displayed when inserting on editing job posts. This map is a javascript program, and it allows advertisers to pin-point the location of the job. You change the map by simply replacing the default images with your own. If enabled, the map is placed in the 2nd section of the posting form. Example of a map:


13

b. Enable ‘Mouseover’ Preview of images on Resume list - If enabled, this feature will display a thumbnail preview of the candidate’s photo when a mouse is moved over their name. Example of thumbnail preview, when the mouse is over a name.

c. Enable multiple languages for employers - If enabled. it will allow employers to select their preferred language when signing up, and allow them to select a languge from the menu.

NOTE: This feature requires that you have a field with the following parameters on the resume form: ”Field Type” = Image “template tag” = IMAGE This field exists on the form by default. If you do not want to allow images on resumes: Edit your resume form, then change the image field to another type, such as Text Field or Separator. You can also move the field to another section. Then turn off this feature from the Main Configuration.


14

d. Enable multiple languages for candidates - If enabled will allow candidates to select their preferred language when signing up, and allow them to select a languge from the menu.

e. Enable Job Alerts for candidates - If enabled, candidates will see an option to setup Job Alerts from their account. You can specify the duration of the interval between days. (If you do not have job alerts set up for your job board, then turn this option to ‘No’)

f. Enable Resume Alerts for employres – If enabled, employers will see an option to setup Resume Alerts from their account. You can specify the duration of the interval between days. (If you do not have resume alerts set up for your job board, then turn this option to ‘No’)

g. Enable Online Applications – Candidates can apply to the jobs online via the website. They can attach up to three documents with the email.

h. Enable ‘Tell a Friend about a Job’ feature – When enabled, users will be given a form where they can email their friend about a job posting.

i. Enable ‘Save Job’ feature – Job Seekers can save jobs in to their private area for later refrence.


15

7. Localization – Time and Date Allows you to set the date format and time-zone of your job board. This is very useful if your job board is hosted on a web server that is on another time-zone.

a. Date Format – This is a string which specifies how dates are formatted. The default is d-M-Y. More information about this format is available here: http://au3.php.net/date Note: The date format specified must be correctly parsed by the PHP strtotime() function.

b. GMT Difference - How many hours difference from your time zone and the Greenwich Mean Time.

8. Categories

Allows you to control some aspects of formatting categories.

a. Max Sub-categories to show – How many sub-categories to show before showing the [More] link, and let the user to expand the categories if they want to see more.

b. How many columns on front page – Categories are formatted into tables when they are displayed. Enter a number of columns that you want the rendered table to have on the front page.

c. How many columns on the category page - Categories are formatted into tables when they are displayed. The category page is rendered when a user goes to browse by category. Enter a number of columns that you want the rendered table to have.

d. Format sub-categories in to tables? – This will place the categories in the main page in to a table layout. Enabled by default.

e. Cut-off category names? – If the category name is too big, it will trim the name, eg. Australia will be changed to Aust…. If 4 characters are the maximum.

f. Indent sub-categories, shown on the selection list – If Yes, the categories on the search form will be indented to save space.


16

9. Data Cleaning The system is able to strip unwanted data when it is inputted. The system also has some additional defenses from entrusted input.

a. Strip unwanted HTML tags – If enabled, the system will strip unwanted HTML tags form Text-Editor and HTML-Editor fields. Note that HTML tags are not allowed in other fields, and are always escaped. It is recommended that you turn this feature on.

b. Strip characters that aren’t valid ISO-8859-1 – If enabled, the system will strip any illegal characters. This can happen when users paste data from Word documents, or their browser sends data in the incorrect character encoding. The system always expects the data to be in ISO-8859-1 Latin 1 character set, or similar (such as windows-1252). This Charest is the standard for HTML.

c. Break Long Words – Sometimes intentionally or accidentally, a user may enter a very long word without any spaces which will break the formatting of your site. This feature prevents this problem by breaking long words with a space. It safe to use with HTML and multi-lingual strings.

d. Enable Bad word filter – This is a basic filter, which will stop bad words. (Assuming that the correct spelling is used). Enter your word list, separated by commas.

NOTE: The job board will display characters of different languages in Unicode, which are formatted into the Latin character set using HTML entities. For example, the Korean word for hello “안녕” will be represented as 안녕 It is assumed that the web browser will make the correct conversion when a form is submitted.


17

e. Clean White-space form strings – When enabled this will trim any white space (blanks) from the ends of all input strings. Useful in maintaining database integrity.

f. File Uploads – Allowed extensions – Which files are allowed to be uploaded to the job board during Applications and attach to resumes. Enter your list separated by commas.

g. Image Uploads, allowed extensions – Which image types are allowed. Enter your list separated by commas.

h. File uploads maximum size – Enter the maximum allowed size for uploaded file. The value is set in bytes.

10. Accounts and Permissions

a. Candidate’s accounts need to be activated - If enabled, candidates cannot log into the system until they are approved by the administrator. Don’t forget to edit the email template titled “Candidate Signup” after changing this setting.

b. Employer accounts need to be activated - If enabled, employers cannot log into the system until they are approved by the administrator. Don’t forget to edit the email template titled “Employer Signup” after changing this setting. It is also possible to deny access to the Resume DB until the account is approved, or deny access to the Resume DB until the user had posted


18

an ad.

c. Impose a limit on how many free posts an employer can have – If enabled, an employer will have a limit on how many free posts they can make at one time. This stops the employer from spamming your job board, and forces them to delete their old posts. This feature only works if standards posts are for free (no billing).

d. Employers begin with how many free credits for Premium Posts – How many free Premium Post credits to give to an employer at signup.

e. Employers begin with how many free credits for Standard Posts – How many free Standard Post credits to give to an employer at signup.

f. Allow the Admin to login to employer’s and user’s accounts using the Admin password? – When enabled, the Admin will be able to access user’s accounts by using the Admin password as their password.

11. Menu Options – Allows you to set the menu type to use for your users.

a. Candidate’s Menu – JavaScript Menu or Text based Menu

Note: To combat the problem of employers re-signing up for accounts, employers cannot sign up for a new account with the same email address.


19

b. Employer’s Menu - JavaScript Menu or Text based Menu

12. Anonymous fields and request system a. Enable Resume’s ‘anonymous fields’ and request system – When

enabled, candidates will be able to set their Resume to anonymous. Employers will need to send a request for permission to view. Candidates are able to Grant or Deny permission.

13. Blocked fields

a. Enable blocked fields system – When enabled, selected fields on

the resume will show as ‘Blocked’ for non-subscribed employers.

14. Billing System Options

a. Subscription: Enable subscription billing for employers – When enabled, employers will need to purchase a subscription package in order to view resumes.

b. Enable billing for standard posts - When enabled, an option for premium posts will appear in the employer’s menu. Employers will then be able to purchase credits for premium posts.

c. Enable billing for premium posts – When enabled, an option for

premium posts will appear in the employer’s menu. Employers will then be able to purchase credits for premium posts.


20

d. Invoice ID to start from – Enter the number to seed the Invoice ID serial identification number.

15. Posts

a. Posts need approval – If enabled, administrators will need to manually approve each post before it can go live.

b. Number if jobs displayed per page - How many jobs to display before braking into a new page.

c. How many days until expired – How many days until a post has been expired. Expired posts will no longer be displayed in the posts list / search result.

d. Show Description Preview in posts list headings – If enabled, a snippet of the DESCRIPTION will be shown below the title when listing posts. Example:

e. Show ‘Posted By’ in the post list heading – If enabled, the value of POSTED_BY will be shown on the job list. Example:

NOTE: Search engines such as Google, archive job posts into their index. It is common that expired posts turn up in the search engine results. Therefore, expired posts are not be deleted. A message saying that the post has been expired will be displayed to the user. It is possible to delete expired posts if disk space becomes an issue.


21

f. Show ‘Category’ in posts list heading – If enabled, the value of JOB_TYPE will be shown when listing jobs. By default, this field is a category type. Example:

(You can modify the ‘Category’ string using the Language translation / Editing tool.)

g. Show the day, and how many days elapsed – If enabled, the jobs on the job list will be grouped by day. The current day will be shown. This feature displays the day names in English. Example:

h. Show number of hits to the public – If enabled, the number of hits a post received will be shown to the public. Example:

i. How many days until premium post expires: How many days the premium post will stay at the top.

j. Premium posts per page – how many premium posts to list per page.

NOTE: Here is an example of the job list with features from d. to g. (above) turned off:


22

k. Group premium posts by day of week – If enabled, the posts will be grouped by day of week.

l. Post Manager – Show Posts Per page – How many posts to show per page in the Employer’s Post Manager section.

16. Resumes a. Resumes need approval – If enabled, resumes will be placed in to an

approval queue.

b. Resumes per page – How many resumes to display per page.

17. Header and Footer

a. Header – HTML of the top part of the job board. This is read from header.php See miscellaneous notes at the end of this document for more details.


23

b. Footer – HTML of the bottom part of the job board. This is read from footer.php See miscellaneous notes at the end of this document for more details.

18. Email Settings

a. Hostname – The hostname of the local web server. Used when logging into the SMTP server.

b. SMTP Server address – Domain name of your mail server

c. POP Server address – Domain name of your POP server, usually the same as the SMTP server.

d. SMTP/POP3 Username – Password to the account on your mail server SMTP / POP account

e. SMTP/POP3 Password – Password to the username above

f. SMTP Authentication Hostname – When logging into the SMTP, this is the server used for authentication. Usually the same as the SMTP

g. POP3 Port – Port of the POP server, 110 is the default.

h. POP before SMTP – Enable this option if your server requires POP before SMTP

i. Include a signature in emails – Appends a single line to email messages: “This email was sent from SITE_NAME”. String is changeable in english.php or other language files.

j. Send application receipts to administrator – When a candidate applied for a job, sends to the administrator a copy of the application


24

email that was sent to the employer. (Not including attachments).

k. Send application receipts to candidates – When a candidate applied for a job, sends to the candidate a copy of the application email that was sent to the employer. (Not including attachments)

l. Send email to admin when a new employer signs up – Sends to the administrator a copy of exactly the same email that was sent to the employer.

m. Send email to admin when a new job is posted – Sends via email the Title, Description, Posted By and Date of the post to the administrator.

n. Email debug mode – If enabled, will output status messages to the screen.

o. Replace @ sign with image when displaying addresses – If enabled, will replace the @ sign with images. This is to foil any attempts by unscrupulous spammers who use the job board to harvest email addresses.

p. Outgoing email Queue – these settings control the processing of the outgoing email queue.


25

Payment Modules Payment modules can be managed from the Admin.

As of version 2.7.x, the job board supports the following payment modules: 2Checkout, Authorize.net (SIM), Bank deposit, ccAvenue, Check / Money Order, E-Gold, Monetbookers.com, NOCHEX, and PayPal.

Configuring the PayPal module

1. Click on the PayPal module name, then click the Install button

2. Fill in the required parameters. The module will recommend some settings to you.

a. PayPal Email Address – This is your PayPal business email address

b. PayPal Identity token - Required for PDT (Payment Data Transfer). You

can find the Identity token under Profile -> 'Website Payment Preferences' page in your PayPal account

c. PayPal Server Host – This is the address of the PayPal server the billing script will talk to. For live websites, choose www.paypal.com If you want to test the billing functions, use www.sandbox.paypal.com

d. PayPal IPN URL - This is the URL of the script that processes posting credits. This script connects to the PayPal server through HTTP. It also receives messages from PayPal through HTTP. Use the recommended IPN URL for this option. Use the recommended IPN URL for this option.

e. PayPal return URL – After a successful payment, this is the URL where the customer will return to.

f. PayPal Cancelled return URL – This is the URL where the customer will return after a cancelled payment.


26

g. PayPal Page Style – Set the style of the checkout / payment page on PayPal.com. The style is configured in your PayPal account.

h. PayPal Currency – Select the currency that you want to receive.

i. PayPal Button Image URL – Set the URL for the button’s image. Should be on a https server.

j. PayPal Subscription button URL – Set the URL for the button’s subscription. URL should be https

Click ‘Save’ to save changes.

3. Click the ‘Enable’ button to activate the module.


27

Configuring other Payment Modules Other payment modules are configured in the same way as the PayPal module shown above. Please click the ‘Install’ button to enable the module, fill in the details then click the ‘enable’ button.

Configuring Subscription Plans 1. Adding a new subscription plan

a. Select “Subscription Plans” from the Price Admin menu on the left.

b. Click on the ‘New subscription plan’ button.

c. Enter a descriptive name for the subscription, description, the price, the duration, and select what kind of access the subscription can have. Click “Add” to save.

2. Editing a subscription plan

NOTE: Your PayPal account will need to have PayPal IPN turned on. To do this, log into your PayPal account, go to "profile". Then go to “Instant Payment Notification Preferences”. Click “Edit” and turn it on. Also, please turn on ‘Auto Return’ option. TIP: Before going live, you may test the PayPal IPN scripts by setting the PayPal server to www.sandbox.paypal.com in the Main Configuration section.


28


b. Select the subscription plan that you would like to edit by clicking on the radio button next to the plan’s name.

c. The subscription plan will become editable, and you may modify the values. Click “Update” to save.

3. Deleting a subscription plan


b. Select the subscription plan that you would like to delete by clicking on the radio button next to the plan’s name.

c. Click the “Delete” button. Click “Yes” to confirm that you want to delete.


29

Configuring Posting Plans

4. Adding a new posting plan

a. Select “Posting Plans” from the Price Admin menu on the left.

b. Click on the ‘New Package’ button

c. Enter a descriptive name for the posting plan, enter the price, the quantity, and select the type of post (Premium/Standard). Click “Add” to save.

5. Editing a Posting plan


b. Select the posting plan that you would like to edit by clicking on the radio button next to the plan’s name.

c. The posting plan will become editable, and you may modify the values. Click “Update” to save.


30

6. Deleting a posting plan


b. Select the posting plan that you would like to delete by clicking on the radio button next to the plan’s name.

c. Click the “Delete” button. Click “Yes” to confirm that you want to delete.


31

Configuring Categories The diagram below introduces some of the features of the category editor.

The job board has support for unlimited number of categories. Each category can have zero or more child-categories. The current path is displayed at the top of the editing page. Categories can be added, edited or deleted.


32

1. Adding a category

a. Select “Edit Categories” from the Configuration menu on the left.

b. Navigate to the category that is to be edited. (Click on the categories to go down a level)

c. Use the text input to enter a new category name and click “Add”. Un-tick the checkbox if you do not want records to be added to this category.

d. The new category will appear on the category list. This list is alphabetical order.

2. Editing a category name


b. Navigate to the category that is to be edited. (Click on the categories to go down a level).

c. Click on the (Edit) icon next to the category name. Use the text input to edit the category name and click “Save”


33

d. You will see the edited category appear on the category list. This list is alphabetical order.

e. List Order: When editing category names, you will also see the ‘List Order’ setting which allows you to put the category names in to a special order. Entering 1 in the category will place it to the top of the list. Entering a 2 will make it 2nd, 3 will make it 3rd, etc.

3. Deleting a category


b. Navigate to the category that is to be edited. (Click on the categories to go down a level).

c. Click on the (Delete) icon next to the category name. Click “OK” to confirm.

Configuring Codes (Radio & Checkbox options) Codes are used to populate the options of radio boxes and check boxes. Here is an example of a field that has 3 codes for displaying 3 checkboxes:

When [Edit Options] is clicked, the codes for this field will be displayed in a popup window. You may edit / delete the codes for the field. Here is an example of the code editing window:

NOTE: For safety, the system does not allow deleting categories which have job posts under them. NOTE 2: As of version 2.1, Job, resumes and profiles can be categorized. However, only job posts can be browsed by category by default.


34

1. Adding a code

a. Find the code group that is to be edited. The code group can be found

on the Form Editor, or from the configuration menu by clicking “Edit codes”.

OR

b. In the pop-up window, enter the code and the name of the code. Click “Save” when done. The new code must be unique from all other codes, and it must not be similar. It is recommended that the new code is at least 3 characters.


35

2. Editing a code

a. Find the code group that is to be edited. The code group can be found on the Form Editor, or from the configuration menu by clicking “Edit codes”.

b. Select on the code that is to be edited.

c. Edit the field, and click “Save” to save changes.

3. Deleting a code

a. Find the code group is to be deleted. You may find the code group on the Form Editor, or you may go to it directly from the configuration menu, and click “Edit codes”.

b. Select the code that is to be deleted.

c. Click on the ‘delete’ button to delete the code.

Configuring Languages 1. Adding a new language

a. Create a new file for the language. For example, if you want to add

Japanese, create a file named japanese.php

i. Upload this file to the /lang directory ii. Make sure that the file has write permissions (chmod 666)

b. Select “Languages” from the Configuration menu on the left.


36

c. Fill in the form to add a new language. Click “Submit” when finished.

i. Language name – The name of the language ii. Language code – choose a unique language code iii. Language file – select the file used for the language iv. Image – Icon for the language. About 26 x 18 pixels. v. Charset - Leave the default value. This is the character set

used to encode the language. (The language will be stored as Unicode HTML entities). Currently this field has no meaning, and can be safely ignored.

d. The new language will be listed in the languages list on top of the page. Click on the “Translation / Editing Tool” to edit your new language. See the instructions for the translation tool later in this manual.

2. Setting the Default Language A Default Language is the language which is loaded first when a user visits the website for the first time.

a. Select “Languages” from the Configuration menu on the left.


37

b. Find the language on the list that is to be set to default, and click “Set Default”

3. Activating / Deactivating a language Languages can be activated or de-activated. A deactivated language will not be visible / selectable to the users of the website.

a. Select “Languages” from the Configuration menu on the left.

b. Find the language on the list that is to be changed, and click either on “Activate” or “Deactivate”

4. Language translation Tool / Editor. This tool eases the editing of all the strings found in the language files. The screen is split into two columns. The column on the left has the original source language strings in English, while the column on the right has all the strings that are to be translated. Here is a diagram showing the Translation tool screen:


38

a. Editing a language There are two types of editing modes. To select the editing mode, click on one of the radio buttons.

i. Edit as text – Use this editing mode for general editing. This mode helps to preview characters which otherwise do not exist in HTML character sets. It also allows you to edit text with HTML, while viewing your language’s character set.

ii. Edit with encoded HTML Entities - use this editing mode when making a final save. This mode displays characters that are non-standard HTML characters encoded as ‘HTML Entities’. For example, the Korean word for hello “안녕” will be represented as 안&#45397

NOTE: Before making a final save, it is strongly recommended that the special HTML characters which are not allowed inside HTML tags are converted to their proper HTML entities. Special characters are characters such as &, <, >, “, etc.. Here is a basic table: Characters not allowed inside HTML tags

Change to:

& (ampersand) & < (less than) <

> (greater than) > “ (double quote) " ‘ (single quote) &#039


39

b. Translating a String

i. Find the string that is to be translated.

ii. Translate the source string on the left with the new translated version on the right.

Configuring Email Templates There are 9 different email types that can be configured. They are grouped into for groups. Here is the table of Email Templates as shown in the Configuration:

Email Name Description Candidate Signup Sends a sign-up confirmation details to candidates. Employer Signup Sends a sign-up confirmation details to employers. Forgot Password Sent to Employer or Candidate with a new temporary

Variables in language strings. Sometimes the strings can contain variables. These are substituted with a value once the job board is running. Variables are enclosed using % signs. For example %EMPLOYER_NAME% will be substituted as the actual name of the employer.


40

password. Request Candidate’s Details Sent to candidates when an employer requests a

candidate’s contact details. (For candidates that have chosen to block their contact details to the public)

Resume Alert (text) Sends a list of newly posted resumes to employers, the text part of the message

Resume Alert (html) Sends a list of newly posted resumes to employers, the HTML part of the message

Job Alert (html) Sends a list of newly posted jobs to candidates, the text part of the message

Job Application receipt Sends a list of newly posted jobs to candidates, the HTML part of the message

Confirmed - Bank Order was confirmed, and customer chosen to make a bank deposit

Confirmed - Check Order was confirmed, and customer chosen to make a payment by check

Confirmed - Instant Order was conformed, and payment successfully completed via instant credit card payment method

1. Editing Email Templates

a. Select “Email Templates” form the Configuration menu

b. Click on the template that is to be edited.

c. Edit the template. Click “Save Template” when done.


41


42

Configuring MOTD – Message of the day

A message can be displayed to the employers or job seekers after they log in. This is useful to remind your users about some important news, or to place your sales pitch for the employers.

Candidate’s MOTD – Message of the day for Candidates (Job seekers).

Employer’s MOTD - Message of the day for Employers (Advertisers).

Editing the MOTD 1. Select the language that you want to work in.

2. Display MOTD – Yes / No

3. Motd Message – Write your message and click save when done. You can use

any of the features of the HTML editor.

Configuring Forms - Form Editor Overview Customization of the forms is done visually from a web based interface. The interface is very similar to visual developer tools such as Visual Basic or Delphi. You will notice the following menu in the Form Editor:


43

View Form – Preview the form as it is presented to the user on the website.

Edit Fields – Edit properties of each field, or delete fields. Click “Edit Fields” and then click on the field that you want to edit. The field’s parameters will be visible on the right.

New Field – Click to add a new field to the form. You can specify the field’s parameters on the right.

Job List – Edit the columns that are displayed in the job list.

The above screenshot shows the main features of the forms editor. You will notice that forms are split into several sections. The default Posting Form has 3 numbered sections (1 - head, 2 - middle and 3- footer). This allows you to group your fields.


44

Form Editor – Adding, Editing and Deleting the Fields

Adding a New Field to the form The following shows you how to insert a new field into a form.

1. Click on “New Field” from the menu on the top.

2. You will see the Field Property Editor. Fill in the following: a. Input the Field Label. (Some fields do not need labels, such as a blank

space)

b. Select the Type – Select the type of field. You may select a Text Field, Separator, HTML Editor, Text Editor, Category, Check Boxes, Date, Image, File, Radio Buttons, Note, Blank Space, etc.

c. (Optional) Input the initial value

d. Select the section – You will notice that the form fields are grouped into sections. Select the section that the new field will go into.

e. (Optional) Validation Check – If “Is Required” is checked, the system will validate the field before it is saved in the database. If “Is Required” is checked, the “Type of Check” option must also be selected. (Type of Check: Must not be empty, Valid Email, Valid Date) The error message is displayed when the data in the field fails the check.


45

f. Display settings: i. Check “Is it on search form” if you want this field to appear

on the search form. You can give the field a sort order (a number). Sort order of 1 will make the field appear 1st, sort order of 2 will make it 2nd and so on.

ii. Template Tag: This is required. You must enter a unique variable name for this field. You will notice that you cannot change this field for reserved fields.

g. Parameters i. Width – If field type is Text Field, Text Editors or HTML Editor ii. Height – If field type is Text Editors or HTML Editor iii. Is hidden from website? Check if this field is to be viewed

only by Administrators. NOTE: This field is checked for the Job Description by default. This is because the Job Description is displayed outsides of the form.

iv. Can be anonymous – For resumes only. Check if you want your candidates to hide this field from employers, and allow viewing only to Approved Employers.

v. Is blocked – When the blocking system is enabled in Main Config, this field will be subject to blocking. Only subscribed members will be able to view this field (Resume forms only)

vi. Pre-Fill – When checked, the system will try to fill in the data from the current users’ previous record. This only works for Job Postings, and is designed to save time so that advertisers do not have to re-enter some fields when re-posting a job.

vii. Field comment – Input the comment for the field that you want the user to see.

viii. Select the Category: Use this field to set the initial category, only if the field is of type “Category”. Click on the “Select Category..”


46

3. When finished making changes, click the “Save” button on top of the form.

Editing Form Fields 1. Click on “Edit Fields” from the menu on the top.

2. The form will be displayed in Edit mode. Click on the Field Label, marked as a

blue link to edit the Field.

3. You will see the Field Property Editor appear on the right. Use the Field Property Editor to change the properties of the field.

4. Click “Save”. There is no need update the database, so you do not need to click “Save Changes”.


47

Moving Form Fields Up / Down 1. Click on “Edit Fields” from the menu on the top.

2. The form will be displayed in Edit mode. Click on the Up and Down arrows to movie the field up or down.

Deleting Form Fields 3. Click on “Edit Fields” from the menu on the top.

4. The form will be displayed in Edit mode. Click on field that you want to delete.

5. You will see the Field Property Editor appear on the right. Click on the “Delete” button. Click “OK” to confirm delete.

Including / Excluding a field on a Search Form

1. To include a search on the search form, click on Edit Fields.

2. Click on the field that you want to include


48

3. You will see the Property Editor on the right. Check / Uncheck the “Is on search form” field.

You can give the field a sort order (a number). Sort order of 1 will make the field appear 1st, sort order of 2 will make it 2nd and so on.

4. Click “Save” to save changes.

5. Scroll to the bottom of the page to preview your search form

Setting fields to be required 1. To make a field required when inserting / updating the data, click on Edit

Fields.

2. Click on the field that you want to make required

3. You will see the Property Editor on the right. Check / Uncheck the “Is Required” field. If “Is Required” is checked, the system will validate the field before it is saved in the database. If “Is Required” is checked, the “Type of Check” option must also be selected. (Type of Check: Must not be empty, Valid Email, Valid Date) The error message is displayed when the data in the field fails the check.


49

Types of Fields The Form Editor allows for adding virtually unlimited about of fields to the form. A large variety of field types are possible. Field Type Example Screenshot Blank Space – No label or filed is display

Category – category selector

Check – A group of Checkboxes.

Date – Day, Month, and Year.

Date – Date entry field with a pop-up Calendar for selecting the date.

File – Upload a file, such as PDF, Doc, etc..

Image – Upload and image and create a thumbnail.


50

Editor – A fully featured HTML editor

Multiple Select – Similar to checkbox

Note

Radio buttons

Separator – Field separator.

Single Select

Text Area – Standard multi-line <textarea>

Text Field –


51

Standard text field


52

Customizing columns on the lists All columns on the lists can be customized. The job board displays a list of records for the following record types: Jobs, Resumes, Employer’s Profiles, Employers (user), Job Seekers (users).

To customize a list, first go to where you customize the record’s form, eg click Customize ‘Posting Form’. Then click on the ‘Job List’ Tab to go to the List Editor.

1. Adding a new column to the list a. Select the column that you would like to add to the list.

b. Enter the order of the column in which it will appear on the list, ordered ascending, left to right. 1=1st, 2=2nd etc.

c. Choose whenever to link the column name. When linked, users will be able to click on the value in this column to see the full record

d. Choose whenever this column is to be displayed for the admin only.

e. Choose whenever to clean the formatting of the column’s data values. This will

f. Is in bold? Choose whenever to display this field in bold.

g. Choose whenever to make the field storable, when column name is clicked


53

h. Choose whenever to allow the column’s data to wrap inside the cell

i. Choose whenever to truncate the column data

j. Click ‘Save’ to add the column.

2. Editing a column on the list a. Click on the Edit icon next to the column name

b. Edit the column settings and click ‘Save’

3. Deleting a column from the list a. Click on the Delete icon next to the column name


54

Note: The following section of the manual is for advanced users only.

Field Parameters – What is the ‘Template Tag’? (Advanced) When customizing fields on a Form, the Template Tag allows you to give your field a unique name. This unique name is then used to display / print the value of the field on web pages. Template tags are like variable names. You will see that using template tags is very easy, and it they help to simplify code modifications / maintenance.

Template tags are used when displaying the following:

a) Record List: Display data formatted in a list of records returned from the database. The list is usually a result from a search query, such as lists of posts, or lists of resumes.

b) Record Display: Display data formatted in a record. Eg. When viewing a single job post or resume.

How do I make my new Template Tags display in a Record Display? Temple tags are added automatically in Record Display type functions. You do not need to make any modifications to the code. The values will be loaded and displayed on the screen without any modification.

However, template tags are not automatically added to Record List type functions. Read on for more information.

How do I make my new Template Tags display in a Record List? If you have added a new temple tag, or renamed an old template tag, and you want it to display in a Record List in one of the columns, you will need to modify the source code with the new template tag name. This is simple to do as you generally need to modify the code in one function. Before we show you which files to modify, let’s introduce you to some important functions first:

How does the source code work - Loading values into tags: Use the get_template_value(string, form_id) function to load the template value into a variable. ‘string’ is a parameter is the Template Tag name. The function returns the template’s value.

You will need to initialize the forms before using the get_template_value() values. The forms are initialized by requiring the relevant *.inc.php file for the form type. Eg:

require (‘include/posts.inc.php’) // require the posts form, this will initialize the posts form


55

Form Form ID DB table Module to require

Job Posts 1 jobs_table include/posts.inc.php

Resume 2 resumes_table include/resumes.inc.php

Profiles 3 profiles_table include/profiles.inc.php

Employer Signup

4 employers include/signup.advertiser.inc.php

Job Seeker Signup

5 users include/signup.camdidate.php

Eg. This will PHP load the template tag named ‘TITLE’ $TITLE = get_template_value (“TITLE”, 1);

Displaying template tags: Once you have loaded a template tag, displaying them is simple:

echo $TITLE;

How does the source code work - Fetching template column names: When producing a Record List, each column name is given a label at the top of the table. The get_template_field_label (string, form_id) function is useful for getting the Label of the field, and displaying the returned result as the column name

$title_label = get_template_field_label (“TITLE”, 1)

Read on to find out in which section to modify.

What if I want to customize the way the individual records are displayed on the field? See the above table to find the code for displaying individual records. A very good example of customized record display can be found in post_display.inc.php. You will see that the Date, Title and Ad Text are displayed first, before the other information.

Note: post_display.inc.php has been separated from the rest of the code so that it is easier to customize. We have predicted that most of our clients, who customize the source code, will be interested in customizing this file the most. Therefore this file is a very good place to begin your customizing work, and it will give you an introduction to the rest of the system.

Reserved Fields Reserved fields are fields who are Template Tag cannot be changed or deleted. These fields are critical by the system.

To do: write about reserved fields

56

What are the ‘Admin’ and ‘Edit’ modes? Records can be displayed in ‘Admin’ or ‘Edit’ modes, depending on what parameters were specified to the function. When displaying records to the public, the mode is neither ‘Admin’ nor ‘Edit’

Miscellaneous Notes 1. When changing the HTML footer, if you want to keep the Map and Pin JavaScript

functionality, you must include a snippet of PHP/JavaScript code which must be before the end of the </body> tag. Here is the snippet of PHP code:

(if you do not want to display a map, you can turn off this feature in the Main Configuration)

<?php $pin_y = $prams[pin_y]; $pin_x = $prams[pin_x]; $pin_z = $pin_x+$pin_y; if (($_REQUEST['post_id'] != '') && (MAP_DISABLED=="NO") && ($pin_z !=0)) { $map_size = getimagesize("images/".MAP_IMAGE_FILE); $pin_size = getimagesize("images/".PIN_IMAGE_FILE); $right = ($map_size[0]-$pin_size[0])-$pin_x; // map_x - pin_x $bottom = $map_size[1]-$pin_y; if ($pin_y == '' ) { $pin_y=0; } if ($pin_x == '' ) { $pin_x=0; } ?> <img border="1" name="pin" alt="pin" src="<?php echo "images/".PIN_IMAGE_FILE; ?>"

<?php $size=getimagesize("images/".PIN_IMAGE_FILE) ?> width="<?php echo $size[0]; ?>" height="<?php echo $size[1]; ?>"/>

<script type="text/javascript"> <!-- SET_DHTML("pin"+MAXOFFLEFT+<?php echo $pin_x+$pin_size[0]; ?>+MAXOFFRIGHT+<?php echo

$right;?>+MAXOFFBOTTOM+<?php echo $bottom;?>+MAXOFFTOP+<?php echo $pin_y; ?>+CURSOR_HAND+NO_DRAG,"map"+NO_DRAG);

<?php if ($pin_x != '') { echo "dd.elements.pin.moveTo(dd.elements.map.x+$pin_x, dd.elements.map.y+$pin_y); "; } else { ?> dd.elements.pin.moveTo(dd.elements.map.x, dd.elements.map.y); <?php } ?> dd.elements.pin.setZ(dd.elements.pin.z+1); dd.elements.map.addChild("pin"); </script> <?php } ?>

2. Dynamic Title, and search engine optimization (SEO)

You may want to have the title of your HTML pages displayed to the title of the job advertisements. This is practical if you want search engines to index your site,

57

as many of the search engines will give more weight to the keywords in the title. Here is the code to include in header.php:

<title><?php if ($title==”) {$title= SITE_HEADING;} echo $title; ?></title>

Additionally, you may include the following code for the meta-data:

<meta http-equiv=”description” content=”<?php echo SITE_DESCRIPTION; ?>”>

<meta http-equiv=”keywords” content=”<?php echo SITE_KEYWORDS; ?>”>

The above code is included in the default header file.

3. Overlib in the Advertiser’s and Admin area.

Overlib is used to display pup-up of the resume photo if one exists. The following code must be included in the header:

<script type=”text/javascript” src=”../overlib/overlib.js”></script>

and the following code after the <body> tag:

<div id=”overDiv” style=”position:absolute; visibility:hidden; z-index:1000; “></div>

Configuration Notes.

Board’s Name and Headings • The site name should be the name of the website, as short as possible. • The site heading will appear in the <title></title> section, and should be

optimized for search engines. When viewing a job ad, the site heading will be replaced with the post’s heading.

Path name and Locations • You may place the script into any directory. • Don’t forget the trailing / at the end of path names • Set the path to the ImageMagick ‘convert’ program for resizing images. See

http://www.imagemagick.org for more information


58

Licenses and Acknowledgments. Some portions of Jamit Job Board source code are licensed from:

• HTML editor (FCKEditor) (based on LGPL license) Copyright © 2003 - 2006 Frederico Caldeira Knabben, and all source code is included.

• Javascript Menu (mygosuMenu 1.4.2) COPYRIGHT: © 2003,2004 Cezary Tomczak, released under the BSD license. http://gosu.pl/dhtml/mygosumenu.html

• wz_dragdrop.js Javascript library. Copyright 2002-2003 Walter Zorn. http://www.walterzorn.com Released under LGPL and all source code is included.

• ‘SCW’ Date Selection field, Copyright (C) 2005-2006 Anthony Garrett http://www.tarrget.info/calendar/scw.htm

Jamit Job Board License License: (1 Licenses for Jamit Job Board Software - for a single domain).

* Jamit Software retains full ownership and copyright of the software. * This license grants permission for the Client to use the software on the domain specified. * This license grants permission for the Client to modify the source code for the purpose of customization & integration with existing website. * The Client will not sell, license or distribute the software, either in its entirety or modified form to a third party, or use in any other products, unless agreed under different terms by Jamit Software. THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL JAMIT SOFTWARE BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Jamit Software PO BOX 232 Thornleigh, NSW 2120 Australia [email protected]

Please see http://www.jamit.com.au/support/ Knowledgebase for more information and tips.

jamit job board 2.8.x series

Documents