Create Joomla administrator

First log in Joomla! backend as super administrator, then browse to User Management:

Now create a new Joomla! administrator/super administrator and make sure that user is not blocked. You can also change an existing user's permissions to become an administrator/super administrator. Let's say we want to change permissions for an existing user to make him an administrator, this is how to do that:

• Step 1 - select the user you want to change his permissions;
• Step 2 - click the Edit button;

Loading...

• Step 3 - click the Administrator user group;
• Step 4 - click the Save button.

Grant Job Board Permissions

To manage Job Board administration permissions, first you have to navigate to User Permissions panel:

• Step 1 - click the Subscription and Permissions menu item;
• Step 2 - click the User Permissions submenu.

To edit a user's permissions, click on the name of the user that you want to be Job Board administrator/super administrator. Usually a Job Board administrator is given specific permissions, but super administrators are given all permissions.

Below you can see the Job Board User Permissions panel. This is the list of Joomla! administrators and super administrators that the Job Board component recognize them as having administration rights. See the new administrator we have setup earlier?

Please note: that a new Joomla! administrator has no administration rights in Job Board component but Joomla! super-administrators have full permissions. In the image below you can see back-end permissions list for the Job Board administration.

To add permissions to the new Job Board administrator we have setup earlier, select the administration sections according to his/her expertise or qualification.

Customize displaying forms

Displaying forms are used to collect data, Job Board uses four forms to collect data:

• Jobs form: Used to collect job information.
• Profile: Used to collect front-end user information.
• Resumes: Used to collect job seeker resume info.
• Applications: Used to collect job seeker's applications information.

Forms are composed by many fields. Thus, any modification to fields will affect the above mentioned 4 forms. If you have enough permissions to customize fields, it is quite easy to edit these fields up to your expectation by changing HTML control that displays form's fields. By following the below steps and screenshot, you can easily change the field value type, validate fields input, add a new field, remove one field/select to display a certain field or not in a few minute.

Filter the form that you want to customize

After login back-end, go to JA Job Board component. Please navigate to Fields Form Management:

• Step 1 - click the Design and Customization menu item;
• Step 2 - click the Form Customization submenu.

Next we can use the Drop down box right above the list to select the form you want to edit it's fields. See the image below how to:

Customize form

Customizing forms & their corresponding fields is a task preferably for the development stage. On a production website, changing field types will produce loss of data and will require website administrators to request employers to update their active jobs according to the new job related field structure. Moreover, this task will be very difficult for large websites, so it is a reason just enough to consider building the right field structure from the start. All forms hold both system fields & non-system fields. The non-system fields are form specific, but the system fields are hold in almost all of the forms as the primary keys which connect database tables. It is recommended to back-up your website's database before changing anything in the Job Board field structure.

Editing a field

Except for system fields, you can edit any of the non-system fields properties for all forms. However, for system fields you cannot change field name, field type and table name.

Each form holds specific fields & each field has specific properties. For instance, you want to edit the Job code field from the Job form. In the left side of the image below you can see the field highlighted in red background.

If you change field type to single select, radio or multiple select, then you should click the Apply button to save the new property, then you will see an Edit option link next to this property. Click that link to add options for the new field type if it does not have any select option. If you change form name of one field, then that field will disappear on the field lists of old form and appear on fields list of new form. Hence, you have to filter fields of new form to rebuild database.

Please note that if you change field name, field type or table name, then you have to rebuild database. To rollback changes that require rebuild database, click undo link of the field that you want to reverse.

As we said above, the new field type single select, radio or multiple select will need the select options, so click "Edit option"" and follow instructions in the image bellow:

Adding a new field

To add a new field, click the New button in the Fields Form Manager panel. See image below:

In this section we will go deeper into the Job Board field properties and explain each property's functions. While editing a new field, the form preview in the left side will show no for preview. But after finalizing edit of the new field by clicking the Save button and come back to edit the same field, the form preview will show the new field at the bottom, highlighted in red background. Please note that the new field will not show in front-end or back-end forms until the database is rebuilt. Also note that you can undo adding the field to the associated form by using the Undo link of each newly-added field. We will explain below just how to do that.

