內容簡介
Garagem 外掛將 WordPress 與 Garagem CRM 連接，讓使用者能夠即時發布物件搜尋/列表頁面、物件詳細頁面及賣家潛在客戶流程，並支援即時同步更新。
【主要功能】
• 快速設定 — 安裝後即可配置並發布列表
• 即時更新 — 物件更新即時反映於網站
• 主題相容性 — 與常見佈景主題及頁面建構器相容
• 高級篩選 — 按類型、價格範圍等進行篩選
• 個別物件網址 — 提供詳細頁面及聯絡表單
• 整合表單 — 連接 Garagem CRM 的聯絡表單
外掛標籤
開發者團隊
原文外掛簡介
Garagem connects WordPress to Garagem CRM so you can publish property search/listing pages, property detail pages, and seller lead flows with real-time synchronization.
It is compatible with standard WordPress themes and page builders (including Gutenberg, Elementor, and Divi), and supports server-side rendering for crawlable HTML output.
Why use Garagem?
Setup and synchronization
Fast setup — Install, configure your Site ID, add a shortcode, and publish listings without custom code
Near real-time updates — Property updates in Garagem CRM are reflected on the site
Theme compatibility — Responsive UI that integrates with common WordPress themes/builders
Caching support — Uses minified assets and works with common cache plugins
Search and navigation
Advanced filters — Filter by listing type, property type, bedrooms, price range, area, and more
Carousel mode — Display highlighted listings with horizontal navigation
Configurable display — Control grid density, primary color, and display mode via shortcode attributes
Property pages
Individual property URLs — Detail pages with media, metadata, and lead forms
SEO-ready output — Server-rendered HTML plus JSON-LD and Open Graph metadata
Related properties — Similar listings support to improve navigation
Lead capture
Integrated forms — Contact/visit forms and seller lead flow connected to Garagem CRM
WhatsApp workflow support — Designed to fit CRM workflows that include WhatsApp communication
Quick start
Install and activate the plugin
Go to Settings → Garagem
Configure your Site ID (Garagem CRM → Settings → Channels → Sites)
Add a shortcode to any page:
[garagem_search] (search/listing)
[garagem_property code="145242"] (single property page)
[garagem_seller_lead] (seller lead flow)
Shortcodes
[garagem_search] — Search form + property grid
[garagem_property code="145242"] — Full page for a specific property
[garagem_seller_lead] — Seller lead capture flow
Shortcode attributes
[garagem_search]
layout — Grid density: confortavel (default), compacto, denso, ultra-denso
limit — Properties per page (default: 12)
display — grid (default) or carousel
property_click — detail (default, drawer) or page (property page)
hide_search — true to hide the search bar
new_tab — true to open links in a new tab
[garagem_seller_lead]
photo_module — enabled or disabled
photo_modes — CSV options: upload,schedule,later
schedule_disabled_days — CSV blocked days (0-6)
weekday_time_slots — CSV time slots for weekdays
weekend_time_slots — CSV time slots for weekends
property_fields — CSV for step-2 fields (example: saleValue:required)
background_color — Background color (hex)
text_color — Text color (hex)
About Garagem
Garagem is a real estate CRM platform for agents and brokerages.
Learn more: Garagem website | Plugin documentation
Requirements
An active Garagem CRM account (paid service) with at least one published site — this plugin depends on Garagem API services
PHP 7.4 or newer
WordPress 6.0 or newer
For developers
Source code and build tooling are available at:
https://github.com/emcasa/garagem/tree/main/apps/site/wordpress-plugin
The plugin includes both minified assets (assets/) and non-minified source files (src/) for review. Minification is built with esbuild and keeps identifiers readable (no mangling).
Visual customization: all plugin CSS classes use the .garagem- prefix and can be overridden in your theme CSS or a custom CSS plugin, without editing plugin files.
Compatibility: the plugin uses standard WordPress enqueue APIs (wp_enqueue_scripts, wp_enqueue_style) and is designed to avoid conflicts with themes/plugins. Shortcodes work in any shortcode-enabled context, including Elementor (HTML/Shortcode widget), Divi (Text/Code module), and the Block Editor (Shortcode block).
External services
This plugin connects to the Garagem Sites API to display property listings on your WordPress site. The default API origin is https://cdn.fndn.ai. A saved endpoint of https://app.garagem.ai/api/sites is upgraded to that default automatically. An explicit custom endpoint in Settings is left unchanged.
This service is provided by Garagem (https://garagem.ai).
What the service is and what it is used for:
The Garagem Sites API provides real estate listing data. Requests use the base https://cdn.fndn.ai/site/api/sites:
Fetch site configuration (branding, URL patterns) — GET /resolve?siteId={siteId}
Fetch search results with filters and pagination — POST /{siteId}/search
Fetch individual property details — GET /{siteId}/property/{id}
Fetch available locations for the filter UI — GET /{siteId}/locations
Receive contact, visit, and seller-lead submissions — POST /api/webhooks/sites/{siteId}/leads on the same origin
Receive property photo uploads from the seller lead flow — POST /api/webhooks/sites/{siteId}/photos on the same origin
The [garagem_seller_lead] shortcode also loads a map for address entry:
By default it loads https://maps.fndn.ai/sdk.js (Garagem Maps). No Google API key is sent.
If a Google Maps API key is saved in Settings → Garagem, that loader is replaced by https://maps.googleapis.com/maps/api/js and the key is sent to Google as the key query parameter.
What data is sent and when:
On every page load containing a plugin shortcode: your Garagem Site ID, search parameters entered by visitors (text query, filters, pagination), and property codes when viewing individual properties. Responses are cached with WordPress Transients: search for 1 minute, site configuration and property details for 5 minutes, locations for 30 minutes.
On a seller-lead page: the browser loads https://maps.fndn.ai/sdk.js, or Google Maps JavaScript when a key is configured. Address text the visitor types is sent to that map service for autocomplete.
On voluntary form submission only: name, email, phone, message, address, property metadata, optional visit date/time, and optional photos. No visitor-identifiable data is sent unless the visitor submits a form.
No tracking: The plugin does not set cookies, does not collect visitor analytics, and does not fingerprint visitors.
Service URL: https://cdn.fndn.ai/site/api/sites
Maps URL: https://maps.fndn.ai/sdk.js
Terms of Use: https://garagem.ai/termos
Privacy Policy: https://garagem.ai/privacidade
