diff --git a/.beads/issues.jsonl b/.beads/issues.jsonl index 37dd4940..ca206367 100644 --- a/.beads/issues.jsonl +++ b/.beads/issues.jsonl @@ -1 +1,9 @@ +{"id":"html-2fp","title":"Separate Residential and Commercial listings on homepage","description":"","status":"open","priority":1,"issue_type":"task","created_at":"2025-11-30T02:24:09.984594683-06:00","updated_at":"2025-11-30T02:24:09.984594683-06:00"} +{"id":"html-3nq","title":"Enhance footer with office hours, professional logos, license numbers","description":"","status":"open","priority":3,"issue_type":"task","created_at":"2025-11-30T02:24:30.889106857-06:00","updated_at":"2025-11-30T02:24:30.889106857-06:00"} +{"id":"html-5bw","title":"Add service cards section (Buy/Rent/Sell) to homepage","description":"","status":"open","priority":1,"issue_type":"task","created_at":"2025-11-30T02:24:04.779591681-06:00","updated_at":"2025-11-30T02:24:04.779591681-06:00"} +{"id":"html-7jz","title":"Add Communities section to navigation and create community pages structure","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-11-30T02:24:15.204568226-06:00","updated_at":"2025-11-30T02:24:15.204568226-06:00"} +{"id":"html-98b","title":"Add location search dropdown to homepage hero","description":"","status":"open","priority":1,"issue_type":"task","created_at":"2025-11-30T02:23:59.555310037-06:00","updated_at":"2025-11-30T02:23:59.555310037-06:00"} +{"id":"html-bfd","title":"Update DESIGN-DOCUMENT.md and IMPLEMENTATION-PLAN.md with RHR structural changes","description":"","status":"closed","priority":0,"issue_type":"task","created_at":"2025-11-30T02:24:40.504170573-06:00","updated_at":"2025-11-30T02:28:50.551587345-06:00","closed_at":"2025-11-30T02:28:50.551587345-06:00","close_reason":"Updated DESIGN-DOCUMENT.md and IMPLEMENTATION-PLAN.md with RHR structural changes"} {"id":"html-clv","title":"Analyze Robert Hoffman Realty site structure for HomeProz redesign","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-11-30T02:11:43.511290155-06:00","updated_at":"2025-11-30T02:21:47.665340956-06:00","closed_at":"2025-11-30T02:21:47.665340956-06:00","close_reason":"Completed site analysis comparing RHR to HomeProz design"} +{"id":"html-cpd","title":"Add map view to property listings archive page","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-11-30T02:24:20.442584472-06:00","updated_at":"2025-11-30T02:24:20.442584472-06:00"} +{"id":"html-t8u","title":"Add Resources section to navigation and create resource pages","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-11-30T02:24:25.662824938-06:00","updated_at":"2025-11-30T02:24:25.662824938-06:00"} diff --git a/.claude/settings.local.json b/.claude/settings.local.json index bdf1b6d8..26450a37 100755 --- a/.claude/settings.local.json +++ b/.claude/settings.local.json @@ -24,7 +24,9 @@ "Bash(bd doctor:*)", "Bash(bd setup:*)", "Bash(bd update:*)", - "WebFetch(domain:www.roberthoffmanrealty.com)" + "WebFetch(domain:www.roberthoffmanrealty.com)", + "Bash(bd create:*)", + "Bash(bd ready:*)" ], "deny": [], "ask": [] diff --git a/contract/Contracts/WordPress-Website/_scratch/site_analysis/DESIGN-DOCUMENT.md b/contract/Contracts/WordPress-Website/_scratch/site_analysis/DESIGN-DOCUMENT.md index 235db0b0..302b5e4c 100755 --- a/contract/Contracts/WordPress-Website/_scratch/site_analysis/DESIGN-DOCUMENT.md +++ b/contract/Contracts/WordPress-Website/_scratch/site_analysis/DESIGN-DOCUMENT.md @@ -126,15 +126,26 @@ Homepage ├── Properties (Listings Archive) │ ├── Property Detail Page (single-property.php) │ └── ... +├── Communities (NEW - location-based pages) +│ ├── Albert Lea +│ ├── Austin +│ ├── Glenville +│ ├── Emmons +│ └── [other served areas] ├── About Us │ └── Individual Agent Pages (optional) -├── Services (optional) +├── Resources (NEW - buyer/seller guides) +│ ├── Buyer's Guide +│ ├── Seller's Guide +│ └── Market Info ├── Blog/News (archive + single posts) │ └── Blog Post (single.php) ├── Contact └── Legal Pages (Privacy Policy, Terms) ``` +> **Note**: Site structure expanded based on competitor analysis (Robert Hoffman Realty). Communities and Resources sections add SEO value and demonstrate local market expertise. + ### 4.2 WordPress Template Hierarchy The theme will include the following template files: @@ -153,6 +164,9 @@ The theme will include the following template files: | `404.php` | Not found page | | `header.php` | Global header | | `footer.php` | Global footer | +| `page-community.php` | Community/location page template (NEW) | +| `page-resources.php` | Resources landing page (NEW) | +| `template-resource.php` | Individual resource page (guides) (NEW) | ### 4.3 Page Templates (User-Selectable) @@ -168,68 +182,117 @@ These templates will be available in the WordPress page editor: ### 4.2 Homepage Layout (Top to Bottom) +> **Updated based on Robert Hoffman Realty competitor analysis** + #### Section 1: Header (Sticky) - Logo (left) -- Navigation: Properties | About | Contact (center/right) +- Navigation: Properties | Communities | About | Resources | Contact (center/right) - Phone number CTA button (right) - Mobile: Hamburger menu #### Section 2: Hero -- Full-width background image/video +- Full-width background image/video (local landmark or property photo) - Headline: "Find Your Dream Home Today" (Abril Fatface) -- Subheadline: "Expert Real Estate Services for Buyers and Sellers" -- Primary CTA: "View Properties" button +- Subheadline: "Expert Real Estate Services in Southern Minnesota" +- **Location Search Dropdown** (NEW): Select community to browse properties +- Primary CTA: "Search Properties" button - Secondary CTA: "Contact Us" button -#### Section 3: Featured Properties -- Section title: "Current Listings" -- Filter tabs: All | Residential | Commercial | Land -- Property cards in grid (3 columns desktop, 2 tablet, 1 mobile) -- "View All Properties" link +#### Section 3: Service Cards (NEW) +- Section title: "How Can We Help?" +- 3-column layout: + - **Find a Home**: Description + "Search Now" button + - **Find a Rental**: Description + "Start Here" button + - **Sell Your Home**: Description + "Get Your Home's Value" button +- Each card has brief description of service -#### Section 4: Why Choose HomeProz -- Section title: "Our Mission" or "Why HomeProz" +#### Section 4: Featured Residential Listings +- Section title: "Featured Homes" +- Property cards in carousel/grid (3 visible, arrows to scroll) +- Shows: Price, Address, Beds, Baths, SqFt, Status badge +- "View All Residential" link + +#### Section 5: Featured Commercial/Land Listings (NEW - separate section) +- Section title: "Commercial & Land" +- Property cards in carousel/grid (3 visible) +- Shows: Price, Address, Units/Acres, Type badge +- "View All Commercial" link + +#### Section 6: Why Choose HomeProz +- Section title: "Why HomeProz" - 3-column feature blocks with icons: - Local Expertise - Personalized Service - Results-Driven - Mission statement text -#### Section 5: Meet the Team +#### Section 7: Meet the Team - Section title: "Meet Our Agents" - Agent cards in grid (4 columns desktop) - Each card: Photo, Name, Title, Phone, Email - Hover effect reveals bio snippet -#### Section 6: Testimonials +#### Section 8: Testimonials - Section title: "What Our Clients Say" - Testimonial carousel/slider - Client name and transaction type +- (Note: RHR lacks testimonials - this is a competitive advantage) -#### Section 7: Contact CTA +#### Section 9: Contact CTA - Split layout: Form (left) | Map + Info (right) - Contact form fields: Name, Email, Phone, Message -- Office address, phone numbers +- Office address, phone numbers, **office hours** (NEW) - Embedded Google Map -#### Section 8: Footer +#### Section 10: Footer - Logo -- Quick links -- Contact info +- Quick links (Properties, Communities, About, Resources, Contact) +- Contact info with office hours - Social media icons +- **Professional association logos** (NEW): REALTOR, Equal Housing, local MLS +- **License numbers** (NEW) - Legal text (copyright, DBA, broker info) ### 4.3 Properties Archive Page -- Hero with search bar -- Filter sidebar (desktop) / Filter modal (mobile) - - Property Type - - Price Range - - Bedrooms - - Status (Active, Pending, Sold) - - Location/City +> **Updated based on Robert Hoffman Realty competitor analysis** + +- Hero: "Browse Our Properties" +- **Location search dropdown** prominently in hero +- **Map + Grid split view** (NEW): + - Left (1/3): Interactive map with property markers + - Right (2/3): Property grid + - Toggle: "Map View" | "Grid View" for mobile +- Filter bar (horizontal, above results): + - [Type dropdown] [Price dropdown] [Beds dropdown] [Status dropdown] [Clear Filters] - Property grid with pagination -- Sort options (Price, Date, etc.) +- Sort options (Price High/Low, Newest, etc.) +- Results count: "XX Properties Found" + +``` ++------------------------------------------+ +| HEADER | ++------------------------------------------+ +| Hero: "Browse Our Properties" | +| [Location Dropdown] [Search Button] | ++------------------------------------------+ +| [Type v] [Price v] [Beds v] [Status v] | ++------------------------------------------+ +| XX Properties Found [Sort: v] | ++------------------------------------------+ +| +------------+ +------------------------+| +| | | | +------+ +------+ +--+ || +| | MAP | | |Prop | |Prop | | | || +| | with | | |Card | |Card | | | || +| | markers | | +------+ +------+ +--+ || +| | | | +------+ +------+ +--+ || +| | | | |Prop | |Prop | | | || +| | | | |Card | |Card | | | || +| +------------+ +------------------------+| ++------------------------------------------+ +| [Pagination] | ++------------------------------------------+ +``` ### 4.4 Property Detail Page @@ -562,6 +625,114 @@ User-friendly error page: - Property results show as cards - Page/Post results show as list items +### 5.13 Community Page Template (`page-community.php`) (NEW) + +Location-based pages for each served community (SEO benefit + local expertise): + +``` ++------------------------------------------+ +| HEADER | ++------------------------------------------+ +| Hero: "[Community Name], Minnesota" | +| Photo of local landmark or neighborhood | ++------------------------------------------+ +| About [Community Name] | +| Brief description of the area, amenities, | +| schools, attractions, lifestyle. | ++------------------------------------------+ +| Properties in [Community Name] | +| +--------+ +--------+ +--------+ | +| | Prop | | Prop | | Prop | | +| | Card | | Card | | Card | | +| +--------+ +--------+ +--------+ | +| [View All Properties in Community Name] | ++------------------------------------------+ +| Local Information (optional) | +| - Population, ZIP codes | +| - School district links | +| - Local attractions | ++------------------------------------------+ +| Contact CTA | +| "Looking for a home in [Community]?" | ++------------------------------------------+ +| FOOTER | ++------------------------------------------+ +``` + +**Communities to create pages for:** +- Albert Lea (primary) +- Austin +- Glenville +- Emmons +- Clarks Grove +- Alden +- Hartland +- Geneva +- Hollandale +- Hayward +- Conger + +### 5.14 Resources Landing Page (`page-resources.php`) (NEW) + +Hub page for buyer/seller resources: + +``` ++------------------------------------------+ +| HEADER | ++------------------------------------------+ +| Hero: "Resources & Guides" | +| "Everything you need to buy or sell" | ++------------------------------------------+ +| +------------------+ +------------------+ | +| | Buyer's Guide | | Seller's Guide | | +| | [Image] | | [Image] | | +| | Description | | Description | | +| | [Read Guide] | | [Read Guide] | | +| +------------------+ +------------------+ | ++------------------------------------------+ +| Additional Resources | +| +--------+ +--------+ +--------+ | +| |Market | |Moving | |Mortgage| | +| |Report | |Checklist| |Info | | +| +--------+ +--------+ +--------+ | ++------------------------------------------+ +| Contact CTA | ++------------------------------------------+ +| FOOTER | ++------------------------------------------+ +``` + +### 5.15 Resource Page Template (`template-resource.php`) (NEW) + +Individual guide/resource pages (Buyer's Guide, Seller's Guide, etc.): + +``` ++------------------------------------------+ +| HEADER | ++------------------------------------------+ +| Hero: "[Resource Title]" | ++------------------------------------------+ +| Table of Contents (sticky sidebar) | ++------------------------------------------+ +| +----------------------+ +-------------+ | +| | | | TOC | | +| | Guide Content | | - Section 1 | | +| | (Block editor) | | - Section 2 | | +| | | | - Section 3 | | +| | Section 1 | | | | +| | ... | | Contact CTA | | +| | Section 2 | | | | +| | ... | | | | +| +----------------------+ +-------------+ | ++------------------------------------------+ +| Related Resources | ++------------------------------------------+ +| Contact CTA | ++------------------------------------------+ +| FOOTER | ++------------------------------------------+ +``` + --- ## 6. Block Patterns (Reusable Layouts) @@ -802,6 +973,25 @@ This design document is a draft for review. Please provide feedback on: --- -*Document Version: 1.0* -*Date: November 28, 2025* -*Prepared by: Hanson.xyz Development Team* +## 14. Competitor Analysis Reference + +This document was updated based on analysis of Robert Hoffman Realty (roberthoffmanrealty.com), a successful real estate site serving the same Albert Lea, MN market. + +Key structural elements adopted: +- Location search dropdown in hero +- Service cards section (Buy/Rent/Sell) +- Separate Residential and Commercial listing sections +- Community pages for each served location +- Resources section with buyer/seller guides +- Map view on property archive +- Enhanced footer with professional logos and license info + +Full analysis available at: +`competitor_analysis/robert-hoffman-realty/ANALYSIS.md` + +--- + +*Document Version: 1.1* +*Date: November 30, 2025* +*Updated by: Hanson.xyz Development Team* +*Changes: Added structural elements from RHR competitor analysis* diff --git a/contract/Contracts/WordPress-Website/_scratch/site_analysis/IMPLEMENTATION-PLAN.md b/contract/Contracts/WordPress-Website/_scratch/site_analysis/IMPLEMENTATION-PLAN.md index 10ce569e..13926af0 100755 --- a/contract/Contracts/WordPress-Website/_scratch/site_analysis/IMPLEMENTATION-PLAN.md +++ b/contract/Contracts/WordPress-Website/_scratch/site_analysis/IMPLEMENTATION-PLAN.md @@ -125,6 +125,8 @@ themes/homeproz/ ├── page.php ├── page-about.php ├── page-contact.php +├── page-communities.php # Communities landing page (NEW) +├── page-resources.php # Resources landing page (NEW) ├── search.php ├── single.php ├── single-property.php @@ -132,6 +134,8 @@ themes/homeproz/ ├── template-full-width.php ├── template-landing.php ├── template-blank.php +├── template-community.php # Individual community page (NEW) +├── template-resource.php # Individual resource page (NEW) ├── screenshot.png ├── style.css └── theme.json # Block editor config @@ -861,8 +865,70 @@ This implementation plan is a draft for review. Please confirm: ### Phase 7: Testing & Launch - PENDING +### Phase 8: RHR Structural Enhancements - NEW +**Based on Robert Hoffman Realty competitor analysis (November 30, 2025)** + +This phase adds structural elements to match competitor site conventions: + +#### 8.1 Homepage Enhancements +- [ ] Add location search dropdown to hero section +- [ ] Add service cards section (Buy/Rent/Sell) below hero +- [ ] Separate residential and commercial listings into distinct homepage sections + +#### 8.2 Navigation & New Pages +- [ ] Update navigation: Properties | Communities | About | Resources | Contact +- [ ] Create Communities landing page (page-communities.php) +- [ ] Create individual community template (template-community.php) +- [ ] Create community pages: Albert Lea, Austin, Glenville, Emmons, etc. +- [ ] Create Resources landing page (page-resources.php) +- [ ] Create individual resource template (template-resource.php) +- [ ] Create resource pages: Buyer's Guide, Seller's Guide + +#### 8.3 Property Archive Enhancements +- [ ] Add map view to property listings page (split layout: map + grid) +- [ ] Add map toggle for mobile view +- [ ] Add property markers to map based on location + +#### 8.4 Footer Enhancements +- [ ] Add office hours display +- [ ] Add professional association logos (REALTOR, Equal Housing, MLS) +- [ ] Add license numbers + +#### 8.5 ACF Fields for New Features +``` +Community Page Fields +├── community_description (wysiwyg) +├── community_hero_image (image) +├── community_population (text) +├── community_zip_codes (text) +├── community_school_district (text) +└── community_attractions (repeater) + +Resource Page Fields +├── resource_intro (wysiwyg) +├── resource_sections (repeater) +│ ├── section_title (text) +│ └── section_content (wysiwyg) +└── resource_cta_text (text) + +Theme Options (ACF Options Page) +├── office_hours (textarea) +├── license_numbers (textarea) +└── professional_logos (gallery) +``` + +**Beads Issue Tracking:** +- html-98b: Add location search dropdown to homepage hero +- html-5bw: Add service cards section (Buy/Rent/Sell) to homepage +- html-2fp: Separate Residential and Commercial listings on homepage +- html-7jz: Add Communities section to navigation and create community pages structure +- html-cpd: Add map view to property listings archive page +- html-t8u: Add Resources section to navigation and create resource pages +- html-3nq: Enhance footer with office hours, professional logos, license numbers + --- -*Document Version: 1.5* -*Last Updated: November 28, 2025* +*Document Version: 1.6* +*Last Updated: November 30, 2025* *Prepared by: Hanson.xyz Development Team* +*Changes: Added Phase 8 (RHR Structural Enhancements) based on competitor analysis*