WP Job Hunter

User's Guide


Thank you for purchasing my plugin. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much! This plugin using Job Service Providers API to fetch jobs to your website. Some of them pay you affiliate revenue, that you can track when you login to your chosen Affiliate Provider's Admin Page. ( usually the same where you registered ) The installation and the setup are super simple, you will get a brilliant responsive widget and jobs content to you website within a minutes.

You can earn a lot of money with sharing jobs on your website and in the other hand, you can get a nice content to your website as well.
indeed.com, careerjet.com and the others those part of the plugin provides amazing affiliate program and they will pay you when somebody click on a sponsored job link. (pay per click method)

If you already have the API Key for your chosen service provider, you can jump to the Install Guide section.

If you aren't a member of the any Publisher Program, you need to register on one of the following url:

Get Indeed Publisher ID

Become CareerJet Partner

SimplyHired Partner Solutions

Request Elance API Key

Get Authentic Jobs API Key

After the successful registration, you will find your ID in your admin, for example if your registered for Indeed Publisher Program, find your affiliate ID under the XML Feed tab.

You will see something like this:

Some of them send it by email or some of them display it directly after the registration. Anyway, you need one at least to use the plugin.

You are ready to Install the WP Job Hunter plugin, you can jump to the Install Guide section

- responsive job board widget
- super simple setup
- ability to set up keywords and locations for the widget
- ability to set up separately keywords and locations for posts
- ability to set up the number of the listed jobs for the widget between 1-10
- instant refresh the widget job list on every page load by random
- very fast and well-designed
- contained the indeed logo, it is required by the indeed.com policies
- more informative jobroll widget than the usual with a short jobs' description
- links nofollow feature
- no coding or any technical skills necessary
- auto-post feature after page load
- choosable author for the posts
- create custom categories with keywords
- ability to feed jobs only when the job fit to any exist category
- enable or disable comments on jobs' posts
- one-click facebook share button
- one-click facebook like button
- one-click google plus share button
- show job's location with Google Maps on post's page by one-click
- enable or disable statistic
- statistic contain the total jobs, the top 50 viewed jobs and the last 50 viewed jobs
- generate tags by automatically from the content with an intelligent method, ability to excluding tags
- fully customizable external indeed link with four inbuilt view or with your own html elements
- feed jobs by cron with customizable limits, used by the inbuilt adjustable keywords and location parameters
- set up email address to get cron responses
- works with any professional wordpress templates, fully adapts for the style of the templates
- fancy, arranged tabs on admin page with a lot of help
- list of supported countries for the Location and Location Shortcode settings on admin page
- geolocation with cache
- CareerJet
- SimplyHired
- Elance
- Authentic Jobs
- Job feed cache
- option to use the first post tag as a keyword in the widget
- multiple widgets on the same page
- WPML compatible, fully localizable
- customize jobs on the widget by enable or disable description-, location- and company informations

First, log in to the Administration area of your Wordpress website and select Plugins:

Click Add New on the top of the page:

Select Upload on the top of the page again:

Browse the plugin zip file from your computer and click on the Install Now button:

Click on the Activate Plugin link and the plugin will be active immediately.

After the successful plugin activation, you will be redirected to the plugins' list page.

You can find the WP Job Hunter plugin in the list:

The widget of the plugin is also available with the clicking on the Widget link, but first, you need to set up the plugin settings now. Read about the set up in the section of General Settings.

After you successfully installed the plugin, click on the Settings below the WP Job Hunter plugin on the plugin list page or choose the General Settings from the left navigaton bar under the WP Job Hunter main menu.


