Quick Start Guide

Quick Start Guide

Thanks for choosing Another WordPress Classifieds Plugin to increase customer interaction on your site. We have some easy scenarios below that will help you get your site up and running QUICKLY with AWPCP.

What do you want to do with AWPCP?


I want…

 

What I want isn’t listed hereI want to browse the docs OR I want to ask questions


Help Installing AWPCP

Installing AWPCP is easy.

  1. Install the plugin.
  2. Configure your Classified Page names
  3. Take a quick tour of the AWPCP Classified admin sections and decide what you want to configure next.

Once you have the plugin installed, you can view it from your site under the Classifieds Page name you defined in step 2.  For example, if you called the page “Classifieds”, then you will be able to access AWPCP from http://<your_site_name>/classifieds.  If you called the page “My Classified Listings”, then you can see AWPCP from http://<your_site_name>/my-classified-listings.

Most themes will make your AWPCP link visible directly in your menus.  If you can’t see it in the menu, consult your theme for documentation on showing pages inside your theme.  If your theme is WP 3.0 Menu enabled, you can configure it under Appearance->Menus in your WordPress admin section.

Return to Top


Setup a Free Classified Board

To setup a free classified board in AWPCP, you need to do the following:

  1. Go to the Payment settings tab.
  2. Make sure “Charge Listing Fee?” is unchecked at the top.
  3. Click Save Settings.
  4. Go to the Image settings tab.
  5. If you want to allow images in your free listings, check “Allow images in ads?”
  6. Change the number of images you want for free mode.
  7. Click Save Settings.

Now you’re ready to allow free classifieds on your site.

Return to Top


Setup a Paid Classified Board

This setup assumes that:

  • You want to charge fees for all categories on your site
  • You want to use the same fees for these categories

You may prefer the Fee Per Category approach if that’s not quite what you want, instead.  More information here.

To setup a paid classified board in AWPCP, you need to do the following:

  1. Go to the Payment settings tab.
  2. Make sure “Charge Listing Fee?” is checked at the top.
  3. Activate either PayPal or 2Checkout as your payment gateway.
  4. Enter the proper credentials, depending on the gateway (PayPal email, 2Checkout account)
  5. Set your payment currency for your local region (e.g. USD for US Dollar, GBP for British Pound).  Valid currencies are found here.
  6. Click Save Settings.
  7. Go to the Image settings tab.
  8. If you want to allow images in your free listings, check “Allow images in ads?”
  9. Click Save Settings.
  10. Go to Fees menu.
  11. Add as many fee plans as you wish to use for your site.

Now you’re ready to accept paid ads for your site.

Return to Top


Setup a Mixed Free/Paid Board

To create a mixed free/paid classifieds board, do the following:

  1. Follow all the steps outlined for Setting up a Paid Board first.
  2. After you define your paid plans, define ONE or more fee plans that have a $0.00 cost to them.  This gives you the “free” option mixed with the paid one.

Now you’re ready to have free and paid ads together.

Return to Top


Setup a Classified With Fees per Category

This setup assumes that:

  • You want to charge fees for some categories on your site
  • You may not want the same fees for each category

You may prefer the Paid Board approach if that’s not quite what you want, instead.  More information here.

To setup a “fee per category” classified board:

  1. Purchase the Fee Per Category premium module
  2. Install and configure Fee Per Category module
  3. Go to Fees menu.
  4. Add as many fee plans as you wish to use for your site.
  5. For each fee plan, assign that plan to one or more categories.
  6. Click Update Plan after setting categories.
  7. IMPORTANT:  After your other plans are complete, define ONE fee plan that isn’t assigned to ANY categories at all.  This will be your “default fee plan” that is used for “everything else”.  It is best to make this fee plan amount $0.00, but you can define it to be whatever you like.

Now you’re ready to have classifieds with varying fees depending on the category.

Return to Top


Allowing only Registered Users to Post

If you only want registered users posting classified ads, do the following:

  1. Go to the Registration tab.
  2. Make sure “Require user registration?” is checked.
  3. Click Save Settings.

Now in order to post a classified, your users must previously register with your site and be logged in.  When they attempt to post an ad, their user profile details will be used in the ad submission form.

IMPORTANT:  Users that have blank or incomplete profile information (e.g. missing first/last name) may complain that their ads are being placed with incomplete information and that they cannot edit their ad contact info.  They must have a complete profile to display this information properly.

Return to Top


Allowing only Registered Users to Respond

If you only want registered users posting classified ads, do the following:

  1. Go to the Registration tab.
  2. Make sure “Reply To Ad requires user registration?” is checked.
  3. Click Save Settings.

Now in order to reply to a classified, your users must previously register with your site and be logged in.

Return to Top


Allow Registered Users To Manage Their Ads

If you only want registered users to manage their ads from their WordPress profile:

  1. Go to the Registration tab.
  2. Make sure “Require user registration?” is checked.
  3. Click Save Settings.
  4. Go to the General tab.
  5. Make sure “Allow Ad Management Panel” is checked
  6. Click Save Settings.

