Makler-Berater

Description

Makler-Berater is an AI assistant that actually knows your WordPress property listings.

Third-Party Service

This plugin connects to the Makler-Berater API service (https://api.makler-berater.de) to provide AI-powered property search and chat functionality. The following data is sent to the service:

  • Property data (title, description, price, location, features, photos) — sent during sync
  • Chat messages — sent when visitors use the chat widget
  • Photo URLs — sent for optional AI vision analysis

When data is sent: During property synchronization (hourly + on save), when visitors use the chat widget, and when photo analysis is enabled.

Service links:
* Terms of Service
* Privacy Policy

The AI processing takes place on EU servers (AWS Frankfurt). No data is transferred to US services.

Visitors can search your properties using natural language chat — and get instant, accurate answers based on your real inventory. No generic chatbot responses. Real data.

What This Plugin Does

  • One-line widget integration — The AI chat widget appears on all pages of your WordPress site. No coding required.
  • Automatic property sync — Your listings are synced hourly and in real-time on every change. Zero manual data entry.
  • Real AI answers — The assistant knows price, location, rooms, features of every property and answers questions like “Is there a house under €400,000 with a garden in Cologne?”
  • Photo analysis (Vision AI) — Features are automatically extracted from property photos: hardwood floors, fireplace, open kitchen — even if the agent never mentioned them in the description.
  • GDPR/DSGVO compliant — AI processing on EU servers (AWS Frankfurt). No data transfer to US services.
  • Multilingual — German and English UI included. Works with properties in any language.

Supported Property Plugins

Optimized adapters for:

  • WP-ImmoMakler / OpenImmo (immobilie CPT — most popular German real estate plugin)
  • Frymo (v1.x+)
  • Immonex Kickstart / OpenImmo2WP (inx_property CPT)
  • Estatik (v4.x)
  • WP-Property (v2.x)

NEW in 2.0: Generic mode — works with any property plugin! Unknown plugins are auto-detected and all data is sent as a raw dump to the AI, which interprets field names automatically.

The correct data source is detected automatically.

Shortcode Integration

In addition to the automatic widget on all pages, you can place the chat on specific pages:

[makler_berater] — Default settings
[makler_berater color="16a34a"] — Custom color
[makler_berater mode="inline"] — Inline instead of floating
[makler_berater title="How can I help?"] — Custom title
[makler_berater autoopen="true" delay="3000"] — Auto-open after 3s
[makler_berater page_context="true"] — Send page content as context

Privacy & Security

Three-layer security filter protects sensitive data:

  • Layer 1: WordPress internal fields (underscore prefix) are automatically filtered
  • Layer 2: Email, phone, bank details, passwords, API keys are blocked
  • Layer 3: Custom blocklist configurable in admin

Why Makler-Berater?

Generic chatbots (Tidio, WPBot, Chatbase) don’t know your property inventory. Makler-Berater connects directly to your real estate data, so visitors get accurate answers about your actual listings.

For Developers & Agencies

This plugin is ideal for WordPress agencies building real estate websites. One Makler-Berater account per client, the plugin on their site — done.

Filter hooks for developers:
* makler_berater_load_widget — Control widget loading (e.g., cookie consent)
* makler_berater_property_data — Modify data payload before sending
* makler_berater_block_field — Block/allow individual fields
* makler_berater_collected_images — Customize image list
* makler_berater_sync_statuses — Which post statuses to sync

Installation

  1. Install and activate the plugin in WordPress
  2. Go to Makler-Berater Settings in your dashboard
  3. Create a free account at admin.makler-berater.de
  4. Enter your API key and Business ID
  5. Click “Test Connection” — done!

The widget appears immediately on all pages. Properties are synced automatically every hour.

FAQ

Which property plugins are supported?

Optimized adapters exist for WP-ImmoMakler/OpenImmo, Frymo, Immonex/OpenImmo2WP, Estatik, and WP-Property. Since version 2.0, the plugin also works with any property plugin in generic mode.

Do I need a Makler-Berater account?

Yes. Create a free account at admin.makler-berater.de. You get 50 free AI credits to start.

Is the data processing GDPR compliant?

Yes. AI processing takes place on AWS servers in the EU (Frankfurt). No data is transferred to the US. Sensitive data (email, phone, bank details) is automatically blocked by the three-layer security filter. You can configure a privacy URL directly in the plugin.

Can the widget be customized?

Yes — color, title, welcome message, and whether property cards are shown are all configurable. Via shortcode you can override these settings per page. Advanced customization (logo, persona name, white-label) is available in higher plans.

Does it work without a supported property plugin?

Yes! Since version 2.0, the plugin auto-detects property post types and syncs data in generic mode. The AI backend interprets field names automatically — works with any language.

How often are properties synced?

Hourly via WordPress Cron plus in real-time on every property change (save_post hook). You can also trigger a manual sync at any time.

What is Photo Analysis (Vision AI)?

The Vision feature analyzes property photos using AI and extracts visible features like hardwood floors, fireplace, open kitchen, rooftop terrace, etc. This enables search queries like “apartment with parquet and fireplace” — even if the agent didn’t describe these details in the text.

Does it work in languages other than German?

Yes. The plugin UI is available in German and English. The AI chat works in any language — visitors can ask questions in English, French, Turkish, etc. and get answers based on your property data regardless of what language the listings are in.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Makler-Berater” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Makler-Berater” into your language.

Interested in development?

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

Changelog

2.0.0

  • Complete rebuild: Modular architecture with clean class structure
  • Generic mode: Now works with any property plugin (raw dump fallback)
  • Shortcode: [makler_berater] with per-instance parameters (color, mode, title, autoopen, delay, page_context)
  • Three-layer security filter: Automatic protection of sensitive data (email, phone, bank details, API keys)
  • 5-source image collector: Featured image, attached media, ACF gallery, meta fields, content images
  • Post-type auto-detection: Three strategies (known plugins, keyword scan, meta-key analysis)
  • Data preview: Check what data will be sent or blocked before syncing
  • Retry queue: Failed API calls are automatically retried with exponential backoff
  • Content hash detection: Unchanged properties are automatically skipped during hourly sync
  • Cookie consent integration: Compatible with Borlabs Cookie, Complianz, Real Cookie Banner, WP Cookie Consent (CookieYes)
  • WordPress Multisite: Network overview page for super-admins, bulk business ID assignment
  • Debounce: Prevents duplicate API calls on save_post
  • Tabbed settings page: 4 tabs (Account, Widget, Sync, Advanced)
  • External assets: CSS and JS from separate files (no more inline code)
  • Custom blocklist: Admin can block additional fields
  • Developer hooks: 5 filter hooks for custom modifications
  • Real-time sync with debounce: Instant sync on property changes
  • Batch import with progress bar: Transfer all existing properties with one click
  • Internationalization: Complete .pot file + English translation

1.2.0

  • WP-ImmoMakler/OpenImmo adapter (immobilie CPT, 300+ fields)
  • Real-time sync on every property change (save_post hook)
  • Auto-delete sync on trash/delete
  • Initial import: transfer all existing properties with progress bar
  • Photo analysis (Vision AI): auto-extract features from photos

1.1.0

  • Frymo adapter for automatic property sync
  • Immonex/OpenImmo2WP adapter
  • Estatik adapter
  • WP-Property adapter
  • Connection test (health check) in settings
  • Hourly automatic sync via WP-Cron
  • Sync log page

1.0.0

  • Initial release: Widget integration + settings page