=== SiteCurb Listings ===
Contributors: sitecurb
Tags: real estate, listings, realtor, property, shortcode
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show a real estate agent's SiteCurb listings on any page with one shortcode: photos, price, beds and baths in a grid that matches your theme.

== Description ==

**SiteCurb Listings** puts an agent's current listings on a WordPress site — a brokerage site, a team site, a personal blog — without re-entering anything. The listings are managed once on [SiteCurb](https://sitecurb.com/), and this plugin shows them wherever you drop the shortcode.

    [sitecurb_listings]

Each card shows the first photo, the price, the headline, the city and state, and the facts (beds, baths, square feet), and links to the full listing page. Sold and pending listings carry a tag.

= Features =

* **One shortcode** — `[sitecurb_listings]` uses the site set on the settings page; every option can be overridden per shortcode
* **Responsive grid** — 1 to 4 columns, inherits your theme's fonts and colours
* **Status filter** — show active listings only (default), sold, pending, or everything
* **Featured only** — `featured="yes"` for a homepage highlight strip
* **Cached** — listings are fetched from SiteCurb and kept for 15 minutes (configurable), so pages stay fast and nothing is fetched on every view
* **No JavaScript, no external scripts** — one small stylesheet, loaded only on pages that show listings
* **Multiple agents** — use `site="..."` to show different agents on different pages of a brokerage site

= Shortcode reference =

* `site` — the agent's SiteCurb address: `jane`, `jane.sitecurb.com`, or a connected custom domain. Defaults to the site set under Settings → SiteCurb Listings.
* `limit` — number of listings to show, 1 to 50. Default 6.
* `columns` — 1 to 4. Default 3.
* `status` — `active`, `pending`, `sold` or `all`. Default `active`.
* `featured` — `yes` to show featured listings only. Default `no`.

Example: `[sitecurb_listings site="jane" limit="3" columns="3" featured="yes"]`

= Who is it for? =

Agents who already have a SiteCurb site and also appear on a brokerage or team WordPress site, and the web designers who build those brokerage sites. Add the shortcode once per agent and their listings stay current on both sites.

= Privacy =

The plugin fetches the public listings feed from the SiteCurb site you specify (`https://<your-site>/feed`). No visitor data is sent anywhere. The request is made by your server, not by your visitors' browsers.

== Installation ==

1. Install and activate the plugin.
2. Go to **Settings → SiteCurb Listings** and enter your SiteCurb site address (e.g. `yourname.sitecurb.com`).
3. Add `[sitecurb_listings]` to any page or post, or use the Shortcode block.

You need a published SiteCurb site. Sites are free to build at [sitecurb.com](https://sitecurb.com/).

== Frequently Asked Questions ==

= Do I need an account or an API key? =

No. Published SiteCurb sites expose a public listings feed, and the plugin reads that. Only the site address is needed.

= How quickly do changes on SiteCurb show up on WordPress? =

Within the cache window, 15 minutes by default. Saving the settings page clears the cache immediately.

= Can I show more than one agent? =

Yes. Use the `site` attribute: `[sitecurb_listings site="jane"]` on one page and `[sitecurb_listings site="mark"]` on another.

= Does it include an MLS or IDX feed? =

No. It shows the listings an agent has added to their SiteCurb site.

= What does it look like? =

It inherits your theme. The stylesheet only sets the grid, the photo ratio and spacing; colours and fonts come from your theme, so it looks native.

== Screenshots ==

1. A three-column listings grid on a standard theme.
2. The settings page.

== Changelog ==

= 1.0.0 =
* First release.
