=== WPAdverts - Classifieds Plugin ===
Plugin URI: https://wpadverts.com/
Contributors: gwin
Tags: classifieds, classified, classified ads, classifieds script, classifieds plugin
Requires PHP: 5.6
Requires at least: 5.7
Tested up to: 6.9
Stable tag: 2.3.0
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Build classifieds section in seconds. Allow your visitors to browse and post (paid or free) classified ads on your site.

== Description ==

This is the popular classifieds plugin that experienced users stay with or come back to!

More than 10 years of experience led us to build WPAdverts around 3 key points:

* FASTER
* MORE FLEXIBLE
* MORE FREEDOM!

WPAdverts is a fast, lite-weight plugin that’s flawless on ANY device and fits with ANY theme! 

It also plays nicely with other plugins, giving you the freedom to quickly create the classifieds site that YOU want, as a flexible foundation that can grow with you and your community.

= ANY HOSTING? YES! =
 
There’s no need for expensive hosting with WPAdverts, because our crafty WordPress-standards coding keeps your server-load low and your loading-times FAST!

= EASIER BY DESIGN =

Everything comes together like you’d expect.

WPAdverts blends seamlessly with WordPress, making it super-simple and familiar; you’ll feel like a pro’ in approx’ 3 minutes!

= SPEEDY, EXPERT SUPPORT =

If you ever do get stuck you can rest assured of fast support by someone who really knows WordPress!

We also have extensive documentation and helper videos too.

= EXTENSIONS? OF COURSE! =

We DO NOT confuse or “nickel and dime” you at every step; instead we simply offer 3 value-packed packages. See pricing below.

= TAKE ACTION; TAKE CONTROL =

Note this is more than a demo; it’s a fully-functioning classifieds software with all critical functions built-in; you can start TODAY. 

= INSTALL =

Click the Installation tab at the top of this page to see how you install WPAdverts – or just click the blue Install Now button at the bottom of this page!

Install WPAdverts now and you’ll understand our 5 star reviews and why people keep coming back, building their success upon success!


**Quick Links**

