How to Use Custom Fields in Listings Widgets?

Custom fields are a powerful feature in the widget editor that allows users to create and personalize their listings according to their specific needs. These fields enable the addition of various types of information to each listing, enhancing the detail and functionality of the listings. Custom fields can range from simple text entries to complex interactive elements like image galleries, ratings, and more.

Custom fields are used for:

• Adding additional information to listings that are not covered by default fields.

• Customizing the appearance and functionality of listings.

• Enabling users to sort, filter, and search through listings based on specific criteria.

General Properties of Custom Fields

Each custom field has several general properties that determine its behavior and appearance within the widget. These properties allow for a high level of customization, ensuring that each field serves its intended purpose effectively. Below are the general properties that custom fields can have:

1. Show Field Name

   • Description: Determines whether the name of the field is displayed alongside the field value.
     
     

   • Usage: Toggle this option on if you want users to see the name of the field.

2. Global Value

   • Description: Indicates whether the field value should be the same across all items in the listing.
     
     

   • Usage: Toggle this option on to use the same value for this field in all items.
     
     
     
     

3. Show in Listing Item

   • Description: Specifies whether the field should be displayed in the listing item view.
     
     

   • Usage: Toggle this option on to show the field in the summary view of the listing item.
     
     
     
     

4. Show in Full Details View

   • Description: Determines if the field should be displayed in the detailed view of the listing item.
     
     

   • Usage: Toggle this option on to include the field in the detailed view.
     
     

5. Searchable Field

   • Description: Indicates if the field should be included in search queries.
     
     

   • Usage: Toggle this option on to make the field searchable.
     
     

6. Show as a Sorting Option

   • Description: Allows the field to be used as a sorting criterion in the listing.
     
     

   • Usage: Toggle this option on to enable sorting by this field.
     
     

These general properties are available for each custom field, allowing users to tailor their listings to their specific requirements and improve the overall user experience.

Custom Field Types

In addition to the general properties, each custom field can be of various types, each with its own specific settings and use cases. Here are some common custom field types and their applications:

1. Text Field

   • Field Types: Free Text, Short Text, Paragraph, Title, Subtitle, Heading (3-6)
     
     

   • Description: Used for adding text information.
     
     

   • Properties:

     • Text Type: Defines the format of the text (e.g., Paragraph, Title, Heading).

     • Field Name: The label for the text field.

     • Default Value: The initial text to display in the field.
       
       

2. Link Field

   • Description: Used for adding hyperlinks to external resources.
     
     

   • Properties:

     • Field Name: The label for the link field.

     • Default Value: The URL to link to.

     • Default Value Text: The text displayed for the link.
       
       

3. Email Field

   • Description: Used for adding email addresses.
     
     

   • Properties:

     • Field Name: The label for the email field.

     • Default Value: The email address to display.
       
       

4. Button Field

   • Description: Used for adding interactive buttons.
     
     

   • Properties:

     • Field Name: The label for the button.

     • Default Value Text: The text displayed on the button.

     • Default Value URL: The URL the button links to.

     • Default Value Link Target: Determines if the link opens in a new tab or the same tab.
       
       

5. Tags Field

   • Description: Used for adding tags to categorize listings.
     
     

   • Properties:

     • Field Name: The label for the tags field.

     • Options: List of predefined tags.
       
       

6. Categories Field

   • Description: Used for adding categories to listings.
     
     

   • Properties:

     • Field Name: The label for the categories field.

     • Options: List of predefined categories.
       
       

7. Icon Set Field

   • Description: Used for adding sets of icons.
     
     

   • Properties:

     • Field Name: The label for the icon set field.

     • Options: List of icons with their labels.
       
       

8. Image Gallery Field

   • Description: Used for adding multiple images in a gallery format.
     
     

   • Properties:

     • Field Name: The label for the image gallery.

     • Layout: Defines the layout of the image gallery (e.g., Grid, 2 Rows, 1 Row).
       
       

9. Rating Field

   • Description: Used for adding a rating system to listings.
     
     

   • Properties:

     • Field Name: The label for the rating field.

     • Default Value: The initial rating value (e.g., 5 stars).
       
       

10. List Field

    • Description: Used for adding lists of items.
      
      

    • Properties:

      • Field Name: The label for the list field.

      • Default Value: The initial items in the list.
        
        

11. Price Field

    • Description: Used for adding pricing information.
      
      

    • Properties:

      • Field Name: The label for the price field.

      • Default Value: The initial price value.

      • Currency: The currency for the price (e.g., US Dollar).
        
        

12. Parameter Field

    • Description: Used for adding parameters with predefined options.
      
      

    • Properties:

      • Field Name: The label for the parameter field.

      • Options: List of predefined parameters.
        
        

13. Date Range Field

    • Description: Used for specifying a range of dates.
      
      

    • Properties:

      • Field Name: The label for the date range field.

      • Default Value: The initial start and end dates.

      • Hide Icon: Option to hide the date range icon.

      • Hide Expired Events: Option to hide expired events.
        
        

14. Widget Field

    • Description: Used for adding custom widgets.
      
      

    • Properties:
      

      • Field Name: The label for the widget field.

      • Default Value: The initial widget configuration.

By utilizing these custom field types and their detailed properties, users can create comprehensive and detailed listings tailored to their specific needs.