Design Listing Widget

The Design Listing Widget lets you display a list of designs on your website that visitors can use to decorate products. You can modify the appearance and content of the design list by editing the Design Listing Widget settings.

In this article, you will learn how...

• To add a Design Listing Widget to your website
• To edit/add category tabs in a Design Listing Widget
• To configure the Design settings for the Design Listing Widget

To add a Design Listing Widget to your website:

1. Click on the WIDGETS button in the Website Editor Toolbar.
2. Browse the Widgets tab to locate the Design Listing Widget in the LISTS section.
   
3. Click and drag the Design Listing Widget onto your website page.

   Allowable areas the Design Listing Widget can be inserted into include:

   • Within rows
   • Within columns
   • Above or below existing widgets
   • Between existing widgets

   The Design Listing Settings popup will be displayed.

   
4. Configure the Properties for the Design Listing Widget.
   • Panel title: lets you specify the title that will appear in the header area for the design listing.
   • Categories Display Type: sets the overall look of the product listing.
     • Normal: displays products as a flat listing.

       The following settings are displayed only if "Normal" is selected from the Categories Display drop-down.

       • List Display: lets you choose the source of products to display.
         • Featured Products: displays products that are marked as featured.
         • Latest Products: displays the most recently added products.
         • Most Popular Products: displays products that are selling at a high rate.
         • Highest Voted Products: displays the products which have received the highest customer rating.
         • All Products: displays all product categories.
       • Category lets you choose the category of products to be displayed. All categories will be displayed if nothing is selected.
     • Display Categories as Tabs: displays products within tabs configured for specific categories.

       When this option is selected, you are able to add multiple tabs to display different categories of products. By default, a tab containing all products will be preconfigured.

       Click here for instructions on how to edit or add category tabs.

   • Show Designs: lets you choose whether stock or store designs will be available in the design listing.
     • Show Store Designs: only displays designs that have been uploaded to the store.
     • Show Stock Designs: only displays designs added from the stock design collection.
     • Show both Store and Stock Designs: displays both uploaded and stock collection designs.
   • Designs Per Listing: lets you specify the number of designs the listing will be limited to per page.
5. Configure the Design settings for the Design Listing Widget. Click here for instructions.
6. Click OK to apply the changes.
7. Click on the Save button and then click on the Publish button at the right of the Page Settings Bar.

To edit/add category tabs:

1. Make sure Display Categories as Tabs is selected in the Categories Display Type drop-down box.

   A section called, "Select categories you wish to appear as tabs" will be displayed.

   

   By default, a tab containing all products will be preconfigured.

2. Click on the Configure button to edit existing tabs.

   OR

   Click on the + button to add a new tab.

   The properties for editing a tab category and adding a tab category are the same:

   
3. Configure the tab properties as required:
   • Tab Content: lets you choose the source of products to display.
     • Featured Products: displays products that are marked as featured.
     • Latest Products: displays the most recently added products.
     • Most Popular Products: displays products that are selling at a high rate.
     • Highest Voted Products: displays the products which have received the highest customer rating.
     • All Designs: displays all design categories.
       • Tab Type: lets you choose one of the following types.
         • Single: displays a single category.
         • Group: displays a group of categories.
       • Category lets you choose the category of products to be displayed. All categories will be displayed if nothing is selected.
   • Category lets you choose the category of products to be displayed. All categories will be displayed if nothing is selected.
4. Click OK to apply the changes or click on the Design Listing breadcrumb link in the title bar to go back to editing the main properties.

To configure the Design settings for the Design Listing Widget:

1. Click on the Design tab.
   

   If you add the Design Listing Widget to a custom dropdown menu, the Show as Link(s) in Mobile Menu option will be available. When enabled, this option will generate matching links for the content placed in the custom dropdown menu that will be rendered as a simple list of links on the site's mobile menu.

   

2. Select from one of the pre-configured Design Listing Layout options:
   • Grid: design thumbnails maintain their aspect ratio and are displayed in the center of each cell in a uniform grid arrangement.
   • Masonry: design thumbnails are resized to have the same width while maintaining their aspect ratio and arranged to form equal columns. Designs are placed in optimal positions based on available vertical space.
   • Collage: design thumbnails maintain their aspect ratio, but are cropped and are placed in a pre-defined pattern arrangement of a specified number of items per row. You can set a 3,4,5, or 6 image pattern per row. Each row will use one of 4 pattern variations. If the last row has fewer items than necessary then the images will be arranged in a layout to ensure that all space is used on the final row.
   • Carousel: rotates the design thumbnails radially and in a 3D feel by using distance and depth of field. The design thumbnails rotate on an axis where the image is always facing you.
   • Stacked: design thumbnails maintain their aspect ratio and are displayed in a single column.
