The Subcommunities feature is one method of dividing your Higher Logic Vanilla (Vanilla) community into multiple "mini communities" (often by language or product). Subcommunities are a great way to manage a community in multiple languages on the same instance.
A subcommunity divides a single community or a node into different areas by making each of the top-level categories into a separate area of the community.
The Subcommunities addon is only available with some plan levels.
📝 NOTE: If you are a Cloud customer on a plan that includes subcommunities and are unable to access them, contact Vanilla support to have them enable it for you.
Categories and their content are filtered between subcommunities.
- Discussions and all of their types
This filtering occurs on the following pages.
- Recent Discussions
- All Categories
- Home page pointing to either All Categories or Recent Discussions
- Knowledge Base Homepage
- Related Articles
/kb/articles/425 underneath the article.
- Creating a new article
Some community content is shared between a community's subcommunities. For example:
- Users and user-related features
- Private Messages / Conversations
- Points / Reputation
- Roles / Ranks / Role Tracker
- Moderation features (such as Moderation & Spam Queues)
- Reported posts
- Tags (also called #hashtags)
- Warnings & Notes
- The Activity page
- The BestOf page
- Who's Online
If your community requires some of these features to split between sections of your sites, but still needs certain configurations and users synchronized between them, a setup using a Hub, Multisite Sync, and a Single Sign On solution may be required.
Set a default
A subcommunity can be set as default by checking the Default checkbox while creating and editing a subcommunity. Setting a default subcommunity adds a rewrite rule to rewrite every single page of the site to be in the default subcommunity if one is not provided through a prefix in the URL.
For example. If the default subcommunity is set as English with the URL prefix of
en set, the following URLs would be re-written:
/ => /en/categories => /en/categories/profile => /en/profile/discussions => /en/discussions/groups => /en/groups/dashboard => /en/dashboard... and many more
What if I turn off subcommunities later?
These are 301 redirects, which means they are permanent redirects. This means user’s browsers (and your own) will keep the redirect cached. If you later decide to unset your default subcommunity (without setting a new one) or disable subcommunities, many users’ browser will still attempt to redirect.
Properly undoing these redirects may require assistance.
Communities with no default subcommunity
If no default subcommunity is set, users visiting
forums.example.com would see a category list as if the Subcommunities addon was not enabled. If the user then clicked a top level Category associated with a subcommunity, they will be navigated to the Categories page of that subcommunity.
While this may sound like a good way of navigating between subcommunities, it doesn’t work in practice. This is because Vanilla rewrites the breadcrumbs for users inside of a subcommunity in a way that makes it feel quite disorienting to navigate from a non-subcommunity portion of a site to a subcommunity portion of it.
Navigate between subcommunities
When a default subcommunity is set, it can be difficult for a user to navigate between subcommunities. To properly facilitate this, the
SubcommunityToggleModule is included with the Subcommunities addon.
This module allows a user to switch between communities using a dropdown menu, like the one shown below. Pictured below is an enhanced
SubcommunityToggleModule next to the MeBox. Other common locations for this Module are in the Panel and Footer of the site.
Subcommunities & Products
Subcommunities can now be grouped by products. To enable this feature, toggle ON the Enable Product Integration option on the subcommunities page.
What is a product?
A product is a way of grouping related subcommunities together. This can enable Rich translation integrations in certain parts of Vanilla. The first integration to use this is multi-lingual articles in Knowledge Base.
Check out the article to learn more.
Legacy Themes only
To add the module using CustomizeTheme, use the following snippet.
Click the link below to access a video expanding on what you learned in this article.