WP Job Board

WP Job Board allows you to run a job board inside WordPress. It allows web developers, entrepreneurs, recruitment agencies and bloggers a reliable, high-quality job board solution.

WP Job Board

Key Features

  • WordPress
  • Works on all themes
  • One-click installation
  • Visual editor

Integration

See PayFast integration

How do I use PayFast with WP Job Board Plugin?

In order to use PayFast with WP Job Board Plugin, you will need to install the PayFast payment module for WP Job Board Plugin which is provided by PayFast.

What are the installation requirements?
  • A working WordPress site with the WP Job Board plugin installed
  • Currency will need to be set to South African Rands (ZAR) on WP Job Board. See FAQs below for instructions.

Installation and Testing

How do I install the PayFast module?

To install the PayFast payment module, follow the instructions below:

  1. Download the PayFast payment module (v3 or v4)
  2. Unzip the module to a temporary location on your computer
  3. Copy the ‘wp-content’ folder for the v3 or v4 module to your base ‘WordPress’ installation
    • This should NOT overwrite any existing files or folders and merely supplement them with the PayFast files
    • This is however, dependent on the FTP program you use
    • If you are concerned about this, rather copy the individual files across as per instructions below
  4. Login to the WP Job Board Plugin back office console and activate the plugin
  5. Navigate to ‘Settings (WPJB)’ and select ‘Configuration’
  6. Scroll down to ‘Payment Methods’ and click ‘Edit’ for PayFast
  7. Select ‘Enable this payment method’
  8. The payment options will then be shown, select ‘Sandbox’, ‘Debug On’ and the ‘Pay Now’ button you prefer.
  9. Click ‘Save Changes’
How do I copy the individual files across?

If you are concerned that copying the entire folder from the downloaded module may overwrite files in your installation, rather copy the files from the extracted module individually into your installation.

Be sure to copy the files from the downloaded module to their corresponding locations within your installation:

The list of files needed in your online installation are as follows:

wp-content/plugins/wpjobboard/application/libraries/Payment/PayFast.php
wp-content/plugins/wpjobboard/application/libraries/Payment/payfast_common.inc
wp-content/plugins/wpjobboard/application/public/paynow-dark.png
wp-content/plugins/wpjobboard/application/public/paynow-light.png
How can I test that it is working correctly?

If you followed the installation instructions above, the module is in ‘test’ mode and you can test it by purchasing from your site as a buyer normally would. You will be redirected to PayFast for payment and can login with the user account detailed above and make payment using the balance in their wallet.

You will not be able to directly ‘test’ a credit card, Instant EFT or Ukash payment in the sandbox, but you don’t really need to. The inputs to and outputs from PayFast are exactly the same, no matter which payment method is used, so using the wallet of the test user will give you exactly the same results as if you had used another payment method.

I’m ready to go live! What do I do?

In order to make the module ‘LIVE’, follow the instructions below:

  1. Login to the WP Job Board plugin back office
  2. Navigate to ‘Settings’ below ‘Job Board’
  3. Click on ‘Edit Payment Options’ button
  4. In the PayFast Settings block, use the following settings:
    • PayFast Sandbox/Live = ‘Live’
    • PayFast Merchant ID = Integration Page>
    • PayFast Merchant Key = Integration Page>
    • PayFast ITN Debug = Off
  5. Click Save Changes

See Upgrading

Standard Upgrade Procedure

  1. Download the payment module from our site
  2. Unzip the module to a temporary location on your computer
  3. Copy the ‘wp-content’ folder in the archive to your base ‘WP Job Board Plugin’ folder

See FAQs

Frequently Asked Questions (FAQs)

How do I add South African Rands (ZAR) to WP JobBoard?

You can add the South African Rand to the currencies list by adding the code below in your theme functions.php file.

To check your currently active theme, go to Appearances.

add_filter("wpjb_list_currency", "my_new_currency"); 

function my_new_currency($all) { 
   $all[710] = array(    "code" => "ZAR",     "name" => "South African Rand",     "symbol" => "R",      "decimal" => 2 
  );    return $all;  }
What is the payment flow?

PayFast works on browser redirection and will redirect the user to PayFast for payment after they click the ‘Pay Now’ button on the Checkout page.

If the payment is CANCELLED during processing on PayFast:

  • The user will be returned to the ‘Front’ page of your WordPress installation.

If the payment is SUCCESSFUL through PayFast:

  • The user will be returned to the ‘Order Confirmation’ page
  • The order will be created and the job will be listed as ‘Active’
Do I need to set the ITN url on my account?

No. When using the one of our payment modules, the ITN url is set automatically and you do not need to set it on your account manually.

Where is my “base WP Job Board Plugin v3.6.0 folder”?

This is the root of your WP Job Board Plugin v3.6.0 installation. Where this is, depends on what system you are using and where you are hosting.

The easiest way to find this though would be to look for the WP Job Board Plugin v3.6.0 directory structure.

The base (or root) WP Job Board Plugin v3.6.0 folder will look similar to the image shown below.

Simply find the folder in your installation which looks similar to this structure and that will be your ‘base WP Job Board Plugin v3.6.0 folder’.

I upgraded WP Job Board Plugin v3.6.0 and now “PayFast” no longer appears as a payment option!

When upgrading WP Job Board Plugin, the PayFast payment module files may be deleted.

You simply need to reinstall the module following the installation procedures above and the ‘PayFast’ options will reappear with your previous setting intact.

Useful links