Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this document, we provide a resource of the basis JSON Schemas to be used for your project.

...

View file
namebasis_layout_blocks_all.json

product

display one specific product in a grid or a slider

Expand
titleJSON Schema
Code Block
languagejson
{
  "title": "Product",
  "type": "object",
  "properties": {
    "accessor": {
      "type": "string",
      "description": "hits accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
nameproduct.json

product_slider

display a container of products as a slider (children blocks should be product Layout Blocks)

Expand
titleJSON Schema

localized properties must be adapted to match your e-shop languages.

Code Block
languagejson
{
  "title": "Label",
  "type": "object",
  "properties": {
    "title": {
      "type": "object",
      "title": "Label",
      "properties": {
        "de": {
          "type": "string",
          "description": "label in German"
        },
        "fr": {
          "type": "string",
          "description": "label in French"
        }
      }
    },
    "see_all_label": {
      "type": "object",
      "title": "See all link label",
      "properties": {
        "de": {
          "type": "string",
          "description": "see all link label in German"
        },
        "fr": {
          "type": "string",
          "description": "see all link label in French"
        }
      }
    },
    "see_all_link": {
      "type": "object",
      "title": "See all link",
      "properties": {
        "de": {
          "type": "string",
          "description": "see all link in German"
        },
        "fr": {
          "type": "string",
          "description": "see all link in French"
        }
      }
    },
    "accessor": {
      "type": "string",
      "description": "hits accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
nameproduct_slider.json

product_list

display a container of products as a list or grid (children blocks should be product Layout Blocks)

Expand
titleJSON Schema

localized properties must be adapted to match your e-shop languages.

Code Block
languagejson
{
  "title": "Label",
  "type": "object",
  "properties": {
    "title": {
      "type": "object",
      "title": "Label",
      "properties": {
        "de": {
          "type": "string",
          "description": "label in German"
        },
        "fr": {
          "type": "string",
          "description": "label in French"
        }
      }
    },
    "see_all_label": {
      "type": "object",
      "title": "See all link label",
      "properties": {
        "de": {
          "type": "string",
          "description": "see all link label in German"
        },
        "fr": {
          "type": "string",
          "description": "see all link label in French"
        }
      }
    },
    "see_all_link": {
      "type": "object",
      "title": "See all link",
      "properties": {
        "de": {
          "type": "string",
          "description": "see all link in German"
        },
        "fr": {
          "type": "string",
          "description": "see all link in French"
        }
      }
    },
    "accessor": {
      "type": "string",
      "description": "hits accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
nameproduct_list.json

autocomplete_product

display one specific product in a search autocomplete overlay

Expand
titleJSON Schema
Code Block
languagejson
{
  "title": "Product",
  "type": "object",
  "properties": {
    "accessor": {
      "type": "string",
      "description": "hits accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
nameautocomplete_product.json

autocomplete_product_list

display a container of products as a list in a search autocomplete overlay (children blocks should be autocomplete_product Layout Blocks)

Expand
titleJSON Schema

localized properties must be adapted to match your e-shop languages.

Code Block
languagejson
{
  "title": "Label",
  "type": "object",
  "properties": {
    "title": {
      "type": "object",
      "title": "Label",
      "properties": {
        "de": {
          "type": "string",
          "description": "label in German"
        },
        "fr": {
          "type": "string",
          "description": "label in French"
        }
      }
    },
    "see_all_label": {
      "type": "object",
      "title": "See all link label",
      "properties": {
        "de": {
          "type": "string",
          "description": "see all link label in German"
        },
        "fr": {
          "type": "string",
          "description": "see all link label in French"
        }
      }
    },
    "see_all_link": {
      "type": "object",
      "title": "See all link",
      "properties": {
        "de": {
          "type": "string",
          "description": "see all link in German"
        },
        "fr": {
          "type": "string",
          "description": "see all link in French"
        }
      }
    },
    "accessor": {
      "type": "string",
      "description": "hits accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
nameautocomplete_product_list.json

autocomplete_text

display one specific textual suggestion in a search autocomplete overlay

Expand
titleJSON Schema
Code Block
languagejson
{
  "title": "Autocomplete Text",
  "type": "object",
  "properties": {
    "accessor": {
      "type": "string",
      "description": "autocomplete accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
nameautocomplete_text.json

autocomplete_text_list

display a container of text as a list in a search autocomplete overlay (children blocks should be autocomplete_text Layout Blocks)

Expand
titleJSON Schema
Code Block
languagejson
{
  "title": "Autocomplete Text List",
  "type": "object",
  "properties": {
    "accessor": {
      "type": "string",
      "description": "ac-queries accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
nameautocomplete_text_list.json

product_list_bar

a bar appearing before or after the product list to indicate the number of results, offer pagination and change of sort order

Expand
titleJSON Schema
Code Block
languagejson
{
  "title": "Product",
  "type": "object",
  "properties": {
    "accessor": {
      "type": "string",
      "description": "hits accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
nameproduct_list_bar.json

pagination

a component to appear as a child element of a product_list_bar Layout Block and which displays the pagination controls to the user

Expand
titleJSON Schema
Code Block
languagejson
{
  "title": "Pagination",
  "type": "object",
  "properties": {
    "accessor": {
      "type": "string",
      "description": "hits accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
namepagination.json

title

a simple title element showing a title H1 on the whole width of the page

Expand
titleJSON Schema

localized properties must be adapted to match your e-shop languages.

Code Block
languagejson
{
  "title": "Title (H1)",
  "type": "object",
  "properties": {
    "title": {
      "type": "object",
      "title": "Title",
      "properties": {
        "de": {
          "type": "string",
          "description": "title in German"
        },
        "fr": {
          "type": "string",
          "description": "title in French"
        }
      }
    }
  }
}

Complete Layout Block:

View file
nametitle.json

subtitle

a simple title element showing a sub-title H3 on the whole width of the page

Expand
titleJSON Schema

localized properties must be adapted to match your e-shop languages.

Code Block
languagejson
{
  "title": "Subtitle (H3)",
  "type": "object",
  "properties": {
    "title": {
      "type": "object",
      "title": "Title",
      "properties": {
        "de": {
          "type": "string",
          "description": "Subtitle in German"
        },
        "fr": {
          "type": "string",
          "description": "Subtitle in French"
        }
      }
    }
  }
}

Complete Layout Block:

View file
namesubtitle.json

search_title

a simple title element showing a search title H1 on the whole width of the page (very similar template to integrate, but has a different internal behavior in Boxalino due to the parameter bx-search-title.

Expand
titleJSON Schema

localized properties must be adapted to match your e-shop languages.

Code Block
languagejson
{
  "title": "Title (H1)",
  "type": "object",
  "properties": {
    "title": {
      "type": "object",
      "title": "Normal Search Title",
      "properties": {
        "de": {
          "type": "string",
          "description": "normal search titlein German"
        },
        "fr": {
          "type": "string",
          "description": "normal search title in French"
        }
      }
    },
    "bx_alternate_title": {
      "type": "object",
      "title": "Corrected Search Title",
      "properties": {
        "de": {
          "type": "string",
          "description": "corrected search title in German"
        },
        "fr": {
          "type": "string",
          "description": "corrected search titlein French"
        }
      }
    },
    "accessor": {
      "type": "string",
      "description": "search accessor (typically leave empty)"
    }
  }
}

Complete Layout Block:

View file
namesearch_title.json

facet_list

display the facets in a search or navigation page (has no children blocks, all the facets are provided as an array in the response parameter bx-facets)

...