Wovax IDX

Basic Setup

1. In your WordPress admin dashboard, navigate to Wovax IDX > Settings and go to the Initial Setup tab.
2. Add a valid email address.
3. Choose an environment: Development (free demo listings) or Production (live MLS listings, requires an active Wovax IDX subscription licensed to your domain name).
4. Select the listing details page format you want to use. Currently there are two versions: the Gutenberg blocks page, and our Legacy system (which we do not recommend for new users).
5. Click Create Search Results Page button. This will create a page containing the Wovax IDX search results shortcode.
6. Click Create Listing Details Page button. This will create a page used to create the property listings style/layout template.
7. Save Changes.
8. Navigate to the Users and Styling tabs in the Settings page and select options as desired. Save changes.

Back To Top

Setup Gutenberg Listing Details Page

1. Make sure the ‘Gutenberg Blocks’ setting is selected in the Wovax Settings and that the listing details page was created correctly.
   1. To make sure the page was created correctly: Go to the ‘Listing Details’ page in the Pages section of the admin and click on it to open the editor. You should see the Gutenberg editor with a block for the listing photos, and then below that some labeled fields. If you don’t see that, make sure the Gutenberg editor is enabled on the site. If there’s just a shortcode, delete the page, empty the trash, and then re-create the listing details page using the button in Wovax settings.
2. Once you have the listing details page with the blocks editor open, you should be able to add and remove blocks using either the + button in the top left, or the + button that appears when you hover over the page.
   1. If you have the Top Toolbar option selected, you can move blocks around by clicking on them and then finding the Move Up and Move Down arrows on the top toolbar.
   2. If the Top Toolbar option is not selected, you can drag and drop blocks by clicking on them to select, and then holding down your mouse button over the six dots next to the arrows that indicate the drag and drop area.
3. Click on the + button and scroll down – you should see a section called ‘Wovax IDX’. Click on that to view the blocks for the listing details data.
   1. Adding a Labeled Field block: you should see the settings on the right sidebar. Click the ‘Field’ dropdown to set which field data should be displayed here. 
   2. Adding a Field Data block: You can also add just the field value with the ‘Field Data’ block. This is for instances where you want to label the field in some other way, or if the field data doesn’t need a label (for example Price or Description)
   3. The Field type dropdown in either the Labeled Field block or the Field Data block allows you to format the data in that field
      1. Link is for something like the Virtual Tour field, and it will format the contents as a clickable link if they are a valid url.
      2. Numeric adds a comma to numeric fields (1,000 vs 1000)
      3. Price adds commas and a dollar sign to numeric fields ($1,000 vs 1000)
      4. Text displays the field data as is, without making any modifications
   4. If you want to add a listing map, you’ll need to have an API key for the service you want to use (Google Maps, etc) which you’ll set in the main Wovax Settings area.
4. You can use the default WordPress formatting blocks (like the Groups or Columns blocks) to format the page, or you can search the plugin repository for plugins that add additional blocks and features to the editor. 
5. Save the page once you are done editing.

Back To Top

Setup Legacy Listing Details Page

1. Wovax IDX > IDX Feeds
2. Select a feed. Choose options from the General tab and save changes.
3. Under the Fields tab, choose aliases for standard IDX fields (if desired). If no alias is entered the default field titles will display on your site. Save Changes.
4. Under the Layout tab, drag and drop fields from Available Fields to Listing Fields. (Listing Fields will display on property detail pages.) Save Changes.

Back To Top

Search Form Shortcode

1. Go to the Shortcodes page in the admin menu under Wovax.
2. Click ‘Create New’
3. Select ‘Search Form’ under Type and name your shortcode, and save
4. Click the ‘View options’ tab and check Grid View and Pagination and save
5. Click the ‘Feeds’ tab and select the feeds you want the search bar to search, and then save the shortcode.
6. Click the ‘Filters’ tab, and for each search filter, follow these steps:
   1. Select a filter type – ‘Select’ creates a dropdown of all the possible values. The others are text inputs that can accept different types of input.
   2. Choose what field to search for that filter.
   3. Add the Label and the Placeholder (the placeholder is text that is present before any values are entered)
   4. Click Add Filter
