Michael Bromley 6c21cc90c1 chore(docs): Update code block language code 2 anni fa
..
api 2b9ce33915 chore(dev-server): Add test plugins for new UI extension APIs 2 anni fa
entities 2b9ce33915 chore(dev-server): Add test plugins for new UI extension APIs 2 anni fa
ui 6c21cc90c1 chore(docs): Update code block language code 2 anni fa
.gitignore 2b9ce33915 chore(dev-server): Add test plugins for new UI extension APIs 2 anni fa
README.md 2b9ce33915 chore(dev-server): Add test plugins for new UI extension APIs 2 anni fa
generated-admin-types.ts 6c21cc90c1 chore(docs): Update code block language code 2 anni fa
generated-shop-types.ts 6c21cc90c1 chore(docs): Update code block language code 2 anni fa
reviews-plugin.ts 2b9ce33915 chore(dev-server): Add test plugins for new UI extension APIs 2 anni fa
types.ts 2b9ce33915 chore(dev-server): Add test plugins for new UI extension APIs 2 anni fa

README.md

Reviews Plugin

The reviews plugin add product reviews to Vendure.

Screenshot of the Admin UI product details page with reviews

This plugin demonstrates many capabilities of the Vendure plugin system:

  • Creation of new database entities (see ./entities)
  • Extension of the GraphQL APIs with new types, extensions of existing types, new queries and new mutations (see ./api/api-extensions.ts)
  • Implementation of custom resolvers for those GraphQL extensions (e.g. ./api/product-entity.resolver.ts)
  • Modifying the VendureConfig to add CustomFields (see ./reviews-plugin.ts)
  • Extending the Admin UI with custom UI components for those CustomFields as well as list and details views for managing reviews.
  • Adding a custom widget to the Admin UI dashboard
  • End-to-end testing of the GraphQL extensions & business logic with Vitest & the @vendure/testing package.

Usage

Start the Vendure server and then in the Shop API (http://localhost:3000/shop-api) try the following mutation:

mutation {
  submitProductReview(input: {
    productId: 2
    summary: "Good tablet"
    body: "The screen is clear, bright and sharp!"
    rating: 5
    authorName: "Joe Smith"
    authorLocation: "London"
  }) {
    id
    state
  }
}

You should then be able to log into the Admin UI (http://localhost:3000/admin) and see the new "Product Reviews" menu item on the left. Clicking this takes you to a brand new extension module listing all product reviews. You can approve the review that was just submitted.

When viewing the Tablet product (http://localhost:3000/admin/catalog/inventory/2) you'll now see the review rating and count which make use of the custom UI controls defined in the ui extension.