The keywords use the following syntax: key:value

Keywords

status – Sets the ticket status.

• status:closed – changes the status of ticket to ‘closed’

priority – Sets the ticket priority.

• priority:high – changes the priority of ticket to ‘high’

milestone – Sets the ticket milestone.

• milestone:future-release – changes the milestone of ticket to ‘future-release’

category – Sets the ticket category.

• category:design – changes the category of ticket to ‘design’

tagged – Adds tags to a ticket.

• tagged:needs-testing – adds an ‘needs-testing’ tag to ticket
• tagged:needs-testing tagged:dev-build – adds an ‘needs-testing’ and ‘dev-build’ tags to ticket

assigned – Assigns a ticket to users.

• assigned:meloniq – assigns the ticket to ‘meloniq’ user
• assigned:dave assigned:shannon – assigns the ticket to ‘dave’ and ‘shannon’ users

NOTE:

• do not put a space before or after the colon
• used values are equal to created by WordPress ‘slugs’ for term
• value ‘none’ clears the status, milestone, category or tags
• to assign a user, as value use his login

Commit messages

The above keywords can be present in commit messages from your source control tool (such as svn or git). You’ll have to add the ticket number to the commit message so Quality Control knows which ticket you want to update:

git commit -m "fixed the bug [#13 status:closed]"

You can also modify multiple tickets from a single commit:

git commit -m "fixed the bug [#13 #69 status:closed]"
git commit -m "fixed the bug [#13 tagged:needs-testing] [#69 status:closed milestone:3-3]"

Like this tutorial? Subscribe and get the latest tutorials delivered straight to your inbox or feed reader.

Upgrade Information

Use the AppThemes Updater Plugin to automatically update the theme, or visit www.appthemes.com and click on My Account to download the updated version.

Fixes

• Fixed styling of ticket paragraphs
• Fixed assigning user and taxonomies while creating ticket
• Fixed incorrect redirect after deleting ticket
• Fixed undefined index notice after deactivating repository plugin
• Fixed undefined variable notice in the sidebar call
• Fixed undefined method QC_Ticket_Status::update_ticket() error
• Fixed xml parse error for beanstalk repository
• Fixed visibility of tickets per Permissions settings
• Fixed quick editing ticket

Changes

• Improved parsing commit messages, see: Updating tickets with keywords
• Added recent tickets widget
• Added ‘assigned to’ link in project team widget
• Added filtering by ‘assigned to’ all tickets pages
• Added creating default milestones and ticket on theme installation
• Added changeset url metabox to add/edit changeset page
• Added css class to tickets with priority taxonomy, can easy highlight important tickets
• Reverted showing ticket details on archives pages

Files Modified

Modified    changelog.txt
Modified    form-login.php
Modified    form-password-recovery.php
Modified    form-password-reset.php
Modified    form-registration.php
Modified    framework
Modified    functions.php
Modified    includes/admin/admin.php
Modified    includes/admin/settings.php
Modified    includes/class-qc-taxonomy.php
Modified    includes/core.php
Modified    includes/modules/assignment.php
Modified    includes/modules/categories.php
Modified    includes/modules/changesets.php
Modified    includes/modules/milestones.php
Deleted     includes/modules/notifications.php
Modified    includes/modules/priorities.php
Modified    includes/modules/states.php
Modified    includes/modules/tags.php
Modified    includes/template-tags.php
Modified    includes/utils.php
Modified    includes/views.php
Modified    includes/widgets.php
Modified    index.php
Modified    qualitycontrol.pot
Added	    scripts/i18n/timeago/jquery.timeago.ar.js
Added	    scripts/i18n/timeago/jquery.timeago.bg.js
Added	    scripts/i18n/timeago/jquery.timeago.bs.js
Added	    scripts/i18n/timeago/jquery.timeago.ca.js
Added	    scripts/i18n/timeago/jquery.timeago.cy.js
Added	    scripts/i18n/timeago/jquery.timeago.cz.js
Added	    scripts/i18n/timeago/jquery.timeago.da.js
Added	    scripts/i18n/timeago/jquery.timeago.de.js
Added	    scripts/i18n/timeago/jquery.timeago.el.js
Added	    scripts/i18n/timeago/jquery.timeago.en-short.js
Added	    scripts/i18n/timeago/jquery.timeago.en.js
Added	    scripts/i18n/timeago/jquery.timeago.es.js
Added	    scripts/i18n/timeago/jquery.timeago.fa.js
Added	    scripts/i18n/timeago/jquery.timeago.fi.js
Added	    scripts/i18n/timeago/jquery.timeago.fr-short.js
Added	    scripts/i18n/timeago/jquery.timeago.fr.js
Added	    scripts/i18n/timeago/jquery.timeago.he.js
Added	    scripts/i18n/timeago/jquery.timeago.hr.js
Added	    scripts/i18n/timeago/jquery.timeago.hu.js
Added	    scripts/i18n/timeago/jquery.timeago.hy.js
Added	    scripts/i18n/timeago/jquery.timeago.id.js
Added	    scripts/i18n/timeago/jquery.timeago.it.js
Added	    scripts/i18n/timeago/jquery.timeago.ja.js
Added	    scripts/i18n/timeago/jquery.timeago.ko.js
Added	    scripts/i18n/timeago/jquery.timeago.lt.js
Added	    scripts/i18n/timeago/jquery.timeago.mk.js
Added	    scripts/i18n/timeago/jquery.timeago.nl.js
Added	    scripts/i18n/timeago/jquery.timeago.no.js
Added	    scripts/i18n/timeago/jquery.timeago.pl.js
Added	    scripts/i18n/timeago/jquery.timeago.pt-br.js
Added	    scripts/i18n/timeago/jquery.timeago.pt.js
Added	    scripts/i18n/timeago/jquery.timeago.ro.js
Added	    scripts/i18n/timeago/jquery.timeago.ru.js
Added	    scripts/i18n/timeago/jquery.timeago.sk.js
Added	    scripts/i18n/timeago/jquery.timeago.sl.js
Added	    scripts/i18n/timeago/jquery.timeago.sv.js
Added	    scripts/i18n/timeago/jquery.timeago.th.js
Added	    scripts/i18n/timeago/jquery.timeago.tr.js
Added	    scripts/i18n/timeago/jquery.timeago.uk.js
Added	    scripts/i18n/timeago/jquery.timeago.uz.js
Added	    scripts/i18n/timeago/jquery.timeago.zh-CN.js
Added	    scripts/i18n/timeago/jquery.timeago.zh-TW.js
Modified    scripts/jquery.timeago.js
Modified    single-ticket.php
Modified    style.css
Modified    templates/loop-ticket.php
Modified    templates/navigation.php
Modified    templates/ticket-meta.php
Modified    tests/lib
Added	    tests/test_changesets.php
Modified    tests/test_emails.php
Modified    tests/test_protected.php
Modified    tests/test_read-only.php
Modified    tests/testcase.php
Modified    wrapper.php

There are just a few things you will want to do to get Events going. We will walk you through the process here.

By default, events in vantage is disabled. To enable events in the administration panel, go to “Vantage > Settings > Events”. Here you can see an option “Enable Events”, checking this option and saving changes will enable events in Vantage.

Configuring Events

After you have enabled events you will be able to see the remaining configuration setting options.

General Settings

• Charge for Events – Allows you to charge users for posting an event to your site. Default value is unchecked. Check “Yes” to enable.
• Moderate Event – Checking “Yes” means that newly posted events will be held in moderation. The event will not be published until you approve it (see more info on approving events at the bottom of this tutorial).

Search Settings

• Default Search Result Sort – Applies default sorting order for events search results – only when search by location is not involved. The options for these settings are:
  • Event Date – Events are sorted event date.
  • Newest First – Listings are sorted by the time the event was created. The most recently created listings will appear at the top.
  • Alphabetical – Events are sorted alphabetically by event name.
  • Popular – Events are sorted by number of event comments and number of attending (see tutorial on attending widget).
