Houzi Docs logo Houzi Docs

Important: You are required to install the Houzi Rest Api Plugin on your Houzez wordpress. To install the Plug-in, click on Houzi Rest Api Plugin Link.

A Mobile App View is provided in the center of screen, so you can see how the modifications will look on real device.

results-and-maps-screen

This guide consists of following sections:

Listing Item Designs
Display Configurations
Sorting Configurations

Let’s dive into the details of each section.


Listing Item Designs

Houzi provides you wide range of listing items designs. On the top right side of Results and Maps section, Listing Items designs are provided. Click on any design, and you will be able to see, how it will look on real device in the Mobile App View. (By default, selected design is Design 01, one of most popular designs.)

results-designs


Display Configurations


Sorting Configurations

Houzi provides you with following two sorting configuration:

Default Sort By
Sort First By

Let’s dive into the details of each configuration.

Default Sort By

When you search something, the corresponding search results can be sorted w.r.t. one of the following orders:

The default Houzi sort by order is “Newest”. You can select the desired sort by order from the Default Sort By dropdown.

sort-by-dropdown

sort-by-dropdown-menu


Sort First By

When you search something, the corresponding search results are sort by the default sort by order. If you want to further sort these results on the basis of some specific attributes e.g. if you want to sort results w.r.t. “Featured” results (meaning show featured results on top) or if you want to sort results w.r.t. “Term”, you can configure some settings in the “Sort First By” configurations.

To configure the Sort First By settings, Click on the Sort First By dropdown menu.

sort-first-by-dropdown

Following dialog will open:

sort-first-by-dialog

You can perform following opertions while configuring the Select First By settings:

Add new Item
Edit an Item
Delete an Item
Re-arrange an Item

You can add one or more Sort First By items to configure the sort. e.g. You can sort the searched results in such order that you want to see the newest result items on top and among these newest result items, you want to see those items on top which have the attribute of “Hot Offer” and among these items, you want to see the “Featured” items on top. To achieve such sorting, you can select the newest order from the Default Sort By dropdown. Next step will be to add the Featured and *Hot Offer *(which is a term attribute) in the Sort First By items. You can add these items by following the guide.

Let’s dive into the details of each operation.

Add New Item

You can add a sort first by item by clicking on the “ADD NEW WIDGET” button. Following dialog will be displayed:

sort-first-by-add-dialog-01

You have to set the following fields to add the sort first by item:

Section Type
Title
Default Value
Icon
Term
Sub-Term


Section Type

You can add sort first by items based on following two types of attributes from the Section Type dropdown menu:

  1. Featured.
  2. Term.

Featured
If you want to show the results items that have the attribute “Featured” on the top of results items listing.

Term
If you want to show the results items that have the attribute “Term” (some specific term e.g. result item with property_label Hot Offer) on the top of results items listing.

sfb-section-type-01

sfb-section-type-02


Title

You can define the title of the item in Title field.

sfb-title


Default Value

The default value indicates that either you want to apply this sort order on the search result items by default or let the user decide to use this sort order from the sort menu on the Results screen. You can choose the default value of an item to be on or off. On indicates that this sort option will be applied by default.

sfb-default-value-01

sfb-default-value-02

User can manually turn on or turn off the value of sort first by item from the sort menu on Results screen.


Icon

You can define the icon of your sort first by menu item. Click on the icon button, an icon picker dialog will open. You can either choose from Material Icons or Cupertino Icons. Just search and click the required icon, it will be displayed and previous icon will be replaced.

sfb-icon-01

sfb-icon-02


Term

This field is only available if you have chosen the Term section type.

You are provided with following three Houzez taxonomies to select your term:

Click on the Term dropdown menu and select your required taxonomy as Term.

sfb-term-01

sfb-term-02


Sub-Term

This field is only available if you have chosen the Term section type.

You select the sub-term, you must first select a term from the Term dropdown menu. After selecting the required term let say property_label, now its related sub-terms will be available for selection in the Sub-Term dropdown menu. Click on the Sub-Term dropdown menu and select your required sub-term.

sfb-sub-term-01

sfb-sub-term-02


After defining all the above sections, click on the Done button on the bottom of the dialog. Your item will added like following screenshot:

sfb-dialog-02

Click on the Done button on the bottom of the dialog.

You can see the view of Sort menu on the Mobile App View in the center of screen.


Edit an Item

You can Edit the item just by clicking on Edit Icon of respective section. While editing a section, you can perform following actions:

Term and Sub-Term are only section type “Term” related fields.

sfb-edit-01

sfb-edit-02


Delete an Item

You can Delete any item just by clicking on delete icon of respective item. A delete confirmation dialog will open.

sfb-delete-01

sfb-delete-02

Click Delete if you want to delete the item.
Click Cancel if you want to discard the action.


Re-arrange an Item

You can Re-arrange the Sort First By items. Hold the item that you want to re-arrange and move it vertically (upwards or downwards). Place it on desire position in items list.

sfb-re-arrange-01

sfb-re-arrange-02

Previous: Change design of Agency listing Next: Customize Listing Details