Newer Version Available

This content describes an older version of this product. View Latest

reorderManagedTopics(String, ConnectApi.ManagedTopic​PositionCollectionInput)

Reorders the relative positions of managed topics in a community.

API Version

32.0

Requires Chatter

No

Signature

public static ConnectApi.ManagedTopicCollection reorderManagedTopics(String communityId, ConnectApi.ManagedTopicPositionCollectionInput managedTopicPositionCollection)

Parameters

communityId
Type: String
Use either the ID for a community, internal, or null.
managedTopicPositionCollection
Type: ConnectApi.ManagedTopicPositionCollectionInput
A collection of relative positions of managed topics. This collection can include Featured and Navigational managed topics and doesn’t need to include all managed topics.

Usage

Only community managers (users with the “Create and Set Up Communities” or “Manage Communities” permission) can reorder managed topics.

If you don’t include all managed topics in the ConnectApi.ManagedTopicPositionCollectionInput, the managed topics are reordered by respecting the positions indicated in the ConnectApi.ManagedTopicPositionCollectionInput and then by pushing down any managed topics that aren’t included in the ConnectApi.ManagedTopicPositionCollectionInput to the next available position.

Example

If you have these managed topics:

Managed Topic Position
ManagedTopicA 0
ManagedTopicB 1
ManagedTopicC 2
ManagedTopicD 3
ManagedTopicE 4

And you reorder managed topics by including this information in ConnectApi.ManagedTopicPositionCollectionInput:

Managed Topic Position
ManagedTopicD 0
ManagedTopicE 2

The result is:

Managed Topic Position
ManagedTopicD 0
ManagedTopicA 1
ManagedTopicE 2
ManagedTopicB 3
ManagedTopicC 4