=== Estatequay ===
Tags: real estate, property listings, openimmo, kyero, mcp
Requires at least: 6.5
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Real estate listings for WordPress: agents' feeds and private offers, an approval workflow, ad rules for Germany and Spain, and a read-only MCP endpoint.

== Description ==

Estatequay ("estate" + "quay", the property harbour) brings property listings to a WordPress site:
from estate agents' software and from private owners.

* **Listings and providers** as their own post types. Estate agents deliver by SFTP inbox or by feed
  URL; private offers are entered by the editorial team.
* **Approval workflow**: new listings of an agent wait for approval; holds name their reason; a
  refusal carries a reason to the provider; every decision is logged on the listing.
* **Private offers expire** after 60 days. A week before, the owner gets signed links to keep the
  listing online or take it offline, no login needed.
* **Trust and safety**: "estate agent" or "private offer" on every listing, a safety note above the
  contact form, a "report this listing" link, enquiries by relay form (no address on the page,
  nothing stored but a counter), photos stripped of GPS and camera data.
* **For agents**: own login and area, an e-mail report after every delivery, OpenImmo-Feedback XML
  attached to enquiries, monthly enquiry statistics per listing, a test inbox that changes nothing.
* **Formats**: OpenImmo import (the German standard) with full and partial sync and a guard against
  mass withdrawal; Kyero v3 import (Spain), also from a feed URL that is fetched regularly.
* **Ad rules** for Germany (energy certificate details, § 87 GModG) and Spain (energy letters,
  regional tourist-rental numbers, agents' register numbers in Catalunya and Valencia, the DIA note in
  Andalucía, rent rules).
* **Languages**: English, German (informal and formal) and Spanish; numbers, money and dates follow
  the site's language.
* **AI-ready**: an optional read-only MCP endpoint at `/<slug>/mcp` with the tools search_listings,
  get_listing and list_agents (WordPress 6.9 or later, Abilities API). It serves only what the public
  pages show.

== Installation ==

1. Upload the zip under Plugins → Add New → Upload Plugin, then activate it.
2. Settings live on the imports page of the plugin's admin menu: site name, contact address, area,
   URL segment, market (de, es).
3. Put the shortcode `[estatequay]` on the page that lists the properties.
4. Agents' inboxes are created under `<parent of the WordPress folder>/private/immo-inbox/`. Where that
   folder is not writable, define `ESQ_INBOX` in wp-config.php. A system cron that runs
   `wp immo run` every few minutes is recommended over WP-Cron.

== Changelog ==

= 1.0.0 =
* First public release.
