Administering communities

Overview

A community in Workplace provides a focus for group discussions and collaboration about specific topics or tasks.

Learn more about communities in Working with communities in the Using Workplace guide.

This guide provides Workplace system administrators with details on how to administer communities within their Workplace instance.

As a Workplace system administrator, you have full access to all private communities configured in Workplace, and have the ability to configure permissions within a private community by implementing differential manager- and user-level access in the private community. This allows specific Workplace users (who are not Workplace system administrators) to retain full control within the private community.

Configuring permissions within a private community

Configuring permissions within a private community allows specific Workplace users (who are not Workplace system administrators) to manage their community. These people (called private community managers) are able to:

Once permissions have been configured, other (non-manager) members of the community are no longer able to perform these functions (listed above) within the community.

There are two methods by which a private community’s access can be restricted to specific managers:

Using a group for each individual community

This procedure describes how to create a user group for members who will be managing an individual private community.

  1. Ensure you are logged in to Workplace as a Workplace system administrator and have accessed admin mode.

  2. In the asset map side nav on the left, locate the Squiz Workplace Mk III > Squiz Workplace - Site > Site Configuration > Squiz Workplace Users asset and expand its tree.

  3. Locate the user group whose name matches that of the private community you are configuring permissions on.

    This user group:

    • is automatically created with the original name of the private community, and

    • contains all current members of the private community.

    If the community’s name was changed prior to you performing this procedure, then the names of this user group asset and its community asset may not match. Therefore, you may wish to update the name of this user group asset (from the asset’s Details screen) to match that of the current name of its community asset.

  4. Within this user group asset (e.g. My private community), create a new user group, whose Group Name follows the recommended convention private-community-name managers (e.g. My private community managers). This convention makes it easier to search for and identify this asset in Workplace, and clearly describes the asset’s purpose.

  5. Expand the parent user group asset (e.g. My private community) and move the user account assets of each Workplace user who will be a manager of this community to the child user group you created (e.g. My private community managers).
    If only one user account is present, it will belong to the creator of this private community. Otherwise, at least one of these user accounts will belong to the community’s creator.

  6. Back in the asset map side nav on the left, locate the Squiz Workplace Mk III > Squiz Workplace - Site > Squiz Workplace > Communities asset and expand its tree.

  7. Locate the private community’s asset (e.g. My private community) and choose Details.

  8. On the right, click the Acquire locks button.

  9. Scroll down the page to the Members section and set the Select Admin Group asset value to the child user group for managing the community (e.g. My private community managers).

  10. Click the Commit button to save your changes.

Using a group for all private communities across Workplace

This procedure describes how to create a user group for members who will be managing all private communities across Workplace.

  1. Ensure you are logged in to Workplace as a Workplace system administrator and have accessed admin mode.

  2. In the asset map side nav on the left, locate the Squiz Workplace Mk III > Squiz Workplace - Site > Site Configuration > Squiz Workplace Users asset and expand its tree.

  3. Within this Squiz Workplace Users user group asset, create a new user group, with the recommended name Private communities managers. This name makes it easier to search for and identify this asset in Workplace, and clearly describes the asset’s purpose.

    This user group may already be present if you or another Workplace system administrator previously ran through this procedure.
  4. Expand the Squiz Workplace Users asset’s tree and locate the user group whose name matches that of the private community you are configuring permissions on.

    This user group:

    • is automatically created with the original name of the private community, and

    • contains all current members of the private community.

    If the community’s name was changed prior to you performing this procedure, then the names of this user group asset and its community asset may not match. Therefore, you may wish to update the name of this user group asset (from the asset’s Details screen) to match that of the current name of its community asset.

  5. Expand the parent user group asset (e.g. My private community) and move the user account assets of each Workplace user who will be a manager of this private community (as well as others across Workplace) to the Private communities managers user group you created above.
    If only one user account is present, it will belong to the creator of this private community. Otherwise, at least one of these user accounts will belong to the community’s creator.

  6. Back in the asset map side nav on the left, locate the Squiz Workplace Mk III > Squiz Workplace - Site > Squiz Workplace > Communities asset and expand its tree.

  7. Locate the private community’s asset (e.g. My private community) and choose Details.

  8. On the right, click the Acquire locks button.

  9. Scroll down the page to the Members section and set the Select Admin Group asset value to the child user group for managing the community (e.g. Private communities managers).

  10. Click the Commit button to save your changes.

