HomeSelf VPR Connector

Bring your properties into AI conversations. HomeSelf VPR Connector connects your WordPress property pages to canonical HomeSelf Verified Property Records (VPRs). A VPR is an AI-readable property record. Who this is for:

• Hotels and direct booking sites — Make your property easier for AI assistants to understand
• Property managers — Connect your portfolio to canonical VPRs for AI-mediated discovery
• Real estate agencies — Turn listings into structured records AI can compare
• Short-term rentals — Villas, apartments, B&Bs, and aparthotels

What this plugin does:

• Displays a clean, professional property record card
• Shows a trust badge linking to the canonical HomeSelf VPR
• The card can optionally show a Copy AI prompt button
• Includes copyable AI setup help prompts
• Adds structured data references for AI and search systems
• Works with Gutenberg blocks
• Works with Elementor widgets (when Elementor is active)
• Works with any WordPress theme via shortcodes
• Fetches data from HomeSelf with smart caching

What this plugin does NOT do:

• Does NOT create or manage VPRs on HomeSelf
• Does NOT guarantee AI search visibility, ranking, or citation
• Does NOT claim SEO benefits or booking guarantees
• Does NOT verify property ownership
• Does NOT require API keys or account connection
• Does NOT replace your booking engine or PMS

Quick setup in 5 steps:

1. Create a VPR on HomeSelf
2. Install the WordPress plugin
3. Paste your VPR URL or Property ID
4. Add the block, widget, or shortcode to your page
5. Publish

Integration options:

• Gutenberg Block — Add the HomeSelf VPR Card block in the WordPress editor
• Elementor Widget — Use the HomeSelf VPR Connector widget (requires Elementor)
• Shortcode — Paste a shortcode into any page, post, or builder

Display formats:

• Card — Best for full property pages, showing complete information with optional AI prompt copy button
• Badge — Best for compact trust indicators and sidebar placement

Shortcode usage: [homeself_vpr id="uuid-or-slug" template="card|badge" theme="standard|dark" ai_record_tools="1|0" markdown_link="1|0"]

• id — Property ID or slug from HomeSelf (optional if default is set)
• template — card (full card) or badge (trust badge)
• theme — standard (light theme) or dark (dark theme), default uses plugin setting
• ai_record_tools — Show AI-readable record tools in card (default: from settings)
• markdown_link — Show Markdown download link (default: from settings)

0.4.5 - 2026-05-07

• Improved WordPress.org external service disclosure for HomeSelf public VPR endpoints.
• Escaped JSON-LD output safely for script-tag context using wp_json_encode() with JSON_HEX flags.
• Removed unsafe JSON_UNESCAPED_* flags from JSON-LD output.

0.4.4 - 2026-05-07

• Updated screenshots section to accurately describe the five available screenshots.
• Ensured screenshot descriptions match actual WordPress.org assets.

0.4.3 - 2026-05-07

• Fixed Standard/Dark card theme rendering across admin preview, shortcode, Gutenberg, and Elementor.
• Ensured explicit theme selection overrides system color preferences.
• Improved Standard theme styling for light WordPress layouts.
• Fixed remaining WordPress Plugin Check variable-prefix warnings in the VPR card template.

0.4.2 - 2026-05-07

• Added Standard and Dark visual theme options for VPR card and badge.
• Added theme support for shortcode, Gutenberg block, Elementor widget, and admin preview.
• Improved frontend theme compatibility for light and dark WordPress property pages.

0.4.1 - 2026-05-07

• Fixed Markdown link setting in the admin AI-readable record section.
• Fixed admin preview parity for AI-readable record tools.
• Fixed Gutenberg block renderer to pass AI record tools and Markdown link to template.
• Improved AI-readable drawer copy and visibility rules.
• Ensured JSON-LD, AnswerPack, and Markdown URLs are passed consistently to the frontend renderer.

0.4.0 - 2026-05-07

• Added premium AI-readable record section to VPR card with JSON-LD, AnswerPack, Markdown, and Copy VPR link actions.
• Added CSS styling for AI-record drawer with light/dark mode support and responsive design.
• Added Elementor widget controls for Show AI-readable record tools and Show Markdown download link.
• Fixed Gutenberg block editor controls for AI-record tools and Markdown link.
• Updated Elementor widget to pass AI-record tools settings to renderer.
• Bumped to version 0.4.0 for product evolution from trust widget to AI-readable property data layer.

0.3.28 - 2026-05-07

• Improved admin settings layout and section containment.
• Moved machine-readable link controls into the display configuration flow.
• Improved add-to-page method cards for WordPress editor, Elementor, and shortcode.
• Improved preview and save section layout.
• Fixed admin spacing issues around WordPress footer and third-party admin notices.

0.3.27 - 2026-05-07

• Fixed Elementor widget PHP namespace syntax error.
• Verified all plugin PHP files pass syntax validation.

0.3.26 - 2026-05-07

