Installation Overview
Transcription
Installation Overview
Jamit Software – Jamit Job Board Installation & Configuration Jamit Job Board 3.0.x series By Jamit Software http://www.jamit.com/ Updated 2007-Junt-26 Installation & Configuration Manual. For the latest information see: http://www.jamit.com/ Installation & Customization instructions The following installation instructions are general instructions for most servers. For more specific instructions for Linux/Cpanel based hosting with screenshots, please see http://www.jamit.com/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 rss.xml lang/english.php (or the language file which you will be using) • 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/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. 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. 1 Jamit Software – Jamit Job Board Installation & Configuration 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) b) c) d) e) f) Site’s HTTP URL – The URL to your job board Image path – The full path to upload_files/images/ directory Images URL – The URL to the upload_files/images directory Files path – The full path to upload_files/docs/ directory Files URL – The full path to upload_files/docs directory The path to the Image Magick ‘convert’ executable file. You may skip and set this setting later in the Main Config. Later, You can also configure the job board to use the GD Library if you do not have Image Magick. Click the “Continue” button. 2 Jamit Software – Jamit Job Board Installation & Configuration 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 emails 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: 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. Here is how to set up a new language: 3 Jamit Software – Jamit Job Board Installation & Configuration 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. 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. 11. Customize the theme. The default theme is located in the include/themes/default/ directory. You may begin customizing the look of the site by modifying the index-header.php , index-footer.php and main.css files. There are many other files that can be customized there. If you want to create a custom theme then create your own directory in the include/themes/ directory, for example mytheme/ and copy the default/images images to your new directory and any other files that that you want to customize. 4 Jamit Software – Jamit Job Board Installation & Configuration NOTE: In the index-header.php template file, the job board will display the appropriate meta tags by calling the JB_echo_index_meta_tags() function. This function exists in the include/themes.php file. This call should be made between the <HEAD></HEAD> tags. NOTE 2: The following charset should be used by your website, no matter what language your job board is in. This is because the job board uses HTML entities to encode Unicode characters. This allows the job board to display multiple encodings on one page, and it does not introduce any other complications <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> NOTE 3: For some features to work properly, the job board will need a base path specified in the index-header.php file: <base href="<?php echo JB_BASE_HTTP_PATH; ?>"> NOTE 4: The URL to the main.css file is given like this: <link rel="StyleSheet" type="text/css" href="<?php echo JB_get_maincss_url(); ?>" > Theme Customization section is described in more detail later in this document. 5 Jamit Software – Jamit Job Board Installation & Configuration 12. You may want to replace some of the original graphics with your own graphics. These are in include/themes/default/images directory. It is better to create your own custom theme directory and copy all the default/images to your own images/ inside your custom theme directory, and change the images there. • 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. 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. 16. Install and Configure Payment Methods. 17. You’re welcome to modify the source or create new plugin. 6 Jamit Software – Jamit Job Board Installation & Configuration 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 some hosting providers, this can be easily done using the administration features found in CPanel / Plesk / Ensim etc. Register Globals On some servers the Job Board may report that it is running with Register Globals turned on. For good security practice, the register_global PHP setting should be turned off in your PHP configuration, and you can set it to Off if you have access to your php.ini file. If you do not have access to this file, you may also do it via the .htaccess file. The .htaccess file should be in your home html directory if you have an Apache server. For more info, Google keywords are: register_globals htaccess In your .htaccess file, append the following line: php_flag register_globals Off 7 Jamit Software – Jamit Job Board Installation & Configuration Administration Panel – Overview The administration panel, or simply the ‘Admin’ allows an administrator to perform configuration and setup tasks, as well as the usual every day tasks of managing orders and user accounts Employer Admin Allows Administrators to maintain employer accounts. You can edit Employer’s accounts, change their passwords, delete their accounts and modify posting credits. 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, subscription orders and membership orders. Also you can view the transaction history form here. Website Reports View the payment module log and see who’s online. See who is currently 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. 8 Jamit Software – Jamit Job Board Installation & Configuration Configuration Main Configuration (Configure, Website name & details, database, files and locations, Set the Theme, Email Server, etc. etc.) Payment Modules – Install and enable payment modules. Plug-ins – Enable / Disable plug-ins 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. You can also use the Editing / Translation tool from this menu to edit the wording of your job board. 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 Info - Profile Form – Add / Edit / Delete form fields Employer Signup Form – Add / Edit / Delete form fields Candidate Signup Form – Add / Edit / Delete form fields System Info – Display PHP information, MySQL stats and other related information. Cron Info – Display information about Cron including stats and tips for how to set it up. Jamit Home – Go to the Home page of Jamit.com Extras - XML Export – Configure XML feeds to export Job Postings form your website - Email Monitor – Scan your POP mail box for bounced email to automatically unsubscribe users form the email alerts / newsletters - Mod Rewrite – SEO optimize your category names by specifying a custom filename for each URL, Title, Description and Keywords. - Database Tools – Index your database to gain performance, Scan and repair your tables. - Fun Game – Just in case you need a break. Logout - Logout form the Admin 9 Jamit Software – Jamit Job Board Installation & Configuration 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 has write permissions turned on (chmod 666) when editing this form. You should turn off write permissions after editing this form or when modifying the plug-in settings. 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. 2. Paths and Locations Edit the paths and locations to the job board’s resources. 10 Jamit Software – Jamit Job Board Installation & Configuration 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 If your system does not support it, check the ‘Do not use Image Magick’ option. i. Path and Filename to RSS feed – The full path to the file on your server. The rss.xml file is the default filename. 11 Jamit Software – Jamit Job Board Installation & Configuration 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. Check the “Use Serialize” option if you do not have PHP 4.310/5.0.3 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. The image for the map is stored in the images/ directory of your current theme. 12 Jamit Software – Jamit Job Board Installation & Configuration Example of a map: 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. 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. c. Enable multiple languages for employers - If enabled. it will allow employers to select their preferred language when signing up, and 13 Jamit Software – Jamit Job Board Installation & Configuration allow them to select a languge from the menu. 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. 14 Jamit Software – Jamit Job Board Installation & Configuration 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. Display 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. Input Date Sequence – The order in which the date is inserted. Eg. YMD will cause the date input field to have the Year first, then Month, then Day. c. GMT Difference - How many hours difference from your time zone and the Greenwich Mean Time. d. SCW Date Display Format – SCW is the javascript pop-up calendar tool. You can set the date format for this field type. e. SCW Date Input Sequence – Like above, but for the SCW pop-up calendar. 15 Jamit Software – Jamit Job Board Installation & Configuration 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. g. Show category counters next to category names? – If Yes, it will show how many records are in the category. h. Mod Rewrite – If Yes, to be used with in conjunction with the Apache server Mod_rewrite module. It will basically rewrite the category urls of ?cat=22 to something more meaningful like jobs/categories/accounting-jobs.html – See more about this option by clicking the ‘see here’ link. Please note that this option is highly advanced and we can only provide limited support since this may 16 Jamit Software – Jamit Job Board Installation & Configuration involve the settings of your server software. i. Rewrite Directory – Specify the directory name for your meaningful category files. 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. Break long words – If Yes, the job board will put a space between very long words before saving them to the database. Eg. Asdfghahgsfadsgdgfdsgdgffdhafa would become asdfghahgsfads gdgfdsgdgffdhafa. HTML tags should not be affected by our algorithm, assuming that the HTML is valid. c. 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 windows1252). This Charest is the standard for HTML. d. Trim white-space from strings - If Yes, then any blank characters form the ends of the strings will be stripped before saving to the database 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 Jamit Software – Jamit Job Board Installation & Configuration e. 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. 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 18 Jamit Software – Jamit Job Board Installation & Configuration 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 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. 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. 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. 19 Jamit Software – Jamit Job Board Installation & Configuration 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 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. 20 Jamit Software – Jamit Job Board Installation & Configuration 13. Membership Fields a. Enable membership fields - If enabled, the fields marked as ‘Members Only’ will not be viewable until the user pays the membership fee. 14. Blocked fields a. Enable blocked fields system – When enabled, selected fields on the resume will show as ‘Blocked’ for non-subscribed employers. 15. 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. New: You can choose to have the standard posts automatically upgraded to premium posts. This may be useful for some types of job boards. 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. d. Enable billing for Candidate Memberships – When enabled, candidates will be required to pay for membership before they can do anything or view certain fields on the job list. e. Enable billing for Employer Memberships – When enabled, candidates will be required to pay for membership before they can do anything or view certain fields on the job list 21 Jamit Software – Jamit Job Board Installation & Configuration f. Invoice ID to start from – Enter the number to seed the Invoice ID serial identification number. g. Default Payment method – The default payment method that is automatically selected when the payment option list is shown. 16. 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. 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. 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: 22 Jamit Software – Jamit Job Board Installation & Configuration e. Show ‘Posted By’ in the post list heading – If enabled, the value of POSTED_BY will be shown on the job list. Example: 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: NOTE: Here is an example of the job list with features from d. to g. (above) turned off: 23 Jamit Software – Jamit Job Board Installation & Configuration 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. k. Group premium posts by day of week – If enabled, the posts will be grouped by day of week. l. Display number of views column for premium posts only – If enabled, will add a ‘views’ column to the premium list which shows how many times a job posting was viewed. m. Post Manager – Show Posts Per page – How many posts to show per page in the Employer’s Post Manager section. 17. Resumes a. Resumes need approval – If enabled, resumes will be placed in to an approval queue. 24 Jamit Software – Jamit Job Board Installation & Configuration b. Resumes per page – How many resumes to display per page. 18. Theme Settings a. Select a theme – A drop down list with the possible themes. The themes are listed form the include/themes/ directory. 19. Plugin Settings a. Enable Plugins – If enabled, the system will look for plugins in the include/plugins/ directory and include them. 20. Email Settings a. Use SMTP Mail for sending email – If Yes, you will be required to fill in your SMTP setting below. Sending email via SMTP can be more reliable, and if needed for scalability, you can use a separate SMTP server to handle the load. If you cannot send via SMTP, please set this option to No. Setting this option to No will send the email by using the standard PHP mechanism, and will not require you to fill in the SMTP settings. b. Hostname – The hostname of the local web server. Used when logging into the SMTP server. c. SMTP Server address – Domain name of your mail server d. POP Server address – Domain name of your POP server, usually the same as the SMTP server. e. SMTP/POP3 Username – Password to the account on your mail server SMTP / POP account f. SMTP/POP3 Password – Password to the username above g. SMTP Authentication Hostname – When logging into the SMTP, this is the server used for authentication. Usually the same as the SMTP h. POP3 Port – Port of the POP server, 110 is the default. 25 Jamit Software – Jamit Job Board Installation & Configuration i. POP before SMTP – Enable this option if your server requires POP before SMTP j. 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. k. Send application receipts to administrator – When a candidate applied for a job, sends to the administrator a copy of the application email that was sent to the employer. (Not including attachments). l. 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) m. 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. n. 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. o. Send email to a customer when a membership had expired – Sends a notification to employer / candidate when their membership expired. p. Send email to an Employer when a subscription had expired – Send a notification to an employer when their subscription to view resumes had expired. q. Email debug mode – If enabled, will output status messages to the screen. r. 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. s. Outgoing email Queue – these settings control the processing of the outgoing email queue. 26 Jamit Software – Jamit Job Board Installation & Configuration 27 Jamit Software – Jamit Job Board Installation & Configuration 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, EGold, 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 (employers) – After a successful payment, this is the URL where the employer will return to. 28 Jamit Software – Jamit Job Board Installation & Configuration f. PayPal Cancelled return URL (employers) – This is the URL where the employer will return after a cancelled payment. g. PayPal return URL (candidate) – After a successful payment, this is the URL where the candidate will return to. h. PayPal Cancelled return URL (candidates) – This is the URL where the candidate will return after a cancelled payment. i. PayPal Page Style – Set the style of the checkout / payment page on PayPal.com. The style is configured in your PayPal account. j. PayPal Currency – Select the currency that you want to receive. k. PayPal Button Image URL – Set the URL for the button’s image. Should be on a https server. l. PayPal Subscription button URL – Set the URL for the button’s subscription. URL should be https Click ‘Save’ to save changes. 29 Jamit Software – Jamit Job Board Installation & Configuration 3. Click the ‘Enable’ button to activate the module. 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. Configuring other Payment Modules 30 Jamit Software – Jamit Job Board Installation & Configuration 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. NOTE: Bank and Check payment methods support a feature for crediting the customer in advance. That is, the customer can be given the posting credits, subscription or membership before the payment is collected. An invoice email (Order Confirmation) is sent to the customer with the payment details and the order status will be ‘Pending’. To have this feature enabled, set the ‘Advance Credits’ option to Yes when configuring these modules. TIP: If you are testing, there is an easy way to order without paying. Simply place the product on order and then go to Admin and click the ‘Complete’ button to complete the order. 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. 31 Jamit Software – Jamit Job Board Installation & Configuration 2. Editing a subscription plan a. Select “Subscription Plans” from the Price Admin menu on the left. 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 32 Jamit Software – Jamit Job Board Installation & Configuration a. Select “Subscription Plans” from the Price Admin menu on the left. 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. 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. 33 Jamit Software – Jamit Job Board Installation & Configuration 5. Editing a Posting plan a. Select “Posting Plans” from the Price Admin menu on the left. 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. 6. Deleting a posting plan a. Select “Posting Plans” from the Price Admin menu on the left. b. Select the posting plan that you would like to delete by clicking on the radio button next to the plan’s name. 34 Jamit Software – Jamit Job Board Installation & Configuration c. Click the “Delete” button. Click “Yes” to confirm that you want to delete. 35 Jamit Software – Jamit Job Board Installation & Configuration Configuring Membership Plans 1. Adding a new membership plan d. Select “Memberships” from the Price Admin menu on the left. e. Click on the ‘Add New Membership’ button. f. Enter a descriptive name for the membership, the price, the currency, the duration, and the user type. Click “Add” to save. 2. Editing a membership plan g. Select “Memberships” from the Price Admin menu on the left. h. Select the membership plan that you would like to edit by clicking on the ‘Edit’ link next to the plan’s name. i. The membership plan will become editable, and you may modify the values. Click “Submit” to save. 36 Jamit Software – Jamit Job Board Installation & Configuration 3. Deleting a membership plan j. Select “Memberships” from the Price Admin menu on the left. k. Select the membership plan that you would like to delete by clicking on the delete link next to the plan’s name. l. Click “Yes” to confirm that you want to delete. Configuring Plugins Plugins are components that plug-in to the job board to provide custom functionality. They minimize the need to upgrade the entire job board just to get a new extra feature. The default installation of the job board contains two basic example plugins: StatsBox and OnlineUsers. 1. Enabling a plugin 37 Jamit Software – Jamit Job Board Installation & Configuration a. Select ‘Plugins’ from the Admin Menu b. Click on the Enable button. 2. Configuring a plugin a. Select ‘Plugins’ from the Admin menu b. Click the “Configure” button c. Edit the Plugin’s configuration options and save changes. Each plugin has it’s own custom configuration form. Some plugins may not have any configuration options. 3. Disabling a plugin a. Select ‘Plugins’ from the Admin menu 38 Jamit Software – Jamit Job Board Installation & Configuration b. Click on the ‘Disable’ Button 4. Installing New Plugins Plugins are located in the include/plugins/ directory. Each plugin is located in it’s own sub-directory. To install a new plugin, upload the whole plugin folder to your include/plugins/ directory. Here is a screenshot of an FTP program showing the upload of a module called ‘Custom Field’. Notice that the entire folder is uploaded to the include/plugins/ directory. Once the plugin folder is uploaded, you will be able to enable your plugin in the admin. Please make sure that your config.php file has write permissions, and that your language file has write permissions too. 39 Jamit Software – Jamit Job Board Installation & Configuration 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. 40 Jamit Software – Jamit Job Board Installation & Configuration 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”. Untick 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 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). (Edit) icon next to the category name. Use the text c. Click on the input to edit the category name and click “Save” 41 Jamit Software – Jamit Job Board Installation & Configuration 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 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. Click on the confirm. (Delete) icon next to the category name. Click “OK” to 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. 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: 42 Jamit Software – Jamit Job Board Installation & Configuration 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: 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 43 Jamit Software – Jamit Job Board Installation & Configuration code is at least 3 characters. 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. 4. Changing a code id a. Sometimes you may make a mistake and may want to change the code id. Also, the options in the forms are ordered by alphabetical order of the code. In that case Click the ‘Change ID’ button to change the ID of the code. b. Enter a new unique ID and click the ‘Change’ button. The system will work and change all the codes, and update any existing records with the new code. 44 Jamit Software – Jamit Job Board Installation & Configuration 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. c. Click the ‘Add Language button. Fill in the form to add a new language. Click “Submit” when finished. i. ii. iii. iv. v. Language name – The name of the language Language code – choose a unique language code Language file – select the file used for the language Image – Icon for the language. About 26 x 18 pixels. FckEditor language file – FCKEditor is the name of WISIWIG HTML Editor. Here you can tell the FCKEditor which language file to use. vi. Language Direction – left or right, or right to left. 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. 45 Jamit Software – Jamit Job Board Installation & Configuration 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. 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. 46 Jamit Software – Jamit Job Board Installation & Configuration 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: 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 안녕 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 Change to: HTML tags & (ampersand) & < (less than) < > (greater than) > “ (double quote) " ‘ (single quote) ' 47 Jamit Software – Jamit Job Board Installation & Configuration 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. 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. 48 Jamit Software – Jamit Job Board Installation & Configuration 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 Candidate Signup Employer Signup Forgot Password Request Candidate’s Details Resume Alert (text) Resume Alert (html) Job Alert (html) Job Application Job Application receipt P. Confirmed - Bank P. Confirmed - Check P. Completed Sub. Confirmed – Bank Sub. Confirmed - Check Sub. Completed Sub. Expired Mem. Confirmed – Bank Description Sends a sign-up confirmation details to candidates. Sends a sign-up confirmation details to employers. Sent to Employer or Candidate with a new temporary password. 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) Sends a list of newly posted resumes to employers, the text part of the message Sends a list of newly posted resumes to employers, the HTML part of the message Sends a list of newly posted jobs to candidates, the text part of the message Template for the job application email. Sends a list of newly posted jobs to candidates, the HTML part of the message Posting Order confirmation when the Bank payment method is selected Posting Order confirmation when the Check / Money Order payment method is selected Posting Order successfully completed Subscription Order confirmation when the Bank payment method is selected Subscription Order confirmation when the Check / Money Order payment method is selected Subscription order to view resumes successfully completed Sent to an employer when a subscription to view resumes expires Membership Order confirmation when the Bank 49 Jamit Software – Jamit Job Board Installation & Configuration Mem. Confirmed - Check Mem. Completed Mem. Expired payment method is selected (Employers and Candidates) Membership Order confirmation when the Check / Money Order payment method is selected (Employers and Candidates) Membership order to view resumes successfully completed (Employers and Candidates) Sent to a user when a membership expires 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. 50 Jamit Software – Jamit Job Board Installation & Configuration 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: 51 Jamit Software – Jamit Job Board Installation & Configuration 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. 52 Jamit Software – Jamit Job Board Installation & Configuration 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. 53 Jamit Software – Jamit Job Board Installation & Configuration 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 when editing the form. 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. Is Members Only – When memberships are enabled, this field will be viewable by members only. vii. 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. viii. Field comment – Input the comment for the field that you want the user to see. ix. Select the Category: Use this field to set the initial category, only if the field is of type “Category”. Click on the “Select Category..” 54 Jamit Software – Jamit Job Board Installation & Configuration 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”. 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. 55 Jamit Software – Jamit Job Board Installation & Configuration 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 3. You will see the Property Editor on the right. Check / Uncheck the “Is on search form” field. 56 Jamit Software – Jamit Job Board Installation & Configuration 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, Must be numeric) The error message is displayed when the data in the field fails the check. 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. 57 Jamit Software – Jamit Job Board Installation & Configuration Field Type Blank Space – No label or filed is display Example Screenshot Category – category selector Check – A group of Checkboxes. Currency See Text Field. This field can be entered as a decimal, and is displayed with the default currency sign. 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.. Flixn.com Video Recorder (Users can record their video straight form their web-cam, without leaving your website. Service is provided by Flixn.com) Image – Upload and image and create a thumbnail. 58 Jamit Software – Jamit Job Board Installation & Configuration Integer See Text Field. Integers cannot have a decimal point. Use this field if you want your fields sortable. Editor – A fully featured HTML editor Multiple Select – Similar to checkbox Note Numeric See Text Field. This field should be used for numeric data, if you want your column to be storable. Numeric fields can have decimal values. Radio buttons Separator – Field separator. Single Select Text Area – Standard multi-line <textarea> Text Field – Standard text field 59 Jamit Software – Jamit Job Board Installation & Configuration YouTube Video 60 Jamit Software – Jamit Job Board Installation & Configuration 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 61 Jamit Software – Jamit Job Board Installation & Configuration 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 62 Jamit Software – Jamit Job Board Installation & Configuration 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) List of Recods: 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) Display a record: Display data formatted in a record. Eg. When viewing a single job post or resume. How do I make my new Template Tags display when showing a record? 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 JB_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 JB_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 63 Jamit Software – Jamit Job Board Installation & Configuration 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/employers.inc.php Job Seeker Signup 5 users include/candidates.inc.php Eg. This will PHP load the template tag named ‘TITLE’ $TITLE = JB_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 JB_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 = JB_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 themes/include/default/ display-post.php template file. 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 and made in to a template file so that it is easier to customize. 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 64 Jamit Software – Jamit Job Board Installation & Configuration 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 if (($_REQUEST['post_id'] != '') && (JB_MAP_DISABLED=="NO")) { $pin_y = $prams['pin_y']; $pin_x = $prams['pin_x']; // echo the javascript to position the pin on the map JB_echo_map_pin_position_js ($pin_x, $pin_y); } ?> 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, as many of the search engines will give more weight to the keywords in the title. Here is the code to include in themes/default/index-header.php file: <?php echo JB_echo_index_meta_tags();?> The above code is already 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”><!-- overLIB © Erik Bosrup --></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. 65 Jamit Software – Jamit Job Board Installation & Configuration • 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 66 Jamit Software – Jamit Job Board Installation & Configuration 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 Copyright 2007 Jamit Software License: (1 License for Jamit Job Board – 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 software is to be used in conjunction with a Web Hosting account, a domain name and any type of web server software or operating system supported by the PHP programming language. * The intended use of the software is to run a Job Board. A Job Board is defined as a 'classified ads' service for advertisers / employers and job seekers, where the primary aim is to advertise job vacancies. * This license grants permission for the Client to modify the source code for the purpose of customization & integration with an 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. This restriction also implies the use of this software as a 'hosted' service for other websites, which includes either renting, leasing, selling or giving away the services offered by this software to other websites or webmasters. * Removal of any copyright notices in the source code is not permitted. Jamit Software PO BOX 232 Thornleigh, NSW 2120 Australia [email protected] Please see http://www.jamit.com.au/support/ 67 Jamit Software – Jamit Job Board Installation & Configuration Knowledgebase for more information and tips. 68