AeroIDX – Real Estate IDX Search, MLS Listings & Lead Capture
| 开发者 |
realtycandy
redjim |
|---|---|
| 更新时间 | 2026年8月25日 23:27 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
AeroIDX turns your real estate (IDX) listings into real WordPress pages that load fast and are built to rank. Every property gets a clean, readable URL, and its SEO markup is written on the server, so search engines can crawl and index a listing as soon as it goes up.
Most IDX widgets draw their listings with JavaScript in the browser, which leaves the page's HTML nearly empty for search engines. AeroIDX does the opposite. It writes the title, meta description, Open Graph and Twitter Card tags, the canonical link, and the structured data straight into the server response.
Key features
- Clean listing URLs. Every property is served at
/details/{address-slug}/{listing-id}. - Server-side SEO tags. The
<title>, meta description, Open Graph, and Twitter Card tags render on the server for every listing. - Schema.org structured data. Each listing outputs
RealEstateListingJSON-LD, so it can qualify for rich results in Google. - Works with your SEO plugin. When Yoast SEO or Rank Math is active, AeroIDX hands them the listing data. With no SEO plugin, it outputs the tags itself.
- XML sitemap. A dedicated sitemap lists every property so search engines can find them all.
- Canonical URLs and legacy redirects. Old
/details?id=...links 301-redirect to the canonical URL, so you keep the SEO equity. - Classic and block themes. Works with both classic themes and block (FSE) themes.
- Clean handling of removed listings. A delisted property returns a proper HTTP 410 (Gone) page instead of a broken link.
- Market pages. Give a saved market its own WordPress page and write your own content around its listings, or drop a market into an existing page with a shortcode.
安装:
- Upload the plugin folder to
/wp-content/plugins/, or install the plugin ZIP via Plugins → Add New → Upload Plugin. - Activate the plugin through the Plugins screen in WordPress.
- Make sure pretty permalinks are enabled (Settings → Permalinks, any option other than "Plain"). AeroIDX needs them to serve clean listing URLs.
- Open the AeroIDX menu in the WordPress admin sidebar.
- Enter the API Key from your AeroIDX account and save.
/details/{address-slug}/{listing-id}.屏幕截图:
常见问题:
Do I need an AeroIDX account?
Yes. AeroIDX is the WordPress front end for the AeroIDX platform. You need an active account and an API key. Get one at https://app.aeroidx.com/api-keys.
Does it work with Yoast SEO or Rank Math?
Yes. AeroIDX detects Yoast SEO and Rank Math and feeds them the listing data so they generate the meta tags. If no SEO plugin is active, AeroIDX outputs the SEO tags itself.
Do I have to use pretty permalinks?
Yes. AeroIDX serves listings at clean URLs, which requires the WordPress permalink setting to be anything other than "Plain".
Does it work with block (FSE) themes?
Yes. AeroIDX supports both classic themes and block themes. The listing widget is injected into the theme's content area in either case.
Where do listing pages appear?
Every listing is rendered at /details/{address-slug}/{listing-id} on your site. AeroIDX also generates an XML sitemap so search engines can find them all.
What happens to a listing that is sold or removed?
AeroIDX returns a proper HTTP 410 (Gone) page for delisted properties, so you don't accumulate broken links or soft 404s.
How do I style listing pages to match my theme?
AeroIDX listing pages aren't editable in the WordPress editor. They're rendered on demand from your IDX data. To style them, use the scoped CSS hooks the plugin exposes from your theme custom CSS, a page builder custom CSS field (Bricks, Elementor, etc.), or a child theme stylesheet. Your rules only affect AeroIDX pages:
body.aeroidx-page: body class on every page AeroIDX creates for you — Search, Sign In, My Account, Featured, Roster, the /aeroidx shell, and each market page. On the built-in listing and agent pages it comes from the classic templates, so block themes render those two without it.#aeroidx-listing-detail,.aeroidx-listing-detail: main wrapper of the listing detail page. Classic themes only.#aeroidx-agent-detail,.aeroidx-agent-detail: main wrapper of the agent listings page. Classic themes only..aeroidx-widget-mount: direct parent of every AeroIDX widget, on every surface the plugin renders..aeroidx-listing-gone,.aeroidx-agent-gone,.aeroidx-page-gone,.aeroidx-listing-error: the “no longer available” and error states.
更新日志:
0.6.0
- New: saving your API Key now checks it with AeroIDX before storing it. A key with a character missing is refused instead of quietly saved, and the working key you already had stays in place.
- New: the Settings screen says whether AeroIDX is answering, which plan the account is on, and when it last checked.
- New: the Appearance screen adapts to your theme. It lists the selectors that exist on the theme you are actually running, and each one has a copy button.
- New: a "where do I find my key" link on the screens that ask for one, pointing at the page in AeroIDX that issues it.
- New: when another page already sits at the address an IDX page wants, AeroIDX asks what should happen instead of deciding on its own. Use the page that is already there, or put the IDX page at an address of its own.
- New: AeroIDX recognises the pages it set up earlier, even after you rename or move one. It offers to pick that page back up rather than build a second copy of it.
- New: market pages ask the same questions, and every market on the Markets screen shows whether its page already exists, with a button to connect it.
- Changed: changing your API Key now clears the data cached from the previous account. Switching accounts used to leave the old one's markets and widgets on screen for up to an hour.
- Changed: the setup wizard now uses the same buttons, fields and wording as the rest of the plugin's screens.
- Changed: the AeroIDX screens use the full width of the page, and the page settings sit in two columns instead of one narrow one.
- Changed: when AeroIDX uses a page you already have, it adds the IDX content below what is on that page. Nothing is removed, and you can rearrange it in the editor.
- Changed: the setup wizard asks the same questions as the Pages screen. Creating every page at once no longer reconnects a page without telling you.
- Fixed: creating an IDX page when another page already sat at its address published a duplicate at /search-2, /featured-2 and so on. AeroIDX stops and asks instead.
- Fixed: AeroIDX did not recognise the pages it had created itself, so deleting an IDX page and setting it up again produced another duplicate every time.
- Fixed: widgets added with the
[aeroidx_widget]shortcode had no element to style, although the plugin's own documentation said they did. Every AeroIDX widget now sits inside.aeroidx-widget-mount. - Fixed: an API Key that had stopped working removed Team-only pages and lowered the counts on the Home screen without saying why. The plugin now tells you the key was rejected.
- Fixed: the setup wizard said your key had failed when AeroIDX simply could not be reached, sending people to replace a key that was fine.
- Fixed: the admin could take around twenty seconds to load while an API Key was not working.
- Fixed: a copy button that failed to reach your clipboard gave no sign of it, so you could paste something else without noticing.
- Fixed: the styling documentation described where selectors apply. Two of the four descriptions were wrong.
- New: a Markets screen in wp-admin. Give any market on your AeroIDX account its own WordPress page, then edit that page like any other: write about the area, add your own photos, and the market's listings sit inside it.
- New: an
[aeroidx_market id="..."]shortcode, for dropping a single market into a page you already have. - New: the plugin now creates a page called AeroIDX on your site. Links to a market from your AeroIDX dashboard need it, and until now you had to create that page yourself. If you already made one, the plugin uses it and leaves your content alone.
- Fixed: links to a market from your AeroIDX dashboard, from an alert, or from a Market Areas widget led nowhere on a WordPress site. They now open the right page.
- Fixed: some text on the AeroIDX admin screens was too light to read comfortably, including search box placeholders and the current page number in a list.
- Fixed: buttons on the AeroIDX admin screens kept a blue outline after being clicked, as though they were still selected.
- Fixed: the dropdowns on the AeroIDX admin screens were missing their arrow, so they looked like text fields.
- Fixed: a widget pasted straight into a page, rather than added with the AeroIDX shortcode or block, only worked if the AeroIDX script was also in your site header. Widgets now work on their own, wherever you put them.
- Fixed: listing and search screens pushed the rest of the page down as they finished loading. Space is now held for them from the start, so nothing moves.
- Changed: if you added the AeroIDX script to your site header, you can remove it. The plugin loads what your widgets need by itself, and keeping both no longer loads it twice.
- Performance: that code now starts loading at the top of the page instead of the bottom, so widgets appear sooner.
- New: a Widgets screen in wp-admin. Pick a widget type, build it in the full AeroIDX builder (it opens in a new tab), and get a shortcode ready to paste on any page.
- New: a widget library to manage what you've built. Edit, duplicate, or delete a widget, and copy its shortcode with one click.
- New: testimonials widget, a carousel of client testimonials.
- Fixed: creating an IDX page before saving your API Key published a page that visitors saw empty. The plugin now asks for the key first, on every route that could get there.
- New: deleting an IDX page asks you to confirm first. The page goes to the Trash, but AeroIDX stops treating it as that IDX page, and the confirmation says so.
- Design: the admin screens were rebuilt to match AeroIDX — same layout, refreshed colour, type and spacing.
- Privacy: the admin now uses a typeface that ships inside the plugin instead of loading one from an outside service, so no administrator IP reaches a font host.
- Maintenance: filtering the widget list with no matches now offers a way back to the full list.
- Fixed: on sites running Yoast SEO or Rank Math, the sitemap index answered with a "page not found" error. Those plugins claim every URL that ends in -sitemap.xml, so the index moved to /aeroidx-sitemap-index.xml. The old address still works wherever it worked before.
- Fixed: robots.txt no longer points search engines at the sitemap until it actually holds listings.
- Clearer, more benefit-focused plugin description and readme copy for real estate agents. No functional changes.
- Internationalization: the text domain now matches the plugin slug, so translations load correctly.
- Performance: sitemap data is no longer autoloaded on every page request.
- Security: hardened URL escaping in Open Graph and Twitter Card meta tags.
- Maintenance: clearer plugin description and installation instructions.
- New: SEO-friendly agent pages at /agent/{name}/{id}: clean URLs with canonical, Open Graph, Twitter Cards, and Person schema.
- New: configurable agent URL base, with 301 redirects from previously used bases so old links keep working.
- New: agent pages integrate with Yoast SEO and Rank Math, feeding agent data through their tags so output stays single-source (no duplicate meta).
- Improved: agent pages now reach full SEO parity with listing detail pages.
- Initial release.