Adding members to a private community

While private community members with manager-level access can add new members to the community, Workplace system administrators can also do this through the admin mode area of their Workplace instance.

This procedure assumes that your Workplace user accounts were configured through a SAML identity provider.

  1. Ensure you are logged in to Workplace as a Workplace system administrator and have accessed admin mode.

  2. In the asset map side nav on the left, locate the Squiz Workplace Mk III > Squiz Workplace - Site > Site Configuration > Squiz Workplace Users asset and expand its tree.

  3. Locate the user group whose name matches that of the private community you are adding members to, and expand its tree.

    This user group:

    • is automatically created with the original name of the private community, and

    • contains all current members of the private community.

    If the community’s name was changed prior to you performing this procedure, then the names of this user group asset and its community asset may not match. Therefore, you may wish to update the name of this user group asset (from the asset’s Details screen) to match that of the current name of its community asset.

  4. Still within the Squiz Workplace Users asset, expand the SAML Users user group asset.

  5. For each Workplace user who is being added to this private community as a member, link the Workplace user’s user account asset from within the SAML Users user group to the community’s user group asset.

'Unarchiving' a community

When a community is archived, its Workplace Community asset is set to Archived, and the community is hidden from the Communities page and cannot be accessed. Therefore, to 'unarchive' an archived community, its Workplace Community asset needs to be set to Live.

To unarchive a community along with all of its discussions:

  1. Ensure you are logged in to Workplace as a Workplace system administrator and have accessed admin mode.

  2. In the asset map side nav on the left, locate the Squiz Workplace Mk III > Squiz Workplace - Site > Squiz Workplace > Communities asset and expand its tree.

  3. Locate the Workplace Community asset of the community to unarchive and choose Details.

    The name of this asset should match the name of the community.
  4. On the right, click the Acquire locks button.

  5. In the Status section, set the Change Status asset value to Place Under Construction and select the Cascade Status Change check box.

  6. Click the Commit button to save your changes.

  7. In the Status section again, set the Change Status asset value to Approve and Make Live and select the Cascade Status Change check box.

  8. Click the Commit button to save your changes.

The community and all of its discussions should now appear on the Communities page again.

While unarchiving a community with this procedure, you can also prevent any previously archived discussions within that community from being unarchived.

To do this, when setting the Change Status asset value in each of the two steps above, do not select the associated Cascade Status Change check box. Keeping these check boxes clear ensures that any previously archived discussions (i.e. Workplace topic assets) remain unarchived.

'Unarchiving' a community’s discussion

When a community’s discussion is archived, its Workplace Topic asset is set to Archived, and the discussion itself is hidden from the community’s overview page and cannot be accessed. Therefore, to 'unarchive' an archived discussion, its Workplace Topic asset needs to be set to Live.

To unarchive a community’s discussion:

  1. Ensure you are logged in to Workplace as a Workplace system administrator and have accessed admin mode.

  2. In the asset map side nav on the left, locate the Squiz Workplace Mk III > Squiz Workplace - Site > Squiz Workplace > Communities asset and expand its tree.

  3. Locate the Workplace Community asset of the community containing the discussion to unarchive and expand its tree.

    The name of this asset should match the name of the community.
  4. Locate the Workplace Topic asset of the discussion to unarchive and choose Details.

    Similarly, the name of this asset should match the Topic name of the the community’s discussion.
  5. On the right, click the Acquire locks button.

  6. In the Status section, set the Change Status asset value to Place Under Construction.

  7. Click the Commit button to save your changes.

  8. In the Status section again, set the Change Status asset value to Approve and Make Live.

  9. Click the Commit button to save your changes.

The community’s discussion should now appear on the community’s overview page again.

When setting the Change Status value for either of the two steps above, there is no need to select the associated Cascade Status Change check box. Doing so has no effect.