Administration
This section is for Confluence administrators who manage Chirp for their organization. Note that users who are not Confluence admins will not have access to the Chirp app’s admin screen.
1. Accessing Administration Settings
You can access Chirp’s admin area by navigating to the app and then clicking on the ‘Admin Settings’ link at the bottom of the left navigation.
2. Concepts
3. Managing Sections & Groups
This is what the Administration screen looks like.
Divided into two areas. Table at the top is to ‘Manage sections’ and the one in the lower half if to ‘Manage groups’.
Section
You can create new sections, edit existing ones & even delete them from here.
Sections have a single attribute which is their - Name. That’s it.
And their sequence can be updated in the ‘Manage sections’ table by simply drag & drop action on the rows.
Note - Deleting a section does not delete the Groups associated with it. Those groups simply become orphan, displayed without a Section.
Group
Group is the core of entire Chirp experience. In essence, groups let you configure what Confluence pages show up within that group’s feed, how they are shown & more.
Let us understand all the Group level settings below -
Group name - This is what the Group will appear as to the Chirp users in the left navigation
Group description - Additional information shown to the users when they navigate to a group’s feed
Section - Which section in the navigation should this Group belong to? (Note - It’s not mandatory for a group to be associated with a section)
Associated Confluence space - Each group in Chirp maps to a Confluence space. You can search the space by its key here.
Visibility & access - Whether the group should be displayed in Chirp’s left hand navigation to all Chirp users or to only those users who have access to the mapped Confluence space.
Which means, you can have groups that are conditionally displayed the Chirp users based on their Confluence space permissions. This ensures less clutter in the left navigation for users.
Group content type - This determines what content is displayed within that Group’s feed.
Social feed - User created posts being displayed in a chronological manner.
Curated pages - Admin selected pages shown in pre-selected sequence. Useful when certain documentation needs to be surfaced for Chirp users.
Content types - Whether the group feed should display Pages or Blog posts from the selected Space.
Interactive features - Whether users can create Pollsin the given group is controlled from this toggle.
Feed label - The group feed will display only those pages/blog posts from selected Confluence space that have this configured label (there could be other labels as well, but the configured one must be present).
View mode - How the content is presented to the users is controlled through this setting.
Feed view - Social media like rich post card view (this view is not available for Curated pages group content type)
List view - Compact list that only shows post title & metadata
If the Group content type is Social feed, you will see the Categories tab.
Up to 5 categories can be added per group. Each category has three attributes -
Display name - What the category name will say in the group feed
Filter label - This is the label a Confluence page should have to appear under this category (note that this is an additional label on top of the group level filter label. So, for any Confluence page to appear in the feed - it should have the Group configured label as well as Category configured label).
Color - Accent color for the posts that belong to this category.
If the Group content type is Curated pages, you will see the Collections tab.
Up to 5 collections can be added per group and each collection can hold a max of 10 Confluence pages. Each collection has 3 attributes
Name - What the collection name will say in the group feed
Color - Accent color for the pages that belong to this collection
Confluence page url - This is the list of up to 10 confluence page URLs