7. When you’re done, copy the shortcode value from either the area next to the Edit Shortcode text, or the Shortcode column in the list of all shortcodes and paste it in the page or area you want the content displayed on.

Back To Top

Search Form Filter Options

• Types
  • Select: This is a dropdown of all the available choices in the field that you choose. For this reason, you’ll want to avoid fields that have a lot of different values. Property Type is a good choice for a Select dropdown, MLS# is not.
  • Numeric Range: This is a dropdown of min/max range values generated by the rules you choose.
    • Start and End: the number that begins the range and the number that ends the range. For example, if the field is Price and you choose 10000 as the start number and 100000 as the end number with 10000 as the interval, you’ll get values like 10,000 – 20,000 and 20,000 – 30,000. Selecting 10,000 – 20,000 would return listings with prices between 10,000 and 20,000. Basically, a minimum of the low number and a maximum of the high number.
    • Range Interval: The amount between two values in the generated range list. Dynamic is tied to the order of magnitude of the low number. So if the low number is in the ten thousands, the interval will be 10,000. If the low number is in the hundred thousands, the interval will be 100,000. All the other intervals you can select are static and won’t change.
  • Numeric: This searches for the exact value you input, and allows number inputs but not letters or symbols. Because the value is exact, this is best for things like Zip Code and MLS Number.
  • Numeric Maximum: This search filter returns any listings with numbers in the selected field below the value searched for. If the field is Price and the number input is 100,000, the search is going to return all listings whose price is under 100,000.
  • Numeric Minimum: The same as Numeric Maximum, but the searched number is a lower bound rather than an upper bound.
  • Text Search: This filter accepts any character, and looks for any listings that contain the text searched for. Searching for ‘Park’ in the Description field would return listings with words like parked, parking, and city parks in the description.
  • Omnisearch is a text search that allows you to search multiple fields.
• Field: This is what column in the MLS data your search will be applied to.
• Filter Label: This is the text that will show up even when there is text in the input or an option is selected for a dropdown.
• Filter Placeholder: This is the text that will show up in the filter before any text is input or any options are selected.

Back To Top

Listings Embed Shortcode

1. Go to the Shortcodes page in the admin menu under Wovax.
2. Click ‘Create New’
3. Select ‘Listing Embed’ under Type and name your shortcode, and save the shortcode.
4. Click the ‘View options’ tab and check Grid View and Pagination, and then save the shortcode.
5. Click the ‘Feeds’ tab and select the feeds you want the listings to pull from, and then save the shortcode.
6. Click the ‘Rules’ tab and create rules to select the listings you want to display.
   1. For example, if you want listings from the city of New York, you’d select the field ‘City’, then the type ‘Equals’ and then type ‘New York’ in the value box, and then click Add Rule
   2. For less specific values, you may want to use the ‘Contains’ type. This type is slower, but returns listings that have additional text to what you’re looking for. For example, if the Subdivisions New Haven, New Haven Properties, and New Haven Homes all refer to the same area, you could use a ‘Contains’ type with ‘New Haven’ in the value to return listings matching any of those.
   3. Numeric Min / Max types are for returning properties based on numeric fields, like Price or Square Footage. For example, you could use Numeric Min on a Price field to return all the listings that are at least $250,000
7. Once you’re done, you can copy the shortcode value from either the area next to the Edit Shortcode text, or the Shortcode column in the list of all shortcodes and paste it in the page or area you want the content displayed on.

Back To Top

Listings Embed Rules Options

• Field: This is the field that your rule will be applied to in order to select listings to display.
• Rule Type: 
  • Equals: Selects listings where the value exactly matches the rule value. 
  • Contains: Selects listings where the rule value is contained inside the field value for the listing.
  • Numeric Min: When used on a field with numeric values, selects all listings that have a numeric value at least as much as the value selected, and all greater than that value.
  • Numeric Max: When used on a field with numeric values, selects all listings that have a numeric value less than the value selected.
• Value: This is the value the Rule Type will be applied to.

Back To Top