Makler-Berater

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

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.

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