Files
homeproz/CLAUDE.md
T
Hanson.xyz Dev 25608a5327 Add db_content_updates directory for production sync
- Create db_content_updates/ for documenting database changes
- Add README with required document format and template
- Update CLAUDE.md with mandatory documentation requirement
- All content changes must be documented for production team

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-04 20:12:05 -06:00

2.6 KiB
Executable File

HomeProz WordPress Theme

Custom WordPress theme for HomeProz Real Estate (Albert Lea, MN). Dark/rust brand aesthetic with ACF-powered property listings.

Development Rules

  1. No emojis - nowhere in code, commits, docs, or conversation
  2. Tailwind CSS + SCSS - compiled via Vite
  3. jQuery - for all JS functionality
  4. Co-locate files - SCSS/JS live alongside PHP templates
  5. Page-scoped styles - wrap in .Page_Class_Name { }, early return in JS
  6. Server-side render - no client-side templating
  7. No custom animations - keep it static and fast
  8. ASK before architectural decisions
  9. No git commits unless asked - commits are for checkpoints before major work or major milestones, not for small single-file changes

Build

cd wp-content/themes/homeproz
npm run build

Tools

  • WP-CLI: wp --allow-root <command>
  • Dev commits: ./dev_commit.sh "message" (includes DB snapshot)

WordPress Admin

  • URL: /wp-admin/
  • Username: admin
  • Password: Byg2X2sqbHeVvHLYRz5e

Theme Options

Access via homeproz_get_option('key'):

  • phone, email, address, facebook, tiktok

Database Content Changes (MANDATORY)

This site has a production fork. All database changes must be documented for production sync.

Schema changes (new tables, columns, indexes): Use migration files in the MLS plugin (wp-content/plugins/mls-by-hansonxyz/).

Content changes (options, ACF fields, posts, menus, terms): Create a timestamped document in db_content_updates/ with:

  • Filename: YYYY-MM-DD_HH-MM_description.md
  • What was changed (exact field names, option keys, post IDs)
  • The exact values set (copy/paste the WP-CLI commands or SQL)
  • Why it was changed
  • Any dependencies or order of operations

Example: 2026-01-04_19-30_add-footer-menu.md

DO NOT make database content changes without creating the corresponding document. The production team relies on these files to sync changes.

Custom Post Types

Agent (/agents/)

  • ACF: phone, email, bio, gallery, social links, order, disabled toggle
  • Disabled agents: 404 on profile, office contact on property cards

Key Helpers

// Get locations with active/pending properties only
$locations = homeproz_get_active_locations();

// Contact page with property inquiry prefill
$url = add_query_arg('property', urlencode($title), home_url('/contact/'));

Page Classes

Home_Page, Properties_Archive, Single_Property, About_Page, Contact_Page, Blog_Archive, Single_Post, Agents_Archive, Single_Agent, Search_Page, Error_404