homeproz/FEATURES_PENDING_12_15.md

# HomeProz Website - Pending Features Analysis
**Date:** December 15, 2025
**Compiled by:** Hanson Development
**Status:** Internal Review Document (Not for Client Distribution)

---

## Executive Summary

This document consolidates feedback from multiple stakeholders (Dayna, Sonny, Anna, Davy, Brian Haugen) collected in early December 2025. Features are grouped by category, scored, and include implementation recommendations.

**Scoring Scale:**
- **Feasibility:** How technically achievable (Trivial / Easy / Moderate / Complex / Impractical)
- **Priority:** Business importance per stakeholder emphasis (Low / Medium / High / Critical)
- **Practicality:** ROI vs effort ratio (Poor / Fair / Good / Excellent)
- **Recommendation:** Overall verdict (Skip / Defer / Consider / Implement / Must-Do)

---

## Category 1: MLS Integration & Property Display

### 1.1 Co-Listing Agent Support
**Description:** Allow multiple agents to be displayed on a single property listing when co-listed.

**Requested by:** Davy
**Details:** Davy noticed only one agent shows on co-listed properties. Dayna confirmed "each property will include space for additional realtors/agents."

| Metric | Score |
|--------|-------|
| Feasibility | Moderate |
| Priority | High |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** MLS data includes co-listing agent fields (CoListAgentKey, CoListAgentMlsId, etc.). Requires schema update to store and display multiple agents per listing. The MLS API provides this data - we just need to capture and render it.

**Implementation Notes:** Update `class-mls-db.php` to store co-agent data, update property templates to display both agents with proper attribution.

---

### 1.2 Featured Photo Control
**Description:** Ensure the main cover photo from MLS is used as the featured photo, with ability to override.

**Requested by:** Davy, Dayna
**Details:** Davy noted featured photos didn't match MLS during presentation. Dayna confirmed "each property's featured photo will carry over from MLS or you can edit or choose whichever photos you would like."

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | High |
| Practicality | Excellent |
| Recommendation | **Must-Do** |

**Analysis:** MLS media has `Order` field - image with Order=1 should be primary. This should already work based on our media ordering system. May need verification and possible admin override capability.

**Implementation Notes:** Verify `media_order` is respected. Consider adding ACF field for manual override if needed.

---

### 1.3 Sold/Pending Properties Display
**Description:** Show pending and sold properties, possibly on a dedicated "Results" page.

**Requested by:** Davy, Anna, Dayna, Brian Haugen
**Details:**
- Davy wants "running list or Sold in the last year column" to show sales success
- Anna believes "Brian mentioned that is in the works"
- Dayna says "we will need to discuss how and where we would like these to sort and appear - perhaps a results page!"
- Meeting transcript confirms sold/pending display is expected

| Metric | Score |
|--------|-------|
| Feasibility | Complex |
| Priority | High |
| Practicality | Fair |
| Recommendation | **Consider** |

**Analysis:** Current sync strategy DELETES sold/pending-changed-to-closed properties per MLS Grid best practices. Showing sold properties requires:
1. Changing sync strategy to retain closed listings (storage implications - 1.3M vs 30K records)
2. OR maintaining a separate "sold by us" table
3. Time-boxing (last 12 months) to limit scope

**Contradictions/Concerns:**
- MLS Grid rules may restrict display of sold properties
- Storage/performance impact of keeping closed listings
- Need clarification: show ALL sold in area, or only OUR sold listings?

**Recommendation:** Create manual "Results/Success Stories" section where agents can highlight their closed deals rather than automated MLS sync of all closed properties. This is more practical and better marketing.

---

### 1.4 Geolocation Search ("Properties Near Me")
**Description:** Add location-based property search using browser geolocation.

**Requested by:** Sonny, Dayna
**Details:**
- Sonny: "Could do an all properties near you under featured properties. and have the website do a 'allow website your location' when you open it. Similar to Keller williams realty on mobile."
- Dayna: "add geolocation to search (properties near me)"

