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.

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.

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.

Maybe you would like to receive some feedback from your site visitors or give them a chance to ask you further questions about the services that you offer. What better way to do that than adding a contact form to your site. In this tutorial, you will learn how to install the excellent Contact Form 7 from Takayukister into your AppThemes application theme. It takes just a few minutes, so let’s start immediately:

Download and Install

First thing that we need is the Contact Form 7 plugin. You can download and save the Contact Form 7 Plugin from the WordPress plugin repository. No need to unzip the file, just save it so you can find it later.

Now open your WordPress admin area, go to the plugins section and click “Add New”

Our next step is to click on “Upload” so that you see the message “Install a plugin in .zip format”. Click the button and find the contact-form-7.x.zip file you saved earlier. Click “Install Now”.

Your plugin will need a while to upload depending on your internet connection speed, so please be patient. Just wait until you see the message “Plugin installed successfully” and then press “Activate Plugin”. The plugin is now installed and it’s time for us to setup a page and menu.

Adding the Form to a Page

What we need next is the shortcode from the plugin to place it on a normal WordPress page. In your WordPress admin menu you will see “Contact”. Click on that and something like in the following screenshot will show up. For now just copy or note the shortcode that you see there.

Now we need to create a simple WordPress page that we can use to show the contact form on our website. Go to WordPress “Pages” and create a new page. In this tutorial we choose the title “Contact Us”. In the description field we simply paste the shortcode from above, nothing else! That’s it. Save (Publish) your settings.

Please Note: The ID number that you see on your site can be different from this tutorial. Don’t use the one from here!

Adding to the Menu

Now it’s time to make sure people can find your contact form. So let’s place a link to our Header menu. To do so, go to WordPress Appearance > Menus and find your newly created page on the left side where it says “Pages”. Find your “Contact Us” page, checkmark it and click “add to Menu”

Now you should see something like this:

Save the settings by clicking on the “Save Menu” button. Got it? Well, nothing more to do. Go to your frontpage and enjoy your new contact form that will look like this:

Did I mention that you can use this tutorial on any theme from AppThemes? There are no known problems using this plugin at this time.

In an upcomming tutorial I will show you how to tweak your Contact Form 7 to look more professional by adding some additional information. Stay tuned!

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

Before proceeing you should consider the following…

• You should have an basic understanding of PHP
• You should be able to use FTP to add or remove files from your hosting server
• You should back up all of your files and database before proceeding with the steps outlined below
• Know that you proceed at your own risk – AppThemes does not support customizations of any kind
• You also might want to read our other tutorial on creating child themes for Vantage

Start by creating a bare bones child theme style.css file:

/*
Theme Name:     Vantage Example Functional Child Theme
Theme URI:      http://appthemes.com/
Description:    Example child theme for the Vantage theme 
Author:         AppThemes
Author URI:     http://appthemes.com/
Template:       vantage
Version:        0.1.0
*/
 
@import url("../vantage/style.css");

Now create a blank child theme functions.php file:

<?php

// BEFORE USING: Move the vantage-child theme into the /themes/ folder.
//
// You can add your own actions, filters and code below.

We are going to accomplish these 3 things in this fast-paced tutorial.

• Remove the Admin Bar
• Create a widget that will display all of the links that were in the admin bar
• Quick and easy swapping of the Vantage’s i18n text strings

Removing the Admin Bar

So, you want to remove the admin bar that appears on the top of the page, well a child theme is one great way to do that without needing to modify Vantage’s code. Here is how easy this will be.

