# SourceCred Discourse Admin Docs

**URL:** <https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399>\
**Category:** Site Feedback\
**Created:** [December 11, 2019, 1:02am UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399 "2019-12-11T01:02:45Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 11, 2019, 1:02am UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/1 "2019-12-11T01:02:45Z")

</div>

Docs on best practices around SourceCred Discourse management.

Every Discourse feature or plugin that is used to create and manage this Discourse should be listed here.

Every comment in this thread should be a Wiki. Please only create or edit Wikis in this thread. This will keep things organized for future readers. Also, if/when this thread becomes an [Artifact](https://discourse.sourcecred.io/t/about-the-artifacts-category/253) then all contributors will get Cred 🙂

  

## Helpful Highlevel Resources

- [Building a successful community on Discourse](https://meta.discourse.org/t/building-a-successful-community-on-discourse-toc/68504)
- [Discourse how to guides](https://meta.discourse.org/c/howto/10)
- [Discourse features page](https://www.discourse.org/features)
- [Discourse integrations page](https://discourse.org/integrations)
- [Discourse FAQ category](https://meta.discourse.org/c/howto/faq/)
- [Discourse moderation guide](https://meta.discourse.org/t/discourse-moderation-guide/63116)

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 11, 2019, 1:05am UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/2 "2019-12-11T01:05:26Z")

</div>

## Pinned Threads

For pinned threads the preview tries to show as much of the first comment as possible. In order to make the pinned threads easy for new users to scan, we should keep the first comment to one or two sentences. Then we can create a new comment below with the bulk of the information.

If you’re wondering what I’m talking about try going to the [SourceCred Discourse](https://discourse.sourcecred.io/) on a private browser. The pinned threads are easy to read because the first comment is just a sentence or two. Also, if you go to the [Categories](https://discourse.sourcecred.io/categories) page you’ll see that the pinned threads in each category also preview the first comment.

It’s important when pinning threads to keep the first comment short and sweet 🙂

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 11, 2019, 4:36am UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/3 "2019-12-11T04:36:43Z")

</div>

## Categories

Category titles should be capitalized.

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 11, 2019, 9:34pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/4 "2019-12-11T21:34:35Z")

</div>

## Dates and Times

Placeholder for the [date/time stuff](https://discourse.sourcecred.io/t/weekly-sourcecred-community-call/260/9).

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 11, 2019, 9:44pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/5 "2019-12-11T21:44:38Z")

</div>

## Updating Broken Links

Sometimes people might delete posts. This could be due to cleaning up the forum to make docs more readable, or because something was moved. This is great, but it can break links, and thus Cred flow.

Let’s consider two categories of broken link:

- a broken reference from a regular post
- a broken reference from a [supernode](https://discourse.sourcecred.io/t/supernodes-moving-past-raw-activity/340)

For the regular links, each reference generally won’t flow a ton of cred, and I think this happens pretty rarely, so I wouldn’t worry about it overmuch.

For the supernode links, many people will have the ability to edit or suggest changes to a supernode, so it should be easy for the community to crowdsource a fix.

* * *

### Open Questions

We should also look into the specific cases where links can get broken… If a post gets moved, does Discourse provide a redirect? If we can enumerate the redirects somehow then we could have a pure technical fix. We suspect that when a post gets deleted, links to other posts in the thread will be unaffected, (and obviously there’s no way to recover the link to the deleted post).

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 11, 2019, 11:08pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/8 "2019-12-11T23:08:24Z")

</div>

> **[Discourse Moderation Guide](https://meta.discourse.org/t/discourse-moderation-guide/63116)**
>
> So you’re a moderator on a Discourse forum - congratulations! As a forum moderator, it’s your role to help oversee the forum, ensuring that users and content are in line with your TOS, FAQ, and other published rules/guidelines. Discourse comes with...

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 11, 2019, 11:10pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/9 "2019-12-11T23:10:20Z")

</div>

## Markdown Basics

[https://commonmark.org/help/](https://commonmark.org/help/)

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 11, 2019, 11:10pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/10 "2019-12-11T23:10:39Z")

</div>

## Discourse Basics

> **[Discourse New User Guide](https://meta.discourse.org/t/discourse-new-user-guide/96331)**
>
> Welcome! As a new user of Discourse, we hope you will find this site intuitive and clearly structured, but here is some guidance to get you started: Basic Terms Used by Discourse Browsing the Forum Topic lists See who is participating ...

---

<div class="post-metadata">

**Author:** ![decentralion](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/decentralion/32/7_2.png) [@decentralion](https://discourse.sourcecred.io/u/decentralion)\
**Post date:** [December 18, 2019, 6:09pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/13 "2019-12-18T18:09:30Z")

</div>

## Splitting Topics

First, select the gear icon in the top right hand side when viewing a topic. ![image](https://canada1.discourse-cdn.com/flex032/uploads/sourcecred1/original/1X/a87f8c3c0d8d22c0946aa415002dfcaddd74eb5f.png)

Select, the first action, “Select Posts”

![image](https://canada1.discourse-cdn.com/flex032/uploads/sourcecred1/original/1X/70e688c7d9817d654f675eed1a0f61ed10d7d39e.png)

You can choose which posts in the topic you want to move. You can also select a post and all its replies. Once you’ve selected the posts you want to move, choose “move to” in the right hand menu.

 ![image](https://canada1.discourse-cdn.com/flex032/uploads/sourcecred1/original/1X/8a94346a4d2b2b71c460d9c1106872d43ee37338.png)

You will now be able to split the posts into a new topic, or re-organize them into an existing topic.

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 21, 2019, 10:26pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/15 "2019-12-21T22:26:18Z")

</div>

> **[Beginner's guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966)**
>
> This is a crash course in Discourse theme basics. The target audience is everyone who is not familiar with Discourse themes. If you’ve already used Discourse theme / theme components, this guide is probably not something you need to read. What are...

> **[How do I install a Theme or Theme Component?](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682)**
>
> Importing new themes and theme components To import new themes and components, visit www.yoursite.com/admin/customize/themes or via the UI head to Admin \> Customize \> Themes Then click on Install here you’ll see this You can install...

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 21, 2019, 10:27pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/16 "2019-12-21T22:27:34Z")

</div>

> **[Discourse Category Banners](https://meta.discourse.org/t/discourse-category-banners/86241)**
>
> This theme component uses your existing category details to create banners for your category pages. You can preview the theme on our theme preview site here (you’ll have to navigate to a category page) Github repo: GitHub -...

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 21, 2019, 11:26pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/17 "2019-12-21T23:26:32Z")

</div>

> **[Discourse Button Styles](https://meta.discourse.org/t/discourse-button-styles/88154)**
>
> This theme component includes basic settings for changing button colors without writing CSS. Github repo: https://github.com/awesomerobot/discourse-button-styles Installation: How do I install a Theme or Theme Component? Preview: Example of what...

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 21, 2019, 11:32pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/18 "2019-12-21T23:32:53Z")

</div>

> **[Discourse Activity Summary Emails Guide](https://meta.discourse.org/t/discourse-activity-summary-emails-guide/36627)**
>
> What is an Activity Summary email? The Discourse “Activity Summary” (formerly known as the digest email) is an email sent out to members of a forum who haven’t visited in a specific period with a collection of the most popular content since their...

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 21, 2019, 11:33pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/19 "2019-12-21T23:33:32Z")

</div>

> **[What are Topic Templates?](https://meta.discourse.org/t/what-are-topic-templates/38295)**
>
> Topic templates are a useful tool to reinforce forum conventions or to guide new users. Category-specific topic template Some categories might follow a strict pattern. One such example would be a Movies category, wherein you’d like users to start...

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 21, 2019, 11:34pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/20 "2019-12-21T23:34:19Z")

</div>

> **[Displaying sub-categories in boxes](https://meta.discourse.org/t/displaying-sub-categories-in-boxes/59371)**
>
> There are two new ways to display a list of sub-categories within the parent category: in boxes with only the name, logo, and description in boxes with name, logo, and a list of some featured topics You can enable these styles by visiting the...

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 21, 2019, 11:41pm UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/21 "2019-12-21T23:41:52Z")

</div>

Solved integration is currently enabled in the [Help](https://discourse.sourcecred.io/c/community/help/25) category. To enable it for other categories go to the admin settings in the category, then scroll to the bottom and enable the solved plugin.

> **[Solved](https://www.discourse.org/plugins/solved.html)**
>
> Great answer? Solved allows users to accept solutions to their topics.

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 22, 2019, 12:09am UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/22 "2019-12-22T00:09:10Z")

</div>

> **[Easy responsive footer](https://meta.discourse.org/t/easy-responsive-footer/95818)**
>
> This is a theme component that will allow you to build a fully-responsive footer using nothing but plain text. Repository link https://github.com/discourse/Discourse-easy-footer Preview: ...

The colors were changed because the default is that the footer is the opposite of the main background for contracts. To change this you have to go into the CSS of the plugin and change `.custom-footer` background to `$primary-low`.

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 22, 2019, 12:11am UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/23 "2019-12-22T00:11:44Z")

</div>

> **[discourse/discourse-kanban-theme](https://github.com/discourse/discourse-kanban-theme)**
>
> A Discourse theme component providing basic kanban-board functionality - discourse/discourse-kanban-theme

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 22, 2019, 12:12am UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/24 "2019-12-22T00:12:03Z")

</div>

> **[Hamburger Theme Selector](https://meta.discourse.org/t/hamburger-theme-selector/61210)**
>
> Location repo: GitHub - discourse/discourse-hamburger-theme-selector About This theme component adds a theme selector in the hamburger menu provided there is more than 1 user selectable theme. This selector works with both logged on users and...

---

<div class="post-metadata">

**Author:** ![burrrata](https://yyz2.discourse-cdn.com/flex032/user_avatar/discourse.sourcecred.io/burrrata/32/135_2.png) [@burrrata](https://discourse.sourcecred.io/u/burrrata)\
**Post date:** [December 22, 2019, 12:13am UTC](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399/25 "2019-12-22T00:13:57Z")

</div>

> **[Custom Header Links](https://meta.discourse.org/t/custom-header-links/90588)**
>
> This is a theme component that will allow you to add custom text-based links to the header easily. Github repository link: https://github.com/discourse/discourse-custom-header-links Demo: ...

The default background is black. This Discourse changed the background in `.d-header` by adding `background: $primary-low;`. In `.custom-header-links` a `font: bold;` parameter was added. (the font:bold thing may or may not actually do anything)

[Next page](https://discourse.sourcecred.io/t/sourcecred-discourse-admin-docs/399.md?page=2)