=== AWP Classifieds ===
Plugin Name: AWP Classifieds
Contributors: awpcp, sswells, srwells
Tags: listings, classified ads, classified, classifieds, directory plugin, classifieds script, classified theme, wp classified, ads
Requires at least: 6.2
Requires PHP: 5.6
Tested up to: 6.9
Stable tag: 4.4.5
License: GPLv2 or later

Create a classified listings directory, from auto listings to yard sales with AWP Classifieds plugin.

== Description ==

[Main Site](https://awpcp.com/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) | [Classifieds Docs](https://awpcp.com/knowledge-base/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) | [Showcase](https://awpcp.com/showcase/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) | [Modules](https://awpcp.com/premium-modules/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion)

Add a classified ads section to your WordPress site, quickly and easily with AWP Classifieds (formerly known as AWPCP or Another WordPress Classifieds Plugin). Create classified listings from cars to yard sales.
Lots of features, very configurable. Easy to setup. Great support.
We've been the #1 WordPress Classified Ads Plugin for 10+ years.

Looking for other types of directories? Check out [Business Directory Plugin](https://wordpress.org/plugins/business-directory-plugin/) for more easy WP directories.

== Classified Ads Features ==

* Search your classified directory by city, state, country, username, or keyword
* Allow AdSense ads to be displayed in your classified directory with configurable ad placement
* Control over HTML use in your ads
* Limit the text size of ad postings
* Standard form fields can be enabled or disabled, depending on your needs (title, website, name, country, etc)
* Allow or disallow image posting with listing ads
* Automatic expiration of ads (free or paid)
* Ads can have a "Tweet This" button in their layout
* Ads can have a "Share on Facebook" button in their layout
* Ads can be flagged by community for bad/offensive content
* Ads can imported via CSV files
* Ad listings support embedded videos
* Ads can have character limits, supported by plans (different plans can have different limits)
* Ads can be displayed on any page for a single category using shortcodes
* Auto-verify ads with email links to post immediately upon click
* Ads can be 'Sent to Facebook' inside of ad management
* Support for displaying ad events in BuddyPress activity stream with [BuddyPress module](https://awpcp.com/downloads/buddypress-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion)
* Ads can be edited via front end, back end with or without registration (depending on settings)
* Multiple levels of directory categories supported

== WordPress Classified Plugin Notification Features ==

* Allow posters to be notified of expiring ads, renewals, and approvals of ads
* Allow admin to be notified when new ads are posted, ads are edited and much more
* Ad users can contact the ad poster without exposing the poster's email (blind email system, similar to Craigslist)
* Admin can (optionally) be notified of expiring ads

== Ad Listing Payment Features ==

* Allows for paid or free ads
* Supports PayPal, PayPal Pro, Authorize.net, Stripe and 2Checkout for paid ads
* Allow for image posting limits higher than free ads
* Multiple fee scales for posting ads (allows you to have longer ad postings with higher fees)
* Variable ad expiration lengths connected to fee scale (e.g. allow ads to run for 30 days for $10, 60 days for $15, etc)
* Supports a "credit system" or pay with regular currency per ad. Mix and match if you want.
* Support for ad memberships (packages of ads for a single price)

== Posting Controls for your WordPress classified ads  ==

* Allow admin to approve ads prior to posting
* Allow admin to approve images prior to posting
* Users can edit or delete their own ads
* Admin can edit or delete all ads in the system
* Secure system gives users a unique editing key to administer their own ads
* Allows for limiting image posting (by image size, height, width and total count if desired)
* Anti-spam checks for all ads posted via Akismet.
* Flagged ads can be viewed separately to determine violations, and then deleted or unflagged.
* Ad Management panel, visible by users and admins for easier ad creation/editing/delete.
* Admin can post ads on behalf of other users with the ads displaying as if the user posted them initially
* Email verification step can be used to auto-post ads upon successful verification link click
* Ads can be posted to a Facebook page manually or automatically

== Classified Directory Image Features ==

* Allow image posting or shut it off completely
* Control the number, filesize, height and width of images posted
* Allow for different numbers of images to be posted with paid ads vs. free ads
* Allow for image approval prior to posting
* Allow users to add a primary image to their ad listing (Great for car listings and real-estate listings)
* Now supports multi-image asynchronous loading

== Add-on modules, not included in our free classified website builder ==

* [Extra Fields](https://awpcp.com/downloads/extra-fields-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows you to add any custom fields for display. For example, if you have a pet-related board, you might have "Sex", "Breed", and "Dam/Sire" as additional fields you require for display. Supports search and custom ordering of fields.
* [Region Control](https://awpcp.com/downloads/regions-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows you to restrict viewing of ads based on locale, so users don't see items they aren't physically near them, also allows customization of the region types, such as village, borough, etc.
* [Featured Ads](https://awpcp.com/downloads/featured-ads-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows you to promote certain ads over others by charging a fee for them, featured ads are displayed using CSS to highlight them. Featured ads are always returned first in a category, the overall ad list, or in search results. Also has a widget for placement anywhere on your site. Full admin control of featured ads, too
* [BuddyPress](https://awpcp.com/downloads/buddypress-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows users to manage their listing ads in the BuddyPress profile directly, see events from ad posting in the activity stream and more
* [Fee per Category](https://awpcp.com/downloads/fee-per-category-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows you to charge for certain categories and not others, giving you more freedom on how to configure your classified section. Allows for multiple fee plans per category, as well as a default plan to cover "all other unspecified" categories
* [Membership to Post](https://awpcp.com/downloads/subscriptions-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows power users to place blocks of ads at a time, great for real estate agents, car dealers, anyone who wants to place ads in bulk
* [Comments/Ratings](https://awpcp.com/downloads/comments-ratings-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allow users to rate classified ads, and add ratings and comments on listings
* [RSS Feeds](https://awpcp.com/downloads/rss-feeds-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows you syndicate your ads for your users to download in their favorite RSS reader and come back to your site more often!
* [Coupons/Discounts](https://awpcp.com/downloads/coupons-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows you to offer coupon codes for ad promotions to your users, coupons can be a percent off, or a fixed amount, have expiration dates and be tracked by usage
* [Category Icons](https://awpcp.com/downloads/category-icons-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - adds small icons to give visual cues to your user for each directory category in AWP Classifieds Plugin
* [Mark as Sold](https://awpcp.com/downloads/mark-as-sold-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows users to mark for sale items as sold to keep content in your classifieds, but clarify availability
* [Attachments](https://awpcp.com/downloads/attachments-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows users to attach PDFs, text files or other images to their classifieds (great for job boards!)
* [Ad Campaign Manager](https://awpcp.com/downloads/campaign-manager-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - add your own advertisements in 5 different positions
* [ZIP Search](https://awpcp.com/downloads/zip-code-search-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - search for ads that have address fields within a radius of a postal code

== Premium Payment Gateways for Paid Listings ==

Want to accept credit cards on your site for paid listings in your classifieds directory? Choose from any of our extra payment processors.

* [Stripe](https://awpcp.com/downloads/stripe-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - accept payments via Stripe for ads
* [PayPal Pro]( https://awpcp.com/downloads/paypal-pro-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows you to have an embedded payment form on your site for use with PayPal Pro accounts
* [Authorize.net Gateway](https://awpcp.com/downloads/authorizenet-module/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) - allows users to purchase ads and credit plans using Authorize.net

These are just some of the features of our easy WordPress Classifieds Plugin.

For more information and support please visit [awpcp.com](https://awpcp.com?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion)

If you love AWP Classifieds, [please consider purchasing a Module](https://awpcp.com/premium-modules/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion)!

== Installation ==

Pre-installation note: If you have previously tried other WordPress classified plugins and plan to use the same page, please make sure your database has been cleared of any posts with the same name or slug as your classifieds page.
For example, if your page will be named "Auto Listings", you might have a wp_posts database entry post_title value of "Auto Listings" and post_name value of "auto-listings" still left over from previous plugins.
You need to check your database to make sure old data does not exist. Delete all entries from your wp_posts table where the post_title and post_name are the same as your classifieds page.

1. Upload the folder another-wordpress-classifieds-plugin with its contents to wp-content/plugins/
2. Activate the plugin
3. Click on the "Click here to setup your site options" link and fill out all your various options to configure how you want your classifieds to run.
4. Create some categories and sub categories for your ads.
5. Set up your payment fees if you are going to be running in pay mode.

== External Services and Domains ==

This plugin connects to the following external services to provide its functionality:

**Google reCAPTCHA (www.google.com)**
* Used for spam protection and form validation
* Domains: www.google.com/recaptcha/api.js, www.google.com/recaptcha/api/siteverify, www.google.com/recaptcha/admin
* Data transmitted: reCAPTCHA responses and site verification tokens
* Required for: Anti-spam protection features

**PayPal (paypal.com)**
* Used for payment processing and IPN (Instant Payment Notification) verification
* Domains: ipnpb.paypal.com, ipnpb.sandbox.paypal.com
* Data transmitted: Payment verification data, transaction details
* Required for: PayPal payment gateway functionality

**Facebook (facebook.com)**
* Used for posting ads to Facebook and cache management
* Domains: graph.facebook.com
* Data transmitted: Ad content, user access tokens (if Facebook integration is enabled)
* Required for: Facebook posting features (optional)

**Strategy11 (strategy11.com)**
* Used for collecting anonymous onboarding feedback and usage analytics
* Domains: feedback.strategy11.com
* Data transmitted: User email, name, and plugin usage information
* Required for: Onboarding wizard feedback collection (optional)

**HTTPBin (httpbin.org)**
* Used for determining the server's external IP address
* Domains: httpbin.org
* Data transmitted: Server IP address detection requests
* Required for: Server IP address identification functionality

**Additional Payment Gateways**
* **Authorize.Net (authorize.net)** - Payment processing gateway
* **Stripe (stripe.com)** - Payment processing and subscription management
* **2Checkout (2checkout.com)** - International payment processing
* Domains: www.authorize.net, stripe.com, www2.2checkout.com
* Data transmitted: Payment information, transaction details, customer data
* Required for: Premium payment gateway modules (optional)

== Screenshots ==

[Visit the main site for screenshots]( https://awpcp.com/features/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion)

== Frequently Asked Questions ==

For the definitive FAQ section, please visit the [FAQ Section of the Forum]( https://awpcp.com/forum/faq/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion), or our [Quick Start](https://awpcp.com/knowledge-base/quick-start-guide/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) guide.

= How do I install AWP Classifieds Plugin? =
Please see our [Installation Guide](https://awpcp.com/knowledge-base/quick-start-guide/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion#qs-general), the [Quick Start Guide](https://awpcp.com/knowledge-base/quick-start-guide/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) for common how-to scenarios, and our [Initial Setup](https://awpcp.com/knowledge-base/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion#setup) page for instructions on how to get going quickly.

Full [documentation](https://awpcp.com/knowledge-base/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion) for the plugin is also available.

= What types of classified listing directories can I create? =

Our classifieds website builder software combined with our add-on modules is the most powerful classifieds plugin on the market. The options for classified advertising are limitless. Here are a few types of classified directories you can create:

* Job board listings and help wanted
* Auto, truck, and car listings
* Apartment classifieds
* Property and real estate listings
* Dating and personal listings
* Fashion listings to buy and sell clothing
* Announcements for events like yard sales, reunions, auctions, and school events

= Can this plugin support paid and free listings? =
Yes it can. You can do this by creating fee plans for 0.00 and some other paid amount at the same time. For more details, read [this article](https://awpcp.com/knowledge-base/quick-start-guide/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion#qs-freepaid).

= Will it work with my theme? =
Our WordPress classifieds plugin will work with any well-written, WP compliant theme. Generally speaking, paid themes tend to be higher quality than free ones.

In general, we like WooThemes as a solid company with great products and support. You can check them out [here](http://woothemes.com) Or [StudioPress](http://studiopress.com​​)

= Can this plugin be translated into my language? =
Yes it can. Our Classifieds directory plugin comes with many user-provided translations under the /languages folder. For details on how to do it, our [translation guide](https://awpcp.com/knowledge-base/quick-start-guide/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion#qs-translate) will help get you started.

= Is this compatible with WordPress Multisite (WPMU)? =
Yes it is. However, you cannot "network-activate" the plugin (as this will share the database). Activate it on only the subsites on which you need a directory. This can be done under Plugins->Add New as the Administrator user. Do not "network activate" AWPCP as the "super admin".

== Changelog ==
= 4.4.5=
* Fix: Improve ownership checks

= 4.4.4 =
* Fix: Security Vulnerabilities
* Fix: Issue with PayPal payment confirmation
* Fix: PHP notices
* Fix: PHP Fatal Error when deactivating the plugin
* Fix: Faulty translation placeholders
* Fix: Broken layout on Safari in some isolated cases
* Fix: Issue loading Moment.js on some pages
* Fix: Other missing dependencies notices

= 4.4.3 =
* Fix: jQuery loading issue

= 4.4.2 =
* Fix: Error when running WP CRON for certain events

= 4.4.1 =
* Fix: Activation issue

= 4.4 =
* Enhancement: Improved security
* Enhancement: Changed some external assets to local files
* Enhancement: Refactored old default PHP functions to newer WordPress alternatives
* Enhancement: Moved add-on licensing and update management to AWP Module Updater
* Fix: PHP 8.2 notices

= 4.3.6 =
* Fix: Minor security vulnerability

= 4.3.5 =
* New: Added an onboarding wizard
* Fix: Updated one of the dependencies to fix an NPM vulnerability
* Fix: Made the 'Test SSL Client' string translatable
* Fix: Bug with listing import when images are imported
* Fix: Improved the way we load translations
* Fix: Bug with broken thumbnail images after WordPress 6.7
* Fix: PHP warning when OpenGraph metadata is loaded

= 4.3.3 =
* New: Updates for better PHP 8 support.
* Security: Add more nonce and user role protection for uninstalling and other ajax functions.
* Security: Hardening for escaping output and SQL queries.
* Update SelectWoo script version.
* Fix: Fallback to native dropdowns if there is a conflict with Select2.
* Fix: SEO Framework updatesfor outdated code.
* Code: Update to phpcs 3 standards.

= 4.3.1 =
* Security update against CSRF attacks in some admin pages. add CSRF tokens "nonce".
* Fix: Pagination show the correct number of ads per page based on "number ads per page plugin" settings instead of 10 ads per page.
* Fix: Reset permalink on installation to avoid page not found errors (404).

= 4.3 =
* Important security update. Sanitizing incoming values.
* Fix: Show payment error messages weren't showing for logged out users.
* Fix: A couple email notifications didn't include a space between the site name and url.

= 4.2.1 =
* New: When viewing a free listing, show "Free" instead of "$0.00"
* Fix: Permissions issues were preventing the admin menu from showing on some sites.
* Fix: The button label, category description, and order weren't always showing in the category form.
* Fix: The links to edit and delete a fee plan weren't working correctly.
* Fix: Prevent trashed posts from coming back when viewing the trash.
* Fix: When deleting expired adds, check by end date instead of only the disabled date. This will delete the expired ads sooner.
* Fix: The custom upload folder setting was only used for temporary files.
* Make a few extra strings translatable.

<a href="https://awpcp.com/plugins/awp-classifieds/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion">See changelog for all versions</a>