• Default location based Search Result Sort – Applies default sorting order for events search results when searching by location. The options for these settings are:
  • Closest Distance First – Events are sorted by distance from the location searched.
  • Event Date – Events are sorted event date.
  • Newest First – Listings are sorted by the time the event was created. The most recently created listings will appear at the top.
  • Alphabetical – Events are sorted alphabetically by event name.
  • Popular – Events are sorted by number of event comments and number of attending (see tutorial on attending widget).

Appearance Settings

• Events Per page – Determines the number of events displayed on each list page. For example if you enter “5”, five events will be shown on home page or any page where events are listed.

Integration Settings

• Display ShareThis on Event Listing – This option is used to display social media sharing options provided by the ShareThis plugin. By default this option is disabled. To enable this option, you will need to install the ShareThis plugin.

Setting up Payments for Events

Now that we have configured all the general settings events, let’s go ahead and setup payment settings for events.

Vantage allows you to charge for users to post events to your site. Events are offered with a simpler pricing structure than listings but you still get plenty of listing options.

Enable Payments for Events
If you are going to charge for events, you want to enable this in Vantage. The default setting for this is “Off”. To enable it, go to Admin > Vantage > Settings >Events. You should see the admin panel pictured below.

Make sure “Charge for Events” is checked and click the “Save Changes” button. Vantage will now charge for Events.

Pricing Settings
Now that we have enabled charging for events, let’s see how to set up pricing for events in Vantage. Go to Admin > Payment > Settings > Events tab to access payments settings for events. Payments settings for events will not be accessible if charging for events is not enabled.
Settings for pricing are explained below.

• Price: Sets the price for adding a single event.
  
• Enable Featured on Home: Allows users to post events which will appear on the home page and marked as featured.
• Featured on Home-Price: Sets the price for an event featured on the home page.
  
• Enable Featured on Category: Allows users to post events which will appear on a category page and marked as featured.
• Featured on Category-Price: Sets the price for an event featured in category.
  
• Surcharges for Event Categories
  Surcharges allow you to charge a little more for posting events in specific categories. Surcharges are added to the regular price to post an event.For example, if an event is created in the “Automobile” category, the total cost of creating the event will be $30 ($5 for the listing price and $25 for the category surcharge).

To learn more about pricing and other pricing settings in Vantage, read our tutorial Setting Up Payments in Vantage.

Events are Now Ready to Go!

Once you have enabled events, saved events settings and set up event pricing, you’re ready to go. Your site’s visitors can now post events to your Vantage business directory website.

If you did not enable events moderation, all new events will be published to your site immediately. On the other hand, if you enabled events moderation, you will need to approve events before they are published. Let’s take a look at how that is done.

Moderating Events
Reviewing Events before they are posted is a good way to make sure that the content on your site is top-notch. See the instructions above to find out how to enable events moderation.

Approving an Event
Let’s see how to approve an Event posted by a user. Start by going to Admin > Events and a list of all the Events posted will appear.

At this point, you have a couple of options on how you can approve an event.

• Approve via Quick Edit – In the list of events, hover the mouse pointer over the title of the event you wish to approve. From the links that appear below the title, click the “Quick Edit” link. This will open editing options for that event. Change “Status” to “Published”, and click on the “Update” button. This will approve the Event and make it visible to everyone.
  
• Approve via Edit Page – In the list of events, click any event to edit it. On the Edit Event page, click the ‘Accept’ button in the moderation queue box to approve the event.
  

Like this tutorial? Subscribe and get the latest tutorials delivered straight to your inbox or feed reader.

In Vantage 1.2, we have moved map settings to a new location: Admin > Vantage > Geo Settings. This is done in anticipation of the soon-to-be-released AppMaps plugin which will allow alternatives to the Google Maps API that comes standard with Vantage. As before, the Geo Settings will control how Vantage works with map APIs to determine locations and distances.

General Settings

• Installed Geocoders: This option determines which “Geocoder” will be used for Vantage. A geocoder takes a given address and converts it to geographic coordinates. All available/installed geocoders will be listed in the “Geocoder” drop down box. Google is the default geocoder provided with the theme and the only option available without the addition of a plugin.
• Distance Unit: Allows you to select Kilometers or Miles as the desired unit of distance for your site.
• Default Standard Location Search Radius: Sets the default value for search radius when searching by location in Vantage. For example, if a user searches for a Listing/Event in Toledo, Ohio, then the search result will display listings or events within 100 miles radius on Toledo. If the “Distance Unit” was set to kilometers, then the search radius would be 100km.
• Map Provider: This setting allows you to select the Map Provider used to display maps on your Vantage site. Google Maps is the default Map Provider provided with the theme and the only option available without the addition of a plugin.

Geocoder – Google
Now that we have seen the General Settings for maps let’s go through the Google geocoder tab. Google is the default goecoderfor Vantage. You can set up language and region biasing for Google’s geocoder using the options below.

• Region Biasing: This option lets Vantageget a better idea of the locations being entered by your users. For example, if you enter the country code “US”(for the United States)for Region Biasing and a user enters ‘Florence’ in the location search, Google knows that they probably meant ‘Florence, Alabama’. And if you enter “IT” (for Italy), then Google will fetch ‘Florence, Italy’.You can find more support for country code here.To set up Region Biasing you will have to enter a two letter Country Code and click “Save Changes” button.
• Language: This option allows you to select the language used to display locations and other information on maps.To set the language, enter a two letter language codes, i.e., if you entered ‘EN’ your map will display in “English” likewise, ‘DE’ for “German”, ‘FR’ for “French” etc. You can find more supported language code from here.
• Distance Unit: Allows you to select the unit of distance to use on your site.

Map Provider – Google
Google is the default Map Provider which is embedded with Vantage. You can set up language and region biasing of “Map Provider – Google” using the below mentioned options.

• Region Biasing: This option lets Vantage get a better idea of the locations being entered by your users. For example, if you enter the country code “US” (for the United States) forRegion Biasing and a user enters ‘Florence’ in the location search, Google knows that they probably meant ‘Florence, Alabama’. And if you enter “IT” (for Italy), then Google will fetch ‘Florence, Italy’.You can find more support for country code here. To set up Region Biasing you will have to enter a two letter Country Code and click “Save Changes” button.
• Language: This option allows you to select the language used to display locations and other information on maps. To set the language, enter a two letter language codes, i.e., if you entered ‘EN’ your map will display in “English” likewise, ‘DE’ for “German”, ‘FR’ for “French” etc. You can find more supported language code from here.
• Distance Unit: Allows you to select the unit of distance to use on your site.

Using Map Widgets

Now that you have set up “Geo Settings”, we will walk you through set up and use of the location widgets. There are two location widgets available in Vantage.

Vantage – Listing/Event Location widget
The Vantage – Listing/Event Location widget displays a map containing the location of a single listing or event. This widget is used in the Single Listing Sidebar or the Single Event Sidebar.To use it, go to Admin > Appearance > Widgets. In the Available Widgets area, drag the Vantage – Listing/Event Location widget and drop it in the Single Listing Sidebar or the Single Event Sidebar.

Let’s review the options for this widget:

• Title: If you want to display a specific title in the sidebar for the map widget, then you can do this by entering the desired text in the Title field and clicking “Save”. This will display the title above the map in the sidebar. If it is left blank then the map will be displayed without a title.
• Map Zoom: This option is used to define the default zoom in level for the location on map, if left blank it will use the default zoom in settings. You can enter numeric values from 0 to 100, these values will be considered as percentage (you do not need to type the % symbol, only a number).
• Show Driving Directions: This option is used to enable the driving directions option. Enabling driving directions adds another text field below map. If a user wants to get directions, they simply enter their location in the additional text field and click the “Get Directions” button. Detailed directions will be displayed with an option to print the directions.

Vantage – Listings/Events Locations widget
The Vantage – Listings/Events Locations widget displays a large map at the top of all the pages where a list of listings or events is displayed – like the home page, search results or similar. All items on a given list page will appear on this large map – events and listings, all on one map.

