=== Raatt's Classified Ads ===
Contributors: mattfaler
Tags: classifieds, classified ads, listings, marketplace, ads
Requires at least: 6.2
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A standalone classified ads plugin with front-end posting, user accounts, search, favorites, seller contact and automatic expiry.

== Description ==

Raatt's Classified Ads is a self-contained classifieds system. It does not require any other plugin.

* Listings post type with categories and locations (hierarchical).
* Price, price type (fixed / negotiable / free / contact), condition, contact phone/email, address and coordinates.
* Front-end registration, login and an account dashboard ([rca_account]): my listings (edit, delete, mark sold, renew), favorites, profile.
* Front-end posting form ([rca_submit]) with image uploads, moderation (hold for review or publish immediately).
* Listings page ([rca_listings]) with keyword/category/location/price search, sorting, pagination and list/grid views.
* Single listing view with image gallery, contact-the-seller form (honeypot + rate limit) and report listing.
* Listings expire automatically (daily cron) and can be renewed.
* Templates can be overridden by copying files from `templates/` to `yourtheme/raatts-classified-ads/`.

== Shortcodes ==

* `[rca_listings per_page="12" category="slug" location="slug" view="grid|list" show_search="yes|no"]`
* `[rca_submit]`
* `[rca_account]`

Pages with these shortcodes are created automatically on activation and can be changed under Classifieds > Settings.

== Developer hooks (selection) ==

Filters: rca_meta_fields, rca_price_types, rca_conditions, rca_search_params, rca_search_query_args, rca_sort_options, rca_account_tabs, rca_submit_validation_errors, rca_contact_mail, rca_report_reasons, rca_locate_template, rca_format_price, rca_post_type_args.
Actions: rca_listing_saved, rca_listing_sold, rca_listing_renewed, rca_listing_expired, rca_listing_deleted, rca_listing_reported, rca_seller_contacted, rca_user_registered, rca_favorite_added, rca_favorite_removed, rca_submit_form_fields, rca_single_listing_after_details, rca_listing_card_after, rca_settings_page_after.

== Uninstall ==

Deleting the plugin keeps all data unless "Delete all data on uninstall" is checked in the settings.

== Changelog ==

= 0.1.0 =
* First release.

== Copyright ==

Copyright (c) 2026 Matt Faler. Released under the GNU General Public License v2 or later.