Let's explore the field properties. They are grouped in several sections so you can easily follow:

Field properties explanation: Database Information

• ID - is a read-only system field property, an integer number associated to the field;
• Field Label - is the label shown in the form, this property cannot be empty;
• Field Name - is the text shown in the header of the table in the database, this property cannot be empty;
• Field Type - describes the behavior of the field, please refer to Field types reference section for more information;
• Init Value - is a default value you can set for the field;
• Form Name - connects the field to a specific form to become one of the form's field set. The options are:
  • Job Form;
  • Profile Form;
  • Resume form;
  • Application Form;
• Table Name - makes the field to show up in a specific table, and this property is related to the Form Name property. The options are:
  • Jobs Table;
  • Profiles Table;
  • Resumes Table;
  • Applications Table.

Published - describes the state of the field, with other words show or not show the field in the front-end tables or forms:

• Yes - the field will be displayed in front-end;
• No - the field will not be displayed in front-end, but the field will always be visible in back-end.

Validation rules

• Is required? - select whether the field is required or not:
  • Yes - the field is required, will need a validation rule (configuration just below) and will display an error message if the user inputs incorrect information;
  • No - the field is not required, will not need a validation rule and will not display an error message;
• Type of check - describes how the field must be validated for the user input:
  • Must not be empty - a simple condition so the user is forced to fill the field;
  • Must be number - limits the input values to numeric values;
  • Must be a valid e-mail - checks if the user input is a valid e-mail address;
  • Must be date format - checks if the user input is a valid date format, this is related to back-end general settings and the error message should inform the date format;
  • Must be time format - checks if the user input is a valid time format;
  • Must be date time format - checks if the user input is a valid date and time format;
• Error message - is shown in a pop-up window to instruct the user with examples on how to input a valid value into the field: "ERROR: You should type a number!", "TIP: the date is not valid, please try YYYY-MM-DD HH:II:SS" (according to your general settings for date and time), etc.

Display settings

• Field order - sets the order of the field in forms and frontend tables, property can be changed after saving the field;
• Field is on filter - marks the field as a part of the back-end filter:
  • Yes - the field is displayed in admin filters;
  • No - the field is not a filter.

Frontend Parameters

• Display mode - describes the display behavior of the field. Options are:
  • Show all in frontend;
  • Hide on new form and view only on edit form;
  • Show on new form and hide on view;
  • Show on new form and view only on edit form;
  • Hide all on Front-end;
  • Admin only;
• Width - set a specific width for the field;
• Height - set a specific height for the field, useful for text-areas and multiselect boxes;
• Class name - used to highlight a field by calling a styling class;
• Readonly/disabled - marks the field is read only or can be modified;
  • Yes - the field cannot be modified in front-end;
  • No - the field is writable in frontend;
• Mouse event - can be used to declare a mouse event for a specific action. Options are:
  • onClick;
  • onChange;
  • onBlur;
  • onFocus;
• Function JavaScript - is used with Mouse event to show a small pop-up message on a specific mouse event;
• Field example - is the pop-up message shown by the JavaScript, on a specific mouse event, to instruct front-end users on how to fill the field;
• Comment - a simple description added next to the field to instruct the user how to fill up the field.

Database Reference

• Is referred?
  • Yes - enables referencing the field to another field, database table or value;
  • No - means that the field is not referred;
• Referred key - links the field to a specific key field, usually ID;
• Referred value - links the field to a specific value in the database;
• Referred table - links the field to a specific table, according to the key referrence.

Removing a field

On the fields list page, select the fields that you want to remove, then click the Delete button, click ok button on the confirmation dialog box. Be careful when you decide to remove a certain field, you cannot rollback to the fields that had been deleted.

Rebuild database

On the fields list page, you could easily recognize all newly added/edited fields that are highlighted in red background. That means these modifications have not been applied to the site yet, until database has been rebuilt.

In order to make changes affect one field, click on click rebuild DB link of that field. A review changes screen will appear, after review field's change, click continue button and click ok button on the confirmation dialogbox. The modified field will be now available at the front-end as you wish.