To activate the large map go to, Admin > Appearance > Widgets. Look for the Vantage – Listings/Events Locations widget in the Available Widgets area and drag the widget to the List Page Top Sidebar as shown in the image below.

The Vantage – Listings/Events Locations widget is very simple and has only one option.

• Title: If you want to display a specific title in the frontend for the map then, you can do this by entering desired text in “Title” field and clicking “Save”. This will display the title above the map. Entering Title is optional. If it is left blank then the map will be displayed without a title.

The image below shows how the map is displayed on the Home Page. In the map, locations for listings are marked with a blue pin, and events are marked with a red pin.

Like this tutorial? Subscribe and get the latest tutorials delivered straight to your inbox or feed reader.

Setting up the Event Attendees Widget

First, you will need to have events enabled. Go to Admin > Vantage > Settings > Events tab to enable events. For more info on setting up events see the Enabling Events in Vantage tutorial.

To setup the Event Attendees Widget, go to Admin > Appearance > Widgets. This will display all the available widgets and the sidebars used by Vantage. In the “Available Widgets” area find the “Vantage – Event Attendees” widget and drag it to the “Single Event Sidebar” as shown in the image below.

As you can see in the image above, you can enter a title and it will be displayed above the widget in the sidebar.

Using the Event Attendees Widget

Now that you have setup the widget from back end, let’s see how it works in the front end. The image below shows how the widget will display in the sidebar of a single event page.

Attending an Event

If you want to attend an event, find the event attendees widget in the sidebar and click the “Yes, I want to attend!” link. Once clicked, your username will be added to the list of people attending and “Yes, I’m attending!” will appear at the top of the widget. Additionally, the link will change to “Change my reservation” as shown in the image below. If you do not wish to attend this event you can simply click on “Change my reservation” link and it will remove your name from the list of people who will be attending this event.

Note: If you haven’t logged in yet and you click on this link, it will prompt you to login in first.

See Who’s Attending

Along with RSVP’ing for an event Event Attendees widget also allows you to see who all user who are attending the event. Just click on the “See Who’s Attending” link and a lightbox window will display links of all the people who are attending the event.

Like this tutorial? Subscribe and get the latest tutorials delivered straight to your inbox or feed reader.

Create Your First Pricing Plan

In order to accept payments for job listings, you must create a pricing plan in JobRoller and assign the plan to job categories. We’ll do that now. But before we do, it’s helpful to see how the pricing plans will look to your customers. You can see that in the screenshot below.

For this tutorial, we’ll create ‘Single’ price plans. If you need to create a ‘Pack’ plan please read our tutorial on creating Pack plans.

Let’s create the pricing plans in the screenshot above. We’ll start with the “Basic” plan. In the WordPress admin, navigate to Payments > Plans. On the “Job Plans” page, click the “Add New” button at the top of the page. You should see the page below.

Plan Name
This will be the name of your pricing plan. You can use names that will help you keep track of your plans but you should remember that your customers will also see the pricing plan name when they buy a job listing. You want keep that in mind. To match our example, we’ll add “Basic” here.

Description
This section allows you the opportunity to give a little more details to your customers about the pricing plan. You can also use the description to “sell” the plan. For this section, we’ll add “A no frills plan for submitting jobs.”

Price
Simple enough, this is the price that your customer will pay with this plan. Let’s charge $5 for our “Basic” price plan.

Relist Price
This field will only be available if you have relisting enabled on your site. It’s the price that your customer will pay with this plan when relisting a job. We’ll charge the same $5 for relisting with our “Basic” price plan. You can set it to 0 to offer relistings.

Job Duration
This setting determines how long a job is displayed before it expires. Duration is always denoted in days. If you want job listings to last a month, add 30 or 31 days. For a year, enter 365 days. If you do not want listings to expire, put zero. When it comes to listing duration, zero equals infinity. For our example, let’s use 15 days.

It’s important to remember that job listing duration and addons durations are not the same. We’ll get into that a little more in a few moments.

Usage Limit
This setting determines the number of times the plan is selectable by the same user. Setting a value greater then 0 will limit the times the plan can be selected. After a user reaches the limit, the plan will be hidden from selection. For the “Basic” plan we’ll set it to 0, so the plan can be selected unlimited times.

Important Note: Usage limits can be reset by an admin on each user profile under ‘Reset Usage’. After resetting the usage limit, the plan will be available for selection again.

Featured Add-ons

This section gives you the opportunity to include featured status as a part of the pricing plan. Let’s look at the options a little more closely.

In the “Featured Add-ons” panel, you will see check boxes marked “Included” next to “Feature on Category” and “Feature on Homepage and Listings”. Checking a box means the featured option will be included as a part of this pricing plan. Leaving it unchecked means that featured is not included in the pricing plan and must be purchased separately.

If you decide to include featured with the pricing plan, you need to set duration for featured status. This determines how long the job listing will remain featured as a part of this pricing plan. The duration is denoted in days. The duration can be any amount but must be the same or shorter than the job listing duration.

There is a lot more to featured and we’ll take a closer look later in this tutorial. For our “Basic” pricing plan, we will not enable featured.

Resumes Add-ons

This section gives you the opportunity to give temporary access to resumes as a part of the pricing plan. Let’s look at the options a little more closely.

In the “Resumes Add-ons” panel, you will see check boxes marked “Included” next to “Browse Resumes” and “View Resumes”. Checking a box means the resumes temporary access (view or/and browse) will be included as a part of this pricing plan. Leaving it unchecked means that resumes temporary access (view or/and browse) is not included in the pricing plan and must be purchased separately.

If you decide to include resumes access with the pricing plan, you need to set their duration. This determines for how long the user can view or/and browse resumes as a part of this pricing plan. The duration is denoted in days. The duration can be any amount but must be the same or shorter than the job listing duration.

For our “Basic” pricing plan, we will not enable resumes addons.

Important notes:

Job Categories

JobRoller allows you to assign pricing plans to job categories. You can assign multiple plans to one category, you can assign one plan to many categories or you can do anything in between. It’s very important to note, if a category does not have an associated pricing plan, users will be unable to purchase job listings in that category, unless categories are not required. That means, whenever you create a new category, you need to make sure you assign a pricing plan to the category.

To link categories to a pricing plan, simply check the categories you want in “Job Categories” in the sidebar.

For our example, we will choose all the available categories. Now we’re certain to have at least one pricing plan for everything on our site.

Once you have set your options and chosen the categories associated with the pricing plan, you can click the “Publish” button. Users can now purchase listings on your site using the “Basic” payment plan.

Important note: If you don’t have job categories set as required and the job is not assigned a category, the categories-plan relation will be ignored and all the plans will be available for selection independently of their category.

Order

The order, determines the position where the plan should be displayed. A plan with a lower value will display first. Let’s set our “Basic” plan to 2, to appear right after the “Gold” plan.

Closer Look at Featured

With options in two different places, featured job listings can get a little confusing. Using the examples in the screenshot at the top of this post, let’s look at featured listings in detail.

Featured not Included in Pricing Plan
In our “Basic” pricing plan that was created above, we opted to not include featured as part of the pricing plan. Here’s what that means to your customers when they buy a job listing.

If you do not have the featured addons listings enabled in the payment settings, then your customer will not get featured as part of the pricing plan and they will not have the option to pay for featured separately.

In the same example, let’s say you do have featured addons enabled in the payment settings. Featured addons would not be included in the “Basic” pricing but it could be purchased separately. In the screenshot below, you see that customers will be able to add featured at an extra cost.

Important note: The featured in category addon will only be available for selection or included in the plan if a job category was assigned to the job.

Addons Included in Pricing Plan
Now we’ll create another example pricing plan. We will create the “Gold” pricing plan shown in our original example screenshot. Here’s how it looks on the “Add New Plan” page.

This is going to be an expensive plan and we want give people incentive to choose this plan, so we’ll include featured and resumes addons, for 50$, and the job listing will be active for 30 days.

Promotional Plans

