Knowledge Base

Function is available since WPJobBoard 3.5

This function is can be used for advanced jobs search, it allows to search: keyword, location, country, category, job type, additional fields, sort jobs and much more. Note that only active jobs are returned.

Default usage

$result = wpjb_find_jobs(array(
    "query" => "",
    "location" => "",
    "country" => null,
    "category" => null,
    "type" => null,
    "posted" => null,
    "is_featured" => false,
    "employer_id" => null,
    "sort" => "job_created_at",
    "order" => "DESC",
    "page" => null,
    "count" => null,
    "field" => array()
));


Parameters

You can pass zero or more parameters to the function.

query – (string) search jobs by: keyword, company name, location

location – (string) search jobs by: city, state, country zip code

country – (int) search countries by country numeric code (available codes can be found in wpjobboard/application/config/country_list.ini

category – (mixed) can be both category id (int) or array of category ids

type – (mixed) can be both job type id (int) or array of job type ids

posted – (int) how many days ago job was posted (available values are: 1=Today; 2=Yesterday, 7=Less than 7 days ago, 30=Less than 30 days ago)

is_featured – (boolean) if true search will return featured jobs only

employer_id – (int) employer id from database table wpjb_employer

sort – (string) field to sort by (available are: “id”, “job_created_at”, “job_title”)

order – (string) either ASC (ascending) or DESC (descending)

page – (int) which page to display (for use with count parameter)

count – (int) number of jobs per page

field – (array) search by additional field, the parameter should contain array of key, value elements where key is additional field id and value is the value to search by, for example array(5 => "find-me")

Returned value


$result->job; // (array) of Wpjb_Model_Job objects
$result->page // (int) page number;
$result->perPage // (int) number of element per page;
$result->count // (int) number of jobs on this page;
$result->total // (int) total number of jobs found;
$result->url->feed // (string) url to custom rss for this search
$result->url->search // (string) url to search result


Examples

Searching jobs by keyword and displaying job link and title:

$result = wpjb_find_jobs(array("query"=>"php"));
foreach($result->job as $job) {
    echo "<p>";
    echo $job->job_title."<br/>";
    echo wpjb_link_to("job", $job);
    echo "</p>";
}


To get access to resumes, first, user has to register as employer and then go to Resumes Access page and then click “Request Full Access”.

Administrator has to follow following steps:

1. Go to http://yoursite.com/wp-admin/admin.php?page=wpjb/employers&action=index/show/pending/
2. Check the list of employers to be approved.
3. Under “Bulk Actions”, select “Activate”.
4. Click “Apply”.

When you edit employer, “Company Profile Status” should read “Full Access Granted” for approved admins.

To register as an employer, you have to go to following address:

http://yourwebsite.com/jobs/employer/new/

You’ll be presented with following form. Fill it and click “Register” to complete.

To register as an job candidate, go to:

http://yourwebsite.com/resumes/my-resume/

Job candidates can also register using the normal WordPress Registration Form.

Note: Please enable “Anyone can register” option in WordPress Administrator Panel under Settings -> General to allow registrations.

You can add links to registration page in sidebar by adding “Job Board Menu” and “Resumes Menu” widgets.

WP JobBoard plugin provides an easy to use Visual Editor for reordering Custom Fields. Follow following instructions to reorder the form fields:

1. Go to Settings -> Visual Editor.
2. Click the corresponding button for the form you want to edit.
3. You will be presented with Visual Editor which allows you to drag and drop fields.
4. To hide or make a field required, hover over corresponding form field. “Configure” link will appear on the top right of field. Click it.
5. You can change Label, Hint and other options here. Once done, click OK.
6. If needed, you can also reset form layout by going to bottom of page and clicking “Reset Form Layout”

Your fields have been reordered.

Here’s how to Add Custom Fields to Job Boards and Resumes:

1. Go to Settings-> Additional Fields.
2. Click “Add Additional Fields”.
3. On next page, select the appropriate options for the new field. The new field(s) can be added for “Add Job Form”, “Apply To A Job Form” and “My Resume” pages.
4. Click Save.

Your custom fields have been added.

To reorder fields, follow these instructions.