Review modified field require rebuild database.

Field types reference

• Blank Space = this field type creates a blank space to separate groups of fields;
• Boolean = this field type can describe a database entry as having one of two values: Yes or No, True or False, Male or Female, Married or Not married, etc;
• Date = used to reference an event (create date, expiry date) at a certain moment in time;
• Date - Calendar = same as the one, but using all date and time information;
• File = used in Review form for job seekers' attached CVs;
• Image = used for job seeker photos and company logos;
• Integer = an integer number related to an entry, for instance: views, age, years of experience, etc;
• HTML Editor = used to call an editor you have set as default in Joomla! configuration: TinyMCE, JCE or any other editor you have installed and set as default;
• Multiple Select - selectbox used in all forms for Location of Employers and Job Seekers. This field allows multiple select just like a company would have open centers in multiple locations;
• Numeric = any kind of number related to an entry;
• Radio Buttons = similar to Single Select field type below, but this uses rounded check boxes for selecting one option/value;
• Separator = used to set a title for a group of fields, for instance: "Job Information", "Education Information", etc;
• Single Select = selectbox with a single selection, used for "Business Type", "Salary Type", etc;
• Text Area = a simple text area for Job Seekers/Employers to add notes or other information to their jobs/reviews;
• Text Field = a simple text field for users to type in several types of information: name, surname, zip code, phone number, etc;
• Password = a simple password in case you want your employers to protect their job postings with a password;
• URL = a URL field type can be used for company website link or job seeker portfolio/blog.

Customize displaying tables

There are 4 displaying tables used on JA Jobboard for showing summary of a user peer'info collected from displaying forms as mentioned above. They are Jobs, Profile, Resumes, Applications table.

• Jobs table: used to display list of jobs. This table appears on front-end pages and on the administrator's job manager page.
• Profiles table: used to display employer info for job seeker or all other user's view depending on admin's configuration.
• Resumes table: used to display resumes info for employer or all other users'view depending on admin's config.
• Applications table: used to display information of applications for employer's review.

Filter the displaying table that you want to customize.

You can customize these tables by adding new column, removing column or changing column properties.

Each column has settings like the following:

Customize interface

It is more difficult and requires web designing excellence to customize the look & feel of your Job Board site. Thus, this section is recommended to administrator who is an expert in web design.

Customize page layout

To customize the look and feel of the Job Board is very easy by using the built in code editor. The procedures are very similar to language customization. First you have to navigate to layout customization panel:

• Step 1 - click the Design and Customization menu;
• Step 2 - click the CSS & Templates submenu.

This is the Layout customization panel:

As you can see these are the layout files, grouped in folders:

• Applications;
• Employers;
• Jobalerts;
• Jobs;
• Payment;
• Posts;
• Profiles;
• Resumes;
• Usergroup;
• Userregister.

For instance we would like to customize the application list in the employer's page:

As you can see the message above the editor, it informs that changing the file will automatically create a template override for the view, but won't affect to the original code. To learn more about template overrides, please visit our designated documentation section. What is important to remember here is that you can change the class names, div IDs, or arrangement as you like. As well as use the new class names into your default Joomla! template, and style these classes and IDs both in Job Board CSS and the default Joomla! template CSS file.

Customizing CSS

To customize the stylesheets for Job Board, you can click the CSS link in the same panel. See images below:

Clicking the Edit link will open the code editor:

Here you can customize default Job Board HTML tags or your own tags. When you update Job Board, remember to back-up this file.

Customize date format

To customize date format, go to general section of system config category, enter the format that you want to display on the display date format textbox. Job board will translate the format as the following: %y to year's four digits, %m to month in number, %d to day in number, %h to hour in 24, %i to minute, %s to second.

Customize email templates

Visit manage email templates for more information.

Customize Job List Themes

JA Job Board supports multiple themes for jobs listing. There are 4 standard themes:

• default - displays the jobs list in a table format;
• inline - displays the jobs listings using li (list items) and AJAX implementations and provides sorting options;
• inline-light - similar to the second but this theme uses less coloring.
• Summary - display the jobs list in table with summary information.