Promotional plans are a great way to engage your customers on your site and JobRoller helps you achieve it by giving you the option to create limited usage plans. These plans are limited in use and will be automatically hidden when the user reaches the selection limit. We’ll create a Free plan trial plan to exemplify a promotional plan by setting the price to 0 and the usage limit to 1. Customers will be able to purchase the plan for Free but only once. Here’s how it looks on the “Add New Plan” page.

Here’s the screenshot with all the plans again.

Relisting Jobs

If your site is configured to enable relisting jobs, you can set a different price for the relisted job. Here’s how our plans price would display with the relist price set on our example plans.

Conclusion

Now that you learned how to set up payments in the first part of this tutorial and you have created some pricing plans after reading this part of the tutorial, you should be ready to offer the best pricing model for your site.

Like this tutorial? Subscribe and get the latest tutorials delivered straight to your inbox or feed reader.

Once finished, your site will be ready to take payments from customers that want to list jobs on your JobRoller site.

Getting started

To begin, you will need JobRoller – version 1.7 or newer – and WordPress installed on a hosting server. You will also want to read the “Getting Started with JobRoller” doc to get ready.

In order to accept payments on your site, you will need to sign up with a payment gateway service. You will also need payment gateway software to complete transactions (PayPal is included with JobRoller).

JobRoller comes with PayPal and Bank Transfer as the default payment gateways. It’s free to sign up with PayPal and it is accepted in many countries around the world. If possible, we recommend starting with PayPal. You can sign up for an account at the PayPal website.

If you prefer not to work with PayPal or cannot get a PayPal account, other gateways are available in the AppThemes Marketplace. You can research and decide which is the best option for you.

Once you have JobRoller added to WordPress and an account with a payment gateway, you’re ready to proceed.

Charge for Job Listings

If you are going to charge for jobs, you want to enable the related option in JobRoller. The default setting for this is “No”, you should go to the settings page to enable it.

In your WordPress admin, go to JobRoller > Settings > Jobs. You should see the admin panel pictured below.

“Moderate Job Listings” and “Edited Job Requires Approval” are options worth mentioning here. If you want to review all new jobs before they are shown to the public, you will want to make sure these options are checked. Leaving the options unchecked means that all new/edited jobs will become public immediately after they are created/edited. The choice is up to you.

Important note: Paid jobs ignore the moderation options and will always be immediately published.

Payments Settings

JobRoller needs to know a few things about how you will charge for jobs on your site. To set up these options, go to Payments > Settings > General tab. You should see something similar to the screenshot below.

Important note: when you make any changes on this tab, you should press the “Save Changes” button before you navigate to another tab or page.

Regional

JobRoller allows you to choose the currency used to collect payments on your site. At present, you can only have one currency at a time. Click the drop down next to “Currency Selection” to select your preference.

Since PayPal is bundled with JobRoller, the default currencies are the currencies supported by that payment gateway. If you have added other payment gateways, you should see the currency options for the currencies supported by each gateway.

Below the currency selection you will find more options like:

• Identifier – allows you to choose between currency symbol and code
• Position – determine where the identifier should be displayed
• Thousands Separator – change to meet your regional price formatting
• Decimal Sepatator – change to meet your regional price formatting
• Tax Charge – allows you to add regional taxes to the final price

Plan Types

JobRoller supports two plan types. Both plan types offer slightly different options when you’re setting you job plans. You can read more on setting up both types of pricing plans by following the related tutorial link, below.

• Single – Single plans are applied to every single job submitted on your site. Job listers will need to pay a pre-set price for each job they post. Read our tutorial on setting up Single pricing plans in JobRoller
• Pack – Pack plans can bundle a pre-set number of jobs. When customers purchase Packs they will be able to submit the number of jobs contained in the pack until the pack expires or after reaching the total jobs limit. Read our tutorial on setting up Pack plans in JobRoller

If you choose ‘Pack’, as your plan type, after saving the changes, you’ll see two additional options:

• Buy Separate Job Packs – Enables customers to purchase packs directly from their dashboard in addition to when submitting a job. It also allows site owners to enable the ‘Buy’ button on the Packs widget
• Display Categories – Enabling this option will display the job categories on each pack

Add-ons

This section primarily deals with settings for featured job listings and resumes access. You will have additional options for these addons in pricing plans, but these are the base options. Here, you can set the price and duration for Featured Addons (home page/listings and category) and Resumes Addons (browse/view resumes) *.

Featured Addons are applied to jobs, while Resumes Addons are applied to users.

For Featured Addons, duration determines the length of time that a job is a featured job. Duration is calculated in days. Enter the number of days you want the featured status on a listing to last. If you do not want featured status to expire, enter zero.

For Resumes Addons, duration determines the number of days that resumes remain accessible to a user. Duration is calculated in days. Enter the number of days allowed for users to browse/view resumes. If you do not want resumes access to expire, enter zero.

Price is the amount you want to charge for an addon. JobRoller only allows whole number values. For example, 12 is allowed but 12.99 or 12,99 are not allowed.

* Important note: Resumes Addons are only available if your site requires an active subscription to browse/view resumes (JobRoller > Settings > Resumes ).

When you have made all your preferred changes in the General tab of the payments settings section, clicking the “Save Changes” button implement your new settings.

Installed Gateways

This is where your installation of JobRoller may differ from the screenshot above. JobRoller will list, in this section, all of the installed payment gateways. If you have added more gateways, you will see them listed with “PayPal” and “Bank Transfer”.

To enable a payment gateway, simply check the “Enable” box to the right of that gateway. If you choose multiple payment gateways, JobRoller will allow your customers a single choice from the gateways you have enabled. With more than one enabled, you give your customers the ability to determine the gateway that works best for them.

Additional Payment Gateway Settings
You will notice in the payments settings section of the WordPress admin that there is a tab for each installed gateway. You can click each tab to see the settings for that gateway. Each payment gateway will have it’s own settings and options. You can follow the directions listed on the page or find instruction or tutorials elsewhere on our site.

Since PayPal is the default gateway for JobRoller, we’ll take a look at those options and how to set them up. As mentioned before, you will need a PayPal account in order to use it as your payment gateway. You can create an account at the PayPal website.

PayPal Email – Add the email address used with your PayPal account here. Make sure it is entered correctly. If it is not exact, PayPal will not process your payments.

Business/Premier Account – Check this option if you have a premier/business account. This type of accounts allow customers to automatically process recurring payments via PayPal.

Important note: Recurring payments are only available for resumes subscriptions.

PayPal Sandbox – The sandbox feature allows you to test payments with your PayPal account. You can read all about PayPal sandbox here.

Enable PDT – PDT provides an extra layer of security to payment transactions on your site. AppThemes highly recommends that PDT is enabled for your site. To find out how to add PDT to your site, read our tutorial Enable PayPal PDT (Payment Data Transfer).

Enable IPN – IPN works by sending messages directly between PayPal and your site in the background. Using this channel of communication, your site can automatically update when orders complete. To find out how to enable IPN on your site, read our tutorial Enable PayPal IPN (Instant Payment Notifications).

Once you have added your payment gateway details, make sure to click the “Save Changes” button before moving on.

Part 2: Creating Pricing Plans

Now that you have edited the job listings and payments settings on your site, you’re ready to create pricing plans. Part two of this tutorial will show you how to create pricing plans for JobRoller.

Like this tutorial? Subscribe and get the latest tutorials delivered straight to your inbox or feed reader.

What’s New?

The new AppThemes Payments API and Custom Forms are the biggest additions for this release. The Payments API is a full featured framework that can be extended with new gateways and options like, coupons. It also consolidates all the pricing data and options on it’s own admin menu and adds a new payment option: bank transfer.

Custom Forms, allow site owners to create any number of custom fields (input, option, checkbox, etc) for each job category, to be displayed for employers on the job submit form. Any values inserted will then be available on the single job page, including file downloads.

Please read the changelog for the full feature list.

Notes:
Automatic recurring payments for resumes subscriptions are only available for PayPal Business accounts (PayPal IPN must be enabled). If you don’t have a business account, subscriptions will default to manual one-off payments, and can be purchased with any gateway.

