Skip to content

Shared Protocols

User roles

Community manager, protocol steward

In a Mukurtu site, protocols typically belong to one community. At times, however, related families, villages, clans, or other communities might want to manage access to certain shared pieces of content with the same set of protocols while keeping their communities distinct. This is possible by adding multiple communities to a protocol, creating a shared protocol. This article covers creating shared protocols, managing membership, applying them to content, and what to expect in front-end display.

Creating a shared protocol

Community managers of more than one community can create a shared protocol for the communities they manage.

To do so, as a community manager, from the main menu, hover over Add Component and select +Cultural Protocol

The main menu with +Cultural Protocol exposed

Name your protocol, select the cultural protocol type, and select "Select Communities."

Tip

It is helpful to give the protocol a distinct name. This helps users recognize the protocol within content and across communities.

The create protocol form with name and protocol type filled out. The add communities button is highlighted

A window will open that displays all the communities you manage. Select the parent communities for the protocol, then select "Add Communities."

The add communities modal with Community 1 and Community 2 selected

You will be returned to the form, and the parent communities will be listed under Communities.

The add protocol form with Community 1 and Community 2 listed as parent communities of the shared protocol. The parent communities are highlighted

Continue filling out the Create protocol form as needed, then select "Save."

The protocol page will load and a success message will be displayed. You will see all parent communities listed to the right under Communities.

The protocol page with a success message displayed.

Tip

The steps to add multiple communities can be repeated with existing protocols as well. To do so, navigate to a protocol and select "Edit." Repeat the above steps to add additional communities to the protocol.

On the community pages of both parent communities, you'll find the shared protocol listed under Cultural Protocols.

The community page of Community 1 with the shared protocol listed under cultural protocols

The community page of Community 2 with the shared protocol listed under cultural protocols

Managing shared protocols

Like any other protocol, protocol stewards manage shared protocols. Protocol stewards can belong to any of the protocol's parent communities. The community manager who created the protocol is automatically a protocol steward. Each site should determine their own guidelines for managing shared protocols. For example, should each parent community have a protocol steward? Or is one protocol steward sufficient, regardless of community membership?

Adding and managing users

Protocol stewards can add and remove users and manage user roles. They can see and add all members of all parent communities, regardless of their own membership in those communities.

The steps to add users and assign user roles are the same as with typical protocols. For detailed instructions, see Manage Protocol Members

Assigning shared protocols to

Shared protocols are assigned to content like any other protocol. In a content form (i.e. digital heritage, dictionary word, etc.) they are listed in the cultural protocol field under "Multiple Communities." The parent communities of the shared protocol are listed below the protocol. Toggle the protocol to green to assign it to the content item.

The cultural protocol field in a digital heritage item form. Community 1 and Community 2 list several single-community protocols. The multiple communities section lists two protocols that are shared by Community 1 and community 2

Display in content items

In a content item, protocols and communities are listed together under "Communities and Cultural Protocols" in the right side-bar. They are displayed as Community name: Protocol name.

A shared protocol will display in the same format. However, because the protocol has multiple parent communities, it will be repeatedly listed with each parent community.

Note that access to a shared protocol does not mean access to every parent community. In the screenshot below, this user is only a member of Community 1. They can access their community and the shared protocol. The user does not belong to Community 2 (a strict community), and therefore does not have access to that community page.

A digital heritage item with the assigned communities and protocols higlighted. Community 2 is greyed out because the user viewing the item does not belong to that community.

Tip

Parent communities will be listed in the order they were created.

On the browse page and in search results, a content item will display all associated communities based on the protocol(s) assigned to the item. Whether the protocol is a shared protocol makes no difference in display. In the screenshot below, Item 1 is assigned one shared protocol, with Community 1 and Community 2 as parent communities. Item 2 is assigned two single community protocols, one each from Community 1 and Community 2.

Two digital heritage items on the browse page. They both list Community 1 and Community 2 as parent communities