Description

UQBITZ Hub de Integração Imobiliária is a WordPress plugin that automatically generates an XML feed in the OpenNavent format to synchronize property listings with major Brazilian real estate portals.

Supported portals:

ImovelWeb
Wimoveis
Casa Mineira

Key features:

Automatic XML feed at /wp-json/uqbhi/v1/feed
Custom Post Type “Imóvel” with full ACF (Advanced Custom Fields) support
Taxonomies: Property Type, Purpose, City & Neighborhood
Required field validation — incomplete listings are excluded from the feed
Admin dashboard with feed status, instructions, and technical field mapping
Automatic amenity and infrastructure mapping to Navent IDs
YouTube video support (automatic code extraction)
Floor plan gallery with custom titles
Auto-fill address from ZIP code (via ViaCEP API)
Complete property type/subtype mapping to the Navent API

Validated required fields:

Title (min. 5 characters)
Description (min. 50 characters)
Price (sale or rental)
Photo gallery (min. 5 images)
Type and Purpose
Full address (ZIP, street, neighborhood, city, state)
Private area (m²)
Property tax (IPTU)
Property age
Condo fee (required for apartments and gated communities)

Screenshots

Overview dashboard — feed status with property list and pending issues
Settings — agency code and contact information
Field mapping — technical ACF to XML field reference table

Installation

Upload the uqbitz-hub-imoveis folder to /wp-content/plugins/
Activate the plugin in the WordPress dashboard
Go to Hub Imóveis Settings and fill in:
- Real estate agency code (provided by the portal)
- Contact email, name, and phone
Add property listings with all required fields filled in
Go to Hub Imóveis Overview to check feed status
Copy the feed URL and register it in the desired portal

Portal setup (ImovelWeb):

Log in to the ImovelWeb dashboard
Go to Ad Integration XML
Paste the feed URL
In “Integrator Name”, enter UQBITZ
Save

FAQ

What are the requirements?

WordPress 6.0 or higher
PHP 8.0 or higher
Advanced Custom Fields (free or Pro) installed and active

Where do I find the feed URL?

Go to Hub Imóveis Overview in the WordPress dashboard. The URL is displayed at the top, in the format: https://yoursite.com/wp-json/uqbhi/v1/feed

Why is a property not showing in the feed?

Properties with incomplete required fields are automatically excluded. Go to Hub Imóveis Overview to see the list of issues for each property.

Can I use this on multiple sites?

Yes. Each plugin installation generates its own independent feed. Just install, configure the agency code, and add properties.

How does the ZIP code auto-fill work?

When you enter a ZIP code while editing a property, the plugin queries the ViaCEP API and automatically fills in street, neighborhood, city, and state.

Do I need an API key from the portal?

No. The XML feed is a public URL consumed by the portal. You only need the agency code provided by the portal.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“UQBITZ Hub de Integracao Imobiliaria” is open source software. The following people have contributed to this plugin.

Fernando Perrella

“UQBITZ Hub de Integracao Imobiliaria” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “UQBITZ Hub de Integracao Imobiliaria” into your language.

Interested in development?

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

Changelog

3.4.1

Changed: WordPress Coding Standards compliance — tabs, docblocks, brace style across all files

3.4.0

Refactor: Split single-file plugin (1881 lines) into 6 modular files under includes/ (SOLID/KISS)
Added: ACF field complemento now registered via code
Fixed: Infrastructure field name casing (Infraestrutura infraestrutura) — items were not loading in XML feed
Changed: Admin code only loads on dashboard (is_admin())

3.3.0

Changed: Uniform prefix uqbhi_ for all functions, constants, options, CPT, and taxonomies
Changed: CPT slug imovel uqbhi_imovel; taxonomies tipo uqbhi_tipo, finalidade uqbhi_finalidade, cidade-e-bairro uqbhi_cidadebairro
Changed: REST namespace portalimoveis/v1 uqbhi/v1
Fixed: Feed URL uses rest_url() instead of hardcoded home_url('/wp-json/...')
Fixed: All admin page slugs prefixed (uqbhi-portal, uqbhi-settings, uqbhi-mapping)

3.2.0

Fixed: HTML output escaping on all admin pages (esc_html, esc_attr, esc_url)
Fixed: Input sanitization via register_setting() callback
Fixed: readme.txt included in plugin folder
Updated: WordPress Plugin Check compliant

3.1.0

Added: Expanded validation — IPTU, property age, condo fee (conditional), full address required
Changed: Optimized layout — infrastructure, gallery, floor plans, video at full width
Changed: Infrastructure checkbox layout set to horizontal
Changed: “Hub Imóveis” menu repositioned below the Imóveis CPT

3.0.0

Added: Admin dashboard with 3 pages: Overview, Settings, Field Mapping
Added: Required field validation in XML feed
Changed: Plugin rebranded from client-specific to generic “UQBITZ Hub de Integração Imobiliária”
Changed: REST API namespace changed to portalimoveis/v1

2.8.0

Added: YouTube video field with automatic code extraction
Added: Floor plan gallery with custom titles

2.7.0

Added: IPTU, condo fee, and property age in XML characteristics
Added: Amenity mapping to Navent AREA_PRIVATIVA IDs
Added: Infrastructure mapping to Navent AREAS_COMUNS IDs

2.5.0

Added: 82 Navent characteristic mappings (numeric IDs to Portuguese labels)

2.4.0

Added: CPT and taxonomies registered via plugin code
Added: Complete type hierarchy (5 types, 40 subtypes)

2.0.0

Initial release: single-file plugin rewrite with REST API XML feed

Description

Screenshots

Installation

FAQ

What are the requirements?

Where do I find the feed URL?

Why is a property not showing in the feed?

Can I use this on multiple sites?

How does the ZIP code auto-fill work?

Do I need an API key from the portal?