Listings, agents, and showing requests
Inventory is WordPress posts, not an MLS feed. Sample data is fiction. Replace it with your own photos and copy on a client site.
Who registers the types
- Acreline Core (recommended on a store install) owns
listing,agent, andbookingplus thekeystone/v1/bookingsREST route. Switching themes leaves those posts andks_*meta in the database. - If the plugin is off, the parent theme registers the same types so the concept demo keeps working.
Listings
wp-admin → Listings. Classic metabox “Listing details,” plus title, editor, and featured image. Types: Home, Working Farm, Land / Acreage, Historic Home. Statuses: Active, New, Pending, Sold.
| Field | Notes |
|---|---|
| Address, city, state, ZIP | Shown on the card and single. |
| Township | Filter values stay Cumberland / Straban / Franklin. Labels on the public site are North Ridge / Mill Creek / Oak Hollow. |
| Price, beds, baths, sqft, acres, year built | Used in search filters and listing cards. |
| MLS number | Display only — not a live feed. |
| Map pin top % / left % | Position on the concept map graphic, not lat/long of a real parcel. |
| Listing photo / virtual tour | Media library or URL. Do not keep Unsplash hotlinks on a client site. |
| Listing office | Optional brokerage attribution for IDX/MLS slots. Shown when Compliance → IDX attribution is on. |
| Listing agent | Agent post ID. |
| Featured | Homepage spotlight. |
Agents
License, MLS/NRDS, specialties, service areas, contact, and social fields. Assign an agent on each listing.
Bookings
The public Book a showing form POSTs to /wp-json/keystone/v1/bookings. A Booking post is created in Requested status. Advance it in wp-admin: Requested → Confirmed → Completed (or Cancelled). Nothing is emailed, texted, or added to a calendar. When form consent is on (Customize → Compliance), the request must include the checkbox; the Booking stores a consent flag and UTC timestamp.
Public links must use a numeric listing post ID:
/book/?listing_id=123
Do not use ?listing=123 as a public query — that string can collide with the listing post type and 404.
Showing types
- In-person tour
- Private preview
- Virtual walk-through
Search
The listings page filters by type, price, and area. Grid and map views read the same listing posts. The payment-estimate modal is a concept calculator, not a lender.