The default theme

We are going to insist on inline themes and explain how to modify the look for normal job posting, featured, hover state and rows, but also show you how to style, move, hide specific parts of the job posting. The inline theme

List item space is the wrapper of all job posting information, and uses several colors and styles:

• normal styling is used for non-premium jobs, and makes use of these code pieces:

Noticed the row1 background color? You can change it with your desired color to match your website design.

• hover styling applies to all jobs, no matter if they are premium or not;

• premium styling applies to jobs that are marked as premium, and use this code:

Job selector is a checkbox connected to the scripts of the theme. This element can be styled in code:

TIPYou can change the position from left to right for RTL websites.

Job title styling uses this code:

You may want to delete the color line, to make it use your template color for a items.

Salary information styling uses this code:

Employer name can be customized in this code:

Employer logo uses this styling:

Job short description uses no specific styling, as it is a simple text that inherits styling from the template for paragraph.

Job Category uses this styling:

You can delete the color styling for links to match your template styling.

Job Location uses some common styling like Job Category for links, and also specific styling such as:

Time stamp or Creation date uses this styling:

Job order number uses this styling:

Featured job Highlight and New job Highlight styling uses this code:

Add a new language

For older versions of JA Job Board component, you have to create the language files for your new language by using the original ones:

• en-GB.com_jajobboard.ini site language file located in your_site_root\languages\en-GB\
• en-GB.com_jajobboard.ini admin language file located in your_site_root\administrator\languages\en-GB\

To add a new language to JA Job Board, first you have to check if your language pack for Joomla! CMS is installed, if not, please do so. Then check the language customization menu, and you will notice JA Job Board automatically created the language files for your language in the Languages Manager page. If you have your own translations, please overwrite these files. If not, please select whether you want to edit site/admin language file. Then click on language name of your new language to proceed with editing. The language file editor will help you easily to edit your language but please note that this file contains key-value pairs. The strings from the left side of the equal mark " = " are the keys that must not be modified AND the strings from the right side of the equal mark are the English language strings you have to edit and translate to your new language.

Language manager screen.

Edit language file.

Add another payment method

For now, Job Board has only one payment method, that is Paypal. If you want to implement another payment method, then you have to write it. To write it, your file should be similar to Paypal.php under components\com_jajobbord\asset\payments folder.

Configure file uploading

On Job Board, front-end user can upload CV, profile image, you can configure which file type is allowed to upload, and limit file's size uploading from general section of system config category.

Manage email templates

Configure email settings

Email settings section of system config category determines whether Job Board can send email to front-end user automatically after some events occur or not, this section also sets email information on sent emails.

Email settings.

Manage email templates

Email templates are used for: - Sending mails to users/admin to notify of an event - To confirm a payment/an action on the site by users or admin. Currently, a list of English email templates for general & major events on a Jobboard site has been included on JA Jobboard by default. Webmaster can find it very easily and conveniently to duplicate these email templates into the language he wants at anytime. Moreover, the system itself will do the rest when the content has been changed into associated language while variables/params are kept unchanged.

List of email templates.

Jobboard maps the event that need to send email with the template name. If Jobboard is enabled to send email automatically, but it cannot find out email template in the language that it has to send. Jobboard will use the template in English as the default language. If the template in English does not exist OR is not published then a notification will display on user screen.

Each template has properties like the following:

You can do the following steps to customize email templates:

• Copy templates from your existing language to another language:
• Edit template: You can edit any email properties except the template name. Note you cannot edit the event that the template attach to, because Job Board maps the event with template name.
• Create new template: You can create a new template, but you can not set its name with one of system templates' name. Job Board allows to create template here so developer does not have to create it in database.
• Export templates: You can export your template into text file, edit it, then import to Job Board.
• Import template: You can import template into Job Board from ini file.

Send email manually

To send email to employers/ job seekers manually, on the employers manager/ job seekers manager page, select employers/ job seeker that you want to send email to, then click send mail button, a compose screen will appear, compose your email then click send button to send.