| Metric | Score |
|--------|-------|
| Feasibility | Moderate |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Database already has lat/lng columns with indexes (added this session). Implementation requires:
1. Browser Geolocation API prompt
2. Distance calculation query (or bounding box filter)
3. "Near Me" button/section on homepage and search

**Implementation Notes:** Use bounding box query first, then haversine formula for precise sorting. Already have index infrastructure from this session's work.

---

### 1.5 Expanded Search Filters
**Description:** Add property type, zip code, and additional search criteria.

**Requested by:** Sonny, Dayna
**Details:**
- Dayna: "Expand out search (Select a community.... Do we like that? Add additional? Search by zip?)"
- Dayna: "Add property type to search and at bottom like Edina Realty - commercial, new construction, acreages, town homes, etc."
- Sonny: "Could add 'specialty real estate' boxes -commercial, new construction, acreages, town homes, etc.- on the bottom like Edina Realty"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | High |
| Practicality | Excellent |
| Recommendation | **Implement** |

**Analysis:** Database already has `property_type`, `property_sub_type`, `postal_code` columns. Query class supports these filters. Just need UI additions.

**Implementation Notes:** Add filter dropdowns to search form. Add property type quick-filter boxes on homepage.

---

### 1.6 Property Type Showcase Boxes
**Description:** Add category boxes on homepage for Commercial, Acreages, New Construction, Townhomes, etc.

**Requested by:** Sonny, Dayna, Anna
**Details:**
- Sonny: "specialty real estate boxes... like Edina Realty, with boxes and when we integrate IDX have it populate accordingly"
- Anna: "We've branded HomeProz specialty as 'Residential, Acreages, and Commercial'... but this website currently only reflects Homes"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | High |
| Practicality | Excellent |
| Recommendation | **Implement** |

**Analysis:** Simple UI component with links to filtered search results. Supports brand positioning.

---

## Category 2: Visual Design & UX

### 2.1 Texture/Luxury Aesthetic
**Description:** Add texture overlays to solid colors (grey/black) for more luxury feel.

**Requested by:** Sonny, Dayna
**Details:**
- Sonny: "add some sort of texture to solid colors (the grey and black) to make it feel more luxury and produced"
- Dayna: "Add some texture to the Entire site - adds visual interest while keeping it modern and polished"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** CSS-only change. Add subtle noise/grain texture overlay to dark backgrounds.

**Bikeshedding Risk:** "Luxury" is subjective. Get sign-off on specific texture samples before site-wide implementation.

---

### 2.2 Hover Animations
**Description:** Add hover effects to elements like "Our Story" and "Our Mission" titles.

**Requested by:** Sonny, Dayna
**Details:**
- Sonny: "'our story' & 'our mission' have them toggle so the words appear if clicked on or hovered over. (cleans up home page for mobile, less clutter)"
- Dayna: "Some visual animations - ex when hovering over Our Story or Our Mission - have the titles expand and bold"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Low |
| Practicality | Fair |
| Recommendation | **Consider** |

**Analysis:** Simple CSS transitions. However, CLAUDE.md explicitly states "No custom animations - keep it static and fast."

**Contradiction:** Project rules say no animations, but client wants them.

**Recommendation:** Clarify with client - subtle hover states (bold, underline) are fine. Avoid complex animations that conflict with project principles. Propose simple hover states rather than toggle/expand behavior.

---

### 2.3 4K/High-Quality Stock Images
**Description:** Replace placeholder images with high-quality 4K stock photos.

**Requested by:** Sonny
**Details:** "make sure photos that are not agent related like (personal agent page) are all 4k and top notch photos" and "add new header picture off stock images 4k with logo"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Content task, not development. Need to source and optimize images.

