WooCommerce Paid Listings User Guide

WooCommerce Paid Listings is a plugin for WP Job Manager which lets you purchase Job Listing Packages and (as of v2) Resume Packages (as products) which are then used to post listings.

↑ Back to Top Installation

To install this plugin, please refer to the guide here: http://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation

↑ Back to Top Setting up WooCommerce products as job/resume packages

After installation the first thing you’ll need to do is setup some products in WooCommerce which job submitters can purchase.

  1. Create a new product
  2. Select a package product type:
    1. Job Package – A package which lets a user post X jobs before expiring.
    2. Resume Package – A package which lets a user post X resumes before expiring. Requires Resume Manager add-on.
    3. Job Package Subscription – Requires WooCommerce Subscriptions. See below for more information.
    4. Resume Package Subscription – Requires WooCommerce Subscriptions and Resume Manager add-on. See below for more information.
    5. NOTE: If using a theme such as ‘Listify’ these packages may be named slightly differently (e.g. Listing Package)
  3. Enter price and other product details like any other product. Job/Resume Package products can be free or paid – your choice!
  4. Package specific options are as follows: Screen-Shot-2013-09-22-at-12.37.28
    • Listing limit – How many job or resume listings this package lets you create once purchased. Can be left blank for unlimited posting.
    • Listing duration – How long job/resume listings last (in days) before expiring when using this package.
    • Feature listings? – Whether or not job listings should be featured when using this package.
  5. Publish the product

The published package will then be available during job submission.

↑ Back to Top Subscriptions Support

Job Packages can also be subscriptions, but this requires the WooCommerce Subscriptions extension from WooCommerce. You can have both Job and Resume Subscription packages.

Subscriptions can work in two ways.

  1. The Package is Linked to the Subscription
  2. From version 2.3.0, there is an option to link to Subscription to the Listing

If the subscription is linked to the package, the user will be able to post X amount of listings per subscription term. Renewals reset the package and allow the user to make more postings.

If the subscription is linked to the listing, the user will be able to post a limit of X active listings which will expire when the subscription expires. Failure to renew will expire the listings.

↑ Back to Top Job Submission Flow

WC Paid Listings will change the job submission process slightly to add the required purchase/job pack steps. This is how it should happen:

  1. User fills in the job submission form as normal
  2. User previews the job as normal
  3. In the preview header, rather than a ‘submit’ button, a ‘choose package’ button will be shown: Screen-Shot-2013-09-22-at-12.08.38
  4. When clicked, the choose a package screen will be displayed. This page lists all Job Package products and previously purchased active job packsScreen-Shot-2013-09-22-at-12.24.56
  5. User chooses a package and clicks submit.
    • If this is a new package, it will be added to the WooCommerce cart, referencing the Job ID. Once paid for, the job will be approved and the package assigned to the user.
    • If this is a package that has already been purchased, the job will be submitted right away.

The same flow is used for resumes: Enter resume details > Preview > Choose Package > Checkout.

You can also choose whether to show packages before or after a listing is created by selecting this option under Job Listings > Settings > Job Submission > Paid Listings Flow:

↑ Back to Top Changes to WC checkout Flow

Since Job Packages need to be assigned to a user, WC checkout will force registration. Guest purchases are not allowed.

↑ Back to Top Post-checkout Actions

After checkout, the job or resume will only be approved/pending approval after payment. This includes orders with status:

  1. Processing
  2. Completed
  3. On-hold

If the order is unpaid, or isn’t one of these statuses, the job will not be approved without admin intervention.

↑ Back to Top Viewing Purchased Packages

Users can view their purchased/active job packs on their ‘My Account’ page. It will show the main highlights of each pack as well as jobs/resumes remaining.

Screen-Shot-2013-09-22-at-12.21.59

Note that this section only displays if the user has at least one job remaining from any package.

↑ Back to Top Advanced: Useful functions

The following PHP functions can be used to check what user’s have access to and more:

↑ Back to Top Advanced: Overriding Templates

The following template files are included with this plugin:

Template File Name Purpose
my-packages.php A tabular list of packages a user has bought – shown on the ‘my account’ page.
package-selection.php A list of radio buttons to select a job package, or a previously purchased package.
resume-package-selection.php A list of radio buttons to select a resume package, or a previously purchased package.

To override these templates, copy them to yourtheme/wc-paid-listings/