Image 1 of 1

Customer Managed Groups

Product information

By Pinelab

Allow customers to manage their own groups, for example to manage family members

npm install @pinelab/vendure-plugin-customer-managed-groups
Support by
Support languages
en
nl
Integration type
Partner
Category
Other
Compatible with
>=2.2.0
Latest version
1.4.1
Last published
Aug 6, 2024
Downloads in past month
256

Vendure Customer Group Extensions

This plugin allows customers to manage their own groups, called Customer Managed Groups. Customer Managed Groups can have Group Admins and Group members.

  • Group admins and members are stored as Vendure’s built-in customers, and the groups are the built-in Customer Group entities.
  • Customers can only be in one group, and they are either group participant or group admin. (Customers can still be in multiple)
  • Customers can create groups and add other non-admin customers to their group. Adding others to your group automatically makes you administrator of the group.
  • Group Admins can fetch placed orders for everyone in the group.
  • Group Admins can update profile details of members of their group.

Getting started

Add the plugin to your config:

import { CustomerManagedGroupsPlugin } from '@pinelab/vendure-plugin-customer-managed-group';
plugins: [CustomerManagedGroupsPlugin];

You can create your own group via the Shop API, if you are logged in as a customer, by inviting another customer by email:

  mutation {
    addCustomerToMyCustomerManagedGroup('invitee@gmail.com') {
        id
        createdAt
        updatedAt
        name
        administrators {
            id
            title
            firstName
            lastName
            emailAddress
        }
        participants {
            id
            title
            firstName
            lastName
            emailAddress
        }
    }
  }

You can also remove participants again, by passing in the customer id that should be removed:

  mutation {
    removeCustomerToMyCustomerManagedGroup('2') {
        id
        createdAt
        updatedAt
        name
        administrators {
            id
            title
            firstName
            lastName
            emailAddress
        }
        participants {
            id
            title
            firstName
            lastName
            emailAddress
        }
    }
  }

Admins are allowed to fetch orders of all customers in a group. You can do this with the following query:

query {
  ordersForMyCustomerManagedGroup {
    items {
      id
      code
      customer {
        emailAddress
      }
    }
    totalItems
  }
}

These are all the GraphQL queries and mutations exposed by this plugin:

extend type Mutation {
  """
  Creates a group with the current logged in user as administrator of the group
  """
  addCustomerToMyCustomerManagedGroup(
    input: AddCustomerToMyCustomerManagedGroupInput
  ): CustomerManagedGroup!
  """
  Create an empty group with the current user as Administrator
  """
  createCustomerManagedGroup: CustomerManagedGroup!

  removeCustomerFromMyCustomerManagedGroup(
    customerId: ID!
  ): CustomerManagedGroup!
}

extend type Query {
  """
  Fetch placed orders for each member of the group
  """
  ordersForMyCustomerManagedGroup: OrderList!
  """
  Fetch the current logged in group member
  """
  activeCustomerManagedGroupMember: CustomerManagedGroupMember

  myCustomerManagedGroup: CustomerManagedGroup
}

Contributions

Thanks @mschipperheyn for his contributions on this plugin.

Vendure
Get started

Create your first commerce experience with Vendure in less than 2 minutes

Vendure is a registered trademark. Our trademark policy ensures that our brand and products are protected. Feel free to reach out if you have any questions about our trademarks.

Newsletter

Get the latest product news and announcements delivered directly to your inbox.

© Copyright 2022 - 2024, Vendure GmbH. All rights reserved.