**Implementation Notes:** Client needs to provide or approve stock image purchases. Optimize for web (not literally 4K - that's overkill for web).

---

### 2.4 Logo Consistency
**Description:** Update logos throughout site, ensure mobile consistency, use condensed HP logo.

**Requested by:** Dayna, Anna, Sonny
**Details:**
- Dayna: "Updated HP logos and be consistent on mobile"
- Anna: "We don't have our condensed HP logo anywhere on here... and it's so awesome! Need it on here"
- Sonny: "top left 'homeproz' change that to a logo or do all caps to make it look uniform"

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | High |
| Practicality | Excellent |
| Recommendation | **Must-Do** |

**Analysis:** Branding consistency is important. Need assets from client.

**Implementation Notes:** Request condensed logo SVG from client. Update header, mobile nav, favicon.

---

### 2.5 Mobile Homepage Optimization
**Description:** Make homepage sections more compact on mobile to reach listings faster.

**Requested by:** Sonny
**Details:** "make 'go with the proz, sell your home, find a home, resources and guides' smaller and side by side on mobile so it goes to listed properties faster"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** CSS/responsive layout adjustment. Good UX improvement.

---

## Category 3: Team/Agent Pages

### 3.1 Agent Page Redesign (LandProz Style)
**Description:** Redesign agent cards/pages to match LandProz model with boxes instead of PNG backgrounds.

**Requested by:** Sonny, Dayna
**Details:**
- Sonny: "Make the meet our team page (about page) like landproz model"
- Sonny: "do the per agent in boxes not a png background like how landproz is *4k stock image of a house (looks cleaner and less cookie cutter)"
- Dayna: "Build out meet our team page - updated high quality headshots, improved background photos, bios, reviews"

| Metric | Score |
|--------|-------|
| Feasibility | Moderate |
| Priority | High |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Requires design reference from LandProz site. Template refactoring needed.

**Implementation Notes:** Need access to LandProz site for reference. May need new headshot photos from agents.

---

### 3.2 Agent Tiers/Categories
**Description:** Categorize agents by role/level (Leadership, Elite, etc.)

**Requested by:** Sonny
**Details:** "Add categories of agents, (leadership, elite, show more agents)"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Medium |
| Practicality | Fair |
| Recommendation | **Consider** |

**Analysis:** Add taxonomy or ACF field for agent tier. Display in groups on team page.

**Potential Issue:** May create internal politics if agents disagree with their tier. Need clear criteria.

---

### 3.3 Agent Testimonials
**Description:** Allow testimonials/reviews on individual agent pages.

**Requested by:** Sonny, Dayna
**Details:**
- Sonny: "per agent page 'make it so we can add testimonials'"
- Dayna: "Build out meet our team page... reviews... and webforms to collect further feedback"

| Metric | Score |
|--------|-------|
| Feasibility | Moderate |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Add ACF repeater field for testimonials on agent post type. Or integrate with Google Reviews.

---

### 3.4 Agent Contact Info Placement
**Description:** Move contact info above listings on agent profile pages.

**Requested by:** Sonny
**Details:** "on per agent page have contact info on top of listings not below (right below biography)"

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | Medium |
| Practicality | Excellent |
| Recommendation | **Implement** |

**Analysis:** Template reordering. Simple change.

---

### 3.5 Agent Biographies & Personal Photos
**Description:** Add detailed bios and personal photo galleries to agent pages.

**Requested by:** Sonny, Dayna
**Details:**
- Sonny: "per each agent have them write out a biography and add personal photos to their agent page"
- Dayna: "bios... their properties"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** ACF fields already exist for bio. May need gallery field addition. Content from agents required.

---

### 3.6 New Headshots
**Description:** Get professional updated headshots for all agents.

**Requested by:** Sonny, Dayna
**Details:** "get new headshots" / "updated high quality headshots"

| Metric | Score |
|--------|-------|
| Feasibility | N/A (content task) |
| Priority | High |
| Practicality | Good |
| Recommendation | **Client Action Required** |

**Analysis:** Not a development task. Client needs to arrange photography session.

---

### 3.7 Expanded Team Members
**Description:** Add non-agent team members (broker, marketing, officers, production staff).

**Requested by:** Anna, Dayna
**Details:**
- Anna: "I definitely agree that we need to include the entire team including broker, marketing team, officers, etc in meet the team, so it's a true reflection of the experience we have backing HomeProz"
- Dayna: "Add additional team members - owners, office, production ect with outlines of each and what they do (experience and results focused)"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Use existing Agent post type with role/category field to differentiate. Or create separate Staff post type.

---

### 3.8 Agent State Licenses
**Description:** Ensure each agent profile shows correct state licensure.

**Requested by:** Sonny, Dayna
**Details:**
- Sonny: "make sure each agent has correct states"
- Dayna: "I will need any additional license numbers you all hold and I'll add that to the footer"

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | High |
| Practicality | Excellent |
| Recommendation | **Must-Do** |

**Analysis:** Legal requirement. Add/verify ACF field for licensed states per agent.

---

## Category 4: Contact & Forms

### 4.1 Property Inquiry Form Auto-Population
**Description:** Contact form should auto-populate with property address/link that cannot be edited by user.

**Requested by:** Brian Haugen (meeting)
**Details:** From transcript: "Brian Hanson will make the property request form automatically populate with the address or a link to the MLS listing, which must not be editable by the user, and should be sent to an office email, while still allowing a personalized message."

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Critical |
| Practicality | Excellent |
| Recommendation | **Must-Do** |

**Analysis:** Use hidden field or read-only display field populated from URL parameter. Already have `?property=` parameter support documented.

**Implementation Notes:** Add hidden/readonly field to contact form. Ensure it's tamper-resistant (server-side validation).

---

### 4.2 Multi-Recipient Email Routing
**Description:** Form submissions go to both the listing agent AND office email.

**Requested by:** Dayna, Anna
**Details:**
- Dayna: "When someone fills out a web form it will send that entry to the agent plus office@homeprozrealestate.com"
- Anna: "Wondering if more than one person can receive emails sent to info@homeprozrealestate.com"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | High |
| Practicality | Excellent |
| Recommendation | **Implement** |

**Analysis:** Contact Form 7 or similar supports multiple recipients. Configure CC/BCC to office address.

---

### 4.3 Office Hours Update
**Description:** Update footer office hours.

**Requested by:** Davy
**Details:**
```
Office Hours
Mon-Fri 9:00am - 4:00pm
Saturday By Appointment
Sunday By Appointment
```

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | Medium |
| Practicality | Excellent |
| Recommendation | **Implement** |

**Analysis:** Simple theme options update.

**Status:** COMPLETED 2025-12-16 - Updated site-footer.php: Mon-Fri 9:00am - 4:00pm, Sat/Sun By Appointment

---

## Category 5: Footer & Legal

### 5.1 Broker Footer Update
**Description:** Update broker attribution in footer with correct legal text.

**Requested by:** Dayna
**Details:** "broker footer will be updated to: HomeProz Real Estate LLC DBA LandProz Real Estate, LLC | 111 East Clark Street, Albert Lea, MN 56007 - 507-516-4870"

Also: "Broker Brian Haugen - MN | Broker/Auctioneer Greg Jensen - MN, IA - 24-21"

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | Critical |
| Practicality | Excellent |
| Recommendation | **Must-Do** |

**Analysis:** Legal requirement. Simple text update.

**Note:** Davy spotted "Bridge Realty" text somewhere - needs to be found and removed.

---

### 5.2 Phone Number Update
**Description:** Update main contact number throughout site.

**Requested by:** Dayna, Davy
**Details:**
- Dayna: "507-516-4870 is the Minnesota state advertising phone number... We will need to choose a number you want as HomeProz main contact number... (Will provided updated new phone number- dayna to purchase and add to phone system)"
- Davy: "IDK whose number that is" (referring to current placeholder)

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | Critical |
| Practicality | Excellent |
| Recommendation | **Must-Do** |

**Analysis:** Update theme options. Awaiting final number from Dayna.

**Blocker:** Need confirmed phone number from client.

---

### 5.3 Service Area Update (MN + IA)
**Description:** Update service area from "Southern Minnesota" to include Iowa.

**Requested by:** Dayna, Davy
**Details:**
- Dayna: "Right now the site reads 'Southern Minnesota'. How would we like to present this? Southern MN and Northern IA? or Minnesota and Iowa?" Answer: "Minnesota and Iowa (for service areas)"
- Davy: "Should we have this say and Northern Iowa? We don't have any in IA right now but when we do..."
- Davy also asked "This is on the bottom but I am wondering if we need it to say IA too since I have an IA license?"

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | High |
| Practicality | Excellent |
| Recommendation | **Implement** |

**Analysis:** Text/content update. Confirmed decision: "Minnesota and Iowa"

---

## Category 6: Reviews & Social Proof

### 6.1 Google Reviews Integration
**Description:** Automatically pull and display Google Reviews on website.

**Requested by:** Anna, Dayna
**Details:**
- Anna: "Google Review process" / "A place to view past Testimonials and new ones"
- Dayna: "Google reviews can be automated to your website"

| Metric | Score |
|--------|-------|
| Feasibility | Moderate |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Requires Google Places API integration or third-party widget. Several WordPress plugins available.

**Implementation Notes:** Recommend plugin like "Widget for Google Reviews" for simplicity. Or custom integration if more control needed.

---

### 6.2 Community Involvement Section
**Description:** Showcase photos/videos of community events and involvement.

**Requested by:** Davy, Anna, Dayna
**Details:**
- Davy: "I noticed he didn't include our 'In the Community' pics that we have on the bottom of our current page. That has our reviews in there and I would like to include all of those too"
- Anna: "a link for showcasing photos and videos with our community involvement to add the LOCAL aspect and relatability such as the Arcadian Bank event, Freeborn Co Fair video produced each year, and more"
- Dayna: "community involvement and reviews (need to include these and decide if it belongs on the about page or I can create a new page)"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Gallery/carousel section. Could be on About page or dedicated Community page.

**Decision Needed:** Standalone page vs section on About page?

---

### 6.3 Results/Success Page
**Description:** Dedicated page showing sold properties, reviews, and agent successes.

**Requested by:** Dayna
**Details:** "A results page would also be a good spot to collect and display reviews (agent profiles as well)"

| Metric | Score |
|--------|-------|
| Feasibility | Moderate |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Consider** |

**Analysis:** Combines sold properties display with testimonials. Better than trying to sync all closed MLS listings.

---

## Category 7: New Pages

### 7.1 Join Our Team / Careers Page
**Description:** Recruitment page for prospective agents.

**Requested by:** Sonny, Anna, Dayna
**Details:**
- Sonny: "add a 'Become a Homeproz agent' page and why we are better what we offer. Tech, residential auctions, in house marketing, etc."
- Anna: "Yes, we definitely need a 'Join our team' tab and share why"
- Dayna: "Add tired experience to meet our team page and button/form to employment application"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Medium |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Static content page with application form. Content needed from client about benefits/culture.

---

### 7.2 LandProz History on About Page
**Description:** Include backstory about LandProz 82-year history on About page.

**Requested by:** Anna
**Details:** "on the 'About HomeProz' page... I think we need to include a little back story about LandProz 82 year success story and how we're a division of LandProz, so it doesn't look like we're just a brand new stand alone pop up Broker without history, experience, knowledge."

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | Medium |
| Practicality | Excellent |
| Recommendation | **Implement** |

**Analysis:** Content addition. Need copy from client about LandProz history.

---

### 7.3 Additional Logos on About Page
**Description:** Add more partner/association logos to About page.

**Requested by:** Sonny
**Details:** "need more logos on about page"

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | Low |
| Practicality | Good |
| Recommendation | **Implement** |

**Analysis:** Content addition. Need logo assets and approval for which associations to display.

---

### 7.4 Buyers/Sellers Guide Enhancement
**Description:** Improve existing guides with more visual appeal.

**Requested by:** Sonny
**Details:** "I like it but it needs more of a flare, pictures maybe?"

| Metric | Score |
|--------|-------|
| Feasibility | Easy |
| Priority | Low |
| Practicality | Fair |
| Recommendation | **Defer** |

**Analysis:** Content/design polish. Lower priority than functional features.

---

## Category 8: Social & External Integrations

### 8.1 Additional Social Platform Links
**Description:** Add links to Instagram, LinkedIn, Google My Business, etc.

**Requested by:** Dayna, Anna
**Details:**
- Dayna: "Additional social platforms can be linked as you build them (Instagram, linkedIn, Google my Business ect)"
- Anna: "Are we on Instagram?"

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | Low |
| Practicality | Excellent |
| Recommendation | **Implement** |

**Analysis:** Add fields to theme options. Display in footer/header as icons.

**Blocker:** Client needs to create accounts first.

---

### 8.2 Email Migration to Google
**Description:** Migrate HomeProz email addresses to Google Workspace.

**Requested by:** Dayna
**Details:** "I need to move your existing HomeProz email addresses over to google and add a few like office@homeprozrealestate and info@homeprozrealestate."

| Metric | Score |
|--------|-------|
| Feasibility | N/A (not dev task) |
| Priority | High |
| Practicality | Good |
| Recommendation | **Client/IT Action Required** |

**Analysis:** Infrastructure task, not website development. Coordinate with launch timing.

---

## Category 9: Technical/Infrastructure

### 9.1 Bridge Realty Text Removal
**Description:** Find and remove errant "Bridge Realty" text from site.

**Requested by:** Davy
**Details:** "This says Bridge Realty ??" (with screenshot reference)

| Metric | Score |
|--------|-------|
| Feasibility | Trivial |
| Priority | Critical |
| Practicality | Excellent |
| Recommendation | **Must-Do** |

**Analysis:** Bug/error from template or previous site. Need to search codebase for "Bridge Realty" and remove.

---

## Priority Summary

### Must-Do (Critical)
1. Broker footer legal text update (5.1) - COMPLETED 2025-12-16: Updated site-footer.php with correct broker info
2. Phone number update (5.2) - AWAITING: Client needs to confirm final phone number
3. Property inquiry form auto-population (4.1) - COMPLETED 2025-12-16: CF7 hidden field, read-only display box, sends to office@homeprozrealestate.com
4. Featured photo from MLS (1.2) - ALREADY WORKING: media_order=1 used as primary
5. Logo consistency (2.4) - AWAITING: Client needs to provide condensed HP logo SVG
6. Agent state licenses (3.8) - AWAITING: Client needs to provide license numbers
7. Bridge Realty text removal (9.1) - COMPLETED 2025-12-16: Removed from page-about.php, updated with correct LandProz DBA info

### High Priority (Implement)
1. Co-listing agent support (1.1)
2. Service area MN + IA (5.3) - COMPLETED 2025-12-16: Updated footer tagline to "Minnesota and Iowa"
3. Expanded search filters (1.5) - COMPLETED 2025-12-16: MLS property types, MLS cities (50+ listings), zip code input
4. Property type showcase boxes (1.6) - COMPLETED 2025-12-16: 5-box grid on homepage (Residential, Land, Commercial, Farm, Multi-Family)
5. Multi-recipient email routing (4.2) - COMPLETED 2025-12-16: Primary to office@, CC to info@, sender confirmation receipt
6. Agent page redesign (3.1)
7. Geolocation search (1.4)

### Medium Priority (Implement When Time Allows)
1. Texture/luxury aesthetic (2.1)
2. Mobile homepage optimization (2.5)
3. Agent testimonials (3.3)
4. Agent contact info placement (3.4)
5. Expanded team members (3.7)
6. Google Reviews integration (6.1)
7. Community involvement section (6.2)
8. Join our team page (7.1)
9. LandProz history content (7.2)

### Consider/Defer
1. Sold/pending properties display (1.3) - Complex, needs strategy discussion
2. Hover animations (2.2) - Conflicts with project rules
3. Agent tiers/categories (3.2) - Potential internal politics
4. Results/success page (6.3) - Good idea, needs scoping
5. Buyers/sellers guide enhancement (7.4) - Low impact

### Client Action Required
1. New headshots (3.6)
2. Email migration (8.2)
3. Social account creation (8.1)
4. High-quality stock images (2.3)
5. Content for various sections

---

## Contradictions & Notes

1. **Animation Policy:** CLAUDE.md says "No custom animations" but Sonny/Dayna want hover effects. Resolution: Implement subtle CSS transitions only, not complex JS animations.

2. **Sold Properties:** Multiple stakeholders want to show sold properties, but current MLS sync strategy deletes closed listings. Resolution: Manual "Results" section rather than MLS sync change.

3. **Service Area:** Initial uncertainty about "Southern MN" vs "MN and IA" - resolved as "Minnesota and Iowa"

4. **Phone Number:** Multiple references to needing correct number - awaiting final number from Dayna

5. **Team Tiers:** Sonny wants "Leadership, Elite" categories - could create internal friction. Needs careful handling.

6. **Design Reference:** Multiple references to "like LandProz" - need access to that site for design reference.

---

## Implementation Phases Recommendation

### Phase 1: Launch Blockers (Must complete before launch)
- Legal/footer updates
- Phone number
- Bridge Realty removal
- Form auto-population
- Logo consistency

### Phase 2: Core Features (First week post-launch)
- Co-listing support
- Search enhancements
- Property type boxes
- Agent page improvements
- Service area update

### Phase 3: Enhancements (Following weeks)
- Geolocation search
- Google Reviews
- Community section
- Careers page
- Visual polish (textures, etc.)

### Phase 4: Deferred/TBD
- Sold properties strategy
- Full agent tier system
- Buyers/sellers guide revamp

---

## Client Action Required for Launch

The following items are blocking final delivery and require client input:

| Item | What We Need | Status |
|------|--------------|--------|
| **Phone Number (5.2)** | Confirmed main contact number for HomeProz (Dayna to purchase and configure) | WAITING |
| **Condensed HP Logo (2.4)** | SVG file of condensed "HP" logo for header/mobile/favicon | WAITING |
| **Agent License Numbers (3.8)** | License numbers for each agent to display on profiles and footer | WAITING |
| **New Headshots (3.6)** | Professional photos for all agents | WAITING |
| **Stock Images (2.3)** | High-quality stock photos for hero sections (client to approve purchases) | WAITING |
| **Social Account URLs (8.1)** | Instagram, LinkedIn, Google My Business links once accounts are created | WAITING |

Once these items are received, implementation is trivial (text/image updates).

---

## Technical Notes (2025-12-16)

### MLS State Filter Implementation
All MLS queries now restricted to Minnesota (MN) and Iowa (IA) only:
- Added `MLS_ALLOWED_STATES` constant in `mls-by-hansonxyz.php`
- Added `get_state_filter()` private method in `class-mls-query.php`
- Applied to: `get_properties()`, `get_distinct_cities()`, `get_distinct_counties()`, `get_count()`, `has_data()`, `get_property_types()`, `get_price_range()`

This ensures all property searches, filters, and statistics only include MN/IA listings.