• Added Gutenberg editor controls for machine-readable VPR links.
• Added block controls for JSON-LD alternate links, AnswerPack alternate links, and visible machine-readable footer links.
• Improved Gutenberg editor status messaging for machine-ready VPR settings.

0.3.25 - 2026-05-07

• Added optional machine-readable VPR links for JSON-LD and AnswerPack.
• Added alternate link references in the page head for AI and structured data consumers.
• Added optional machine-readable footer links in the VPR card.
• Clarified that HomeSelf VPRs are both trust records and machine-ready property records.
• Fixed remaining WordPress Plugin Check naming warnings in frontend templates.
• Reviewed and documented intentional direct database queries used for cache status and cleanup.

0.3.23 - 2026-05-06

• Improved Elementor editor and frontend styling for VPR Card and Badge.
• Fixed Elementor widget CSS loading using proper get_style_depends() method.
• Added Elementor-safe CSS selectors to prevent theme style overrides.
• Enhanced button, text, and badge styling for consistent Elementor rendering.
• Added helper text to Elementor template control for better UX.
• Improved global style registration for Elementor, Gutenberg, and shortcode.

0.3.22 - 2026-05-06

• Redesigned frontend VPR card as a compact premium trust card with light-first design.
• Redesigned VPR badge as a lightweight trust marker with pill styling.
• Improved card hierarchy with "Verified Property Record" as main headline.
• Moved "AI-readable" to supporting text for clearer positioning.
• Added status pill indicator for visual connection status.
• Improved Elementor, Gutenberg, and shortcode visual compatibility.
• Enhanced CSS variables for consistent theming and dark mode support.
• Reduced visual weight of disclaimers while keeping required disclosures.
• Improved CTA button design with better hover states.

0.3.21 - 2026-05-06

• Redesigned the frontend VPR card for a cleaner, compact, site-friendly layout.
• Redesigned the VPR badge to avoid oversized icons and improve compatibility with Elementor and WordPress themes.
• Improved frontend button contrast and responsive behavior.
• Kept card and badge rendering compatible with shortcode, Gutenberg, and Elementor.

0.3.20 - 2026-05-06

• Simplified display templates to Card and Badge.
• Removed Prompt only as a standalone user-facing display option.
• Preserved backward compatibility by falling back legacy prompt templates to Card.
• Clarified multi-property usage in documentation.

0.3.19 - 2026-05-06

• Ensured frontend styles load correctly when using the Elementor widget.
• Prevented duplicate JSON-LD output from repeated Elementor widgets using the same VPR.
• Improved distribution packaging to exclude development artifacts.

0.3.18 - 2026-05-06

• Fixed admin setup state so add-to-page methods activate immediately after a successful VPR connection.
• Improved decoding of property titles and locations containing HTML entities.
• Improved admin preview CTA contrast.
• Improved refresh-cache behavior when VPR values are entered but not yet saved.

0.3.17 - 2026-05-06

• Fixed admin refresh state when a VPR URL or Property ID is already entered.
• Improved connection success and error states.
• Removed troubleshooting prompt from successful connection messages.
• Decoded safe display text for property titles containing HTML entities.
• Improved admin header resilience around third-party WordPress notices.

0.3.16 - 2026-05-05

• Reduced WordPress.org Plugin Check warnings.
• Removed manual text domain loading — WordPress.org auto-loads translations when text domain matches plugin slug.
• Added precise PHPCS comments for intentional cache cleanup queries.
• Clarified external service and privacy disclosures for WordPress.org review.
• Added WordPress.org assets checklist documentation.

0.3.15 - 2026-05-05

• Fixed remaining WordPress.org Plugin Check escaping errors in VPR card and badge templates
• Applied esc_attr() and esc_url() directly at output points for all VPR templates

0.3.14 - 2026-05-05

• Updated Tested up to: 6.9 for WordPress.org compatibility
• Fixed template output escaping for WordPress Plugin Check
• Fixed non-prefixed variable warning in ai-prompt-box template
• Improved ZIP distribution to exclude .distignore file
• Added documentation for retained load_plugin_textdomain() for direct ZIP compatibility

0.3.13 - 2026-05-05

• Fixed WordPress.org Plugin Check escaping issues.
• Replaced parse_url() with wp_parse_url().
• Improved readme compatibility metadata and short description.
• Added languages directory / POT preparation.
• Sanitized admin notice query parameters.
• Added targeted PHPCS comments for intentional cleanup queries.

0.3.12 - 2026-05-05

• Fixed Gutenberg block discovery - block now appears in WordPress editor search
• Improved WordPress admin header separation and visual clarity
• Refined admin setup layout with better color semantics (violet for current, gray for locked)
• Neutralized Step 3 empty state text (was using warning colors)
• Added concise intro sentence to Step 3 of setup flow
• Updated plugin header description for WordPress.org (under 150 characters)
• Added WordPress.org readiness checklist and i18n preparation

0.3.11 - 2026-05-05

• Fixed Gutenberg block editor error - block now renders without errors in the editor
• Improved Elementor empty state guidance with clearer copy
• Replaced oversized admin hero with compact WordPress-native product header
• Improved admin setup layout polish and reduced visual weight
• Updated WordPress integration landing page with frontend VPR card preview image

0.3.10 - 2026-05-05

• Refined admin color semantics and setup guidance.
• Improved progress tracker states (current, complete, locked, error).
• Added next recommended action guidance below progress tracker.
• Improved disabled and active method card states with badges.
• Reorganized help resources by user intent (Start, Understand, Use cases).
• Updated focus-visible states and accessibility improvements.

0.3.9 - 2026-05-05

• Redesigned admin setup layout for a clearer four-step configuration flow.
• Replaced large hero with compact HomeSelf product header.
• Merged display, structured data, and cache controls into a cleaner setup step.
• Improved "Add to page" method cards for WordPress editor, Elementor, and shortcode.
• Moved educational AI discovery content into collapsed advanced sections.
• Reduced AI help button noise and improved setup guidance.

0.3.8 - 2026-05-05

• Added HomeSelf brand header with icon and version badge
• Added contextual copyable AI help prompts throughout the admin
• Improved admin visual consistency with CSS variables
• Added accessibility improvements (aria-labels, aria-live regions, focus states)
• Added AI guidance disclaimer: prompts copied to clipboard only, no data sent automatically
• Enhanced use case cards with AI prompt links
• Added AI help buttons to Steps 1-4 for setup guidance
• Added AI help card in Learn More section
• Improved color contrast and visual hierarchy
• Updated to version 0.3.8

0.3.7 - 2026-05-05

• Reorganized admin page with clearer setup flow (Hero → Use case → Checklist → Steps 1-4 → Learn more)
• Renamed sections with step numbers for better guidance (Step 1 — Connect, Step 2 — Display, Step 3 — Add to page, Step 4 — Preview)
• Improved VPR field help copy with clearer language
• Enhanced empty state for "Add to page" section with disabled mini-cards
• Added active method cards with copy buttons for WordPress editor, Elementor, and Shortcode
• Added "Multiple properties?" help box for multi-property users
• Moved AI Discovery Metrics to collapsible section ("AI discovery metrics, explained")
• Updated collapsible JavaScript to support multiple collapsible sections
• Added safe language: "make the property easier for AI systems to understand, compare, and evaluate"

0.3.6 - 2026-05-05

• Fixed Gutenberg block visibility issue - block now appears in WordPress editor search
• Removed admin hero screenshot with third-party notices
• Replaced with CSS-based data flow visualization
• Updated claim language to safer, non-guaranteeing wording
• Changed "Watch setup video" to "Setup guide" in Learn More section
• Optimized assets and removed 1.2MB screenshot from distribution
• Updated to version 0.3.6

0.3.5 - 2026-05-05

• Added native Gutenberg block: HomeSelf VPR Card
• Added Elementor widget: HomeSelf VPR Connector (loads only when Elementor is active)
• Updated admin UI with integration method selection (Gutenberg, Elementor, Shortcode)
• Added copy buttons for all shortcode templates (card, badge, prompt)
• Updated readme.txt with Gutenberg and Elementor FAQ
• Removed all private-beta terminology
• Optimized image assets for smaller plugin size
• Prepared for public ZIP distribution
• Updated to version 0.3.5 for WordPress.org submission preparation

0.1.3-private - 2026-05-05

• Added hero section with "Bring your properties into AI conversations" positioning
• Added use case selection for Hotels, Property Managers, Agencies, and Short-term Rentals
• Added targeted explanations for each use case
• Added AI Discovery Metrics education (AI Exposure, ASR, HSR, Trust Score)
• Added Learn More section with configurable HomeSelf links
• Improved frontend card copy for clarity
• Added safe AI assistant references to ChatGPT, Claude, Gemini, Perplexity, Google AI Mode
• Updated disclaimer to include citation and visibility
• Updated readme.txt for WordPress.org conversion
• Added marketing copy documentation
• Added screenshot plan

0.1.2-private - 2026-05-05

• Added guided setup checklist for property managers
• Renamed technical labels to user-friendly terms
• Added "Copy shortcode" button
• Added live preview of VPR card in admin
• Added better empty states with guidance
• Added safe references to AI assistants
• Added disclaimer about third-party AI companies
• Updated readme.txt for WordPress.org readiness
• Added private beta documentation

0.1.1-private - 2026-05-05

• Redesigned admin with card-based sections
• Added connection testing with clean status display
• Added manual cache refresh
• Improved admin copy to remove overclaim language
• Enhanced admin visual style

0.1.0-private - 2026-05-05

• Initial private MVP release
• Basic VPR card, badge, and prompt templates
• Admin settings page under Settings > HomeSelf VPR
• Server-side API client with fallback endpoints
• Transient caching with configurable TTL
• JSON-LD schema injection
• Security hardening with input sanitization and output escaping
• i18n ready with text domain