In your child theme’s functions.php file, add this code (below the ‘// You can add your own actions, filters and code below.’):

if ( !is_admin() ) {
	add_filter( 'show_admin_bar', '__return_false', 1000 );
}

So, what does this do? If you are not on a wp-admin page, don’t show the admin bar. Wow, that was easy, right? Now, you’re looking at that empty space up there and thinking, wait a second, weren’t there some useful Vantage specific links in that admin bar? Yes, you are correct. Let me give you a simple demonstration of how to reproduce them some place else.

Create a Widget with the old Admin Bar links

In your functions.php file again, below the lines you just added in the previous step, add the following sets of code. I’ll explain a little about each:

This function will create a permalinks enabled independent getter function for the Vantage dashboard URL

function va_child_get_user_dashboard_url() {
	global $va_options;
 
	if ( !is_user_logged_in() )
		return;
 
	$listings_permalink = $va_options->dashboard_listings_permalink;
	$permalink = $va_options->dashboard_permalink;
 
	if ( get_option('permalink_structure') != '' ) {
		$url = home_url( user_trailingslashit( $permalink ) );
	} else {
		$url = home_url( '?dashboard='.$listings_permalink.'&dashboard_author=self' );
	}
 
	return $url;
}

Here is the code to produce a very very barebones widget. It’s focus isn’t to try to be the best widget, it’s trying to get you up and running to get those links back so your users can login, logout, register, retrieve their lost password, view their dashboard, and edit their profile. You could, of course, take the different URL getter functions and do however you wish with them.

class VA_Child_Widget_Admin_Bar_Links extends WP_Widget {
 
	function __construct() {
		$widget_ops = array(
			'description' => __( 'All the links that were in the admin bar.', APP_TD )
		);
 
		parent::__construct( 'admin_bar_links', __( 'Vantage - Admin Bar Links', APP_TD ), $widget_ops );
	}
 
	function widget( $args, $instance ) {
		extract( $args );
 
		echo $before_widget;
 
		$li = '';
		if ( is_user_logged_in() ) {
			$li .= html( 'li', html_link( va_child_get_user_dashboard_url(), __( 'Dashboard', APP_TD ) ) );
			$li .= html( 'li', html_link( appthemes_get_edit_profile_url(), __( 'Edit Profile', APP_TD ) ) );
			$li .= html( 'li', html_link( wp_logout_url( home_url() ), __( 'Logout', APP_TD ) ) );
 
		} else {
			$li .= html( 'li', html_link( wp_login_url(), __( 'Login', APP_TD ) ) );
			$li .= html( 'li', html_link( appthemes_get_password_recovery_url(), __( 'Lost Password?', APP_TD ) ) );
			if ( get_option( 'users_can_register' ) ) {
				$li .= html( 'li', html_link( appthemes_get_registration_url(), __( 'Register', APP_TD ) ) );
			}
		}
 
		echo html( 'ul', $li );
 
		echo $after_widget;
	}
}

This function and hook will just get the above widget registered so you can use it in the wp-admin widgets page to put it in some sidebars. Also, you would only need the below if you were using the widget from above.

function va_child_register_widgets() {
	register_widget( 'VA_Child_Widget_Admin_Bar_Links' );
}
add_action( 'widgets_init', 'va_child_register_widgets' );

Now you have the widget registered, so go drag it into a sidebar, and now you can login and logout, and do everything you could with the admin bar, just without the admin bar.

Quick and Easy i18n Text String Swapping

In this little example, you can swap out the text strings in the Vantage theme, without all the language packs. This is most useful and makes the best sense for a use case if you are interested in swapping out a few or a small handful of strings. If you have larger needs, then you might consider using the language packs to swap out strings.

add_filter( 'gettext', 'va_child_wordsmith', 10, 3 );
function va_child_wordsmith( $translated, $orig_text, $domain ) {
	// In this simple example, we only want to look at the strings from the parent theme's text domain (APP_TD).
	if( APP_TD !== $domain )
		return $translated;
 
	$different_wording = va_child_different_wordings( $orig_text );
	if ( !empty( $different_wording ) )
		return $different_wording;
 
	return $translated;
}
 
function va_child_different_wordings( $orig_text ) {
	$strings = array(
		// 'Old string' => 'New string',
		'Business Listings' => 'Listings',
		'(e.g. restaurant, web designer, florist)' => '(Example: Auto Repair, Restaurant)'
	);
 
	return !empty( $strings[$orig_text] ) ? $strings[$orig_text] : '';
}

So, all you would do is change the $strings array to hold your ‘old’ string and your ‘new’ string, and it will swap it out for you!

These are some simple examples of how to override the parent theme’s (Vantage) functionality. There are many more things that could be accomplished, so keep an eye out for more tutorials and enjoy!

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

First, let’s take a look at what we are trying to accomplish. In the screenshot below, you can see the “Submit Your Listing” form from ClassiPress. In the enlarged section, you can see a drop down with a list of selectable currencies. If you’re in a region with more than one available currency, this is going to be a useful option for your customers.

To start, we’re going to prepare the “Currency” custom field. In the WordPress admin, go to the left column menu and click ClassiPress > Custom Fields. Scroll down the page, find and click “Currency”.

There are a few options on this page (see below) and they all have help prompts that describe each option. Just rollover the “?” icon next to each option. We want to pay particular attention to “Field Values”. This is where you can enter your currency options. Enter as many as you would like. Be sure to keep everything on one line and separate values with a comma. Once you have your options set, click the “Save Changes” button at the bottom of the page.

Now we are going to create a custom form. In the admin menu, navigate to ClassiPress > Custom Forms. At the top of the custom forms page, you’ll find a button for “Add New”.

On the “New Form Layout” page (below), give your form a name and description – this is for your own use and will not appear on your website. Next you will choose which categories should use your form. If you want every category to include multiple currencies, choose them all. Please note that each category can only use one custom form. If you are using different custom forms, you’ll need to add “Currency” to each form. Make sure “Status” is set to “Active” and click “Create New Form”.

You will be taken back to the “Form Layouts” page. Find your newly created form and click the “Edit Form Layout” icon. It’s the first icon of three icons on the far right.

Now that we’re on the “Edit Form Layout” page, adding the “Currencies” custom field is a snap. Just check the box next to “Currencies” in the list of “Available Fields” and click “Add Fields to Form Layout”. “Currencies” should now appear in the “Form Preview” box on the left. You can drag it up and down to change the order. You can also make it a “Required” field. Before you leave the page, you will need to click the “Save Changes” button.

That’s it, you’re finished! And now that you have added this new custom field, customers can list items in any currency you choose to provide. Here’s another look at “Currencies” in the “Submit Your Listing” form and a couple of classified ad examples using the new currencies.

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