Jobline

This is a component to let clients publish job postings on your website.

Requirements

License

This component is released under the GNU General Public License, a copy of this license should be included in the zip file and available for reading from the administrator page once the component has been installed.

Features

Installation

Just install the component as according to the Mambo documentation.

Upgrade

Steps required to upgrade to a new version of jobline:

  1. Backup your database, at the very least the mos_jl_jobposting table. Can be done via Mambo administrator / System / Database / Backup or via phpMyAdmin.
  2. Note your configuration options, or make a copy of the file components/com_jobline/configuration.php
  3. Uninstall the Jobline component via Mambo administrator -> Components -> Install/Uninstall.
  4. Install the new zip for Jobline via Mambo administrator -> Components -> Install/Uninstall.
  5. Restore your backup of the mos_jl_jobposting table, possibly using Mambo administrator -> System -> Restore. The script phpMyAdmin can also be used for this.
  6. Change back your configuration options, or restore the copy of the file.

Manual installation

It is also possible to upgrade without uninstalling the component, below is a description on how to do this from different versions. If you have followed the above steps you don't need to do this.

From 1.0 / 1.0.1 to 1.0.2

  1. Copy the files in the zip into the correct places (as shown in the jobline.xml file).
  2. Run the following queries in phpMyAdmin:
    ALTER TABLE `mos_jl_jobposting` ADD `jobstatus` tinyint(3) NOT NULL default '1';
    ALTER TABLE `mos_jl_jobposting` CHANGE COLUMN `creditcardexpyear` `creditcardexpyear` int(11) unsigned NOT NULL default '0';

    N.B.: If you have changed the database prefix in Mambo, you must substitute "mos_" in both queries with your chosen database prefix.

Usage

Once installed you will have a new menu option called Jobline under the Components menu in the administrator page of Mambo. From this menu you can Show job postings, Approve new job postings, administer the component, read information, change the configuration etc.

Frontend Usage Information

List job postings

By default the component lists the 20 latest job postings. Uses can change the number of postings to show per page from the drop-down box above the list. If there are more published and posted jobs than the current maximum number of items to show per page there will be links to the other pages below the list of jobs. Clicking on the title of a job posting will show details of that job. Above the list are also two links, one leading to a search form and the other to add a job posting.

Search Job Postings

The search form includes a single search box where the user can enter a search string. This string will be searched for in the job title, description and qualifications text. This is a very simple search that only searches for the entire string. When clicking on search, a result page will show listing all jobs matching the search string. This result page looks the same as the standard job posting list except that it also includes links back to the search form.

Add Job Posting

Any user visiting the site may add job postings, however they will not show up on the site until they have been approved and posted by an administrator. The available fields on job postings are:

Title
This will show as the title of the job. (This is the only required field.)
Job Type
Is this job full-time, part-time or an internship?
Description
A long description of the job.
Qualifications
What are the qualifications required for this job?
Compensation Range
This field can be used to enter what range the compensation for this job will be.
Show compensation?
Should the compensation range be shown publically on the site?
How to apply
Information on how to apply for this job.
Enter Company Name
Name of the company that posts the job.
Address 1
First line of the company address.
Address 2
Second line of the company address.
City
City where the company is located.
State
The US state the company is in.
Zip Code
ZIP code for the company
Company Website
Enter the URL for the company website here.
Contact Name
Name of the contact at the company.
Contact Phone
Phone number to the contact person.
Contact Email
Email address to the contact person.
Show Contact on Job Posting?
Should contact information be shown publically on the job posting?
Member ID
This can be anything, can be used by the administrator to keep track of who to invoice for the job posting.
Credit Card Type
Select between different credit card types.
Credit Card Number
Enter credit card number
Credit Card Expiration
Enter the expiration date of the credit card.

When the information has been entered and the user clicks "Preview Job" a preview of the job posting will be shown and the user will be asked to either "Save Job Posting" or "Edit Job Posting". If the posting is saved it will be saved to the database and will show up in the "Posting Approval Queue" in the administrator page and a thankyou page will be shown. If an admin email address has been entered in the Jobline Configuration an email will be sent to this address informaing about the new job posting. If the user selects "Edit Job Posting" the job posting form will be shown again with all the information prefilled.

It is important to always supply a contact email address, since this is the only way for the administrator to contact the poster of the job and it is also used when applications are sent through the system.