3. Configure the rest of the design options for the Design Listing Widget.

   The settings will vary depending on the layout selected.

   • Thumbnail size: lets you set the dimensions of the design thumbnails. You can choose a preset size or choose Custom Size to specify a custom size.

     The following fields will be displayed when you select Custom Size:

     • Thumbnail Width: lets you specify the width of the design thumbnail in pixels.
     • Thumbnail Height: lets you specify the width of the design thumbnail in pixels.

       The maximum allowable thumbnail width and height is 600px. If a value higher than 600 is entered, the value will be automatically reset to 600. This is to prevent blurry thumbnail images caused by upscaling of the design listing images since they are generated at a maximum size of 600x600 pixels at the time of upload.

     You can configure the container properties of the design thumbnails by clicking on the brush icon beside the Thumbnail Size field. The Thumbnail Properties popup will be displayed.

     
     • Background Color: lets you specify the background fill color of the design thumbnail.
     • Border Width: lets you specify the line thickness of the design thumbnail's border in pixels. Enter a value between 0 and 20.
     • Border Color: lets you specify the color of the design thumbnail's border. Click on the color spot to edit the border color using the Color popup. Click here for instructions.
     • Border Radius: lets you specify the roundness of the corners of the design thumbnail's border in pixels. Enter a value between 0 and 100.
   • Crop Thumbnail: crops the design thumbnail to square when the checkbox is ticked. Leaves the design in its original shape when the checkbox is unticked.
   • Inset Padding Thumbnail: will add spacing at a distance of 10% of the shortest side between the image and the container of design listing thumbnails.
   • Use Higher Resolution on Retina Displays: when checked, will double the pixel density of the images to increase the clarity of the image for retina displays.

     Retina displays have 4 times more pixels than standard screens. So, if you have a 600 x 600 pixel image, you would need a 1200 x 1200 pixel image to render smoothly on a high-density retina display. This setting will do this for you.

   • Image Effects: lets you apply filter and transform effects to the designs.
   • Hover Image Effects: lets you apply filter effects, transform effects and hover animation to the designs for the hover state.

     Click here for instructions on how to add image effects.

   • Panel Title: lets you configure the font style and the color for the title that will appear in the header area of the design listing panel.
     • Click on the font name to configure the font style using the Font popup. Click here for instructions.
     • Click on the color spot to choose a text color using the Color popup. Click here for instructions.
   • Text Overlay Background: lets you configure the background of any design information that is displayed on the design or on design rollover.

     Click on the brush icon to configure the text overlay background. The Text Overlay Background Properties popup will be displayed.

     
     • Background Color: lets you specify the background fill color of the text overlay. Click on the color spot to edit the background color using the Color popup. Click here for instructions.
     • Border Width: lets you specify the border line thickness of the text overlay background in pixels. Enter a value between 0 and 20.
     • Border Color: lets you specify the border color of the text overlay background. Click on the color spot to edit the border color using the Color popup. Click here for instructions.
     • Width: lets you specify the container width of the text overlay background as a percentage of the design thumbnail width.
     • Align: lets you choose an alignment option for the text overlay in reference to the design:
       • Left: aligns the text overlay to the left of the design thumbnail.
       • Center: centers the text overlay horizontally to the design thumbnail.
       • Right: aligns the text overlay to the right of the design thumbnail.
   • Categories Tab: lets you configure the appearance of the tab containing the design listing. (Only available if "Display Categories as Tabs" is selected in the Categories Display Type drop-down list in the Properties tab).
   • Categories Panel: lets you configure the appearance of the panel containing the design categories listing. (Only available if "Display Categories as Tabs" is selected in the Categories Display Type drop-down list in the Properties tab).
   • Design Panel: lets you configure the appearance of the panel containing the design listing.

     Click on the brush icon to configure the design of the Categories tab, Categories panel, and Design panel. The Panel Design popup will be displayed.

     
     • Background Color: lets you specify the background fill color of the design listing panel. Click on the color spot to edit the background color using the Color popup. Click here for instructions.
     • Border Width: lets you specify the line thickness of the design listing panel's border in pixels. Enter a value between 0 and 20.
     • Border Color: lets you specify the color of the design panel's border. Click on the color spot to edit the border color using the Color popup. Click here for instructions.
     • Border Radius: lets you specify the roundness of the corners of the design listing panel's border in pixels. Enter a value between 0 and 100.
   • Design Name: lets you choose an option for the display and placement of the design's name.
     • Don't Show: does not show the design name.
     • Show on Image: displays the design name across the middle of the design thumbnail.
     • Show on Image on Rollover: displays the design name across the middle of the design thumbnail when the mouse hovers over the design thumbnail.
     • Show Above: displays the design name above the center of the design thumbnail.
     • Show Above on Rollover: displays the design name above the center of the design thumbnail when the mouse hovers over the design thumbnail.
     • Show Below: displays the design name below the center of the design thumbnail.
     • Show Below on Rollover: displays the design name below the center of the design thumbnail when the mouse hovers over the design thumbnail.
   • Design Rollover Behavior: lets you choose the behavior when the mouse pointer hovers over the design thumbnail.
     • Do Nothing: does not show a popup window displaying the design.
     • Show Design in Popup: shows a popup window displaying an enlarged view of the design.

   The following settings are available for the Carousel design listing layout only:

   • Carousel Products Per Row: lets you specify how many designs are visible in the carousel row.
   • Carousel Arrow Position: lets you choose the position of scroll arrows displayed on the carousel.
   • Carousel Arrow Style: lets you choose and configure the style of scroll arrows displayed on the carousel.
   • Carousel Animation: displays the current setting duration setting for the transition from one slide to the next.

     Click on the brush icon to display the Animation Settings popup which lets you configure the animation for the transition between slides. Click here for instructions on how to add image effects.

4. Click OK, once you have finished configuring the settings.
5. Click on the Save button and then click on the Publish button at the right of the Page Settings Bar.