Most of these settings are related with the saving jobs as a post feature. Don't forget, some (if not all) of the service providers doesn't allow storing the jobs in the database, so use this feature it at your own risk. (read the service providers' terms and conditions carefully) The best (safest) option to include jobs to your website, using the direct linked shortcodes. Read the details about this feature in the Shortcodes section.


You can specify the author of the posted jobs with the Author of the job posts option. If you want to post under your registered username, select that from the list. You can also find the other usernames in the list except the users with Subscriber role.

If you switch on the Auto-Post after page load option, the plugin will try to save the jobs automatically as a post from the WP Job Hunter widget on every page load. Every jobs posted just once as a normal post type.

After you specified your own job categories, you can set up the plugin to save jobs when only fit to the predefined categories. If you leave switched off the Save job when only fit to any category option, the jobs with unrecognized category will be saved to the Uncategorized category.

IMPORTANT!!!

If you switch on the Save job when only fit to any category option on the Settings tab, you have to specify enough categories and tags. Otherwise the plugin can't save any job to your website. Important to note, if you decided to use this category filter, you won't get any jobs unless you specified a large number of category tags. The plugin will try to find those tags in the jobs' titles and descriptions, therefore the tags needs to be descriptive.

Comments are available on the job's page if the Allow comments on jobs' posts is enabled. This option only works with the next posted jobs. If you switched off, then later you will decide to enable this setting, the older posts are still in comments closed status.

Enable Facebook Like and Share buttons on the jobs' page with the radio buttons of Enable Facebook Like and Share on job's page. This is affect all job posts independently from the other options.

Enable Google Plus share on job's page works like the Facebook option, you can enable or disable it with one single click. The required javascript files will be loaded on the next page refresh on your the frontend area.

Easy to integrate Google Maps with the exact marker on the job post's screen with the Show location with Google Maps below the job option. This will be shown below the job's description.
In this case, a custom gmaps.js file will be loaded with the official Google Maps JavaScript API.

If you set on Enable statistic, you can track your visitors by the inbuilt function of the plugin. It needs more resources and your site will be a little slower when you enabled this option. The performance is strongly depends on your web hosting service provider and configuration. If your website is seems to be slower than usual, turn off this option.

The plugin able to generate the tags automatically from the job's content when it posted to your website. Switch on the Auto generate tags to use this feature. The function search for the most used words from the title and the content and save the first ten words.

You can see an external job apply link on every jobs' page. This link will redirect the user to the job's original page (Indeed, CareerJet, etc.) By default, you can only see a link with Apply Job text, but you can customize it with the Customize external job links option. The last option is provides a default custom style, feel free to modify.
Important to note, you have to keep the current format of the custom link, but you can change the image, add style, etc. :

[a target="_blank" style="border:1px solid #000000;background-color: #5D5D5D;" rel="nofollow" href="{joblink}"]
[img src="{plugin_url:templates/assets/img/apply_job.png}"]
[/a]

Use [ and ] brackets to open and close your custom link instead of < and >.

You have to specify the joblink with the

{joblink}

parameter. If you specify your own image, use it with relative path in the src attribute of the img tag, like:

{plugin_url:templates/assets/img/apply_job.png}

With Integrate with Jobroll Theme you can partly integrate the plugin to JobRoller Theme. In this case, the jobs will be saved to Custom Post types and it will be arranged to the saved Job Types like Fulltime, Freelance, etc. The most of the job feeds doesn't provides the type of the jobs, therefore when the plugin find the Freelancer (for example) text in the job's title or in the description, it will be saved as Freelancer job type. When you switch on this integration, the Google Map automatically disabled, because the Job Roller Theme also includes Google Maps. The plugin automatically remove the Job Roller's Apply button and implement the WP Job Hunter Apply Link instead on the job's page.

After you click on the Save Changes button, all modifications will be saved.

As you red before, the plugin using several job service providers API to feed the jobs. If you read this section, I assume you might already have one, so you can set up the plugin.
Without any Affiliate ID or API Key, please don't try to set up the plugin, because it won't work. Check out the Introduction section for more details about how to get this kind of ID or API Key.

This page responsible to save your Affiliate IDs or API Keys, so the plugin can use it on any areas on your website. Fill out the chosen providers text input, then save:

You don't need to fill all of the fields above, just the ones you willing to use in the future.

If you request for the job feeds often, the service providers can block your access, because of the high loads. The cache option is help you out, therefore it is strongly recommended to enable it for 5 minutes at least. It will result, the same request will give back the same results in 5 minutes. I don't think it is a big deal, because probably it will be the same result without cache in this short period anyway. (at least we doesn't use the API for this small period)

Turning on the Geolocation feature of the plugin, means it will try to use the visitor's IP address to determine the country and the city and display jobs from this location. You can disable this function in the shortcodes and the widget separately, but you are unable to use it in those areas if you disable in this page.

You can choose the geolocation service from the selectbox and set the cache. Using cache is recommended, probably the visitors won't change their locations in few hours, but you can get better performance. The plugin save the visitor's location to COOKIE and use it in the next visit until expires.

If you enabled the option of Auto generate tags, the plugin will automatically generate tags from the title and the content of the job. If you don't like some generated tags, you can exclude words on this tab. You can find some example words defined by default. Again, these tags won't be saved when the plugin automatically post jobs. (by cron or the widget)

Creating categories to the jobs is absolutely possible with this page. Find some predefined categories, but define any number of categories as you wish. The plugin will analyze the job, if found any category tag in the text, it will save it to the category of the matched category tag.
For example:

If the plugin get a job with the following datas:

Assistant Hotel Manager
Ashburn, VA, Fairfield Residential
Assistant Hotel Manager works with the Hotel Manager in the general administration of the property and performs all related management functions. To be...

The plugin find the 'Hotel Manager' words in the title and in the content as well, so it will be saved to the Manager Jobs category, because this category contains the 'Hotel Manager' tag.

You can delete or edit the predefined categories without restrictions.


IMPORTANT!!!

If you switch on the Save job when only fit to any category option on the Settings tab, you have to specify large number of categories. Otherwise the plugin can't save any jobs to your website.

To save all jobs to one specified category, just add alljobs tag to the category.

This page provides a quick access to the WP Job Hunter Widget. Click on the Widget Options link and you will be redirected to the settings of the widgets.

Find the WP Job Hunter widget in the list, then simply pull it to the desired sidebar: