Description

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:

Create a VPR on HomeSelf
Install the WordPress plugin
Paste your VPR URL or Property ID
Add the block, widget, or shortcode to your page
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)

AI Discovery Metrics

The plugin introduces these concepts to help you understand AI-mediated property discovery:

AI Exposure — Your property was retrieved, considered, or evaluated by an AI system
ASR — AI Selection Rate — How often your property is selected by AI after being evaluated for a user intent
HSR — Human Selection Rate — How often people take action after arriving from an AI recommendation
Trust Score — A signal of data reliability, completeness, and evidence quality

Note: ASR and HSR reporting require HomeSelf analytics and may not be available in this connector MVP.

AI-readable property data layer

The plugin can add structured machine-readable references to the canonical HomeSelf VPR endpoints:

JSON-LD endpoint — Structured data format for AI systems and search engines
AnswerPack endpoint — Optimized for answer engines and AI assistants
Markdown endpoint — Human-readable documentation format

The VPR card can optionally show a compact AI-readable record drawer with:
– JSON-LD link
– AnswerPack link
– Markdown download link
– Copy VPR link button

These references do not guarantee AI visibility, ranking, or citation. They provide structured links that make the canonical VPR easier to locate and interpret.

The WordPress page remains your human-facing page. HomeSelf remains the canonical machine-readable VPR source.

Is this for hotels or independent properties?

Both. Hotels with direct booking websites, independent property managers, real estate agencies, and short-term rental hosts can all use this plugin. Choose your use case in settings for tailored guidance.

What is the difference between this and a booking engine?

This is NOT a booking engine. Your WordPress site remains your human-facing property page. HomeSelf provides a canonical AI-readable property record. The connector simply links the two.

Will this slow down my website?

No. The plugin uses server-side fetching with WordPress transients for caching. Data is only fetched when needed and cached according to your settings.

Does this work with Gutenberg?

Yes. The plugin includes a native Gutenberg block called “HomeSelf VPR Card” that you can add to any page or post using the block editor.

Does this work with Elementor?

Yes. When Elementor is installed and active, the plugin provides a “HomeSelf VPR Connector” widget that you can drag and drop onto any Elementor page.

Is this compatible with page builders?

Yes. The shortcode works with any page builder that supports WordPress shortcodes, including Divi, Beaver Builder, and others.

Does this work with caching plugins?

Yes. The plugin uses WordPress transients for its own caching and is compatible with page caching plugins like WP Rocket, W3 Total Cache, and others.

Can I use this on multiple properties?

Yes. Install the plugin once. Add a different VPR ID to each property page using the block, Elementor widget, or shortcode. You can reuse the integration methods across multiple pages with different VPR IDs.

What happens if my VPR changes on HomeSelf?

The plugin fetches fresh data based on your cache settings. You can also manually refresh from the settings page.

Does this collect any data?

No. The plugin only fetches public VPR data from HomeSelf. No personal information is collected or stored.

Does the plugin expose machine-readable property data?

Yes. The plugin adds structured references and alternate links to the canonical HomeSelf VPR JSON-LD, AnswerPack, and Markdown endpoints. The VPR card can optionally show a compact AI-readable record drawer with actions for JSON-LD, AnswerPack, Markdown, and Copy VPR link. The WordPress page remains your human-facing page; HomeSelf remains the canonical machine-readable VPR source.

Privacy Policy

HomeSelf VPR Connector respects your privacy:

The plugin only fetches public data from homeself.ai
No personal information is collected or stored
No tracking or analytics are included
All data processing happens on your WordPress server

External Service Disclosure

This plugin connects to the HomeSelf public service to retrieve public Verified Property Record (VPR) metadata configured by the site administrator.

Service name: HomeSelf
Service URL: https://homeself.ai
Terms of Service: https://homeself.ai/terms
Privacy Policy: https://homeself.ai/privacy

What the service is used for:
The service is used to fetch public VPR metadata so the plugin can display a VPR card, compact badge, and AI-readable structured references on WordPress property pages.

What data is sent:
When a site administrator configures a VPR URL, property ID, or slug, the plugin may send that configured public identifier to HomeSelf public endpoints in order to retrieve the matching public VPR metadata.

When data is sent:
Data is sent when the administrator tests the connection, refreshes cached VPR data, previews the VPR card in the plugin settings, or when the WordPress page renders and cached VPR data needs to be fetched or refreshed.

What data is received:
The plugin receives public VPR metadata such as property title, location, canonical VPR URL, JSON-LD URL, AnswerPack URL, Markdown URL, and related public display fields.

What is not sent:
The plugin does not send private WordPress user data, passwords, billing data, owner verification documents, private property documents, or visitor personal data to HomeSelf.

AI providers:
The plugin does not send data to OpenAI, Anthropic, Google, Perplexity, or other AI providers. AI prompt/copy features only copy text to the visitor clipboard.

No affiliation / no guarantee:
HomeSelf is not affiliated with OpenAI, Anthropic, Google, Perplexity, Elementor, or WordPress. The plugin does not guarantee AI inclusion, ranking, citation, visibility, selection, or bookings.

Third-Party AI Assistant Disclaimer

The plugin references AI assistants such as ChatGPT, Claude, Gemini, Perplexity, and Google AI Mode for explanatory purposes only. HomeSelf is not affiliated with OpenAI, Anthropic, Google, or Perplexity. The connector does not guarantee inclusion, ranking, citation, or visibility in any AI system or search engine.

Screenshots

Admin settings page with use case selection for Hotels, Property Managers, Agencies, and Short-term Rentals
Elementor widget panel showing HomeSelf VPR Connector configuration controls
Admin settings page with connection test and live VPR card preview
Admin settings page with setup checklist and display configuration
Frontend property page displaying the VPR card with AI-readable record drawer

Blocks

This plugin provides 1 block.

HomeSelf VPR Card Connect a WordPress property page to a canonical HomeSelf Verified Property Record.

Installation

Upload homeself-vpr-connector folder to /wp-content/plugins/ directory
Activate the plugin through the ‘Plugins’ menu in WordPress
Go to Settings > HomeSelf VPR
Choose your use case and follow the setup checklist

FAQ

Do I need an account on HomeSelf?: VPRs are created and managed on homeself.ai. You need a VPR to connect your WordPress page, but the plugin itself does not require an account connection or API keys.
Does this create or update VPRs?: No. This plugin only displays existing HomeSelf Verified Property Records. VPRs must be created and managed on homeself.ai.
Will this help my property appear in ChatGPT, Claude, or other AI assistants?: The connector adds AI-readable content and structured references. AI assistants independently decide what content to use. We do not guarantee inclusion, ranking, citation, or visibility in any AI system.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“HomeSelf VPR Connector” is open source software. The following people have contributed to this plugin.

HomeSelf

Translate “HomeSelf VPR Connector” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

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