Realtor starter

Valeria Montoya is a real estate agent on the San Francisco Peninsula who doesn't exist, selling homes in San Carlos, Belmont, San Mateo and Burlingame. Every page is filled in, in English and in Spanish, so the site works the moment it's installed. Every template opens with a comment that explains what it does, which makes it a good one to learn from.

What's in it

• Listings that keep themselves current: her own homes first, then other agents'. Mark a home Sold and it leaves the search, joins the recent sales and moves the town's median price.
• Home search by town, price, bedrooms, bathrooms and status, at an address a buyer can share.
• The whole site in Spanish at /es/…, with an EN / ES switch on every page. Homes and towns need no second copy: one record shows in both languages.
• Private listings: buyers join the private list, are signed in at once, and see homes that aren't on the open market yet.
• Just-listed emails: visitors sign up from any page, and one Bulk Send tells them all about her newest home.
• Neighborhood pages with schools, commute, homes for sale and the median price of recent sales.
• Open houses that hide themselves once they're over, video tours, and a payment calculator on every home for sale.
• A home valuation form, showing requests and a contact form, each saved in the admin and emailed to her, plus an A/B test of the home page.

What you change first

• Agent details. Agent Info in the admin holds her name, phone, office, license line, brokerage, the home page words, her story and portrait, and the rates the calculator uses, each with an English and a Spanish box.
• Listings, towns and testimonials. Each is its own collection. Other agents' homes can come in from a CSV file through the admin's importer. Replace the demo testimonials with real ones before launch.
• Photos. The demo photos and the video tour come from Pexels and are credited in CREDITS.md. The headshot is a stock portrait of a real person, so replace it with the agent's own.
• A login for the agent. An account in the agent group can edit listings, towns and testimonials and send the Just-listed email, but can't change settings or templates.

The Just-listed email goes out through the job queue, so the server needs a cron entry; the README has the line. PHP's intl extension keeps the Spanish pages' dates in Spanish. Rules such as NAR's Clear Cooperation Policy can limit marketing a home before it's on the MLS, so check them before using private listings for real. The site's /readme page gives a tour and a list of what to change before you go live.