Update Your Plugins

Users with AppThemes job feeds plugins (‘LinkedIn Publisher’, ‘Simply-Hired Publisher’, ‘Careerjet Publisher’) and ‘AppThemes Coupons’ should update to the latest version to guarantee full compatibility with JobRoller 1.7. The same applies to other plugins you may have purchased from the marketplace. If you find any problem with a (previously working) plugin on the latest JobRoller version, look for an updated version on the marketplace or contact the plugin author.

Upgrade Information

Now you can automatically upgrade directly from your WordPress admin. Under “Appearance” => “Themes”, you’ll see an upgrade link next to JobRoller. If you don’t, check back later. The AppThemes upgrade check API runs twice a day. It’s important to note that using this auto updater will overwrite any custom coding done to the theme. Customers who have made theme code changes will need to manually upgrade instead.

If you prefer the old fashion way or have made core theme modifications (which is not recommended), visit AppThemes to download the full version.

Fixes

• Some custom tables being concatenated with $wpdb->prefix instead of using $wpdb->table_name
• No email notifications sent to buyer after purchasing a resume subscription
• Banner alignment when using the default theme
• No background color on field labels and form steps
• Missing translations on the backend
• Duplicate key name database warnings
• Browse/view resumes visibility better integrated with the backend role visibility options
• Searches by keyword+location defaulting to OR instead of AND
• Re-listed job does not follow the expiry period on ‘Default Expiration Days’

Changes

• BACKEND
  • Added AppThemes custom forms to the job submit form:
    • Custom forms are created on the backend and assigned to single or multiple job categories
    • Custom form fields are displayed when job listers select the related job category
    • Custom fields values are displayed on the job page
  • Replaced old pricing structure, including job packs and resumes pricing with AppThemes payments framework. This means unlimited pricing plans for single pricing, job packs or resumes subscriptions. All orders and plans are now managed on a new payments menu
    • Payments framework features
      • Adds Bank Transfer as a new payment option, besides PayPal
      • Compatible with any AppThemes gateway available on the marketplace (2Checkout, Authorize.NET, Google Wallet, Stripe, etc)
      • Compatible with AppThemes Coupons, available on the marketplace
      • Allow tax charge
      • Multiple currencies
      • Detailed Orders listing filterable by status
      • Create infinite Job Plans with usage limit for one or multiple job categories
      • Create infinite Resumes Plans (subscriptions) with usage limit and trial option
      • Included pricing addons. These are purchase options that can be included Free on Job plans:
        • Feature Addon (feature jobs on homepage and listings, feature job in category). Can be limited to duration or usage
        • Resumes Addon (browse resumes, view resumes). Can be limited to duration or usage
    • Separate pricing addons. These are additional optional purchase options that can have a price and duration. Available addons:
      • Feature Addon (feature jobs on homepage and listings, feature job in category)
      • Resumes Addon (browse resumes, view resumes)
    • Select plan type: Single, Pack
    • Additional editable duration on the backend job page: job duration, and featured addons duration
    • Adds an intermediate step on the job submit form for the job Plan selection ‘Select Plan’
  • JobRoller dashboard now uses AppThemes framework and displays more information
  • Added two additional panels to Resumes backend with Education/Experience (uses TinyMCE) and custom fields: salary, email, telephone, mobile
  • Added Google mini map location sidebar to the Resumes backend (similar to backend job page)
  • Better backend options organization and grouping
  • Uses meta data to assign featured jobs instead of ‘Featured’ category (note: you should delete the ‘Featured’ category after upgrading)
  • Removed obsolete menu pages (moved to the new payments menu): Pricing, Job Packs and Orders
  • Removed obsolete Tabs (managed internally): Pages
  • New template page ‘Terms & Conditions’ automatically added to WordPress Pages
  • Additional security options to display reCaptcha on contact forms (including the resumes contact form) and ‘Apply Online’ form
  • New backend options
  • JobRoller > Settings > Jobs (Job Options) > Charge for Job Listings
  • JobRoller > Settings > Jobs (Job Listings) > Regular Jobs per Page (replaces the default WordPress ‘Blog pages show at most’ under Settings > Reading)
  • JobRoller > Settings > Jobs (Job Listings) > Featured Jobs per Page
  • JobRoller > Settings > Jobs (Job Listings) > Featured Jobs Sort Method
  • JobRoller > Settings > Resumes (Job Seeker Options) > Enable Recruiters Registration
  • JobRoller > Settings > Security (ReCaptcha) > Enable on Registration Form
  • JobRoller > Settings > Security (ReCaptcha) > Enable on Contact Forms
  • JobRoller > Settings > Security (ReCaptcha) > Enable on Apply Online Form
  • Replaced old ‘Start/End Subscription’, ‘Start/End Trial’ with single ‘Manage Subscriptions’ on the backend Subscriptions list, that links to the user profile
  • New actions available for admins on each user profile: Reset Usage (resets plan usage to 0 for plans with usage limit so customers can select the plan again until the usage is reached again)
  • Jobs submitted on the backend are now included on the job alerts
  • Added ‘Expired’ status to expired jobs. Replaces the old ‘private’ status. Jobs can be filtered on the backend by the new ‘Expired’ status
  • Additional ‘Expire Date’ column on the backend job listings.
  • Additional columns on the Resumes backend listings: ‘Job Types’, ‘Job Categories’, ‘Job Specialties’, ‘Spoken Languages’ and ‘Location’
  • Use single sprite for JobRoller and Jobs menu icon. Job menu icon was replaced with opened briefcase
  • Updated CSS classes to native WP classes on backend buttons
• FRONTEND
  • New selectable user Role: Recruiter. By default, Recruiters can submit jobs and browse/view resumes (if resumes subscriptions are disabled), while Employers (job listers) can only submit jobs
  • New orders Tab on the users dashboard with information on every user order. Filterable by order status
  • Page auto scroll down on errors when applying to jobs
  • Members are now redirected to their dashboard instead of the home page, after logging in
  • Added pagination to each Tab on the users dashboard
  • Allow changing password on user profile when password is disabled on registration
  • Job recommendations do not require a keyword anymore. Job Seekers can set their job preferences and get dashboard recommendations by filling only the job type
  • Better CSS styling for the ‘Buy Packs’ widget
