Using Kauri Communities
Kauri Communities are designed to allow any number of participants to collaborate on the creation and curation of content around a specific topic (more here).
This particular article is aimed at initial community creators (Admins). If you've been invited to a community, check out this article to see what you can do.
Creating a Community
Congratulations, you’ve decided to create a Community!
First, you need to decide on a name, description, and tags for your community (to help users find you!), and an icon image. These are all required to create a community. You can also choose to include a URL, Twitter account, GitHub link, and a background image.
You’ll also have the option of inviting initial moderators and other admins to the community. This is optional, and can be done at any time in the future.
To initiate the creation process, select the “Create Community” button in the upper right hand corner, and use your web3-enabled browser to sign the message (a meta-transaction) that pops up. This will create your Community’s smart contract on the POA Network sidechain. This smart contract will hold the address and roles of your Community’s moderators and admins, and is essentially a permissions manager.
Once you’ve submitted the signature, you’re Community will be created! It typically takes ~5 seconds for the creation transaction to be published, but may take slightly longer depending on network congestion.
You’ll be able to view you Community immediately, and start adding content once the transaction is processed!
There are two main ways to add articles to a community:
Existing articles can be added by selecting “Add Content” on the main Community page. If you’re familiar with adding articles to collections, the process is very similar! The differences being you must select one article to add at a time, and you can only select from articles you’ve written yourself (for now!). After choosing an article in the widget, you’ll be asked to sign a message transferring the article to the Community.
Note: Transferring an article to a Community allows any admins or moderators to make edits and publish changes to it. If you wrote and published the article originally, you will still be credited as the author, but will no longer have exclusive control over its’ content.
New articles can be published directly to a Community. To do this, simply start writing an article, and when you’re ready to publish, select the Community in the dropdown.
At launch, only new collections can be added to a Community. The process is similar to publishing new articles to a Community, in that you can choose to add the collection directly to a Community after selecting “Publish Collection”.
Note: Curating articles not owned by a moderator or admin
You can also use collections to curate content from any author on Kauri, not just moderators and admins. To do so, select "All Articles" in the "Add Article" widget, and then select or use the search bar to find content you want to add.
Curating the Community Home Page
To help readers explore your content, you can curate a home page for you Community to replace the defaults “Articles” view. This page can be organized into sections with headers, which can contain the Community’s articles and collections. The flow should be familiar if you’ve created a collection before!
To update the home page, select “Update Community”. Next, add a name to the first section (required), and a description (optional).
Now you can add any article or collection that is owned by the Community to the section, or add a new section!
When you’re happy, select “Update Community” in the upper right hand corner.
To get some help with content creation and curation, you can invite moderators to your Community. Moderators will be able to add articles and collections, and edit existing articles and collections. They cannot edit your Community’s metadata, invite or manage new moderators or admins, or edit the home page.
To invite moderators, select the “+” button under “Moderators” on the right hand side of the Community page, or navigate to the “Manage” tab and select “Invite Member”.
Next, enter the desired recipient’s email address, and their role (Moderator or Admin). We strongly encourage you both limit the number of admins, and only choose admins you know and trust well, as they have many more privileges than moderators.
Once you’ve invited a moderator, you can see their status in the “Manage” tab under “Invited”.
Managing Moderators and Admins
In addition to inviting moderators to your Community, you can also promote them to Admin, and remove them.
Both of these functions can be found in the “Manage” tab of the Community page, then in “Manage Members”.