The Ad Management panel requires that users be registered, so both settings are necessary.  The Ad Management panel will now appear at http://<your_site>/wp-admin for any logged in user.

Return to Top


Allow Unregistered Users to Manage Their Ads

This is the default setting for AWPCP.  If you have registered users managing their ads now, you must turn off BOTH of those settings to return to the default mode.

Users will receive an email upon submission of their ad.  Inside this email is an access key they will need when they click “Edit Ad” from your classified section, in addition to the email used when the ad was submitted.

Return to Top


Import Ads from Other Sources

AWPCP supports importing ads from any system provided they are in CSV format and the columns are labeled according to the standard outlined in the CSV Import Documentation.

Full import documentation here.

Return to Top


Location Based Classifieds

Location based classifieds are where your categories can be filtered such that the results are specific to your user’s current location.  Users only see relevant results, much like Craigslist does.  Location based classifieds also allow you to restrict what cities, states and countries the users are allowed to enter during the Place Ad process.  By default, an AWPCP classified board allows users to enter in whatever they like to these fields.  This makes it harder for future users to search on the data if there are inconsistencies such as misspellings (e.g. Laraydo, Laredo, or Larado) or capitalization problems (e.g. TExas, TX, and Texas)

To enable location-based classifieds, do the following:

  1. Purchase the Regions Control premium module
  2. Install and configure Regions Control module

Users can now browse and search by location.  In addition, when placing ads, they will be restricted on which cities, states, countries and any other location-specific fields you added (e.g. county, village, borough, etc).

Return to Top


Custom Ad Fields

Custom Ad Fields are obtained through installing the Extra Fields module and configuring whatever fields you wish.  AWPCP allows you to have fields of various types (number, string, URL), as well as private/public, assign them to a particular category or make them available to all ads, and show them in the search form (or not).

To enable custom fields for your ads, do the following:

  1. Purchase the Extra Fields premium module
  2. Install and configure Extra Fields module
  3. See your new fields in the Place Ad form, search on them in the Search Ads form.  You need to select a category FIRST before you will see category-specific fields on either page.  General fields are always visible.

Return to Top


Customizing the Style of AWPCP

Starting with 1.8.0, AWPCP incorporated the ability to pull styles from a custom CSS file that isn’t overwritten on upgrade. For those with a quirky theme, or the desire to heavily customize AWPCP’s look to match their site, this is great news…

How to use the AWPCP Custom Style CSS file:

  1. Create a file called awpcp_custom_stylesheet.css under wp-content/plugins on your site. This location won’t be overwritten by any plugin or WordPress on upgrade.
  2. Place any style changes you need in this file. It will be loaded such that these changes will take precedence in the CSS hierarchy over other styles in AWPCP.

How do I know what I want to put in this file?
Good question! Use Firebug (http://getfirebug.com/) with IE or Firefox to determine what styles are being applied to any given element. Once you know what style is causing an issue, you can override it via the custom style CSS file.

What if I see custom hard-coded styling I can’t override?
You may see something like this in your output of the ads:

<div>
<div style="width:80px;padding:5px;float:left;margin-right:20px;">

That is controlled from Settings->Ad/Listing settings by altering the HTML templates for Single Ad or Ad Listing. As long as you create valid HTML in there, you can change the templates to be anything you like.

Return to Top


Translate AWPCP to your Native Language

AWPCP can be translated into any language, per the WordPress text internationalization standards.  For more general information about how WordPress supports externalized strings for plugins, please read this article first.

  1. Start with the PO file from AWPCP (in the main directory of the plugin, named AWPCP.po)
  2. Downloaded the POedit software (You can find it here)
  3. Translate all strings to your preferred language.
  4. Save the file as AWPCP-<langcode>.po, where <langcode> represents your ISO language code/country combination, such as en_US (English, US), en_UK (English, UK), fr_FR (French, France), pt_BR (Portuguese, Brazil), etc.  Country codes can be found on this GNU website.
  5. Upload this new language-coded file to the main AWPCP directory on your website.
  6. Update your wp-config.php to define WPLANG for your language/country combination.  It should match the <langcode> you used for AWPCP.po above.  For more information on doing this, see this WordPress Codex page on Installing WordPress in your Language.
  7. Under Settings->General Tab, find and check the box that says “Turn On Translation File (POT)?”
  8. Be sure to flush any browser caching you have in addition to any WordPress/web hosting caching you have so that you can see your new strings.

This will translate about 95% of the plugin.  Further translation must happen in the following places, which are stored in the database:

  1. Your AWPCP Page names must be translated to your native language
  2. Strings that are inside the configuration, such as the Welcome Message must be translated
  3. Email templates must be translated
  4. Strings used in the HTML templates for the ads and listings under Ad/Listing Settings must be translated

After you do all of these, AWPCP is fully translated.

NOTE:  AWPCP does not ship with any translations of the PO file because of lack of resources to keep them up to date.  The community often posts these translations for other folks in their country and you can find that in this support forum thread.  Be sure to check the dates of the translation files and compare them with your current version.  Versions older than 6 months will likely be out of date and incompatible with the current plugin PO file.

 

Return to Top