Forem Admin Documentation

website·Indexed 36 days ago

https://admin.forem.com/

Administrative guides for Forem, covering community management, user roles, and advanced customization. Includes documentation on configuring emails, campaigns, newsletters via Mailchimp, monetization, rate limits, anti-spam settings, and brand identity.

Tokens
17.7K
Snippets
20
Records
169
Agent score
60%

What's inside Forem

  1. Overview of Forem HTML Variants

    HTML Variants are custom HTML and CSS designs used to inject specific layouts into different areas of the Forem platform. They are most commonly used for homepage banner designs. Variants can be filtered by their status or location, including Leaderboard (published & approved), Mine, Admin (all), Article show below article CTA, Badge Landing Page (/badge), and Campaign (homepage banner).
  2. Overview of Forem Billboards

    Billboards are customizable images, text, and links that appear in the upper right and lower left sidebars of a community homepage. They are managed via the /admin/customization/billboards admin page, where you can track attributes such as Organization ID, placement area, body markdown, published/approved status, and click-through success rate.
  3. Overview of Forem Campaigns

    Campaigns are used to highlight information to an audience via the Forem Admin interface (accessible at /admin/customization/config). They typically consist of three optional features that can be enabled individually or simultaneously: a large banner on the homepage, highlighted articles under specific tags in the righthand sidebar, and a campaign image in the righthand sidebar.
  4. Overview of Tag Moderator privileges

    Tag moderators are trusted users granted additional privileges to manage specific tags across a Forem community. They possess all standard trusted user features plus the ability to modify assigned tags on posts and edit the associated tag pages. As a result of their role, their profiles are featured on the tag pages they moderate.
  5. Overview of Forem Organization accounts

    Organization accounts are free for teams, companies, or clubs to participate on a Forem community as an identifiable group. Key features include:

    • Dedicated landing pages for key information and member lists.
    • Organization branding in the header and sidebar of published posts.
    • Call-to-action (CTA) units alongside branded posts to drive traffic to products/services.
    • Content management allowing admins to change post authors and publish under the organization.
    • Enhanced analytics for view counts, reactions, and CTA clicks.
    • Following system: members who follow an organization receive notifications for new posts and see content more prominently in their feed.
  6. Create a custom navigation link in Forem Admin

    To add a new navigation link, click the Add Navigation Link button in the admin panel and configure the following fields:

    • Name: The user-facing label for the link.
    • URL: The destination path (e.g., /faq, /about).
    • Icon: An SVG code snippet. Icons are displayed in a 24x24 px box.
    • Section: Choose between Default or Other to determine where the link appears in the sidebar.
    • Position: An optional numeric value to define the sort order. If left blank, links are ordered descending by name.
    • Display only when signed in: A toggle to restrict the link's visibility to authenticated users.
  7. Moderate recently published articles

    The 'Latest Articles' section provides a quick overview of the most recent publications. A toggle menu provides direct links to:

    • Mod: Article Moderation
    • admin: Article Admin
    • Profile: Author profile page
    • admin User: Author admin page (basic actions)
    • Destructive Actions: Author admin page (destructive actions)
  8. Manage member details using Member Management tabs

    The Member Management page is organized into tabs that provide specific tools and data for each user:

    • Overview: View and manage member roles, organizations, credits, and tag moderation. Use the Add role button to assign roles (e.g., Trusted Status) or suspend a user.
    • Notes: A private area for Admins to record internal notes about a member's interactions or history.
    • Emails: Used to verify email addresses, send emails, and review communication history.
    • Reports: View all reports submitted by the member.
    • Flags: View flags submitted about the user by moderators.
  9. Manage static Pages in Forem Admin

    Pages are used to store static content on a Forem instance that does not appear in Feeds. They support custom formatting and can be assigned top-level paths. You can manage pages (create new ones or view existing ones) by navigating to /admin/customization/pages in the Forem Admin dashboard.
  10. Understand the purpose of Forem Admin documentation

    The Forem Admin documentation is designed for users who have already launched and are currently managing a Forem community. It provides guidance on customizing the community appearance, utilizing moderation tools to maintain community health, and leveraging various features to enhance the user experience.
  11. Integrate Forem Newsletters with Mailchimp

    Forem allows you to sync your community members with Mailchimp audiences. Newsletters are managed and sent entirely within Mailchimp; Forem uses the Mailchimp API to share the subscribers list. This is distinct from Forem's internal Email Digests. It is recommended to send no more than one newsletter per week.