• GENERIC
  • Ping notifications on published jobs (backend/frontend). Update services (WordPress > Settings > Writing) are not exclusive to posts anymore
  • Updated Google geocoding API to v.3
  • Updated Google CDN jQuery version to 1.8.3
  • Unified email subject on all automatic email notifications to ‘[Site Name] Subject’ (i.e: [My JobRoller Site] New Job Submitted )
  • Secured values from $_GET with WP esc_attr() for additional security
  • Use WP function wp_remote_get() instead of file_get_contents() for remote URL’s
  • Removed ‘jobroller-no-admin.pot’ file (recommended plugin: http://wordpress.org/extend/plugins/wp-native-dashboard/)
  • Renamed ‘admin-style.css’ to ‘admin.css’
  • Added GNU license to ‘styles.css’ header

Files Modified

Added			images/admin-menu.png
Added			images/file-excel.png
Added			images/file-image.png
Added			images/file-other.png
Added			images/file-pdf.png
Added			images/file-word.png
Added			images/recurring.png
Added			includes/admin/admin-dashboard.php
Added			includes/admin/admin-payments-pricing.php
Added			includes/admin/admin-payments-settings.php
Added			includes/admin/admin.css
Added			includes/admin/theme-upgrade.php
Added			includes/custom-forms
Added			includes/custom-forms.php
Added			includes/dashboard-orders.php
Added			includes/dashboard-packs.php
Added			includes/dashboard-resumes.php
Added			includes/forms/confirm-job/confirm-job-form-preview.php
Added			includes/forms/order/order-checkout.php
Added			includes/forms/order/order-gateway.php
Added			includes/forms/order/order-summary.php
Added			includes/forms/select-plan/select-plan-packs-form.php
Added			includes/forms/select-plan/select-plan-single-form.php
Added			includes/forms/select-plan/select-plan.php
Added			includes/forms/subscribe-resumes/subscribe-resumes-form.php
Added			includes/job-form-custom-fields.php
Added			includes/job-form.php
Added			includes/job-status.php
Added			includes/js/job-form-scripts.js
Added			includes/js/jquery.validate.min.js
Added			includes/payments
Added			includes/plan-activate.php
Added			includes/plan-purchase.php
Added			includes/single-pack.php
Added			includes/template-tags.php
Added			includes/theme-featured.php
Added			includes/theme-options.php
Added			includes/theme-packs.php
Added			includes/theme-payments.php
Added			includes/uploads.php
Added			includes/views.php
Added			order-checkout.php
Added			order-gateway.php
Added			order-summary.php
Added			styles/jqueryui/images/ui-bg_flat_0_aaaaaa_40x100.png
Added			styles/jqueryui/images/ui-bg_flat_75_ffffff_40x100.png
Added			styles/jqueryui/images/ui-bg_glass_55_fbf9ee_1x400.png
Added			styles/jqueryui/images/ui-bg_glass_65_ffffff_1x400.png
Added			styles/jqueryui/images/ui-bg_glass_75_dadada_1x400.png
Added			styles/jqueryui/images/ui-bg_glass_75_e6e6e6_1x400.png
Added			styles/jqueryui/images/ui-bg_glass_95_fef1ec_1x400.png
Added			styles/jqueryui/images/ui-bg_highlight-soft_75_cccccc_1x100.png
Added			styles/jqueryui/images/ui-icons_222222_256x240.png
Added			styles/jqueryui/images/ui-icons_2e83ff_256x240.png
Added			styles/jqueryui/images/ui-icons_454545_256x240.png
Added			styles/jqueryui/images/ui-icons_888888_256x240.png
Added			styles/jqueryui/images/ui-icons_cd0a0a_256x240.png
Added			styles/jqueryui/jquery-ui.css
Added			tpl-purchase-pack.php
Added			tpl-purchase-resume-subscription.php
Added			tpl-terms-conditions.php
Deleted			images/paypal-lg.png
Deleted			images/paypal_verified.gif
Deleted			includes/admin/admin-jobpacks.php
Deleted			includes/admin/admin-orders.php
Deleted			includes/admin/admin-style.css
Deleted			includes/classes/orders.class.php
Deleted			includes/classes/packs.class.php
Deleted			includes/forms/confirm-job/confirm-job-process.php
Deleted			includes/forms/edit-job/edit-job-form.php
Deleted			includes/forms/edit-job/edit-job-process.php
Deleted			includes/forms/edit-job/relist-job-process.php
Deleted			includes/forms/lister-packs/lister-packs-process.php
Deleted			includes/forms/submit-job/submit-job-process.php
Deleted			includes/forms/subscribe-resumes/subcribe-resumes-form.php
Deleted			includes/gateways/admin-gateway-values.php
Deleted			includes/gateways/index.php
Deleted			includes/gateways/paypal.php
Deleted			jobroller-no-admin.pot
Deleted			tpl-add-new-confirm.php
Modified		404.php
Modified		archive-job_listing.php
Modified		archive-resume.php
Modified		changed_files.txt
Modified		changelog.txt
Modified		framework
Modified		functions.php
Modified		header-resume-search.php
Modified		header-search.php
Modified		header.php
Modified		includes/admin/admin-alerts-subscribers.php
Modified		includes/admin/admin-enqueue.php
Modified		includes/admin/admin-options.php
Modified		includes/admin/admin-post-types.php
Modified		includes/admin/admin-scripts.js
Modified		includes/admin/admin-subscriptions.php
Modified		includes/admin/admin-values.php
Modified		includes/admin/install-script.php
Modified		includes/admin/write-panel.php
Modified		includes/appthemes-functions.php
Modified		includes/featured-jobs.php
Modified		includes/forms/application/application-form.php
Modified		includes/forms/application/application-process.php
Modified		includes/forms/confirm-job/confirm-job-form.php
Modified		includes/forms/filter/filter-process.php
Modified		includes/forms/lister-packs/lister-packs-form.php
Modified		includes/forms/login/login-form.php
Modified		includes/forms/preview-job/preview-job-form.php
Modified		includes/forms/register/register-form.php
Modified		includes/forms/register/register-process.php
Modified		includes/forms/resume/contact_parts.php
Modified		includes/forms/seeker-prefs/seeker-prefs-form.php
Modified		includes/forms/submit-job/submit-job-form.php
Modified		includes/forms/submit-resume/submit-resume-form.php
Modified		includes/forms/submit-resume/submit-resume-process.php
Modified		includes/indeed/theme-indeed.php
Modified		includes/sidebar-nav.php
Modified		includes/sidebar-sjob.php
Modified		includes/sidebar-sresume.php
Modified		includes/sidebar-user.php
Modified		includes/theme-actions.php
Modified		includes/theme-alerts.php
Modified		includes/theme-cron.php
Modified		includes/theme-emails.php
Modified		includes/theme-enqueue.php
Modified		includes/theme-functions.php
Modified		includes/theme-geolocation.php
Modified		includes/theme-header.php
Modified		includes/theme-hooks.php
Modified		includes/theme-log.php
Modified		includes/theme-resumes.php
Modified		includes/theme-stats.php
Modified		includes/theme-support.php
Modified		includes/theme-users.php
Modified		includes/theme-widgets.php
Modified		index.php
Modified		jobroller.pot
Modified		loop-job.php
Modified		loop-resume.php
Modified		search-resume.php
Modified		search.php
Modified		single-job_listing.php
Modified		single-resume.php
Modified		style.css
Modified		styles/style-basic.css
Modified		styles/style-default.css
Modified		styles/style-pro-blue.css
Modified		styles/style-pro-gray.css
Modified		styles/style-pro-green.css
Modified		styles/style-pro-orange.css
Modified		styles/style-pro-red.css
Modified		taxonomy-job.php
Modified		tpl-contact.php
Modified		tpl-edit-job.php
Modified		tpl-edit-resume.php
Modified		tpl-job-seeker-dashboard.php
Modified		tpl-jobs-by-date.php
Modified		tpl-login.php
Modified		tpl-myjobs.php
Modified		tpl-profile.php
Modified		tpl-submit.php
Modified		wrapper.php

Upgrade Information

Use the AppThemes Updater Plugin to automatically update the theme, or visit www.appthemes.com and click on My Account to download the updated version.

Fixes

• Fixed incompatibility with WP Reading settings
• Fixed error in cp_breadcrumb() when theme used with Wisija plugin
• Fixed notices in blog post widget
• Corrected misleading information under ‘Allow ad relisting’ option
• Fixed search issue when WP is installed in its own directory
• Fixed pre-pending values with a slash in ‘Edit ad’ form
• Fixed modifying widget queries while searching site
• Fixed ‘Approved ad’ notification was sent for blog posts
• Fixed min/max price in refine results widget, was including prices of not published ads
• Fixed ajax calls when FORCE_SSL_ADMIN is set
• Fixed issue where user had possibility to exceed images limit
• Fixed missing styles for current menu item
• Fixed issue where browser didn’t display last position if back button clicked
• Fixed issue with conditional tags in footer section
• Added additional server side validation for contact form
• Fixed price display for child categories when ‘allow parent category posting’ option was set to ‘no’
• Fixed issue with border under long categories names in directory style
• Fixed issue with text alignment and long categories names in dropdown menu
• Fixed ‘allow html’ option which was not disabling auto-embeds on WordPress 3.5
• Fixed many issues with timezones
• Fixed display date format in many places
• Fixed issue where disabling password on registration page was disabling it on edit profile page
• Fixed issue where ad categories widget could be used just once
• Fixed issue where creating custom fields and forms with non-latin names could cause generating invalid internal names

Changes

• Implemented new Payments module, payment gateways from Marketplace are now compatible
• Removed ‘Coupons module’, use AppThemes Coupons plugin instead
• Coupons from old module are converted to AppThemes Coupons plugin format while updating theme
• Transactions from old module are converted to new format while updating theme
• Implemented new settings pages, settings are converted to new format while updating theme
• Changed template files names for home page (to tpl-ads-home.php) and blog page (to index.php)
• Added ‘Sold ads’ widget
• Added ‘Featured ads’ widget
• Added responsive styling to front end pages
• Navigation menu becomes native select menu at smaller screen sizes (responsive)
• Switch to browser uploader works now without reloading page
• Removed ‘Save Changes’ button from the top of settings page
• Changed Turkish currency code from ‘YTL’ to ‘TRY’
• Removed changing to pretty permalinks on theme installation
• Improved validation of ‘dashboard’ and ‘edit ad’ pages
• Details of purchase with coupon is now available on Orders page
• Moved many inline javascripts to theme-scripts.js file
• Updated external jquery, colorbox, and validation js libraries
• Removed ‘paypal email’ field from profile page
• Added links to sample csv files on importer page
• Added items number control to top ads, categories, and tags widgets
• Removed inline sexybookmarks/shareaholic code from theme, plugin has an option to choose place
• Updated google maps api library url
• Ad price formatting is handled now by new payments module
• Removed classipress-no-admin.pot translation file
• Selectbox js library is now optional
• Changed expire date format to ‘Y-m-d H:i:s’
• Cron emails changed to html format
• Sidebar container is now floated to the right side
• Added disabling ‘submit’ button if uploading images is still in progress
• Removed superfish js library
• Including many template files with get_template_part(), possibility to override by child theme
• Located many template images, possibility to override by child theme
• Added reset statistics link on single ad page and admin option to reset all statistics
• Added action and filter hooks into cp_get_ad_details() function
• Added feature to display current website time in footer section
• Added facebook page icon option in the top bar
• Added compatibility with WPML plugin, need to install free AppThemes WPML Bridge plugin
• Added feature to ping ‘update services’ while publish ad listing

Files Modified

Modified    archive-ad_listing.php
Modified    author.php
Modified    changelog.txt
Deleted    classipress-no-admin.pot
Modified    classipress.pot
Modified    examples/ads-with-attachments.csv
Modified    examples/ads.csv
Modified    examples/classipress-child/functions.php
Added    examples/classipress-child/includes/child-views.php
Deleted    examples/classipress-child/index.php
Added    examples/classipress-child/tpl-featured-ads-home.php
Modified    featured.php
Modified    footer.php
Modified    framework
Modified    functions.php
Modified    header.php
Added    images/chart-bar-cross.png
Added    images/checkmark.png
Added    images/cp_logo_black_small.png
Added    images/cp_logo_white_small.png
Added    images/icon_facebook.gif
Added    images/minus.png
Added    images/plus.png
Modified    includes/admin/admin-addons.php
Added    includes/admin/admin-dashboard.php
Modified    includes/admin/admin-enqueue.php
Modified    includes/admin/admin-notices.php
Modified    includes/admin/admin-options.php
Modified    includes/admin/admin-post-types.php
Modified    includes/admin/admin-scripts.js
Added    includes/admin/admin-settings.php
Modified    includes/admin/admin-style.css
Modified    includes/admin/admin-updates.php
Modified    includes/admin/admin-values.php
Modified    includes/admin/install-script.php
Modified    includes/admin/write-panel.php
Modified    includes/appthemes-functions.php
Modified    includes/forms/step-functions.php
Modified    includes/forms/step1-membership.php
Modified    includes/forms/step1.php
Modified    includes/forms/step2-membership.php
Modified    includes/forms/step2.php
Modified    includes/forms/step3-membership.php
Modified    includes/forms/step3.php
Deleted    includes/gateways/admin-gateway-values.php
Deleted    includes/gateways/banktransfer/banktransfer.php
Deleted    includes/gateways/banktransfer/index.php
Deleted    includes/gateways/gateway.php
Deleted    includes/gateways/index.php
Deleted    includes/gateways/paypal/index.php
Deleted    includes/gateways/paypal/ipn.php
Deleted    includes/gateways/paypal/paypal.php
Deleted    includes/gateways/process.php
Modified    includes/js/colorbox/colorbox.css
Added    includes/js/colorbox/i18n/jquery.colorbox-cs.js
Added    includes/js/colorbox/i18n/jquery.colorbox-da.js
Added    includes/js/colorbox/i18n/jquery.colorbox-de.js
Added    includes/js/colorbox/i18n/jquery.colorbox-es.js
Added    includes/js/colorbox/i18n/jquery.colorbox-fr.js
Added    includes/js/colorbox/i18n/jquery.colorbox-it.js
Added    includes/js/colorbox/i18n/jquery.colorbox-kr.js
Added    includes/js/colorbox/i18n/jquery.colorbox-nl.js
Added    includes/js/colorbox/i18n/jquery.colorbox-pl.js
Added    includes/js/colorbox/i18n/jquery.colorbox-pt-br.js
Added    includes/js/colorbox/i18n/jquery.colorbox-ru.js
Modified    includes/js/colorbox/images/controls.png
Added    includes/js/colorbox/images/ie6/borderBottomCenter.png
Added    includes/js/colorbox/images/ie6/borderBottomLeft.png
Added    includes/js/colorbox/images/ie6/borderBottomRight.png
Added    includes/js/colorbox/images/ie6/borderMiddleLeft.png
Added    includes/js/colorbox/images/ie6/borderMiddleRight.png
Added    includes/js/colorbox/images/ie6/borderTopCenter.png
Added    includes/js/colorbox/images/ie6/borderTopLeft.png
Added    includes/js/colorbox/images/ie6/borderTopRight.png
Deleted    includes/js/colorbox/images/internet_explorer/borderBottomCenter.png
Deleted    includes/js/colorbox/images/internet_explorer/borderBottomLeft.png
Deleted    includes/js/colorbox/images/internet_explorer/borderBottomRight.png
Deleted    includes/js/colorbox/images/internet_explorer/borderMiddleLeft.png
Deleted    includes/js/colorbox/images/internet_explorer/borderMiddleRight.png
Deleted    includes/js/colorbox/images/internet_explorer/borderTopCenter.png
Deleted    includes/js/colorbox/images/internet_explorer/borderTopLeft.png
Deleted    includes/js/colorbox/images/internet_explorer/borderTopRight.png
Modified    includes/js/colorbox/jquery.colorbox-min.js
Modified    includes/js/colorbox/jquery.colorbox.js
Modified    includes/js/jcarousellite.js
Added    includes/js/jcarousellite.min.js
Deleted    includes/js/jcarousellite_1.0.1.js
Added    includes/js/jquery.footable.js
Added    includes/js/jquery.tinynav.js
Deleted    includes/js/superfish.js
Modified    includes/js/theme-scripts.js
Modified    includes/js/validate/additional-methods.js
Added    includes/js/validate/additional-methods.min.js
Modified    includes/js/validate/changelog.txt
Modified    includes/js/validate/jquery.validate.js
Modified    includes/js/validate/jquery.validate.min.js
Modified    includes/js/validate/localization/messages_ar.js
Modified    includes/js/validate/localization/messages_bg.js
Modified    includes/js/validate/localization/messages_ca.js
Deleted    includes/js/validate/localization/messages_cn.js
Modified    includes/js/validate/localization/messages_cs.js
Modified    includes/js/validate/localization/messages_da.js
Modified    includes/js/validate/localization/messages_de.js
Modified    includes/js/validate/localization/messages_el.js
Modified    includes/js/validate/localization/messages_es.js
Added    includes/js/validate/localization/messages_et.js
Modified    includes/js/validate/localization/messages_eu.js
Modified    includes/js/validate/localization/messages_fa.js
Modified    includes/js/validate/localization/messages_fi.js
Modified    includes/js/validate/localization/messages_fr.js
Deleted    includes/js/validate/localization/messages_ge.js
Modified    includes/js/validate/localization/messages_he.js
Added    includes/js/validate/localization/messages_hr.js
Modified    includes/js/validate/localization/messages_hu.js
Modified    includes/js/validate/localization/messages_it.js
Modified    includes/js/validate/localization/messages_ja.js
Added    includes/js/validate/localization/messages_ka.js
Modified    includes/js/validate/localization/messages_kk.js
Modified    includes/js/validate/localization/messages_lt.js
Modified    includes/js/validate/localization/messages_lv.js
Added    includes/js/validate/localization/messages_my.js
Modified    includes/js/validate/localization/messages_nl.js
Modified    includes/js/validate/localization/messages_no.js
Modified    includes/js/validate/localization/messages_pl.js
Added    includes/js/validate/localization/messages_pt_BR.js
Added    includes/js/validate/localization/messages_pt_PT.js
Deleted    includes/js/validate/localization/messages_ptbr.js
Deleted    includes/js/validate/localization/messages_ptpt.js
Modified    includes/js/validate/localization/messages_ro.js
Modified    includes/js/validate/localization/messages_ru.js
Deleted    includes/js/validate/localization/messages_se.js
Modified    includes/js/validate/localization/messages_si.js
Modified    includes/js/validate/localization/messages_sk.js
Modified    includes/js/validate/localization/messages_sl.js
Modified    includes/js/validate/localization/messages_sr.js
Added    includes/js/validate/localization/messages_sv.js
Modified    includes/js/validate/localization/messages_th.js
Modified    includes/js/validate/localization/messages_tr.js
Deleted    includes/js/validate/localization/messages_tw.js
Deleted    includes/js/validate/localization/messages_ua.js
Added    includes/js/validate/localization/messages_uk.js
Modified    includes/js/validate/localization/messages_vi.js
Added    includes/js/validate/localization/messages_zh.js
Added    includes/js/validate/localization/messages_zh_TW.js
Modified    includes/js/validate/localization/methods_nl.js
Added    includes/payments
Modified    includes/sidebar-blog-posts.php
Modified    includes/sidebar-contact.php
Modified    includes/sidebar-gmap.php
Modified    includes/sidebar-popular.php
Modified    includes/theme-actions.php
Modified    includes/theme-comments.php
Modified    includes/theme-cron.php
Modified    includes/theme-deprecated.php
Modified    includes/theme-emails.php
Modified    includes/theme-enqueue.php
Modified    includes/theme-footer.php
Modified    includes/theme-functions.php
Modified    includes/theme-header.php
Modified    includes/theme-hooks.php
Added    includes/theme-options.php
Added    includes/theme-payments.php
Modified    includes/theme-profile.php
Modified    includes/theme-refine.php
Modified    includes/theme-searchbar.php
Modified    includes/theme-security.php
Modified    includes/theme-stats.php
Modified    includes/theme-widgets.php
Modified    includes/views.php
Modified    index.php
Modified    loop-ad_listing.php
Deleted    loop-featured.php
Added    loop-popular.php
Added    order-checkout.php
Added    order-gateway.php
Added    order-summary.php
Modified    page.php
Modified    search.php
Modified    sidebar-ad.php
Modified    sidebar-blog.php
Modified    sidebar-user.php
Modified    sidebar.php
Modified    single-ad_listing.php
Modified    style.css
Modified    styles/aqua-black.css
Modified    styles/aqua.css
Modified    styles/blue-black.css
Modified    styles/blue.css
Modified    styles/green-black.css
Modified    styles/green.css
Modified    styles/red-black.css
Modified    styles/red.css
Modified    styles/teal-black.css
Modified    styles/teal.css
Modified    taxonomy-ad_cat.php
Modified    taxonomy-ad_tag.php
Deleted    tpl-add-new-confirm.php
Modified    tpl-add-new.php
Added    tpl-ads-home.php
Deleted    tpl-blog.php
Modified    tpl-categories.php
Modified    tpl-dashboard.php
Modified    tpl-edit-item.php
Deleted    tpl-membership-confirm.php
Modified    tpl-membership-purchase.php
Modified    tpl-profile.php
Modified    tpl-registration.php
Modified    wrapper.php

Once finished, your site will be ready to take payments from customers that want to list on your classified ads site.

Getting started

To begin, you will need ClassiPress – version 3.3 or newer – and WordPress installed on a hosting server. You will also want to read the “Getting Started with ClassiPress” doc to get ready.

In order to accept payments on your site, you will need to sign up with a payment gateway service. You will also need payment gateway software to complete transactions.

ClassiPress comes with PayPal and Bank Transfer as the default payment gateways. It’s free to sign up with PayPal and it is accepted in many countries around the world. If possible, we recommend starting with PayPal. You can sign up for an account at the PayPal website.

If you prefer not to work with PayPal or cannot get a PayPal account, AppThemes sells plugins for payment gateways in our marketplace. You can research and decide which is the best option for you.

Once you have ClassiPress added to WordPress and an account with a payment gateway, you’re ready to proceed.

Pricing Settings

If you are going to charge for listings, you want to enable this in ClassiPress. The default setting for this is “off”, you should go to the pricing settings panel to enable it.

In your WordPress admin, go to ClassiPress > Pricing. You should see the admin panel pictured below.

Make sure “Charge for Listings” is checked, you have selected “Pricing model” that is suitable for your site and customers, and click the “Save Changes” button.

Pricing Models:

• Fixed Price per Ad – One price for any ad, regardless of category. To use this pricing model, you will need to create at least one ad pack.
• Price per Category – Allows you to set different prices for ads listed in each category. Choose this option, click the “Save Changes” button and a “Price per Category” tab will appear.
• % of Sellers Ad Price – Price to list ad is calculated as a percentage of the price of the item advertised. For example, let’s say you choose this option and set the percentage to 1%. A customer wants to list their boat for $10,000 on your site. The customer would then pay $100 for the ad. If you choose this option, be sure to enter a value for “% of Sellers Ad Price”.
• Only Charge for Featured Ads – All ads are free. Customers are only charged if they opt to have their ad listed as “featured on home”. Make sure you have enabled “Featured slider” and set “Featured ad price” option

Additionally you can modify each of pricing models with “Membership packages”. For more info and instructions on setting up, read the tutorial on Setting Up Membership Packs.

At this point, ClassiPress is now set up to charge for listings.

Payments Settings

ClassiPress needs to know a few things about how you will charge for listings on your site. To set up these options, go to Payments > Settings > General tab. You should see something similar to the screenshot below.

Important note: when you make any changes on this tab, you should press the “Save Changes” button before you navigate to another tab or page.

Regional

ClassiPress allows you to choose the currency used to collect payments on your site. At present, you can only have one currency at a time in ClassiPress. This is the place to choose your currency. Click the drop down next to “Currency Selection” to select your preference.

Since PayPal is bundled with ClassiPress, the default currencies in ClassiPress are the currencies supported by that payment gateway. If you have added other payment gateways, you should see the currency options for the currencies supported by each gateway.

Below the currency selection you will find more options like:

• Identifier – allows you to choose between currency symbol and code
• Position – determine where the identifier should be displayed
• Thousands Separator – change to meet your regional price formatting
• Decimal Sepatator – change to meet your regional price formatting
• Tax Charge – allows you to add regional tax to the listing or membership purchase price

Installed Gateways

This is where your installation of ClassiPress may differ from the screenshot above. ClassiPress will list, in this section, all of the installed payment gateways. If you have added more gateways, you will see them listed with “PayPal” and “Bank Transfer”.

To enable a payment gateway, simply check the “Enable” box to the right of that gateway. If you choose multiple payment gateways, ClassiPress will allow your customers a single choice from the gateways you have enabled. With more than one enabled, you give your customers the ability to determine the gateway that works best for them.

Additional Payment Gateway Settings

You will notice in the payments settings section of the WordPress admin that there is a tab for each installed gateway. You can click each tab to see the settings for that gateway. Each payment gateway will have it’s own settings and options.

Like this tutorial? Subscribe and get the latest tutorials delivered straight to your inbox or feed reader.