The three credit card fields will only be shown if the configuration option "Show Credit Card fields" has been set to Yes. If you use this you should make sure that the site runs encrypted so that no credit card information is sent in plain text over the internet. This information isn't handled in any way and if you allow these fields the administrator will have to withdraw payment manually.

Submit Application

When viewing a Job Posting there is a button below it called "Apply for Job", when this is clicked a application form will be shown. All data the user enters in this form will be emailed to the contact email address for the job posting when the "Send Application" button is clicked.

Administrator Usage Information

Job Postings

This page shows all approved job postings, whether they are published or not. From here you can publish/unpublish job postings, add new postings and edit current job postings. This list works in the same way as the normal Mambo content editing list. To edit a job posting, click on its title or mark the checkbox and click on the "Edit" icon. To add a new job posting click on the "New" icon. Several items can be published, unpublished or deleted at the same time by marking the checkboxes next to them and clicking on the appropriate icon. To mark all checkboxes on the current page, click on the checkbox in the header field.

Add/Edit Job Posting

The form to Add and Edit a Job Posting works in the same way, when a job posting is edited all fields will be pre-filled with the values of that posting.

The fields are the same as when adding a job posting from the frontend, except that there is a drop-down to select if the posting should be published or unpublished.

When editing a job posting, it will be checked out and no other administrator user will be able to edit it until it has been saved or the cancel icon has been clicked.

Posting Approval Queue

When Job Postings have been published from the frontend of the site they will first show up here.

When clicking on the title of a job the edit form will be shown where the administrator can review the posting and change anything if necessary. When everything seems to be OK click on the "Post Job" next to the job to post the job to the site. An email will be automatically sent to the contact email address of the job informing the user that the job has been posted. To reject the post and remove it from the site, click on the "Reject" link, an email will be dispatched informing about this as well.

When a job is posted it will be automatically moved to the "Job Postings" list and show up on the frontpage.

Information

This page shows information about the component, these usage instructions, license information etc.

Configuration

These are a few simple configuration options to change the behavior of Jobline.

Name automatic emails should be sent from
Email address to the administrator, if this is set emails will be sent to this address when new job postings are entered
Email address automatic emails should be sent from
This email address will be in the From field of all emails sent by the system. If you don't enter anything here the server default will be used.
Number of items to show on each page in lists
The default number of job postings to show in lists, this can be changed by the user.
Sort order of items in lists
The default sort order of job postings.
Number of days job postings are shown (enter 0 for no limit)
Job postings won't show up on the site this number of days after it was posted. If this is set to 0 all postings will show on the site until they have been specifically set to unpublished by the administrator.
Terms of Service
The information in this text box will be shown when adding job postings from the frontend. Enter anything you like here about the terms for submitting information to the site.
Show Credit Card fields
If you set this option to Yes three new fields will show up when adding and editing job postings where credit card information can be entered. This information isn't handled in any way so the administrator will have to withdraw money manually when the job is posted. Beware that this information isn't encrypted in anyway and you should not use this unless the site is encrypted.

Information

If you have any bugs to report, or want to make a feature suggestion, or just want to inform me of your site running this component you can write about it on the forums at my Mambo site which you can find at this address: http://mambo.theyard.org

All components and modules I've released are available from that site so if you are looking for more Mambo enhancements, feel free to visit.

If you like this component you can encourage the development by donating a few dollars to me via PayPal on the address Olle@Johansson.com

About the Author

This component was initially developed by Olle Johansson.
Find more Mambo components and modules on Olle Johanssons Mambo site Mambo at the Yard.

Credits

Jobline was conceptualized and funded by PICnet, Inc, which has graciously agreed to license it as GPL.

Those who have contributed with code or language translations need an extra special thanks. These are: Christiaan van Woudenberg for Job Status code, Jean-Christophe Boussion for French translation.

I'd like to thank all of the Mambo Core Developers for giving away so much of their time to develop the best CMS there is to be found on the net.

I'd also like to thank all of those who develop components, modules, templates etc for Mambo, it's great to have such a wealth of addons to choose from.

Disclaimer

Neither the creator of this component, Olle Johansson, nor PICnet are responsible for the security of the data saved by this component and they are not responsible for anything that occurs through the use of this component. The component is used entirely at your own risk.