This is a component to let clients publish job postings on your website.
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.
Just install the component as according to the Joomla documentation.
Steps required to upgrade to a new version of jobline:
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.
Copy the files in the zip into the correct places (as shown in the jobline.xml file).
You will have to follow each of the below steps from your current version up to the latest version, starting with the lowest version number and going up.
N.B.: If you have changed the database prefix in Joomla, you must substitute "jos_" in all queries with your chosen database prefix.
This is a small patch release, make sure to review the configuration file and save it to make sure the new configuration options are available.
This is a small maintenance update, make sure to review the configuration file and save it to make sure the new configuration options are available.
This is a small maintenance update, make sure to review the configuration file and save it to make sure the new configuration options are available.
This is a small maintenance update, make sure to review the configuration file and save it to make sure the new configuration options are available.
This is a large update and requires several changes, it is not recommended to use this manual upgrade for this upgrade.
ALTER TABLE `jos_jl_jobposting` ADD `reference` varchar(255) NOT NULL default '';
ALTER TABLE `jos_jl_jobposting` ADD `location` varchar(255) NOT NULL default '';
ALTER TABLE `jos_jl_jobposting` ADD `duration` varchar(255) NOT NULL default '';
ALTER TABLE `jos_jl_jobposting` CHANGE COLUMN `usstate` `usstate` varchar(10) NOT NULL default '';
INSERT INTO jos_components SET name='List Templates', admin_menu_link='option=com_jobline&task=listtemplates', admin_menu_alt='List Templates', `option`='com_jobline', admin_menu_img='js/ThemeOffice/template.png';
UPDATE jos_components SET ordering = ordering+1 WHERE parent > 0 AND ´option`='com_jobline' AND ordering >= 2;
SELECT parent FROM jos_components WHERE `option`='com_jobline' AND ordering=1;Note the return value of this, as you need it for the next query.
UPDATE jos_components SET parent = ENTER THE VALUE RETURNED FROM THE EARLIER QUERY WHERE `option`='com_jobline' AND name='List Templates';
ALTER TABLE `jos_jl_jobposting` ADD `jobstatus` tinyint(3) NOT NULL default '1';
ALTER TABLE `jos_jl_jobposting` CHANGE COLUMN `creditcardexpyear` `creditcardexpyear` int(11) unsigned NOT NULL default '0';
Once installed you will have a new menu option called Jobline under the Components menu in the administrator page of Joomla. From this menu you can Show job postings, Approve new job postings, administer the component, read information, change the configuration, edit templates etc.
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.
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.
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:
The fields available under this tab can be customized by the administrator from the configuration of Jobline.
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. If no email address is entered, no job application link will be shown when viewing this job posting.
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.
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.
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 Joomla 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.
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.
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.
This shows a list of the available template files in the currently selected template set. To edit the contents of a template file, just click on the name of the item. It is not possible to add or remove template files, as they are used internally by the component.
When clicking on a template in the template list a page with a large text field is shown where the contents of the template file can be edited. If the template file is writeable a green "Writeable" text is shown above the field, if the system won't be able to save the template a red "Unwriteable" text is shown above the field instead. If the latter is shown you need to change the file permissions on the file shown to be able to save this template file from the administrator page. Click on the 'Save' button to save the template, or 'Cancel' to discard any changes.
This page shows information about the component, these usage instructions, license information etc.
These are a few simple configuration options to change the behavior of Jobline.
Start Date; Number of OpeningsThe above will add two text fields, one with the title "Start Date" and another with the title "Number of Openings". N.B. When adding new fields, they have to be added to the "show" template as well before they show on job postings.
Required Skills=Cooking; Sowing; Rowing; Swimming Recommended Licenses=Driving; FlyingThis will give you two keyword categories, one called "Required Skills" and the other "Recommended Licenses", containing different keywords. When adding a new job posting, each keyword can be selected by clicking in the checkbox next to it, and all checked keywords will show up when viewing the job. N.B. When adding new keyword groups, they have to be added to the "show" template as well before they show on job postings.
From v1.1 Jobline includes a template system for the html output of frontend pages. Two different sets of templates are included with Jobline and it's possible to switch between these from the Jobline configuration. Each template file can also be changed via the Jobline Administration. It's only possible to edit the content of template files in the currently selected template set.
The template files are normal HTML files, but also uses functionality similar to Joomla Mambots to make it possible to show where dynamic data should be placed.
N.B. The mxtshowif and mxtshowifnot template mambots can't be nested, as it will only work from the opening mambot to the first occurence of closing mambot.
Please look at the content of the provided template files for more information on how to use this template system.
Customized fields are retrieved by adding "attribs_" to the beginning of the name, so the field "Start Date" would be shown like this: {mxtvalue=attribs_Start Date}
It's also possible to get configuration values, by adding "config_" in front of key name of the configuration value.
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 Joomla site which you can find at this address: Jx Development
All components and modules I've released are available from that site so if you are looking for more Joomla extensions, 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
This component was initially developed by Olle Johansson.
Find more Joomla extensions modules on Olle Johanssons Joomla site Jx Development.
Jobline was conceptualized and funded by PICnet, Inc, which has graciously agreed to license it as GPL.
The continuing development of Jobline has been sponsored by many people, without whom many of the new functions wouldn't exist.
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, Vittorio Docente for Italian translation, Alexander Kozlov for Russian translation, Dominique for Dutch translation, Cristobal Dominguez for Spanish translation, Tomasz Z. Napierala for Polish translation, Bruno Carvalho Castro Souza for Brazilian Portuguese translation, Christoph Lemmer for German formal translation, Øystein Efterdal for Norwegian translation, Helder Lopes for Portuguese translation, amarok for new German formal translation and German informal translation, Onur Bilgiç for Turkish translation, Edu Richard for Catalan.
I'd like to thank all of the Joomla 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 Joomla, it's great to have such a wealth of addons to choose from.
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.