🛠️ Customizing the IDX Omnibar Widget
You can enhance the user experience of the Omnibar by converting input fields into dropdowns or adding placeholder text.
Converting Price Fields to Dropdowns
Use the following script to change the Min and Max Price fields from standard text inputs to predefined dropdown selections.
-
Function: Replaces the
.idx-omnibar-min-price-containerand.idx-omnibar-max-price-containerwith<select>elements. -
Note: This script is specific to the widget ID
#idx_omnibar_widget-2.
JavaScript
jQuery( document ).ready(function($) {
// Min Price Dropdown
$('#idx_omnibar_widget-2 .idx-omnibar-min-price-container').html('<select class="idx-omnibar-min-price" name="lp"><option value="">Min Price</option><option value="50000">$50,000</option><option value="100000">$100,000</option><option value="250000">$250,000</option><option value="500000">$500,000</option></select>');
// Max Price Dropdown
$('#idx_omnibar_widget-2 .idx-omnibar-max-price-container').html('<select class="idx-omnibar-price" name="hp"><option value="">Max Price</option><option value="100000">$100,000</option><option value="250000">$250,000</option><option value="500000">$500,000</option><option value="1000000">$1,000,000</option></select>');
$('.idx-omnibar-bath').attr(({step:1}));
});
Adding Placeholder Text
To clarify what users should enter in the Beds and Baths fields, use this script to set HTML placeholders.
JavaScript
<script>
function placeholders() {
document.querySelector("input[class=idx-omnibar-bed]").setAttribute("placeholder", "Beds");
document.querySelector("input[class=idx-omnibar-bath]").setAttribute("placeholder", "Baths");
}
jQuery(document).ready(placeholders);
</script>
🔌 Troubleshooting IMPress for IDX Broker (WordPress)
The IMPress plugin relies heavily on API calls to build wrappers, search widgets, and saved links. Issues often stem from API errors or environment conflicts.
Common API Error Codes
If the plugin reports an error, refer to this table to identify the cause:
| Error Code | Meaning | Action Required |
|---|---|---|
| 400 | Missing/Invalid parameter |
Check widget or shortcode settings.
|
| 401/406 | Invalid or missing API key |
Verify the API key in IDX Broker settings.
|
| 403.4 | SSL (HTTPS) Required |
Ensure your hosting and IDX pages use SSL.
|
| 412 | Hourly API limit reached |
Check your IDX dashboard for high-frequency calls.
|
| 500+ | System/Maintenance error |
Usually an IDX-side issue; try again later.
|
Troubleshooting Steps
-
Verify Outside WordPress: Test your API key using a tool like Postman or an API tester. If the API works there, the issue is a WordPress conflict.
-
Conflict Testing: Deactivate all other plugins and switch to a default theme to see if the error persists.
-
Check Hosting: If you see a 403 error, contact your host to ensure they allow outgoing HTTPS calls to the IDX API.
-
Review Changelogs: Check the plugin changelog for known issues in recent versions.
When to Escalate
Report any error code above 412 or unresolved technical bugs to developers@idxbroker.com.
Important: When emailing support, include your WordPress version, plugin version, a link to the issue, and a list of all active plugins.