brianhansonxyz/homeproz
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update design docs with RHR competitor structural changes

Browse Source 
DESIGN-DOCUMENT.md v1.1:
- Expanded site architecture with Communities and Resources sections
- Updated navigation: Properties | Communities | About | Resources | Contact
- Hero now includes location search dropdown
- Added Service Cards section (Buy/Rent/Sell)
- Separated Residential and Commercial listings on homepage
- Property archive now includes map view (split layout)
- Added Community page template specs
- Added Resources page template specs
- Enhanced footer with office hours, pro logos, license numbers

IMPLEMENTATION-PLAN.md v1.6:
- Added Phase 8: RHR Structural Enhancements
- New templates: page-communities.php, page-resources.php, template-community.php, template-resource.php
- ACF field specs for community and resource pages
- Linked beads issues for tracking
This commit is contained in:
Hanson.xyz Dev
2025-11-30 02:29:02 -06:00
parent 562a0bd5b0
commit 5b629bdbab
4 changed files with 299 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.beads/issues.jsonl
+8
View File
@@ -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"}
.claude/settings.local.json
+3 -1
View File
@@ -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": []
contract/Contracts/WordPress-Website/_scratch/site_analysis/DESIGN-DOCUMENT.md
+220 -30
View File
@@ -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*
contract/Contracts/WordPress-Website/_scratch/site_analysis/IMPLEMENTATION-PLAN.md
+68 -2
View File
@@ -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*