* [View User Demo](https://demo.wpadverts.com/lite/) – see plugin frontend (plain)
* [View Admin Demo](https://demo.wpadverts.com/lite/wp-admin/) – see wp-admin panel
* [WordPress Classifieds Plugin](https://wpadverts.com/) – official site
* [WPAdverts Pricing](https://wpadverts.com/pricing/) – 3 affordable packs!

**Notable Features**

WPAdverts has ALL the classifieds features you’d expect, and some you might not:

* Modern, responsive design for any device or screen size
* Freedom to work with the very best of other plugins
* Choose Grid or List Display – and allows your visitors to switch too!
* You can allow both registered and/or anonymous users to post classifieds
* Allows users to browse, edit and delete their own ads
* Payments Module to track user payments and transactions logs
* Bank Transfer payment gateway is included, for free
* Charge users for renewing auto-expired ads
* 12 translations available, see list below
* Easy drag-and-drop image upload
* Detailed documentation for both developers AND normal users!

**Documentation**

* [Documentation](https://wpadverts.com/docs/) – mainly for users
* [Short-codes](https://wpadverts.com/docs/shortcodes/) – quick reference for users
* [Code Snippets](https://github.com/simpliko/wpadverts-snippets) – for programmers and developers

**Extensions**

WPAdverts plugin can be extended with premium add-ons to suit and your business, available in 3 convenient and affordable packs; Personal, Pro or Ultimate. 
See all the extensions available at https://wpadverts.com/extensions/

**12 Available Translations**

Brazilian, Croatian, French, Dutch, German, Italian, Polish, Portuguese, Russian, Slovak, Slovenian and Spanish.
We’re not English native speakers, so if you find any typo, grammar mistake or etc. please report it on the support forum, thanks!
Could you translate Adverts to your language? Please do help users by submitting your translation!
Get Involved!

* Rate Adverts – If you find this plugin useful please do leave a [positive review](https://wordpress.org/support/view/plugin-reviews/wpadverts)  : )
* Submit a Bug – If you find any issue please [submit a bug](https://github.com/simpliko/wpadverts/issues/new) on GitHub. 

Get started!

Click the blue button on the lower right-hand side of this page that says ‘Install Now’. It’s quick and easy!


== Installation ==

1. Activate the plugin
2. On activation plugin will create two Pages (in wp-admin / Pages panel)  with [adverts_list] and [adverts_add] shortcodes .
3. Go to Classifieds / Options panel and configure the options.
3. For more detailed instructions visit plugin [documentation](https://wpadverts.com/documentation/)

== Frequently Asked Questions ==

= I have a problem what now? =

Please describe your issue and submit ticket on plugin support forum, you should receive reply within 24 hours (except weekends).

= Ads pages are showing 404 error? =

Most likely rewrite rules were not registered properly for some reason. Go to wp-admin / Settings / Permalinks panel and click
"Save Changes" button without actually changing anything, this should reset router and fix URLs.

== Changelog ==

= 2.3.0 - 2026-03-02 =

* FIXED: Backward incompatible change to [adverts_block]. Read more here https://wpadverts.com/blog/backward-incompatibility-in-version-2-3-0/
* FIXED: Fatal error when deleting temporary files.

= 2.2.11 - 2026-01-05 =

* FIXED: Broken Access Control in [adverts_block] shortcode.
* FIXED: Error when submitting contact form via AJAX request.
* FEATURE: Additional CSS classes for buttons in the Classifieds Single Contact block.

= 2.2.10 - 2025-12-08 =

* FIXED: Error when submitting a contact form.

= 2.2.9 - 2025-12-01 =

* FIXED: Web accessibility (ADA) improvments for blocks.
* FIXED: Few typos fixed.
* FIXED: Warning generated by the wpadverts_block_button() function.

= 2.2.8 - 2025-10-13 =

* FEATURE: Custom login and registration URLs in the Classifieds Manage block.
* FIXED: Incorrectly used esc_html_e() function in a couple of files.
* FIXED: Not all taxonomies being loaded via the REST API. 

= 2.2.7 - 2025-08-07 =

* FEATURE: New Plugin Elementor Integration.
* LANGUAGE: Updated NL translation.
* FIXED: Warning in the Contact Methods block with default contact methods.
* FIXED: Contact methods not detecting visible contact methods correctly (on the Ad details pages).
* FIXED: Warning in the Classifieds Manage block.
* FIXED: Ability to style the block buttons and forms individually.

= 2.2.6 - 2025-06-24 =

* FEATURE: New Plugin Better Messages Integration.
* FIXED: Translation files not loading automatically.
* FIXED: Comments removed from the modal.php template to prevent JS error.
* FIXED: XSS vulnerability in the Classifieds Single Value block.

= 2.2.5 - 2025-06-10 =

* FIXED: Incorrect label for the KSES filter.
* FIXED: Show Avatar option in the Classifieds List not working.
* FIXED: XSS vulnerability in the Classifieds Categories block.

= 2.2.4 - 2025-05-13 =

* FEATURE: Added Currencies extension in the wp-admin -> Classifieds -> Options panel.
* FIXED: Warning in the Classifieds List block when using default_image_url option.
* FIXED: XSS vulnerability in the Classifieds Search block.
* FIXED: In mobile view, the Ad details table is overflowing on the data below. 
* FIXED: "show phone" link not working on Ad details pages.

= 2.2.3 - 2025-04-22 =

* FIXED: Vulnerability in the Classifieds Single Date Table block
* FIXED: Vulnerability in the Classifieds Single Author block
* FIXED: Reverted wrapping the long titles in the Classifieds List block

= 2.2.2 - 2025-04-01 =

* FIXED: XSS vulnerability in the [adverts_block] shortcode
* FIXED: correctly wrapping the long titles in the Classifieds List block
* API: wpadverts/blocks/list/pagination/params filter allows customizing paginate_links() function params in the Classifieds List block.

= 2.2.1 - 2025-02-03 =

* FEATURE: Option to sort Classifieds List block items randomly.
* FEATURE: Option to enter custom login and registration URLs in the Classifieds Publish block.
* FEATURE: core::on_manage_to_pending_notify_admin email sent to administrator when Ad was updated in the Classified Manage block and needs moderation.
* FEATURE: Some blocks styling optimization.
* FIXED: Remove the contact options and show a notification when viewing the expired Ad details page.
* FIXED: Some emails compatibility with the Multiverse extension.
* FIXED: Using not not-callable function in the Emails will no longer cause a fatal error.
* FIXED: Stripe credit card field not loading correctly if Stripe is the default payment method.
* FIXED: "Your ad has been put into moderation …" message showing in an incorrect place.
* API: wpadverts/block/manage/update/moderate action

= 2.2.0 - 2024-12-02 =

* FEATURE: Additional configuration options for the Classifieds Single Author block.
* FEATURE: Additional configuration options for the Classifieds Single Contact block.
* FEATURE: Ad details pattern with contact details in the sidebar.
* FEATURE: Updated Autonumeric JavaScript library (it is being used with the Price input).
* FEATURE: REST API is enabled by default for the "advert" Custom Post Type.
* FIXED: Classifieds Manage block not working with post type different than 'advert'
* FIXED: Warning when checking if *_block() function exists.
* LANUGAGE: Updated German translation.
* API: adverts_show_in_rest filter

= 2.1.8 - 2024-11-19 =

* FIXED: XSS in the [adverts_manage] shortcode.
 
= 2.1.7 - 2024-10-29 =

* FIXED: XSS when loading contact details.
* FIXED: Nonce validation when revealing contact details on the Ad details pages.
* FIXED: Gallery icon showing on Ad details pages even when there are no images uploaded.
* FIXED: Fatal error when null is passed to adverts_filter_money() function.

= 2.1.6 - 2024-08-19 =

* API: The minified Tailwind CSS file was renamed and moved to /assets/css folder.
* FIXED: Improvments and fixes for the new slider to better integrate it with various themes.
* FIXED: wpadverts-blocks-editor-search stylesheet generates incorrect version number.
* FIXED: Use 'echo esc_attr()' instrad of 'esc_attr_e()' function where appropriate.

= 2.1.5 - 2024-08-08 =

* FEATURE: Redesigned Gallery Block - the block is now more intuitive to use, is responsive and supports touch navigation.
* FEATURE: In the Classifieds List Block you can enable image slider to allow users to see images without going into Ad details.
* FEATURE: Added Radio button preview to the wp-admin / Classifieds / Options / Default Styles preview.
* FIXED: Loading images for both grid and list view in the Classifieds List block.
* FIXED: Changing price color in the Classifieds List block does not work.
* API: To revert to the old Gallery add in your wp-config the define("WPADVERTS_BLOCK_GALLERY_USE_OLD", true); line.

= 2.1.4 - 2024-07-16 =

* FIXED: Blocks trying to load JavaScript file that does not exist.
* FIXED: Multiselect input not inheriting the styling correctly in the block mode.

= 2.1.3 - 2024-03-18 =

* FIXED: XSS vulnerability in administration panel.
* FIXED: Patched CSFR vulnerability. 
* FIXED: Replaced esc_attr_e() functions with esc_attr() where applicable.
* FEATURE: Compiled blocks using updated libraries (improved performance when using blocks in the wp-admin panel).

= 2.1.2 - 2024-02-19 =

* FIXED: List Data input not working correctly in the Classifieds Manage block
* FIXED: Contact Phone button in Contact Block should be hidden when the phone is not provided.
* FIXED: Changes to some phrases in the wp-admin / Classifieds / Options to make them more self explanatory.
* FIXED: $_checksum_args property missing (causing a notice/warning in the Classifieds Publish block). 
* FIXED: Selecting "None" in the taxonomy rendering option is not working correclty.
* FIXED: Data Table block not filtering fields correclty by the include_fields option.
* FIXED: Classifieds Search block not loading CSS code.
* FIXED: Not possible to move the Single Notification block.
* API: wpadverts/block/single-contact/contact-options filter added.
* API: wpadverts/block/field/types filter allows registering new field types.
* API: Introduced is_visible property to the contact options API 

= 2.1.1 - 2023-11-15 =

* FEATURE: More accurate field type classes in the HTML code generated for the block inputs.
* FIXED: Block Single Data Table not filtering by exclude_fields correctly.
* FIXED: Block Single Value generating a fatal error.
* FIXED: Custom Post Types and Taxonomies not restoring correctly in the wp-admin / Classifieds / Options / Core / Types panel.
* FIXED: Block "radio" inputs generating with incorrect name (with a [] at the end).
* FIXED: In the block rendering checking if {input}_block is a function name.
* API: wpadverts/block/tpl/wrap/value filter added to the wpadverts_block_tpl_wrap() function.
* API: adverts_manage_edit_back_button filter in [adverts_manage]
* API: adverts_manage_edit_public_link filter in [adverts_manage]
* LANGUAGE: Updated German translation.

= 2.0.0 - 2022-07-21 =

* Notes trimmed

= 1.0 - 2015-08-11 =

* First Release *

== Screenshots ==

1. Ads Search and List blocks displayed in a grid mode.
2. Ads Search and List blocks displayed in a list mode.
3. Ads list on a mobile device.
4. Ads grid on a mobile device.
5. Quickly customize dozens of display options directly from the wp-admin panel.
6. Match your theme styling using the Styling Editor.
7. Ad details page.
8. Ad details page on a mobile device.
9. Publish Ad Form - allow anonymous and/or registered users to post ads.
10. Management Panel - allow users to manage their own ads.
11. List available categories () 
12. Ads list in wp-admin panel.
13. Ad edit page in wp-admin panel.
14. Category edition with icon select.
15. Options, modules and premium extensions.
16. Payment history - if you are planning to charge users for posting Ads.
17. Payment details.

== Upgrade Notice ==

= 1.0 - 2015-08-11 =

* Just try it, you will like it.
