├── .github ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── ISSUE_TEMPLATE │ ├── changes_requested.md │ ├── config.yml │ ├── contribute_open_resources.md │ └── new_file_or_folder.md ├── LICENSE ├── PULL_REQUEST_TEMPLATE.md └── workflows │ └── cla.yml ├── .gitignore ├── README.md ├── babel.config.js ├── docs ├── advanced-customization │ ├── _category_.json │ ├── billboards.md │ ├── config │ │ ├── _category_.json │ │ ├── api-tokens.md │ │ ├── authentication.md │ │ ├── campaigns.md │ │ ├── community-content.md │ │ ├── credits.md │ │ ├── email-server-settings.md │ │ ├── emails.md │ │ ├── google-analytics.md │ │ ├── google-recaptcha.md │ │ ├── images.md │ │ ├── mascot.md │ │ ├── meta-keywords.md │ │ ├── monetization.md │ │ ├── newsletter.md │ │ ├── social-media.md │ │ ├── sponsors.md │ │ └── user-experience-and-brand.md │ ├── content-manager │ │ ├── _category_.json │ │ └── podcasts.md │ ├── extensions │ │ ├── _category_.json │ │ └── listings.md │ ├── html-variants.md │ ├── navigation-links.md │ ├── rate-limits-and-anti-spam.md │ ├── reports.md │ └── tag-display-order.md ├── community-resources │ ├── _category_.json │ ├── connect-with-forem-builders.md │ ├── style-guide.md │ ├── submit-bug-report.md │ └── who-are-these-docs-for.md ├── forem-basics │ ├── _category_.json │ ├── badges.md │ ├── generated-pages.md │ ├── member-management.md │ ├── pages.md │ ├── posts.md │ ├── tags.md │ ├── user-roles.md │ └── user-settings │ │ ├── _category_.json │ │ ├── account-settings.md │ │ ├── billing-settings.md │ │ ├── customization-settings.md │ │ ├── extension-settings.md │ │ ├── notification-settings.md │ │ ├── organization-settings.md │ │ └── profile-settings.md ├── frequently-asked-questions.md ├── getting-started │ ├── _category_.json │ ├── creator-signup-and-onboarding.md │ ├── forem-setup-checklist.md │ └── implementation-guide.md └── managing-your-community │ ├── _category_.json │ ├── admin-moderation-features.md │ ├── managing-posts-and-comments.md │ ├── organization-pages.md │ ├── removing-spam.md │ ├── suspending-users.md │ ├── tag-moderator-features.md │ └── trusted-user-features.md ├── docusaurus.config.js ├── netlify.toml ├── open-resources ├── README.md ├── about-page.md ├── community-guidelines.md ├── community-moderation-page.md ├── contact.md ├── how-to-ask-for-help.md ├── how-to-report-abuse.md ├── how-to-use-the-post-editor.md ├── how-to-write-a-post.md ├── making-your-forem-work-for-you.md ├── organization-info.md └── tag-moderation-page.md ├── package-lock.json ├── package.json ├── sidebars.js ├── src ├── components │ ├── NavigationList.js │ └── NavigationList.module.css ├── css │ └── custom.css └── pages │ ├── index.js │ └── index.module.css ├── static ├── .nojekyll └── img │ ├── 85eo1v89vklsfcvb3b5b.png │ ├── ImagesFavicon.png │ ├── ImagesLogo.png │ ├── ImagesSocial.png │ ├── adminCustomizationConfig.png │ ├── adminGuideButton.png │ ├── campaign_sidebar_image.png │ ├── commentTemplateDelete.png │ ├── commentTemplateMenu.png │ ├── commentTemplateModerator.png │ ├── commentTemplatePersonal.png │ ├── commentTemplatePreview.png │ ├── commentTemplateSelect.png │ ├── contactPage.png │ ├── creatorEmailConfirmation.png │ ├── creatorSettingsPage.png │ ├── creatorSignupPage.png │ ├── creditsPurchasePage.png │ ├── defaultEmailField.png │ ├── deleteUserConformation.png │ ├── deleteUserGDPR.png │ ├── developerToolsExtensions.png │ ├── displayAdsEdit.png │ ├── displayAdsExample.png │ ├── docusaurus.png │ ├── edafdaf3-cc2b-4560-a497-0e671b41c466.png │ ├── emailUserOptions.png │ ├── favicon.ico │ ├── firstAdminPortal.png │ ├── firstAgreement.png │ ├── firstConfig.png │ ├── firstConfigFilled.png │ ├── firstConfigUpdated.png │ ├── firstDropdownAdmin.png │ ├── firstHome.png │ ├── firstProfileBlank.png │ ├── firstProfileFilled.png │ ├── firstSplash.png │ ├── firstTags.png │ ├── forem.svg │ ├── foremDark.svg │ ├── foremLogoDark.svg │ ├── foremLogoLight.svg │ ├── hacktoberfest-card-6x4.pdf │ ├── htmlVariantExample.png │ ├── image (4).png │ ├── image (5).png │ ├── image-2020-09-28-at-6.15.55-pm.png │ ├── image-2020-10-15-at-5.42.44-pm.png │ ├── image-2020-10-15-at-5.45.10-pm.png │ ├── image-2020-10-19-at-3.38.53-pm.png │ ├── image-2020-10-19-at-3.58.42-pm.png │ ├── image-2020-10-21-at-11.55.07-am.png │ ├── image-2020-10-22-at-1.37.33-pm.png │ ├── image-2020-10-22-at-1.48.13-pm.png │ ├── image-2020-10-22-at-1.54.00-pm (1).png │ ├── image-2020-10-22-at-1.54.00-pm.png │ ├── image-2020-10-22-at-1.59.00-pm.png │ ├── image-2020-10-22-at-2.01.45-pm.png │ ├── image-2020-10-22-at-2.02.48-pm.png │ ├── image-2020-10-22-at-3.54.34-pm.png │ ├── image-2020-10-22-at-4.11.41-pm.png │ ├── image-2020-10-22-at-4.21.10-pm.png │ ├── image-2020-10-22-at-4.43.28-pm.png │ ├── image-2020-10-22-at-9.34.32-am.png │ ├── image-202020-08-13-20at-201.19.09-20pm (1).png │ ├── image-202020-08-13-20at-201.19.09-20pm (2).png │ ├── image-202020-08-13-20at-201.19.09-20pm.png │ ├── imageUploader.png │ ├── l2s27233mbg7t1kv3dw4.png │ ├── large_banner_on_homepage.png │ ├── listingsBump.png │ ├── listingsCreateNew.png │ ├── listingsCreateNewExpandCategories.png │ ├── listingsDashboardExpired.png │ ├── listingsDashboardNoOrg.png │ ├── listingsDashboardOrg.png │ ├── listingsNewCategory.png │ ├── logo.svg │ ├── mailchimp-api-example.png │ ├── mailchimpAPI.png │ ├── mailchimpAPItoConfig.png │ ├── mailchimpCreateAudience.png │ ├── mailchimpMainNewsletterAudienceID.png │ ├── mascotConfig.png │ ├── moderatorNotifications.png │ ├── navigationAdd.png │ ├── navigationEdit.png │ ├── navigationLinks.png │ ├── onboardingNewUserActions.png │ ├── open-reports.png │ ├── orgBrandingTwilio.png │ ├── orgCTAtriplebyte.png │ ├── orgDemoHeroku.png │ ├── overridePageNewForm.png │ ├── pageManager.png │ ├── pageNew.png │ ├── podcastBackgroundImage.png │ ├── podcastBrowserPlayer.png │ ├── podcastEpisodesInFeed.png │ ├── podcastFetch.png │ ├── podcastPublish.png │ ├── podcastSuggest.png │ ├── podcastSuggestionForm.png │ ├── publicConfigFalse.png │ ├── publicConfigTrue.png │ ├── recaptcha-checkbox-example.png │ ├── recaptcha-forem-config-2.jpg │ ├── recaptcha-forem-config.jpg │ ├── recaptcha-registration-example.png │ ├── recaptcha-submit-example.png │ ├── screen-shot-2020-09-09-at-11.49.56-am.png │ ├── screen-shot-2020-09-09-at-11.53.11-am.png │ ├── screen-shot-2020-09-12-at-1.18.21-pm.png │ ├── screen-shot-2020-09-12-at-1.22.37-pm.png │ ├── screen-shot-2020-09-12-at-1.25.50-pm.png │ ├── screen-shot-2020-09-12-at-1.26.40-pm.png │ ├── screen-shot-2020-09-12-at-1.29.07-pm-1.png │ ├── screen-shot-2020-09-12-at-1.29.07-pm.png │ ├── screen-shot-2020-09-12-at-1.44.30-pm.png │ ├── screen-shot-2020-09-12-at-1.50.26-pm.png │ ├── screen-shot-2020-09-12-at-1.53.03-pm.png │ ├── screen-shot-2020-09-15-at-6.33.41-pm.png │ ├── screen-shot-2020-09-21-at-5.17.24-pm.png │ ├── screen-shot-2020-09-21-at-5.21.04-pm.png │ ├── screen-shot-2020-09-21-at-5.22.29-pm.png │ ├── screen-shot-2020-09-21-at-5.23.29-pm.png │ ├── screen-shot-2020-09-22-at-12.35.12-pm.png │ ├── screen-shot-2020-09-22-at-12.55.14-pm.png │ ├── screen-shot-2020-09-22-at-12.55.29-pm.png │ ├── screen-shot-2020-10-08-at-9.54.03-am.png │ ├── screen-shot-2020-10-16-at-4.09.29-pm (2) (1).png │ ├── screen-shot-2020-10-16-at-4.09.29-pm (2) (2).png │ ├── screen-shot-2020-10-16-at-4.09.29-pm (2).png │ ├── screen-shot-2020-10-19-at-2.01.07-pm.png │ ├── screen-shot-2020-10-21-at-11.26.10-am (1).png │ ├── screen-shot-2020-10-21-at-11.26.10-am (2).png │ ├── screen-shot-2020-10-21-at-11.26.10-am.png │ ├── screen-shot-2020-10-21-at-11.26.22-am (1).png │ ├── screen-shot-2020-10-21-at-11.26.22-am.png │ ├── screen-shot-2020-11-09-at-3.08.09-pm.png │ ├── screen-shot-2020-11-16-at-11.33.41-am.png │ ├── screen-shot-2020-11-16-at-6.17.02-pm.png │ ├── screen-shot-2020-12-03-at-12.41.06-pm.png │ ├── screen-shot-2020-12-03-at-12.41.18-pm.png │ ├── screen-shot-2020-12-24-at-3.20.38-pm.png │ ├── screen-shot-2020-12-24-at-3.27.23-pm.png │ ├── screen-shot-2020-12-24-at-3.47.09-pm.png │ ├── screen-shot-2021-02-04-at-3.20.29-pm.png │ ├── screen-shot-2021-02-08-at-10.16.44-am.png │ ├── screen_shot_2020-10-15_at_2_44_39_pm.png │ ├── screen_shot_2020-10-19_at_1_59_53_pm.png │ ├── screencapture-localhost-3000-admin-advanced-tools-2021-05-06-12_55_40.png │ ├── sort-abuse-reports.png │ ├── tagConfig.png │ ├── tagManager.png │ ├── tagNew.png │ ├── tagSupportedFalse.png │ ├── tagSupportedTrue.png │ ├── tagattributes.png │ ├── thank-you-reporter.png │ ├── tutorial │ ├── docsVersionDropdown.png │ └── localeDropdown.png │ ├── undraw_docusaurus_mountain.svg │ ├── undraw_docusaurus_react.svg │ ├── undraw_docusaurus_tree.svg │ ├── userMenuAccessingAdminPortal.png │ ├── userNotificationsFullpage.png │ ├── userOrgAlt.png │ ├── userOrgNew.png │ ├── userRolesCurrentRole.png │ ├── userRolesManage.png │ ├── userRolesNewStatus.png │ └── welcomeTag.png └── yarn.lock /.github/CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Covenant Code of Conduct 2 | 3 | ## Our Pledge 4 | 5 | In the interest of fostering an open and welcoming environment, we as 6 | contributors and maintainers pledge to making participation in our project and 7 | our community a harassment-free experience for everyone, regardless of age, body 8 | size, disability, ethnicity, sex characteristics, gender identity and 9 | expression, level of experience, education, socio-economic status, nationality, 10 | personal appearance, race, religion, or sexual identity and orientation. 11 | 12 | ## Our Standards 13 | 14 | Examples of behavior that contributes to creating a positive environment 15 | include: 16 | 17 | - Using welcoming and inclusive language 18 | - Being respectful of differing viewpoints and experiences 19 | - Gracefully accepting constructive criticism 20 | - Focusing on what is best for the community 21 | - Showing empathy towards other community members 22 | 23 | Examples of unacceptable behavior by participants include: 24 | 25 | - The use of sexualized language or imagery and unwelcome sexual attention or 26 | advances 27 | - Trolling, insulting/derogatory comments, and personal or political attacks 28 | - Public or private harassment 29 | - Publishing others' private information, such as a physical or electronic 30 | address, without explicit permission 31 | - Other conduct which could reasonably be considered inappropriate in a 32 | professional setting 33 | 34 | ## Our Responsibilities 35 | 36 | Project maintainers are responsible for clarifying the standards of acceptable 37 | behavior and are expected to take appropriate and fair corrective action in 38 | response to any instances of unacceptable behavior. 39 | 40 | Project maintainers have the right and responsibility to remove, edit, or reject 41 | comments, commits, code, wiki edits, issues, and other contributions that are 42 | not aligned to this Code of Conduct, or to suspend temporarily or permanently 43 | any contributor for other behaviors that they deem inappropriate, threatening, 44 | offensive, or harmful. 45 | 46 | ## Scope 47 | 48 | This Code of Conduct applies both within project spaces and in public spaces 49 | when an individual is representing the project or its community. Examples of 50 | representing a project or community include using an official project e-mail 51 | address, posting via an official social media account, or acting as an appointed 52 | representative at an online or offline event. Representation of a project may be 53 | further defined and clarified by project maintainers. 54 | 55 | ## Enforcement 56 | 57 | Instances of abusive, harassing, or otherwise unacceptable behavior may be 58 | reported by contacting the project team at yo@dev.to. All complaints will be 59 | reviewed and investigated and will result in a response that is deemed necessary 60 | and appropriate to the circumstances. The project team is obligated to maintain 61 | confidentiality with regard to the reporter of an incident. Further details of 62 | specific enforcement policies may be posted separately. 63 | 64 | Project maintainers who do not follow or enforce the Code of Conduct in good 65 | faith may face temporary or permanent repercussions as determined by other 66 | members of the project's leadership. 67 | 68 | ## Attribution 69 | 70 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], 71 | version 1.4, available at 72 | https://www.contributor-covenant.org/version/1/4/code-of-conduct.html 73 | 74 | [homepage]: https://www.contributor-covenant.org 75 | 76 | For answers to common questions about this code of conduct, see 77 | https://www.contributor-covenant.org/faq 78 | {"mode":"full","isActive":false} 79 | -------------------------------------------------------------------------------- /.github/CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | ## Contributing 2 | 3 | We expect contributors to abide by our underlying 4 | [code of conduct](https://github.com/forem/admin-docs/blob/main/code-of-conduct.md). All conversations and 5 | discussions on GitHub (issues, pull requests) and across 6 | [forem.dev](https://forem.dev) must be respectful and harassment-free. 7 | 8 | If you feel another member of the community has violated our Code of Conduct, 9 | you may anonymously contact the team with our 10 | [abuse report form](https://forem.dev/report-abuse). 11 | 12 | Remember that communication is the lifeblood of any Open Source project. We are 13 | all working on this together, and we are all benefiting from this software. It's 14 | very easy to misunderstand one another over asynchronous, text-based 15 | conversations: When in doubt, assume everyone within this project has the best 16 | intentions. 17 | 18 | We are all humans trying to work together to improve the community. Always be 19 | kind and appreciate the need for trade-offs. ❤️ 20 | 21 | Before making your first pull request or issue, give our full 22 | [Style Guide](https://admin.forem.com/docs/community-resources/style-guide) a read. 23 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/changes_requested.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Changes Requested 3 | about: Create a report to help us improve a document 4 | --- 5 | 6 | ### Explain the changes 7 | 8 | 9 | 10 | ### Suggested changes 11 | 12 | 13 | 14 | ### Additional context 15 | 16 | 17 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/config.yml: -------------------------------------------------------------------------------- 1 | blank_issues_enabled: false 2 | contact_links: 3 | - name: Feature Request 4 | url: https://forem.dev/t/features 5 | about: Please use the `Create Post` feature request template to suggest an idea to make Forem better. 6 | - name: Forem Questions and Discussions 7 | url: https://forem.dev/ 8 | about: Please ask and answer questions, discuss features, or reach out for help on forem.dev 9 | 10 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/contribute_open_resources.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Contribute to Open Resources 3 | about: Contribute to Forem's Open Resources 4 | --- 5 | 6 | 7 | 8 | 9 | ### Explain the type of resource 10 | 11 | 12 | ### Additional context 13 | 14 | 15 | 16 | 17 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/new_file_or_folder.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: New File or Folder 3 | about: Create an issue to request or advocate for a file or folder 4 | --- 5 | 6 | ### Explain the need for a new file or folder 7 | 8 | 9 | 10 | ### Suggested topic 11 | 12 | 13 | 14 | ### Additional context 15 | 16 | 17 | -------------------------------------------------------------------------------- /.github/PULL_REQUEST_TEMPLATE.md: -------------------------------------------------------------------------------- 1 | 18 | 19 | ## What type of PR is this? (check all applicable) 20 | 21 | - [ ] New File/Folder 22 | - [ ] Documentation Update 23 | 24 | ## Description 25 | 26 | ## Related Issues & Documents 27 | 28 | 29 | ## [optional] What gif best describes this PR or how it makes you feel? 30 | 31 | ![alt_text](gif_link) 32 | -------------------------------------------------------------------------------- /.github/workflows/cla.yml: -------------------------------------------------------------------------------- 1 | name: "CLA" 2 | on: 3 | issue_comment: 4 | types: [created] 5 | pull_request_target: 6 | types: [opened,closed,synchronize] 7 | merge_group: 8 | branches: 9 | - main 10 | 11 | permissions: 12 | actions: write 13 | contents: write 14 | pull-requests: write 15 | statuses: write 16 | 17 | jobs: 18 | check_cla: 19 | uses: forem/forem/.github/workflows/cla.yml@main 20 | secrets: inherit 21 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Dependencies 2 | /node_modules 3 | 4 | # Production 5 | /build 6 | 7 | # Generated files 8 | .docusaurus 9 | .cache-loader 10 | 11 | # Misc 12 | .DS_Store 13 | .env.local 14 | .env.development.local 15 | .env.test.local 16 | .env.production.local 17 | 18 | npm-debug.log* 19 | yarn-debug.log* 20 | yarn-error.log* 21 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |
2 |
3 |

Forem Admin Docs🌱

4 | For Empowering Community 5 |
6 | 7 | ## What is Forem? 8 | 9 | Forem is open source software for building communities. Communities for your 10 | peers, customers, fanbases, families, friends, and any other time and space 11 | where people need to come together to be part of a collective. 12 | [See our announcement post](https://dev.to/devteam/for-empowering-community-2k6h) 13 | for a high-level overview of what Forem is. 14 | 15 | [dev.to](https://dev.to) (or just DEV) is hosted by Forem. It is a community of 16 | software developers who write articles, take part in discussions, and build 17 | their professional profiles. We value supportive and constructive dialogue in 18 | the pursuit of great code and career growth for all members. The ecosystem spans 19 | from beginner to advanced developers, and all are welcome to find their place 20 | within our community. ❤️ 21 | 22 | ## Table of Contents 23 | 24 | - [What is Forem?](#what-is-forem) 25 | - [Table of Contents](#table-of-contents) 26 | - [Community](#community) 27 | - [Contributing](#contributing) 28 | - [License](#license) 29 | 30 | ## Community 31 | 32 | For a place to have open discussions on features, voice your ideas, or get help 33 | with general questions please visit our community at 34 | [forem.dev](https://forem.dev/). 35 | 36 | ## Contributing 37 | 38 | We encourage you to contribute to Forem! Please check out the 39 | [Contributing to Forem guide](.github/CONTRIBUTING.md) for guidelines about how to 40 | proceed. 41 | 42 | ## License 43 | 44 | This program is free software: you can redistribute it and/or modify it under 45 | the terms of the GNU Affero General Public License as published by the Free 46 | Software Foundation, either version 3 of the License, or (at your option) any 47 | later version. Please see the [LICENSE](.github/LICENSE.md) file in our repository for 48 | the full text. 49 | 50 | Like many open source projects, we require that contributors provide us with a 51 | Contributor License Agreement (CLA). By submitting code to the Forem project, 52 | you are granting us a right to use that code under the terms of the CLA. 53 | 54 | Our version of the CLA was adapted from the Microsoft Contributor License 55 | Agreement, which they generously made available to the public domain under 56 | Creative Commons CC0 1.0 Universal. 57 | 58 | Any questions, please refer to our 59 | [license FAQ](https://docs.forem.com/licensing/) doc or email yo@dev.to. 60 | 61 | 62 | [⬆ Back to Top](#Table-of-contents) 63 | -------------------------------------------------------------------------------- /babel.config.js: -------------------------------------------------------------------------------- 1 | module.exports = { 2 | presets: [require.resolve('@docusaurus/core/lib/babel/preset')], 3 | }; 4 | -------------------------------------------------------------------------------- /docs/advanced-customization/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "Advanced Customization", 3 | "position": 12 4 | } 5 | -------------------------------------------------------------------------------- /docs/advanced-customization/billboards.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 1 4 | --- 5 | 6 | # Billboards 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ## Overview 15 | 16 | **Billboards** are images, text, and/or links you can add to the upper right and lower left sidebars of your community homepage. 17 | 18 | ![Annotation of left and ride sidebar](https://user-images.githubusercontent.com/16007075/121432399-9e900900-c948-11eb-8f9d-db4cf3429477.png) 19 | 20 | On `/admin/customization/billboards` you'll see these attributes from the billboards that have been created for your community: 21 | 22 | - Organization ID \# 23 | - Organization Name 24 | - Placement area \(left or ride sidebar\) 25 | - Body Markdown 26 | - Published Status \(true or false\) 27 | - Approved Status \(true or false\) 28 | - Success Rate \(how often the ad is clicked\) 29 | 30 | You'll also see an edit button to edit the billboard and a destroy button to completely remove it. 31 | 32 | ## How to Create a Billboard 33 | 34 | Before you get started, you'll need an Organization ID # to to create the ad. If you have not created an organization yet, you can do so from your settings page. Once you've created an organization, you can look up the Organization ID \# by visiting `/admin/content_manager/organizations`. 35 | 36 | To create a new billboard, click the "Make A New Billboard" button from `/admin/customization/billboards`. This will bring you to a form with the following fields: 37 | 38 | - Organization ID: add your organization id \# 39 | - Body Markdown: add the markdown or HTML for your ad 40 | - Placement Area: select left or right sidebar 41 | - Published (you will only see this if you are an admin) 42 | - Approved (you will only see this if you are an admin) 43 | 44 | Here is an example of the body markdown from the image up top: 45 | 46 | ```text 47 | 48 | 49 | 50 |
51 | 52 |

Share Your Story

53 | 54 | ``` 55 | 56 | ![Billboard Form](https://user-images.githubusercontent.com/16007075/121432893-3ee62d80-c949-11eb-9b80-e2ba4ce37197.png) 57 | 58 | If you do not have publishing privileges, you'll need to ask a super admin to approve and publish your billboard. 59 | 60 | _Please note: it'll take a few minutes for your billboard or any changes made to your billboard to appear on the home page._ 61 | 62 | _Additionally, if you attempt to publish a billboard and see an error, please make sure there is no space after the image source URL \(i.e. between `png`add the `"` mark in the example above\) as this can return an error._ 63 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "Config", 3 | "position": 0 4 | } 5 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/api-tokens.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Assign API keys. 3 | position: 0 4 | --- 5 | 6 | # API Tokens 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ## Health Check Token 15 | 16 | This health checkup token is used to enable a secure endpoint for monitoring the status of the app \(whether the app is up or down, the status of services like the database, etc\). 17 | 18 | ## Video Encoder Key 19 | 20 | This is a secret key used to allow AWS to perform video encoding through the VideoStatesController. Currently, Videos is not available on most forems. 21 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/campaigns.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: How to go into "campaign mode" on the homepage. 3 | position: 2 4 | --- 5 | 6 | # Campaigns 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ## Overview 15 | 16 | Campaigns (accessed from `/admin/customization/config`) are a way to highlight information to your audience. You can use campaigns in whatever way suits your needs; most often at [DEV](https://dev.to/), we use them to highlight community celebrations or other call-to-actions. 17 | 18 | Campaign features include: 19 | 20 | 1. Large banner on homepage 21 | 2. Highlighted articles under a certain tag on homepage righthand sidebar 22 | 3. Righthand sidebar image for campaign 23 | 24 | You can choose to enable each feature individually or at the same time. 25 | 26 | ![1) Large banner on home page](/img/large_banner_on_homepage.png) 27 | 28 | ![2) Highlighted Campaign Articles & 3) Campaign Sidebar Image](/img/campaign_sidebar_image.png) 29 | 30 | ## Campaign Hero HTML Variant Name 31 | 32 | An HTML Variant is the HTML and CSS design of your banner. Visit [HTML Variants](/docs/advanced-customization/html-variants) (`/admin/customization/html_variants`) to design your banner and add the name of the HTML variant to this field. 33 | 34 | ### Campaign Articles Require Approval 35 | 36 | If using the sidebar, select this box if the articles under your selected tags should be approved before being shown here. Note: the articles will still appear on the main tag page, but they will be hidden from the homepage sidebar. 37 | 38 | ### **Campaign Sidebar Enabled** 39 | 40 | Check this box if you'd like to have the sidebar enabled. 41 | 42 | ### Campaign Sidebar Image 43 | 44 | Add an optional image URL if you'd like to include an image above your campaign sidebar. 45 | 46 | ### Campaign URL 47 | 48 | This link directs users to more information about your campaign when they click on the campaign sidebar image. 49 | 50 | ### Campaign Featured Tags 51 | 52 | Posts under these tags will be featured on the campaign sidebar. 53 | 54 | ### Campaign Call to Action 55 | 56 | This text is set to "Share your project" in the above screenshot. It can be adjusted at your preference. 57 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/community-content.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: How to go into "campaign mode" on the homepage. 3 | position: 3 4 | --- 5 | 6 | # Community Content 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Community Name 15 | 16 | Name of the community, in addition to an optional noun that describes your community if desired \(e.g. DEV, DEV Community, DEV Club, etc.\). Your community name will appear in places like the Code of Conduct, page titles, TOS + Privacy Policy, etc. 17 | 18 | ### Tagline 19 | 20 | The community tagline is displayed on sign-up modals and authentication header. For instance, our tagline is "We're a place where coders share, stay up-to-date, and grow their careers." This is different than the description, which is typically a bit longer. 21 | 22 | ### Community Description 23 | 24 | This description is used in meta tags for SEO, onboarding messaging, and the site footer. 25 | 26 | ### Community Member Label 27 | 28 | This is the word used to reference your community members. We use "developers" as our community label. 29 | 30 | ### Copyright Start Year 31 | 32 | This is displayed in the footer of the site. Your copyright start year should be used to mark the year your community started. 33 | 34 | ### Staff User 35 | 36 | In order to update this, you'll need to create a staff account first. The staff account sends automated messages to users, such as in the /welcome thread. 37 | 38 | ### Experience Low/High 39 | 40 | These labels set the low-to-high experience level range for posts. On DEV, we use "newbies" and "experts." 41 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/credits.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: The primary payment method for your community. 3 | position: 4 4 | --- 5 | 6 | # Credits 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### About Credits 15 | 16 | Credits enable users to purchase [classified listings](https://admin.forem.com/docs/advanced-customization/listings) from your site. Listings can be considered a marketplace for the community: users can offer their services, share events, list items for sale, etc. 17 | 18 | ### Credit Prices 19 | 20 | We recommend tiered bulk pricing for credits (i.e. the more credits someone buys, the cheaper each credit becomes). 21 | 22 | You can include up to four tiers of credit pricing: 23 | 24 | - Small: less than 10 credits 25 | - Medium: 10-99 credits 26 | - Large: 100-999 credits 27 | - Extra Large: 1000 credits or more 28 | 29 | To define the price of a single credit, please include the USD cent value of one credit at each tier. Here's an example of our tiers: 30 | 31 | - Small: 500 cents per credit 32 | - Medium: 400 cents per credit 33 | - Large: 300 cents per credit 34 | - Extra Large: 250 cents per credit 35 | 36 | **In order to sell credits, you will need to have** Stripe API **configured under your Forem's [Monetization settings](https://admin.forem.com/docs/advanced-customization/config/monetization)**. Users can purchase credits from `/credits/purchase` - if Stripe is not configured correctly they will see an error message. 37 | 38 | ![Error message visible on credits purchase page due to incorrect or incomplete Stripe settings](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/creditsPurchasePage.png) 39 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/emails.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Set your community email address and periodic email digest. 3 | position: 6 4 | --- 5 | 6 | # Emails 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Contact email address 15 | 16 | The contact email address is used for any contact links. It will appear on auto-populated support pages, Code of Conduct, Terms of Use, Privacy Policy, and any other locations around the site where users may need to reach out for additional help. 17 | 18 | ### Periodic email digest 19 | 20 | You can set the number of days between email digests a user receives. 21 | 22 | Email digests are automated emails sent to **subscribed** users that highlight suggested posts tailored to their interests, based on the [tags they follow, users they follow, and a few other criteria](https://github.com/forem/forem/blob/main/app/services/email_digest_article_collector.rb). 23 | 24 | Email digests are separate and distinct from [email newsletters](https://admin.forem.com/docs/advanced-customization/config/newsletter), which are sent and managed from a connected Mailchimp account. **You will need to have [Email Server Settings](http://admin.forem.com/docs/advanced-customization/config/email-server-settings) configured for your Forem in order to send email digests.** Your Forem will need at least 3 new posts per day before Email digests are triggered to send automatically. 25 | 26 | Users can opt in or out of these digests at any time from their [Notification Settings](https://admin.forem.com/docs/forem-basics/user-settings/notification-settings) at `/settings/notifications`. They can adjust the content of their digests by following/unfollowing/blocking users and organizations, or [adjusting their tag weightings to reflect their interests](https://admin.forem.com/docs/forem-basics/tags). 27 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/google-analytics.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Configure your Google Analytics. 3 | position: 7 4 | --- 5 | 6 | # Google Analytics 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### View ID 15 | 16 | Set the GA Tracking ID, e.g. `UA-71991000-1` to start gathering analytics in Google Analytics 17 | 18 | [Follow this guide for more information](https://support.google.com/analytics/answer/10269537?ref_topic=1009620#). 19 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/google-recaptcha.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: >- 3 | reCAPTCHA is used to prevent spam from hitting your report abuse page. This is 4 | an optional, but highly recommended protection against spam. More details 5 | here: https://www.google.com/recaptcha/about/ 6 | 7 | position: 8 8 | --- 9 | 10 | # Google reCAPTCHA 11 | 12 | :::important 13 | 14 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 15 | 16 | ::: 17 | 18 | ## Creating your reCAPTCHA App 19 | 20 | 1. First, visit the admin panel to create an app for your Forem: [https://www.google.com/recaptcha/admin/create](https://www.google.com/recaptcha/admin/create) 21 | 2. Fill out the appropriate fields: 22 | 1. Label: **Your Forem name \(for ex. My Forem\)** 23 | 2. reCAPTCHA Type: **reCAPTCHA v2** 24 | 1. Choose the default, **"I'm not a robot" Checkbox** 25 | 3. Domains: **your-domain.com** 26 | 3. Check the "Accept the Terms of Service" checkbox. 27 | 28 | Before submitting, it should look like this: 29 | 30 | ![](/img/recaptcha-registration-example.png) 31 | 32 | ![](/img/recaptcha-checkbox-example.png) 33 | 34 | Once you've clicked submit, you should see your site and secret keys: 35 | 36 | ![](/img/recaptcha-submit-example.png) 37 | 38 | Please add them to your Forem's config section in the **Email address** section of `Config > Authentication`: 39 | 40 | 1. First, visit your Forem's config section. 41 | 2. Under `Authentication`, find the `Email address` field. 42 | 3. Hit "Enable" for `Email address`. Note that this is only temporary, if you do not want to enable email address registration for your Forem. 43 | ![](/img/recaptcha-forem-config.jpg) 44 | 4. Check the `Enable Google reCAPTCHA for email password registration` box. 45 | 5. Paste in the appropriate Google reCAPTCHA keys. 46 | ![](/img/recaptcha-forem-config-2.jpg) 47 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/images.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: How to go into "campaign mode" on the homepage. 3 | position: 9 4 | --- 5 | 6 | # Images 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Logo 15 | 16 | The main site logo appears in the site’s navbar (in the top left-hand corner). 17 | The following logo types are accepted: PNG, JPG, and JPEG. Logos should not be more than 3 MB in size and should not be greater than 4096x4096px in dimensions. If your upload attempt is unsuccessful, try resizing the logo and uploading it again. 18 | 19 | ![Logo in use in navbar](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/ImagesLogo.png) 20 | 21 | ### Secondary Logo 22 | 23 | Used as a secondary logo in places like the sign-in modals, user onboarding, and Apple touch icons. This field requires an image URL link and we recommend that the image be a minimum of 512px512px in dimensions for the best results. 24 | 25 | **Note: You can quickly generate an image link URL by visiting `/admin/advanced/tools` and uploading a photo.** 26 | 27 | ### Main Social Image 28 | 29 | This image is used as the default OpenGraph image that appears when you share links to your community on external sites. This field requires an image URL link and we recommend that the image has an aspect ratio of 16:9 (600x337px or 1200x675px) for the best results. 30 | 31 | ![Social Image in use on Twitter](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/ImagesSocial.png) 32 | 33 | **Note: You can quickly generate an image link URL by visiting `/admin/advanced/tools` and uploading a photo.** 34 | 35 | ### Favicon URL 36 | 37 | The Favicon is a small, iconic image that represents your website. Favicons are most often found in the address bar of new browser tabs. This field requires an image URL link and we recommend uploading a square image for the best results. 38 | 39 | ![Favicon in use in browser tab](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/ImagesFavicon.png) 40 | 41 | **Note: You can quickly generate an image link URL by visiting `/admin/advanced/tools` and uploading a photo.** 42 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/mascot.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Configure your Forems Mascot and User. 3 | position: 10 4 | --- 5 | 6 | # Mascot 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### About 15 | 16 | The Site Mascot is a proxy user that allows [Admins and Moderators](https://admin.forem.com/docs/forem-basics/user-roles) to perform specific functions anonymously. Some of these functions include leaving Moderator Comments and sending Welcome notifications. 17 | 18 | Additionally, when content trips the [Spam Trigger Terms](https://admin.forem.com/docs/advanced-customization/rate-limits-and-anti-spam#spam-trigger-terms), it is flagged in the Moderation Portal by the Mascot User. (A user's trustworthiness score is impacted in the same way by an auto-reactions from the Mascot User as it is by the same reaction from a Trusted User](https://admin.forem.com/docs/managing-your-community/trusted-user-features) 19 | 20 | ### Mascot User ID 21 | 22 | Although your Forem comes with a Mascot account, you can change this to any existing user. This gives you the option to create an entirely new Mascot account that matches the style of your own Forem, complete with its own [User Profile](https://admin.forem.com/docs/forem-basics/user-settings/profile-settings). 23 | 24 | ### Mascot Image URL 25 | 26 | If you're keeping the default Mascot User, you can upload a profile image for your Mascot here. 27 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/meta-keywords.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Configure your Forems Meta Keywords. 3 | position: 11 4 | --- 5 | 6 | # Meta Keywords 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | These keywords are included in as metadata in the relevant pages. They may have a minimal impact on some SEO crawlers, so you can choose whether you want to use them or not. If you want to use them, you can include some search engine keywords that might help your Forem appear in relevant searches, comma-separated. 15 | 16 | ### Default 17 | 18 | Included in all pages. 19 | 20 | ### Article 21 | 22 | Included on article / post pages. 23 | 24 | ### Tag 25 | 26 | Included on tag pages. 27 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/monetization.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Define various monetization variables. 3 | position: 12 4 | --- 5 | 6 | # Monetization 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Shop URL 15 | 16 | The URL of your shop. 17 | 18 | ### Stripe API Key 19 | 20 | Secret Stripe key for receiving payments. For more details see: [https://stripe.com/docs/keys](https://stripe.com/docs/keys) 21 | 22 | ### Stripe Publishable Key 23 | 24 | Public Stripe key for receiving payments. For more details see: [https://stripe.com/docs/keys](https://stripe.com/docs/keys) 25 | 26 | ### Payment Pointer 27 | 28 | Used for site-wide web monetization. For more details see: [https://github.com/thepracticaldev/dev.to/pull/6345](https://github.com/thepracticaldev/dev.to/pull/6345) 29 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/newsletter.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: How to configure Mailchimp newsletters with your Forem 3 | position: 13 4 | --- 5 | 6 | # Newsletter 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Newsletter settings allow you to integrate your Mailchimp newsletter audience with your Forem community members. Newsletters are sent from your Mailchimp account and are different from your [Forem Email Digests](https://admin.forem.com/docs/advanced-customization/config/emails#periodic-email-digest). 15 | 16 | It's up to you how often you want to create and send your Mailchimp newsletters (we recommend no more than one newsletter per week). You will create and manage these and their sending frequency entirely in Mailchimp, with the API (settings below) sharing the subscribers list with Mailchimp. 17 | 18 | Currently, Forem is only configured for Mailchimp newsletter management. If you'd like to request additional integrations, [find out how to contribute feature requests on forem.dev here](https://admin.forem.com/docs/community-resources/connect_with_forem_builders). 19 | 20 | ## Configuring your Forem Newsletters with Mailchimp 21 | 22 | If you don't already have [a Mailchimp account, sign up for one](https://login.mailchimp.com/signup/). 23 | 24 | ### Mailchimp API Key 25 | 26 | Once you've created your account, you'll need to make an API key. To get your API key, follow the [instructions on Mailchimp](https://mailchimp.com/help/about-api-keys/). 27 | 28 | ![Mailchimp API Key management page](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/mailchimpAPI.png) 29 | 30 | ![Your API end page should look something like this](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/mailchimp-api-example.png) 31 | 32 | Copy and paste **Your API Key** from Mailchimp into the **Mailchimp API Key** field under **Newsletter** in `/admin/customization/config`. 33 | 34 | ![Paste the API key from Mailchimp into your Forem Config](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/mailchimpAPItoConfig.png) 35 | 36 | ### Main Newsletter 37 | 38 | This is the newsletter you will send to all your Forem members. Mailchimp calls these newsletters **Audiences**. 39 | 40 | If already have an audience set up that you want to use for this Newsletter, skip to Step 2 below. Otherwise, go ahead and create one in Step 1. 41 | 42 | ![Mailchimp New Audience form](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/mailchimpCreateAudience.png) 43 | 44 | 1. [Create a New Audience in Mailchimp](https://us12.admin.mailchimp.com/lists/new-list/). Fill out the fields accordingly and save. 45 | 2. Once you have an audience you want to use (whether you already had one set up or just created it) Go to the **Settings > Audience name and defaults** 46 | 3. On the right hand side, you'll see the **Audience ID**. Copy and paste it into the **Main Newsletter** field in `/admin/config`: 47 | 48 | ![Enter the Audience ID under Main Newsletter](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/mailchimpMainNewsletterAudienceID.png) 49 | 50 | ### Sustaining Members Newsletter 51 | 52 | This is currently a DEV specific newsletter. 53 | 54 | ### Tag Moderators Newsletter 55 | 56 | This is currently a DEV specific newsletter. 57 | 58 | ### Community Moderators Newsletter 59 | 60 | This is currently a DEV specific newsletter. 61 | 62 | ## GDPR Deletion 63 | 64 | The way your Forem integrates contact details with Mailchimp requires you to [manually remove users from your Mailchimp audience](https://mailchimp.com/help/delete-contacts/) after you delete them from your Forem. 65 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/social-media.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Assign social media variables for community. 3 | position: 14 4 | --- 5 | 6 | # Social Media 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Twitter Hashtag 15 | 16 | Used as the Twitter hashtag of the community. This will be automatically included when people share posts via the built-in sharing tools 17 | 18 | ### Twitter 19 | 20 | Twitter username, no punctuation (e.g. "thepracticaldev") 21 | 22 | ### Facebook 23 | 24 | Facebook username, no punctuation (e.g. "thepracticaldev") 25 | 26 | ### GitHub 27 | 28 | GitHub username, no punctuation (e.g. "thepracticaldev") 29 | 30 | ### Instagram 31 | 32 | Instagram username, no punctuation (e.g. "thepracticaldev") 33 | 34 | ### Twitch 35 | 36 | Twitch username, no punctuation (e.g. "thepracticaldev") 37 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/sponsors.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Define public name for sponsors. 3 | position: 15 4 | --- 5 | 6 | # Sponsors 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ## Sponsor Headline 15 | 16 | Determines the heading text of the main sponsors sidebar above the list of sponsors. 17 | 18 | Default is set to "Community Sponsors" 19 | -------------------------------------------------------------------------------- /docs/advanced-customization/config/user-experience-and-brand.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: How to go into "campaign mode" on the homepage. 3 | position: 16 4 | --- 5 | 6 | # User Experience and Brand 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | The Forem feed is perhaps _the_ core functionality of the service. It's an adaptation of a concept popularized by other social platforms in the past two decades, and it is something we need to develop with care in a way that empowers individual communities and users. 15 | 16 | The core nature of "the feed" is that it needs to evolve and be flexible. We will learn new ideas over time. We need to take into account metrics, but also question the relevance and "goodness" of certain metrics. We want folks finding fulfilling and enriching content, not necessarily addictive content. 17 | 18 | However, we are in the fairly naive early days of the feed, so primarily it is a matter of flexibility and experimentation. 19 | 20 | ### Feed Style 21 | 22 | - `basic` is the standard feed, where only the top post in the feed will show its cover image 23 | - `rich` displays the cover image on all posts in the feed 24 | 25 | ### Feed strategy 26 | 27 | - `basic` is the default and recommended feed for most forems 28 | - More simple and chronological 29 | - `large_forem_experimental` should be reserved for large forem communities 30 | - Introduces some split testing and optimizations 31 | 32 | ### Tag Feed Minimum Score 33 | 34 | Minimum score needed for a post to show up on default tag page. We recommend keeping this at "0" for most Forems. 35 | 36 | ### Home Feed Minimum Score 37 | 38 | Minimum score needed for a post to show up on the unauthenticated home page. We recommend keeping this at "0" for most Forems. 39 | 40 | ### Index Minimum Score 41 | 42 | Minimum score needed for a post to show up in search engine results and the sitemap. We recommend keeping this at "0" for most Forems. 43 | 44 | ### Default Font 45 | 46 | Select the default font that you'd like to display on your community 47 | 48 | ### Primary Brand Color Hex 49 | 50 | This changes the look of several elements across the Forem, including buttons and links. 51 | 52 | ### Public 53 | 54 | Checking this box will make your Forem public to all visitors. Registration will still be required to take actions such as commenting, reacting to content, publishing articles, etc. 55 | 56 | Be **extremely cautious** in changing this, as it can cause substantial issues if you: 57 | 58 | - Accidentally take a public forem back to private \(breaking links\) 59 | - Accidentally take a private forem to public \(exposing private information\) 60 | -------------------------------------------------------------------------------- /docs/advanced-customization/content-manager/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "Content Manager", 3 | "position": 0 4 | } 5 | -------------------------------------------------------------------------------- /docs/advanced-customization/extensions/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "Extensions", 3 | "position": 0 4 | } 5 | -------------------------------------------------------------------------------- /docs/advanced-customization/navigation-links.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | position: 0 4 | --- 5 | 6 | # Navigation Links 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Overview 15 | 16 | The `/admin/customization/navigation_links` page is used to configure the sidebar that appears on your home page. The sidebar has two sections: `Default` (its title is your Community Name) and `Other`. By default you should see the following sidebar navigation items on your homepage: 17 | 18 | | Name | URL | Section | 19 | | :-------------- | :--------------- | :------ | 20 | | Reading List | /readinglist | Default | 21 | | Code of Conduct | /code-of-conduct | Other | 22 | | Privacy Policy | /privacy | Other | 23 | | Terms of use | /terms | Other | 24 | | Contact | /contact | Default | 25 | 26 | ### Possible additional navigation links: 27 | 28 | Some additional navigational links that can be created once you have content for these pages include: 29 | 30 | | Name | URL | 31 | | :------- | :-------- | 32 | | Listings | /listings | 33 | | Podcasts | /pod | 34 | | Videos | /videos | 35 | | Tags | /tags | 36 | | FAQ | /faq | 37 | | Shop | ~ | 38 | | Sponsors | /sponsors | 39 | | About | /about | 40 | 41 | ### How to create a navigation link 42 | 43 | In order to create a navigation links, click on the button that says **Add Navigation Link** and enter the information required. 44 | 45 | A brief description of each of the fields can be found below: 46 | 47 | - **Name** is the user facing friendly name that you will give the link. 48 | - **URL** sets the url for the link. The user will be directed to this link when they click on the navigation item. 49 | - **Icon** requires an SVG icon to be pasted into the text area. The icon will be displayed in a 24x24 px box. More info on finding SVGs below. 50 | - **Section** determines which section the link will be displayed ("Default" or "Other"). 51 | - **Position** provides the position or the order placement of the links in the sidebar. If you choose to not specify an order then the links will be ordered in a descending order by name. 52 | - **Display only when signed in** allows the admin to decide whether that link should only be shown after the user has signed into their account. 53 | 54 | You may also edit or delete your navigation link at any point. 55 | 56 | _NOTE: If you do not have any Other links, the Other section will not show up in your sidebar._ 57 | 58 | ### Finding SVGs 59 | 60 | We recommend the [Twemoji project](https://twemoji.twitter.com/) for SVGs. 61 | 62 | - Find the SVG you'd like to use [here](https://twitter.github.io/twemoji/v/latest/preview.html) 63 | - Use the file name to find the SVG file in the proper folder 64 | - Versioned SVGs will be [here](https://github.com/twitter/twemoji/tree/gh-pages/v) 65 | - Non-Versioned SVGs will be [here](https://github.com/twitter/twemoji/tree/gh-pages/svg) 66 | -------------------------------------------------------------------------------- /docs/advanced-customization/rate-limits-and-anti-spam.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: How to use Rate Limits & Anti-spam tooling. 3 | sidebar_position: 56 4 | --- 5 | 6 | # Rate Limits & Anti-Spam 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Note: Some limits only apply to new users. The number of days a user is considered new defaults to 3 but can be configured. 15 | 16 | ### Rate Limit Article Update 17 | 18 | The number of articles a user can update within 30 seconds. To limit the number of articles a user can publish, see [Rate Limit Published Article Creation](https://admin.forem.com/docs/advanced-customization/rate-limits-and-anti-spam#rate-limit-published-article-creation) below. 19 | 20 | ### Rate Limit User Update 21 | 22 | The number of profile updates a user can make within 30 seconds. 23 | 24 | ### Rate Limit Feedback Message Creation 25 | 26 | The number of times a user can submit feedback within a 5 minute period. 27 | 28 | ### Rate Limit Follow Count Daily 29 | 30 | The number of users a person can follow in one day. 31 | 32 | ### Rate Limit Comment Creation 33 | 34 | The number of comments a user can create within 30 seconds. 35 | 36 | ### Rate Limit Comment AntiSpam Creation 37 | 38 | The number of comments a new user can create within a 5 minute period. 39 | 40 | ### Rate Limit Mention Creation 41 | 42 | The number of times a user can @-mention other uses in a comment or post. 43 | 44 | ### Rate Limit Listing Creation 45 | 46 | The number of listings a user can create in 1 minute. 47 | 48 | ### Rate Limit Published Article Creation 49 | 50 | The number of articles that a user can publish within 30 seconds. 51 | 52 | ### Rate Limit Image Upload 53 | 54 | The number of images a user can upload within 30 seconds. 55 | 56 | ### Rate Limit Email Recipient 57 | 58 | The number of emails we send to a user within 2 minutes. 59 | 60 | ### Rate Limit Organization Creation 61 | 62 | The number of organizations a user can create within a 5 minute period. 63 | 64 | ### Rate Limite Reaction Creation 65 | 66 | The number of times a user can react in a 30 second period. 67 | 68 | ### Rate Limit Sent Email Confirmation 69 | 70 | The number of times we will send a confirmation email to a user in a 2 minute period. 71 | 72 | ### Rate Limit User Subscription Creation 73 | 74 | The number of user subscriptions a user can submit within 30 seconds. 75 | 76 | ### Spam Trigger Terms 77 | 78 | Individual (case insensitive) phrases that trigger spam alerts, comma-separated. For example, if you are seeing a lot of spam about illegal movie downloads, you might want to consider adding these phrases: `fullhd 1080p, free movie download` to this field. 79 | 80 | If any posts are published with these keywords, they will be auto-reported by your mascot as vomit reactions that you can confirm or mark as invalid in `/admin/moderation/reports`. 81 | 82 | If any user names contain these strings they will also be flagged and user vomited, making their user score recalculat to a below zero[[14858]](https://github.com/forem/forem/pull/14858) 83 | -------------------------------------------------------------------------------- /docs/advanced-customization/reports.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of reports. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Reports 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ## Overview 15 | 16 | The `/admin/moderation/reports` page is an area for admins to monitor activity on the platform and respond to reports of abuse. 17 | 18 | ## Suspicious Activity 19 | 20 | ### Latest Articles 21 | 22 | A quick overview of the most recently published articles across your Forem. Hitting toggle will bring you to a few quick links: 23 | 24 | - **Mod** - Article Moderation 25 | - **admin** - Article Admin 26 | - **Profile** - Author profile page 27 | - **admin User** - Author admin page - basic actions 28 | - **Destructive Actions** - Author admin page - destructive actions 29 | 30 | ## Possible Spam/Abuse Users 31 | 32 | This area surfaces potential spam users. We surface these users based on the age of their account, certain words in the user name, etc. Hitting toggle will bring you to a few quick links: 33 | 34 | - **admin User** - Author admin page - basic actions 35 | - **Destructive Actions** - Author admin page - destructive actions 36 | 37 | Please keep in mind that these users may not all be spam users. This list is meant to make it easier for admins to identify potential bad actors and to take action early on. 38 | 39 | ## Abuse Reports 40 | 41 | ### Vomit Reactions 42 | 43 | When a trusted user moderates a post, comment, or user with the 'vomit' emoji, these reports are listed here for you to validate or invalidate. 44 | 45 | Vomit emojis have the immediate impact of reducing the visibility of the reported content or user across the platform. Trusted users are instructed to use the 'vomit' moderation tool when content or a user blatantly breaks the code of conduct. 46 | 47 | Hitting toggle will allow you to confirm the vomit report or mark it as invalid. If a report is marked as invalid, the content or user will regain their visibility on the platform. 48 | 49 | ### Manual Reports 50 | 51 | This is the place to review all the reports that have come through your Forem's report abuse form (`/report-abuse`). This area lists all the reports in chronological order. You can filter the reports by: 52 | 53 | - The Reported URL or The Reporter 54 | - Open, Invalid, or Resolve (clicking the drop down) 55 | 56 | Here's an example of filtering for all 'open' reports: 57 | 58 | ![Filter for all open reports](/img/open-reports.png) 59 | 60 | In addition to filtering, you can also sort all reports by 'Reporter', 'Reported URL', or 'Creation Date' by clicking one of these links: 61 | 62 | ![Sort by Reporter, Reported URL, or Creation Date.](/img/sort-abuse-reports.png) 63 | 64 | Each report will display who submitted the report (reporter), the URL of the page they are reporting, and their message to the admins. If a user is not logged-in at the time of submitting a report, then the reporter will be marked as anonymous. 65 | 66 | In addition to the report, we also display a history of email messages with the reporter and an area to directly email the reporter, offender, and affected. These people are defined as follows: 67 | 68 | - Reporter: person who submitted the report 69 | - Offender: person who may have been abusive on the platform 70 | - Affected: person who may have been affected by abuse 71 | 72 | Note that when Reporters send in a report they are automatically messaged a standard email thanking them for their report: 73 | 74 | ![Example of automatic message sent to abuse reporter](/img/thank-you-reporter.png) 75 | 76 | Oftentimes, the Reporter and Affected are the same person but there are many scenarios where the Reporter is a third party witness to the bad behavior. 77 | 78 | The email form will pull in the reporter's email (if applicable) and provide a canned response for each type of email. You can customize this email however you'd like and click **Send Email** when you'd like to send the email to each person. 79 | 80 | Whether or not you send an email, you can update the status of this report as either open, resolved, or invalid. You must click **Save Status** to update the status. 81 | 82 | If you need to add a note about the report for fellow admins, you can do so in the **Notes** section, just be sure to click **Submit Note** when you're done. 83 | -------------------------------------------------------------------------------- /docs/advanced-customization/tag-display-order.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Sidebar Tags 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Sidebar tags are a feature that allows admin to specify which tags are displayed in the right-hand sidebar of your homepage. You can also choose in which order these tags are displayed. 15 | 16 | ## How to Add Sidebar Tags and Specify Their Order 17 | 18 | To add sidebar tags, you must navigate to `/admin/customization/config` and click "show info" beside "Tags". You then can list any tags you want to display, separating each one by commas. These tags will appear top-to-bottom, the order in which you list them. 19 | -------------------------------------------------------------------------------- /docs/community-resources/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "Community Resources", 3 | "position": 13 4 | } 5 | -------------------------------------------------------------------------------- /docs/community-resources/connect-with-forem-builders.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 1 4 | --- 5 | 6 | # Connecting with Forem Creators and Admins 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | You are invited to join [forem.dev](https://forem.dev/), a Forem community specifically for Forem Creators and Admins to ask questions, share feedback, and learn from others. Once you join up, follow the [Forem Core Team](https://forem.dev/foremteam) for announcements! 15 | 16 | If you want to browse various live Forem communities, then we recommend going to our [Forem Discover page](https://www.forem.com/discover/). 17 | -------------------------------------------------------------------------------- /docs/community-resources/style-guide.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: Forem Admin Docs Contributing and Style Guide. 3 | sidebar_position: 2 4 | --- 5 | 6 | # Contributing and Style Guide 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Thanks for your interest in contributing to Forem's Admin Documentation!  15 | Before getting started, we'd like you to review our contributing and style guide. Afterward, please visit our [Forem Admin Docs repo](https://github.com/forem/admin-docs#forem-admin-docs) and [submit an issue](https://github.com/forem/admin-docs/issues/new/choose) using one of our templates. 16 | 17 | ## Naming Conventions 18 | 19 | When naming files we should opt for kebab case, `kebab-case`, in order to remain 20 | consistent and clear. This rule applies for folders as well. However, before creating 21 | a folder, it'd be best to check in with the Community Success team at  22 | [forem.dev](https://forem.dev) for organizational purposes. 23 | 24 | ### Examples 25 | 26 | Document Title: User Roles > `user-roles.md` 27 | 28 | Document Title: Pages > `pages.md` 29 | 30 | Document Title: Connecting with Forem Creators and Admins  >
31 | `connecting-with-forem-creators-and-admins.md` 32 | 33 | With a longer title, it'd also be acceptable to shorted the slug(or file name). For 34 | example we could shorten the name to: `connect-forem-creators.md` 35 | 36 | ## File Extension 37 | 38 | We'll always be using the markdown, `.md`, extension - see Examples above. 39 | -------------------------------------------------------------------------------- /docs/community-resources/submit-bug-report.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 2 4 | --- 5 | 6 | # Submit a Bug Report 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | You can submit bug reports to us directly through GitHub using our [bug report issue form](https://github.com/forem/forem/issues/new?assignees=&labels=&template=bug_report.md). 15 | 16 | If you have any ideas for features, we ask that you please create a post on [forem.dev](https://forem.dev) detailing your idea for the feature and then tag your post with [#features](https://forem.dev/t/features). This way both the Forem team and community can weigh in openly. 17 | -------------------------------------------------------------------------------- /docs/community-resources/who-are-these-docs-for.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Who are these docs for? 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | This documentation is meant to guide folks who have launched and are managing a Forem community. 15 | 16 | :::important 17 | 18 | NOTE: this guide does not offer development guidance for setting up a Forem. For those who have yet to install the app that are hoping to self-host, please check out our [Forem Selfhost Installation Documentation](https://github.com/forem/selfhost-devel). If you would like to contribute to Forem as a developer, please read our [Forem Developer Documentation](https://docs.forem.com/). 19 | 20 | ::: 21 | 22 | Using these docs, you'll learn: 23 | 24 | - how to customize the appearance of your Forem 25 | - how to use moderation tools to keep your community healthy 26 | - how to wield a variety of other features to enhance the experience on your Forem 27 | 28 | If you are setting up your Forem for the first time, we recommend reading the Getting Started section first. 29 | 30 | If you have joined on with an established Forem as an admin, you may want to skip ahead to the Forem Basics section. 31 | -------------------------------------------------------------------------------- /docs/forem-basics/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "Forem Basics", 3 | "position": 10 4 | } 5 | -------------------------------------------------------------------------------- /docs/forem-basics/badges.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 8 4 | --- 5 | 6 | # Badges 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ## Overview 15 | 16 | Badges appear on user profiles and are a great way to reward your community. People love collecting badges! 17 | 18 | Badges are managed from `/admin/content_manager/badges`, where they can be created, awarded, and removed. 19 | 20 | ## How To Create A Badge 21 | 22 | Click **Create Badge** and you'll open form with the following fields: 23 | 24 | - **Title**: name of badge (a badge's link is auto-generated based on the title, e.g. the title **Slug of Badge** would generate the link `/badges/slug-of-badge`) 25 | - **Description**: the description that appears when a user is awarded the badge 26 | - **Badge Image**: upload an image of your badge 27 | - **Credits Awarded**: number of credits awarded to a user after they were awarded the badge 28 | 29 | ## How To Award A Badge 30 | 31 | ### Manually 32 | 33 | Most badges are awarded manually via `/admin/content_manager/badges` and `/admin/content_manager/badge_achievements` by clicking the **Award Badge** button. To award a badge: 34 | 35 | - **Badge**: Select the name of badge to be awarded 36 | - **Usernames**: List the usernames of each user that should receive the badge in a comma-separated format. 37 | - **Override Default Message**: The default message is the badge description, but you can override that message by adding a custom one here. 38 | - Click **Award Badges** 39 | 40 | ### Automatically 41 | 42 | Forems come loaded with a default set of badges that get awarded automatically. 43 | 44 | Examples types of badges from DEV: 45 | 46 | - **Contributor Badges:** the [DEV Contributor](https://dev.to/badge/dev-contributor) badge is awarded after a PR is merged into the DEV open open-source repo 47 | - **Anniversary Badges**: the [1-year](https://dev.to/badge/one-year-club), [2-year](https://dev.to/badge/two-year-club), [3-year](https://dev.to/badge/three-year-club) badges are awarded on the anniversaries of a community member join date 48 | - **Streak Badges:** the [4-week](https://dev.to/badge/8-week-streak), [8-week](https://dev.to/badge/8-week-streak), and [16-week](https://dev.to/badge/16-week-streak) streak badges are awarded for publishing a post in consecutive weeks 49 | - **Top Post by Tag Badges**: various badges are awarded for the author with the most popular article in a specific tag 50 | - **Beloved Comment**: [this badge](https://dev.to/badge/beloved-comment) is awarded automatically for any comment that reaches a certain threshold of positive reactions 51 | 52 | ## How do I set up an automatically-awarded badge? 53 | 54 | The following badges can be awarded automatically. To do so, be sure to set up a badge using a matching **Slug** by matching the exact formating of the **Badge Name** in the table below. 55 | 56 | For the top post by tag badges, the Forem admin will need to create a badge and associate it with a tag. 57 | 58 | Here's a comprehensive list of the badges' slugs to recreate: 59 | 60 | | Badge Name | Badge Slug | Note | 61 | | :----------------- | :---------------- | :-------------------------------------------------------------------------- | 62 | | DEV Contributor | dev-contributor | This is not generalized. This relates strictly to the DEV Open source repo. | 63 | | **X** Year Badge | **X**-year-club | N/A | 64 | | **X** Streak Badge | **X**-week-streak | capped at 16 weeks, must be 2,4,8,16 | 65 | | Tag Badge | slug of the tag | associate the badge with a tag via /admin/badges | 66 | | Beloved Comment | beloved-comment | Automatically awards a badge if someone's comment reaches 25 likes | 67 | 68 | ## How To Remove A Badge 69 | 70 | If you followed the instructions to award a badge and realize too late that you've awarded the badge to the wrong person, don't worry! Although we would generally recommend allowing someone to keep a casual community badge that has been erroneously awarded, if it's an exclusive award you may opt to remove it. To do this, navigate to `https://dev.to/admin/content_manager/badge_achievements` or click on **Badge Achievements** from the main **Badges** page, locate the recipient, and click **Remove**. 71 | 72 | Please note: If you remove a badge that your Forem is configured to automatically award, it will be re-awarded automatically. 73 | -------------------------------------------------------------------------------- /docs/forem-basics/generated-pages.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the "Out of the Box" pages that are generated when you create your Forem. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Generated Pages 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | **Generated Pages** are pages that are created for your when your Forem is created and spun up for the first time. 15 | 16 | :::important 17 | 18 | If you're looking for information about a custom page, please visit our [Pages documentation](/docs/forem-basics/pages). 19 | 20 | ::: 21 | 22 | ## Overview 23 | 24 | Here's a high-level list of the pages you'll receive once your Forem is created. 25 | 26 | - `/about` 27 | - `/code-of-conduct` 28 | - `/community-moderation` 29 | - `/contact` 30 | - `/events` 31 | - `/faq` 32 | - `/listings` 33 | - `/pod` 34 | - `/privacy` 35 | - `/readinglist` 36 | - `/sponsors` 37 | - `/tag-moderation` 38 | - `/terms` 39 | 40 | ## Overriding a Generated Page 41 | 42 | Certain pages can be overridden to display a custom page built by yourself or team. A great example of this would be the `/contact` page example. 43 | 44 | :::note 45 | 46 | Only certain pages are able to be be overridden. These pages are: 47 | 48 | - `/about` 49 | - `/about-listings` 50 | - `/contact` 51 | - `/community-moderation` 52 | - `/faq` 53 | - `/tag-moderation` 54 | 55 | - `/contact` has unique status, in that it's an automatically generated and populated page (which comes with its own [Navigation Link](https://admin.forem.com/docs/advanced-customization/navigation-links) configured) that can be overridden by being [created as a new Page](https://admin.forem.com/docs/forem-basics/pages). 56 | 57 | ::: 58 | 59 | You can follow our tutorial on [Generated Pages here](https://forem.dev/communitysuccess/overriding-a-generated-page-1mph), and [grab some sample content for your pages here](https://forem.dev/ellativity/series/13)! 60 | -------------------------------------------------------------------------------- /docs/forem-basics/member-management.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: An overview of the Member Management Page in the Admin Panel 3 | sidebar_position: 1 4 | --- 5 | 6 | # Member Management Pages 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Every registered member of a Forem has their own Member Management page, which Admins can use to monitor activity and assign actions to the member's account. It can be accessed for each member by navigating to `/admin/users/` or by navigating to the **People** section of the admin panel and selecting a user. 15 | 16 | ![Member Management page](https://forem.dev/images/4CEpHB7I5XQxOSoT5wszxa8ptJtbx9Hv6ZbGMmtT57I/w:880/mb:500000/ar:1/aHR0cHM6Ly9mb3Jl/bS5kZXYvcmVtb3Rl/aW1hZ2VzL3VwbG9h/ZHMvYXJ0aWNsZXMv/MmZhNmQzbTcwc2h1/ZW9yN245Y2gucG5n) 17 | 18 | The top of the page displays the most important information about your members such as their [status](https://admin.forem.com/docs/forem-basics/user-roles), contact information, social accounts, and important dates. 19 | 20 | ## Overflow Menu 21 | 22 | Clicking on the overflow menu icon (the vertical three dots) allows Admins to take administrative actions on the members's account such as exporting their data, [unpublishing their posts](https://admin.forem.com/docs/managing-your-community/managing-posts-and-comments), or [banishing them](https://admin.forem.com/docs/managing-your-community/removing-spam). 23 | 24 | ![Overflow Menu](https://forem.dev/images/QxQktlE6M0Z2-iXictoTMgPmuctWv8Ze11qnSVr1un8/w:880/mb:500000/ar:1/aHR0cHM6Ly9mb3Jl/bS5kZXYvcmVtb3Rl/aW1hZ2VzL3VwbG9h/ZHMvYXJ0aWNsZXMv/YmdzMnE4cWY1aG9k/ZmRwN2RpcmYucG5n) 25 | 26 | ## Tabs 27 | 28 | Tabs cover the key information about the member's account, their activity, and their interactions with other users on the site. Click on each tab to display additional tools and functions. 29 | 30 | ![Emails Tab expanded](https://forem.dev/images/KrMpuPnaUuPrgY4YxOkIEQO3HtPeZBJnGg-EehHLWbk/w:880/mb:500000/ar:1/aHR0cHM6Ly9mb3Jl/bS5kZXYvcmVtb3Rl/aW1hZ2VzL3VwbG9h/ZHMvYXJ0aWNsZXMv/cG1rZTc3aWZwcm5v/N2Z6bHZwc2kucG5n) 31 | 32 | **Overview**: a birds eye view of the member’s [roles](https://admin.forem.com/docs/forem-basics/user-roles), [organizations](https://admin.forem.com/docs/managing-your-community/organization-pages), credits, and any tag moderation they have been assigned. Click on **Add role** to [suspend a user](https://admin.forem.com/docs/managing-your-community/suspending-users) or add additional roles, including Tag Moderation or Trusted Status. 33 | 34 | **Notes**: a section for Admins to share notes about the member that can only be seen by other Admins. This can be used to track positive or negative interactions, or facts about the member. 35 | 36 | **Emails**: verify the member's email address, send an email, and see any previous communications. 37 | 38 | **Reports**: any reports submitted by the user. 39 | 40 | **Flags**: any flags about the user [submitted by a moderator](https://admin.forem.com/docs/managing-your-community/trusted-user-features) 41 | -------------------------------------------------------------------------------- /docs/forem-basics/pages.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Pages 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | **Pages** are a way to store static content on your Forem that won't appear in Feeds. They allow for custom formating [compared to Posts](/docs/forem-basics/posts) and can be assigned top level paths. 15 | 16 | ## Overview 17 | 18 | The `/admin/customization/pages` page allows you to: 19 | 20 | - Create a new page 21 | - View existing pages 22 | 23 | ## Creating a Page 24 | 25 | Visiting `/admin/customization/pages/new` allows you to create a new page. 26 | 27 | - **Title** = The name of the page, appears in the browser window or tab. 28 | - **Slug** = The unique page path that this page will be accessed with, e.g. `https://yourforem.tld/slug`. The slug for `https://dev.to/code-of-conduct` is `code-of-conduct` 29 | - **Description** = A description of what the page contains, used mostly by search engines 30 | - **Template** = 31 | - [Here is an example of a Contained page](https://dev.to/about) 32 | - [Here is an example of a full_within_layout page](https://dev.to/downloads) 33 | - [Here is an example of a json page](https://dev.to/page/codeland_schedule) 34 | - **Body Markdown / Body HTML** 35 | - You'll usually use _one or the other_ 36 | - You should have a very specific reason for using HTML and not Markdown 37 | - **Social Image** = This is the social image for the page 38 | - **Is Top Level Path?** 39 | - If checked, your page lives at `/slug` 40 | - If not checked, your page lives at `/page/slug` 41 | - Use as 'Locked Screen' 42 | - This determines if the page will be used as a landing page for anonymous viewers (landing pages replace the traditional registration screen). This feature only works for private Forems. If your Forem is public, the landing page will not display. 43 | - Only one page can be used as a locked screen at a time. 44 | - Locked screens can be overwritten. To use another locked screen when there is already a locked screen in use, click the "Overwrite current locked screen" button in the modal that appears when "Use as 'Locked Screen'" is clicked. 45 | 46 | ## What can you do with pages? 47 | 48 | - [Here is an example of a simple Contained Markdown page](https://dev.to/about) 49 | - [Here is an example of a full_within_layout page that uses HTML](https://dev.to/downloads) 50 | - [Here is an example of a json page \(unprettified\)](https://dev.to/page/codeland_schedule) 51 | - You can create more sophisticated pages, such as: 52 | - [A blend of static content with custom CSS + dynamic posts](https://dev.to/shecoded) 53 | - [A full-on conference experience](https://dev.to/codeland) 54 | -------------------------------------------------------------------------------- /docs/forem-basics/posts.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Posts 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | **Posts** (commonly referred to as **Articles**) are the format of content that populate Forem feeds. They can contain text (formatted in markdown), images, videos, and other embedded content. Post authors and Forem Admins have the option to enable/disable discussions on their posts, and Forem Admins have the option to Pin community posts to the top of the main feed. 15 | 16 | Community members can create new posts in the editor by clicking `Create Post` from the top navigation or by navigating to `/new`. The post editor allows post authors to set various attributes like a cover image, tags (for discoverability), and a canonical_url (if the post was originally posted elsehwere first). Post authors can choose to publish their posts immediately or save a draft to work on the article later. Once posted, a community member's article will appear in the feed on the homepage. 17 | 18 | ## Overview 19 | 20 | Navigating to `/new` as a community member allows you to: 21 | 22 | - Draft a post 23 | - Publish a post 24 | 25 | Navigating to `/admin/content_manager/articles` as an admin allows you to: 26 | 27 | - See all recently submitted posts 28 | - Boost (or lower) a post's visibility 29 | 30 | ## Creating a Post as a Community Member 31 | 32 | Visiting `/new` navigates you to the Forem editor where you can create a new post. 33 | 34 | The Forem editor has 2 optional user interfaces that you can select from `/settings/customization`: 35 | 36 | 1. **Basic markdown** - barebones Markdown editor with no GUI attributes 37 | 2. **Rich + markdown** - Markdown editor with some graphical enhancements (e.g. click to add cover image) 38 | 39 | Once on `/new` you can follow the prompts on page to create your post. If using the Basic markdown editor, you'll need to change `published: false` to `published: true` and save in order to publish the post. If using the Rich + markdown editor, you'll need to click `Publish` at the bottom of the page in order to publish the article. 40 | 41 | After publishing the article, it should appear on your profile page, in your user dashboard (`/dashboard`), and in the main feed under `/latest`. 42 | 43 | ## Using `/admin/content_manager/articles` as an Admin to Manage Posts 44 | 45 | Visiting `/admin/content_manager/articles` allows you to easily view all recent submitted posts and provides you various abilities to manage a post: 46 | 47 | - **Featured Number** - a calculation that decides how likely a post is to be seen. The number is auto-calculated based on factors like newness, how many reactions it received, how many times it was clicked, etc. The higher the Featured Number is for a post, the more likely it is to show up in someone's feed, and the lower this number is the less visibility the post will get. Admin can manually adjust feature numbers to manipulate an article's visibility (click `submit` after adjusting the number). 48 | - **Author ID** - the identification number of the community member who authored the post. 49 | - **Co-Author IDs (comma separated)** - can be used to add co-authors to a article. 50 | - **Published at** - when an article was published. 51 | - **Featured** - this highlights the box around the article in admin so that it's green. This can be a helpful visual indicator internally, but it doesn't do anything externally. 52 | - **Approved** - if a post is using a tag that requires "approval", this box must be checked for the post to appear in the feed. 53 | - **Boosted** - this is a deprecated feature. 54 | - **Pinned** - this pins a post to the homepage 55 | 56 | ## Using `/moderate` as an Admin to Manage an Individual Post 57 | 58 | If you want to access the above options for an individual post, you can append `/moderate` to the URL of a post (e.g. dev.to/username/name_of_post/moderate) which acts as quick way to navigate to the corresponding `admin/content_manager/articles/###` page for the specific post. The `/moderate` shortcut is very helpful! 59 | -------------------------------------------------------------------------------- /docs/forem-basics/tags.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 1 4 | --- 5 | 6 | # Tags 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Tags are added to posts by authors and are used to categorize the post. Users can also follow tags which effect how often they are seen in the user's feed. Users can edit the follow weight of each tag from `/dashboard/following_tags` so that they see the tags more or less often. 15 | 16 | ## Editing a tag 17 | 18 | As an admin, you have the ability to manipulate a number of traits for an individual tag by searching and clicking into the tag from `/admin/content_manager/tags`. After clicking on a tag name, you will be dropped into the `/admin/content_manager/tags/{tag-id}/edit` page and see the following options: 19 | 20 | **Moderators**: add a user ID to add a tag moderator 21 | 22 | **Supported**: checking this box will make the tag searchable to authors who are writing posts or listings. Note: adding a tag mod to a tag will automatically make it supported. 23 | 24 | **Badge:** a square image that will appear at the top of the tag's landing page. 25 | 26 | **Category:** \(needs documentation\) 27 | 28 | **Alias for:** typing in a tag name here will make it so that any time a person uses this tag (the one you are editing) it will lead to the tag it is an alias for. (e.g. if "js" is an alias for "javascript" then anytime someone uses the tag "js" in their post, it will be replaced by "javascript" 29 | 30 | **Pretty Name:** Shown at the top of the tag page 31 | 32 | **Short Summary**: Displayed on tag page 33 | 34 | **Rules Markdown:** Displayed on tag page + in drop-down of rich editor. Filling out this field adds a "Create Post" button to the tag page, taking users straight to a new post in their Post Editor with this tag prefilled. 35 | 36 | **Submission Template**: This is where you create a post template! Place text here that will appear when you create any new posts under this tag. You can share these templates by directing people to `/new/{tag_name}`. This is especially useful when encouraging members to post about a topic in a structured format. This field takes markdown. 37 | 38 | Here's an example of the template used for [dev.to/new/shecoded](https://dev.to/new/shecoded): 39 | 40 | ```text 41 | --- 42 | title: Nevertheless, PARAM_0 Coded 43 | published: true 44 | tags: shecoded 45 | --- 46 | 47 | 48 | ## Equality in tech looks like… 49 | 50 | ## I’m an expert at… 51 | 52 | ## My advice for allies to support self-identifying women and non-binary folks who code is... 53 | 54 | 55 | ``` 56 | 57 | Note that the template will also be accessible from the tag landing page by clicking on "write post" in the submission guidelines. The submission guidelines must be set for this to appear. 58 | 59 | **Wiki Body Markdown**: Displayed on tag page 60 | 61 | **BG + Text color hex**: Used as tag colors, ensure contrast meets a11y requirements 62 | -------------------------------------------------------------------------------- /docs/forem-basics/user-roles.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 0 4 | --- 5 | 6 | # User Roles 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | A user's role indicates the level of permissions they have across the site. 15 | 16 | To update a user's role, you'll need to: 17 | 18 | - Find them via `/admin/users` 19 | - Click the `Manage User` button 20 | - Select their new role\(s) in the drop-down 21 | 22 | ![This is the page available at /admin/users](/img/userRolesManage.png) 23 | 24 | ![This is the page to manage users](/img/userRolesNewStatus.png) 25 | 26 | Admins have the ability to remove any role other than the **Super Admin** role from users. Admins do not, however, have the ability to remove roles from themselves. To remove a user's role, you'll need to: 27 | 28 | - Find them via `/admin/users` 29 | - Click the `Manage User` button 30 | - Click the `X` button next to the role\(s\) you wish to remove 31 | 32 | ![This is where admins can remove roles from users other than themselves](/img/userRolesCurrentRole.png) 33 | 34 | ## Base Roles 35 | 36 | ### Comment Suspend 37 | 38 | Users with the **Comment suspend** role are users that no longer have the privilege to comment on posts. This role is typically reserved for users who struggle to behave appropriately in the comments section. 39 | 40 | ### Suspend 41 | 42 | Users with the **Suspend** role no longer have the privilege to publish posts or comments across the site. Typically, a user is suspended when they have broken the Code of Conduct or Terms of Use multiple times. 43 | 44 | ### Regular Member 45 | 46 | A regular member is a user **in good standing**. They have access to all basic privileges \(publishing posts, writing comments, etc\) but they do not have higher access such as community moderation or site administration. 47 | 48 | ### Trusted 49 | 50 | Users with the **Trusted** role are community moderators. They have access to `/mod` and see a moderate icon on every post. 51 | 52 | ### Warn 53 | 54 | Users with the **Warn** role are users that admins flag to one another because of their previous behavior across the site. These are typically users that have broken the Code of Conduct previously but are currently not suspended. We want to make sure their previous actions are taken into consideration if they break the Code of Conduct again. 55 | 56 | Users with the **Warn** role have all the same privileges as **Members in good standing**. Setting a **Trusted** User’s role to **Warn** will remove their **Trusted** privileges and return them to the same privileges as **Members in good standing**. 57 | 58 | Changing a user's status to the **Warn** role does not automatically send an email to the user (we generally advise that users are notified when their roles change, including if they become **Warned**). 59 | 60 | ## Special Roles 61 | 62 | ### Admin 63 | 64 | **Admins** have access to all `/admin` pages on the site but do not have the ability to make site configuration changes (i.e. `admin/customization/config`). We recommend limiting the number of people who have **Admin** permissions for your Forem; consider granting single resource admin privileges first, where possible. 65 | 66 | **Admins** can unpublish articles by appending `/edit` to the end of an article URL and updating the article manually. 67 | 68 | ### Resource Admin 69 | 70 | **Single Resource Admins** have access to select `/admin` pages. For example, **Resource Admin: Articles** gives access to `/admin/content_manager/articles` only. You can give someone as many **Single Resource Admin** roles as necessary, and we would always recommend granting these before a full **Admin** role. 71 | 72 | ### Super Admin 73 | 74 | **Super Admins** have the highest level of permissions across the site, including making changes to `/admin/customization/config`. 75 | -------------------------------------------------------------------------------- /docs/forem-basics/user-settings/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "User Settings", 3 | "position": 0 4 | } 5 | -------------------------------------------------------------------------------- /docs/forem-basics/user-settings/account-settings.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A summary of User Account Settings fields 3 | sidebar_position: 3 4 | --- 5 | 6 | # Account Settings 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ## Set new password 15 | 16 | If your Forem is configured for OAuth and users created their accounts using social account authentication, they have the option to additionally enable email log in. 17 | 18 | Note: email log in is in addition to social log in rather than a replacement for it, so all user accounts created via social authorization will continue to require a social account to be connected to them. 19 | 20 | ## Account emails 21 | 22 | Users can have multiple email addresses, for instance, the email address(es) for any connected social log in(s). 23 | 24 | ## API Keys 25 | 26 | The API is still in its beta stage, and users can experiment with person API keys. The [API documentation](https://docs.forem.com/api) contains further information. 27 | 28 | ## Export content 29 | 30 | Currently we only support the export of posts and comments. Users can request them by email. 31 | 32 | ## Danger Zone 33 | 34 | Users can choose to delete their own accounts. Self-deletion will: 35 | 36 | - Delete their profile, along with any authentication associations. This does not include applications permissions, which need to be deleted from the apps themselves. 37 | - Delete any and all content saved to the account, such as articles, comments, reading lists, or chat messages. 38 | - Allow their username to become available to anyone. 39 | -------------------------------------------------------------------------------- /docs/forem-basics/user-settings/billing-settings.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A summary of User Billing Settings fields 3 | sidebar_position: 4 4 | --- 5 | 6 | # Billing Settings 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Users can add credit cards here, if they wish to use them for purchasing. 15 | -------------------------------------------------------------------------------- /docs/forem-basics/user-settings/customization-settings.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A summary of User Customization Settings fields 3 | sidebar_position: 1 4 | --- 5 | 6 | # Customization Settings 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | These are options for users to modify their experience on your Forem. These settings override any defaults that you may set. 15 | 16 | ## Appearance 17 | 18 | Users can choose a **Site Theme**, **Base Reading Font**, and decide for themselves if the **Site Nav Bar** remains at the top of their display when they scroll or scrolls up with the rest of the page layout. 19 | 20 | ## Writing 21 | 22 | ### Editor Version 23 | 24 | Select either Basic markdown editor or Rich + markdown editor. Any drafts started before switching editors will continue to use the version of the editor they were started with. E.g. if a user begins a draft in Basic before switching to Rich, they will still see the Basic editor when they reopen that draft for editing. All new drafts will use the new editor version, in this case, Rich + markdown. 25 | 26 | ## Content 27 | 28 | All articles on a Forem can be rated 1-5 for difficulty by the author or moderators. Selecting a difficulty level in the User Settings helps customize the user’s feed. 29 | 30 | ## Sponsors 31 | 32 | Forem sponsors can help sustain the platform, so this option is worded to discourage opt-out. Nonetheless, users have the choice of whether or not they want to view sponsor ads. 33 | 34 | ## Announcements 35 | 36 | Announcements allow you to share important information, like updates and events, in the form of banners that appear at the top of the page. These are enabled by default, so you can easily communicate with all users, but can be disabled for clutter-free browsing. 37 | -------------------------------------------------------------------------------- /docs/forem-basics/user-settings/extension-settings.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A summary of User Extension Settings fields 3 | sidebar_position: 6 4 | --- 5 | 6 | # Extension Settings 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ## Comment templates 15 | 16 | All users can create and save comment templates for reuse. Templates are composed in markdown, just like posts. They may be GIF-based greetings, or helpful hints and tips for other users, the possibilities are endless. Once a user has comment templates set up, they can manage them from here (delete or edit): 17 | 18 | ![Manage comment templates from User Extension Settings](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/commentTemplateDelete.png) 19 | 20 | # To use a comment template in a post discussion 21 | 22 | Users can activate the Comment textbox as if to comment, and they will see the option to use a Template: 23 | 24 | ![Select Template from the footer of the Comment text box](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/commentTemplateSelect.png) 25 | 26 | By clicking on Template, they will see their available templates appear in a list: 27 | 28 | ![Templates are listed below the Comment textbox](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/commentTemplateMenu.png) 29 | 30 | Moderators will be offered the choice of Personal or Moderator templates: 31 | 32 | ![Moderators get a choice of selecting from Personal templates](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/commentTemplatePersonal.png) 33 | 34 | ![Or Moderator templates](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/commentTemplateModerator.png) 35 | 36 | Clicking on **Insert** will insert the template markdown into the Comment textbox. Clicking on **Preview** will render the markdown, and if the user is happy with the comment they can submit it right away, or otherwise return to the markdown editor: 37 | 38 | ![Comment template rendered in Preview](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/commentTemplatePreview.png) 39 | 40 | ## Publishing to Forem from RSS 41 | 42 | Users can configure RSS feed settings to import content from another source every time they save these settings and periodically thereafter. Posts land in their `/dashboard` as drafts to allow them to make manual fixes to formatting before publishing. In the case of Medium, the full post is usually not imported by RSS and needs to be manually added to the stub post. Medium RSS feed URLs are https://medium.com/feed/@your_username 43 | Users have the option to automatically mark the feed source as the canonical URL automatically and change any URLs included in the post to refer to the version of that article on your Forem (if available). This is primarily meant for users migrating their entire blog onto your Forem. 44 | 45 | Your Forem installation includes an information page for RSS at `/p/publishing_from_rss_guide` 46 | 47 | ## Web monetization 48 | 49 | This is a beta feature that allows for micropayments on posts. The user settings page includes a [link to a DEV article on the subject](https://dev.to/hacksultan/web-monetization-like-i-m-5-1418) and further information is available at [the Web Monetization Community Forem](https://community.webmonetization.org/)! 50 | 51 | ## GitHub 52 | 53 | Users can pin their GitHub repositories to their profile homepage. Removing the OAuth association with GitHub also removes the repo links. 54 | -------------------------------------------------------------------------------- /docs/forem-basics/user-settings/notification-settings.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A summary of User Notification Settings fields 3 | sidebar_position: 2 4 | --- 5 | 6 | # Notification Settings 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ![Users can customize what they are notified about](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/userNotificationsFullpage.png) 15 | 16 | ## Email notifications 17 | 18 | The most common encounter most admins have with this page is to help direct users who wish to reduce their notification volume. Some users may opt into the [Newsletter](https://admin.forem.com/docs/advanced-customization/config/newsletter) or [Digest](https://admin.forem.com/docs/advanced-customization/config/emails#periodic-email-digest) during Onboarding, without realizing that these can be frequent emails, and later wish to opt out. 19 | 20 | Your Forem needs to have [Email Server Settings (SMTP) configured](http://admin.forem.com/docs/advanced-customization/config/email-server-settings) in order to send digests and other email notifications. 21 | 22 | - **Send me weekly newsletter emails**: This is where users opt in or out of your [Newsletters](https://admin.forem.com/docs/advanced-customization/config/newsletter). Although they're described as "weekly newsletters" your newsletters may be more or less frequent. You manage this frequency yourself via your newsletter provider. 23 | - **Send me a periodic digest of top posts from my tags**: Digests are sent at [the frequency you specify in your Admin Config](https://admin.forem.com/docs/advanced-customization/config/emails#periodic-email-digest). Users can customize the content of the digest much like they customize their feed content: by following other community members, and modifying their [tag weightings](https://admin.forem.com/docs/forem-basics/tags) (as mentioned in [this comment](https://dev.to/michaelcurrin/comment/1abef) on DEV) so they "anti-follow" any topics they don't want to read about. 24 | 25 | ## Mobile notifications 26 | 27 | Currently in beta, additional settings will be rolled out as new notification features are made available. 28 | 29 | ## General notifications 30 | 31 | These are notifications that only appear on the notifications page (accessible when a user is logged in by clicking the 🔔 icon in the top-right corner of the screen or appending `/notifications` to the Forem URL). 32 | 33 | ## Moderator notifications 34 | 35 | Only moderators will see this option. [For more information on **User Roles**, check out this guide](https://admin.forem.com/docs/forem-basics/user-roles). 36 | -------------------------------------------------------------------------------- /docs/forem-basics/user-settings/organization-settings.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A summary of User Organization Settings fields 3 | sidebar_position: 4 4 | --- 5 | 6 | # Organization Settings 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | This is a guide to the User Organization Settings, because organizations are created and managed under individual user account settings. The [Organization Pages documentation](https://admin.forem.com/docs/managing-your-community/organization-pages) covers additional settings and configuration for Forem Admins. 15 | 16 | If a user already has an organization configured, this page will display information about an existing organization by default. 17 | 18 | ## Organization members 19 | 20 | ### Grow the team 21 | 22 | Organization admins can find or refresh the invite token to invite new members here. The new member inputs the token on their own `/settings/organization` (if they are already a member of one or more organizations, they will need to select **New Organization** from the drop-down menu at the top of the page in order to input a token code). New members must be signed up to the Forem with an individual account in order to join an organization. 23 | 24 | ## Organization details 25 | 26 | Update all the organization information that was submitted at the creation of the organization, as well as additional information such as size, back story, and contact email. 27 | 28 | ### Call-to-action box 29 | 30 | As a bonus feature, organizations can enable CTA boxes that appear in the sidebar on posts published under their banner to drive readers towards products and services. 31 | 32 | ![Optional CTA](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/orgCTAtriplebyte.png) 33 | 34 | ## Danger Zone 35 | 36 | ### Delete Organization 37 | 38 | A user can delete their organization if they: 39 | 40 | - are the only member in the organization 41 | - are an admin of the organization 42 | - the organization has no posts 43 | - and the organization has no credits 44 | 45 | To delete an organization, ensure the organization they want to delete is selected in the drop down menu at the top of the page and all the criteria are met. Due to known caching issues organizations may occasionally take a while to delete. 46 | 47 | ## New Organization Settings 48 | 49 | In order to join an existing organization they are not a member of, or to create a new organization, users need to select **New Organization** from the drop down menu that appears in place of their username at the top of the page. 50 | 51 | ![If a user doesn't have any existing organizations, they don't see a menu at the top of their screen](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/userOrgNew.png) 52 | 53 | ![If a user has an organization already set up, they need to select New Organization from the menu at the top of their screen](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/userOrgAlt.png) 54 | 55 | ## Join An Organization 56 | 57 | In order to join an existing organization that they are not already a member or admin for, users can enter the [secret code provided to them by an org admin](https://admin.forem.com/docs/managing-your-community/organization-pages) 58 | 59 | ## Create An Organization 60 | 61 | Anyone (admin or user) can create an organization by navigating to `/settings/organization` and filling out the following required fields: 62 | 63 | - **Name**: The displayed name of the organization 64 | - **Username**: The organization URL will be the Forem URL `/username`. This is also referred to as the **slug** on other forms. 65 | - **Profile image**: Supports PNG, SVG, JPG 66 | - **Website url**: Include the https:// 67 | - **Summary**: Text that will be displayed below the organization name on its landing page 68 | - **Proof**: Asks the user to demonstrate their association with the organization to prevent unauthorized organizations being made in the name of companies or brands or individuals. 69 | 70 | After filling out these fields, you must click "Create Organization" at the bottom of the page. You can then return to `/settings/organization` to add other attributes to your org and invite org members. Note that you can create multiple orgs and switch between them by using the dropdown menu at the top of the page that says "Settings for..." 71 | 72 | **The person who creates the organization will be the main organization admin. Organizations can have as many admins as they have members. Forems don't currently have distinctions between organization founders or members, only between admins and members.**). 73 | -------------------------------------------------------------------------------- /docs/forem-basics/user-settings/profile-settings.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A summary of User Profile Settings fields 3 | sidebar_position: 0 4 | --- 5 | 6 | # Profile Settings 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | If a user is a member of multiple Forems, they can have entirely different settings for each one. As an Admin, you may experience users who are unaccustomed to this, so it's handy for you to know what falls under their Settings compared to your Forem Admin configuration. 15 | 16 | ## User 17 | 18 | Contains the required information for every user. 19 | All users must have a profile image. If a user doesn’t upload a profile image, they will be automatically assigned a Gravatar. 20 | 21 | ## Basic 22 | 23 | Optional user information. 24 | 25 | ## Branding 26 | 27 | Users can make changes to the appearance of their profile. 28 | 29 | ## Coding 30 | 31 | This is a DEV legacy section that may disappear from future versions of Forem. 32 | 33 | ## Work 34 | 35 | Another DEV legacy section that has broader application. 36 | -------------------------------------------------------------------------------- /docs/frequently-asked-questions.md: -------------------------------------------------------------------------------- 1 | --- 2 | sidebar_position: 12 3 | description: Answering some frequently asked questions. 4 | --- 5 | 6 | # Frequently Asked Questions 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | :::tip 15 | Still have a question? Head over to [forem.dev](https://forem.dev), our community of Forem Creators and Developers 16 | ::: 17 | 18 |
19 | 20 | 21 | Who are these docs for? 22 | 23 | 24 | This documentation is meant to guide folks who have launched and are managing a Forem community. 25 | 26 | :::important 27 | 28 | NOTE: this guide does not offer development guidance for setting up a Forem. For those who have yet to install the app that are hoping to self-host, please check out our [Forem Selfhost Installation Documentation](https://github.com/forem/selfhost-devel). If you would like to contribute to Forem as a developer, please read our [Forem Developer Documentation](https://docs.forem.com/). 29 | 30 | ::: 31 | 32 | Using these docs, you'll learn: 33 | 34 | - how to customize the appearance of your Forem 35 | - how to use moderation tools to keep your community healthy 36 | - how to wield a variety of other features to enhance the experience on your Forem 37 | 38 | If you are setting up your Forem for the first time, we recommend reading the Getting Started section first. 39 | 40 | If you have joined on with an established Forem as an admin, you may want to skip ahead to the Forem Basics section. 41 | 42 |
43 | 44 |
45 | 46 | 47 | How do I set the logo on my Forem? 48 | 49 | 50 | Be sure to fill out the "Favicon URL", "Logo PNG", and "Logo SVG" fields under "Images" available from the `admin/customization/config` page. Due to caching, it may take a few minutes for your changes to appear. 51 | 52 |
53 | 54 |
55 | 56 | 57 | How do I change the background image of the onboarding screens? 58 | 59 | 60 | Navigate to `/admin/customization/config` and select "Onboarding" to change out the background image. This will add a nice spruce of personality as new members join your forem. 61 | 62 |
63 | 64 |
65 | 66 | 67 | How do I upload an image to get its direct image URL? 68 | 69 | 70 | You can go to `/admin/advanced/tools` in your Forem Admin page to upload an image. 71 | 72 | ![](/img/screencapture-localhost-3000-admin-advanced-tools-2021-05-06-12_55_40.png) 73 | 74 | Your image URL will look something like this: `dev-to-uploads.s3.amazonaws.com/i/alk5808pwnt3j8sb8th3.png` 75 | 76 |
77 | 78 |
79 | 80 | 81 | What data does Forem collect? 82 | 83 | 84 | We collect and aggregate data about how Forem is being used so that we can focus product development efforts where creators and users are finding the most value, facilitate the delivery of the product, measure engagement and resource consumption, and assess the ongoing health of our infrastructure. The data is generally aggregated but may include identifiers such as Forem Cloud instances. 85 | 86 | Please find below a current exhaustive list of the endpoints that comprise our telemetry data sources. 87 | 88 | --- 89 | 90 | | **URL endpoint** | **Description** | **Metric** | 91 | | :------------------------------ | :--------------------------------- | :---------- | 92 | | **/admin/customization/config** | Admin panel configuration settings | Click count | 93 | | **/admin/invitations** | Admin panel user invitations | Click count | 94 | | **/admin/content_manager/tags** | Admin panel tag management | Click count | 95 | | **/admin/apps/welcome** | Admin panel onboarding | Click count | 96 | 97 | _Last update: 6/17/21_ 98 | 99 |
100 | -------------------------------------------------------------------------------- /docs/getting-started/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "Getting Started", 3 | "position": 9 4 | } 5 | -------------------------------------------------------------------------------- /docs/getting-started/implementation-guide.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A strategy guide and timeline for launching your Forem, learning the platform, and growing your community. 3 | sidebar_position: 2 4 | --- 5 | 6 | # Forem Implementation Guide 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | This implementation guide is meant to outline a clear path to success for Forem Creators. 15 | 16 | We've broken this guide down into 3 stages — **Ready**, **Set**, & **Grow**. As you progress through the checklist for each stage, you'll complete the set up process for your Forem, learn the various features available to you and your community, and eventually begin growing your Forem community. 17 | 18 | ## Ready (Stage 1) 19 | 20 | 1. Register First User 21 | 2. Follow Forem Setup Checklist 22 | - [Get Started Checklist](https://admin.forem.com/docs/getting-started/forem-setup-checklist#1-set-up-and-configure-your-forem) (Set community name, description, suggested tags, suggested users) 23 | - [Create a Welcome Thread](https://admin.forem.com/docs/getting-started/forem-setup-checklist#2-create-a-welcome-thread) 24 | - [Update and customize your Forem tags](https://admin.forem.com/docs/getting-started/forem-setup-checklist#1-set-up-and-configure-your-forem) 25 | - [Create Pages and Sort Them in the Nav Sidebar](https://admin.forem.com/docs/getting-started/forem-setup-checklist#4-create-pages-and-sort-them-in-the-navigation-sidebar) 26 | - [Set your Forem's access level and invite people to join your community](https://admin.forem.com/docs/getting-started/forem-setup-checklist#5-set-your-forems-access-level-and-invite-people-to-join-your-community) 27 | 28 | :::important 29 | 30 | **Need help provisioning your Forem? Schedule a 1:1 call with the Community Success Team.** 31 | 32 | - For Cloud Partners, we have most likely already registered the first user and completed the Forem Setup Checklist on your behalf. Still, feel free to schedule a call with us using Calendly [here](https://calendly.com/d/cfs-bkt-kvj/forem-community-success-1-1-meetings-with-partners) if you'd like us to walk you through any of these details. 33 | - Self-hosted creators may schedule a call with us using Calendly [here](https://calendly.com/d/cdz-xw3-tc5/forem-community-success-1-1-meetings-with-creators) 34 | 35 | ::: 36 | 37 | ## Set (Stage 2) 38 | 39 | 1. Learn the platform basics 40 | - [Create posts](https://admin.forem.com/docs/forem-basics/posts) 41 | - [Create more tags and see the options available for managing them](https://admin.forem.com/docs/forem-basics/tags) 42 | - [See available user roles](https://admin.forem.com/docs/forem-basics/user-roles) 43 | - [See generated pages that ship with a Forem and learn how to edit them](https://admin.forem.com/docs/forem-basics/generated-pages) 44 | - [Consider adding badges](https://admin.forem.com/docs/forem-basics/badges) 45 | 2. Explore advanced features 46 | - [Create a banner with HTML Variants](https://admin.forem.com/docs/advanced-customization/html-variants) 47 | - [Create billboards for the homepage](https://admin.forem.com/docs/advanced-customization/billboards) 48 | - [Set sidebar tags](https://admin.forem.com/docs/advanced-customization/tag-display-order) 49 | - [Add and confirm podcasts](https://admin.forem.com/docs/advanced-customization/content-manager/podcasts) 50 | 51 | ## Grow (Stage 3) 52 | 53 | 1. Add your Forem to [Forem Discover](https://discover.forem.com/) 54 | - View other Forems to get a sense of what the successful communities are doing 55 | 2. Learn about moderation tooling: 56 | - [See available admin moderation features](https://admin.forem.com/docs/managing-your-community/admin-moderation-features) 57 | - [Learn how to remove spam](https://admin.forem.com/docs/managing-your-community/removing-spam) 58 | - [Handle Reports](https://admin.forem.com/docs/advanced-customization/reports) 59 | - [Adjust Rate Limits & Anti-spam](https://admin.forem.com/docs/advanced-customization/rate-limits-and-anti-spam) 60 | - [Recruit Trusted Users](https://admin.forem.com/docs/managing-your-community/trusted-user-features) 61 | - [Recruit Tag Moderators](https://admin.forem.com/docs/managing-your-community/tag-moderator-features) 62 | - Watch Forem's Community Success Team [discuss moderation here](https://youtu.be/uMp1ULIvEso) 63 | 3. Participate in the community on forem.dev 64 | - Stay up to date on the latest changes by following [#changelog](https://forem.dev/t/changelog) 65 | - Make feature requests using [this template](https://forem.dev/new/features) in [#features](https://forem.dev/t/features) 66 | - Make connections and lean on other community members for help 67 | -------------------------------------------------------------------------------- /docs/managing-your-community/_category_.json: -------------------------------------------------------------------------------- 1 | { 2 | "label": "Managing Your Community", 3 | "position": 10 4 | } 5 | -------------------------------------------------------------------------------- /docs/managing-your-community/admin-moderation-features.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of Admin's moderation features. 3 | sidebar_position: 3 4 | --- 5 | 6 | # Admin Moderation Features 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Overviews 15 | 16 | Admins have heightened access across the platform, such as access to backend /admin pages. In addition to these pages, admins also have special moderations features across the Forem that they can access while they interact with the community. Admins have all the features that Tag Moderators have, and more. Before diving into admin moderation features, familiarize yourself with the [tag moderator features](tag-moderator-features.md). 17 | 18 | ### Tag Moderation 19 | 20 | Instead of being assigned a tag to moderate, admins have access to moderate _all_ tags on site. They would moderate from the same mod panel that tag moderators take action from. 21 | 22 | ### Unpublish Articles 23 | 24 | Admins have an additional feature on their mod panel - the ability to unpublish an article. This should be used only on an as-needed basis. 25 | 26 | ![Mod panel with unpublish article button](/img/image-2020-10-22-at-4.21.10-pm.png) 27 | 28 | ### Delete Comments 29 | 30 | When moderating a comment, admins have the option to delete the comment entirely. 31 | 32 | ![Comment mod page with delete comment functionality.](/img/image-2020-10-22-at-4.43.28-pm.png) 33 | -------------------------------------------------------------------------------- /docs/managing-your-community/managing-posts-and-comments.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A breakdown of managing user content on the admin pages. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Managing Posts and Comments 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Below we'll go over how to delete posts and comments in detail. 15 | 16 | ## Deleting Posts 17 | 18 | Generally speaking, we advise you against deleting users' posts, but instead would guide you to unpublish a user's post. This way, the can still recover their content and take it elsewhere. That said, there are definitely times when deletion is warranted. We'll provide guidance on both how to unpublish and how to fully delete a post below. 19 | 20 | ### Steps to Unpublish and/or Delete a Post 21 | 22 | To unpublish a post, you'll need to: 23 | 24 | 1. Ensure that whatever account you're logged into has "trusted user" abilities (i.e. not just "super admin" or "admin" abilities). 25 | 2. Navigate to the article you'd like to delete. To be clear you should be looking at the public-facing article page (i.e. not in admin) 26 | 3. Click on the moderator shield icon in the bottom righthand corner of the screen 27 | 4. Cick the button that says "unpublish article" in red 28 | 29 | If you want to fully delete the user's article, follow the steps above and then: 30 | 31 | 1. Navigate to the user's dahboard (e.g. jess.forem.lol/dashboard/username) 32 | 2. Click the red "delete" button beside the unpublished post's title 33 | 34 | There is no easy way to undelete a post, so please be careful when doing this. 35 | 36 | ### Unpublish all of a User's Posts 37 | 38 | To unpublish all of a user's posts, you'll want to navigate to their admin profile, `/admin/users/{id}/edit`, and you'll want to scroll down to "Semi-Destructive Actions" and click the button "Unpublish all posts" - this will unpublish all of the user's posts. 39 | 40 | ### Banish a User to Delete All of Their Posts 41 | 42 | Banishing a user will delete all of a user's posts and their account too. This is particularly helpful for getting rid of any spammers that you my come across. 43 | 44 | You can learn more about banishing users here (link coming soon). 45 | 46 | ## Deleting Comments 47 | 48 | As a super admin that also has trusted permissions, deleting a comment is quite easy. 49 | 50 | ### Steps to Delete a Comment 51 | 52 | To delete a comment: 53 | 54 | 1. Navigate to the comment you'd like to delete. You can either find the comment in the discussion beneath an article or go directly to the comment's unique URL. 55 | 2. Click on the three dots `...` menu to the top right of the comment's window. 56 | 3. Click on "Moderate" 57 | 4. Look to the bottom of the page and click "Delete Comment" 58 | 59 | There is no easy way to undelete a comment, so please be careful when doing this. 60 | -------------------------------------------------------------------------------- /docs/managing-your-community/organization-pages.md: -------------------------------------------------------------------------------- 1 | # Organization Pages 2 | 3 | ## Overview 4 | 5 | :::important 6 | 7 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 8 | 9 | ::: 10 | 11 | Organization accounts are a free option for teams, companies, clubs, or anyone else that wants to participate on a Forem as part of an identifiable group. 12 | 13 | ### Features 14 | 15 | - Dedicated Landing Page: organizations have a page to display key information, a list of organization members, and more. Here are a few examples from DEV: 16 | 17 | - [https://dev.to/twilio](https://dev.to/twilio) 18 | - [https//dev.to/heroku](https://dev.to/heroku) 19 | 20 | ![Org Page](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/orgDemoHeroku.png) 21 | 22 | - Organization Branding on Posts: new posts published under the organization display additional branding in the header and sidebar. 23 | 24 | ![Org Branding](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/orgBrandingTwilio.png) 25 | 26 | - Call-to-Action on Posts: drive readers towards products and services with a call-to-action unit alongside branded posts. 27 | 28 | ![Optional CTA](https://raw.githubusercontent.com/forem/admin-docs/main/static/img/orgCTAtriplebyte.png) 29 | 30 | - Content management: Organization Admins are able to change the author account and publish posts "under the organization" 31 | - Enhanced Analytics: Measure performance by keeping track of view counts, reactions, and CTA clicks on each post. 32 | - Build a Following: As community members follow an organization, they’ll receive notifications of new posts, and organization content will show up more prominently in their feed. 33 | 34 | ## Creating an organization page 35 | 36 | Any user can create a new organization from their [User Organization Settings page](https://admin.forem.com/docs/forem-basics/user-settings/organization-settings). The person who creates the organization will be the main organization admin. 37 | 38 | ## Invite new members 39 | 40 | Organization admins can find the invite token in their [User Organization Settings page](https://admin.forem.com/docs/forem-basics/user-settings/organization-settings) under **Grow the team**. 41 | 42 | ## Organization roles 43 | 44 | There are only two types of roles in an organization: admin & member. Members can join multiple organizations; admins can admin multiple organizations; users can be a combination of members and admins of different organizations. 45 | 46 | Organization admins and members can set the canonical_url in the Front Matter of each post. Both admins and members will see an option to enable organization branding at the top of every new post. 47 | 48 | If you are the creator of an organization you'll automatically be made an admin. All admins of an organization are able to promote other members of their organization into admin roles. There can be any number of admins per organization. Note that all organization admins have the same abilities. There is no separate organization creator role at the moment. 49 | 50 | Organization Admins are able to view analytics for all posts published under the organization on the organization dashboard. 51 | 52 | ## Changing post author 53 | 54 | Organization admins can reattribute an organization post by visiting `/dashboard` and then clicking on the tab for the organization account (located just below **Posts**). Whereas their dashboard previously listed all their individual posts, the organization dashboard will list of all organization posts. Clicking on the `...` will offer additional options, including reattributing posts. 55 | 56 | ## Deleting an organization 57 | 58 | To delete an organization, first make ensure the user is logged in as the admin of the organization they wish to delete. Navigate to their [User Organization Settings page](https://admin.forem.com/docs/forem-basics/user-settings/organization-settings) and scroll down to the bottom of the page where it says **Danger Zone** to delete the organization. 59 | -------------------------------------------------------------------------------- /docs/managing-your-community/removing-spam.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Removing Spam 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | The best way to remove spam is to banish the user creating it. 15 | 16 | Note: after banishing a user, you cannot recover their account, so be extremely careful when doing this. 17 | 18 | ## Steps to Banish a User 19 | 20 | To banish a user, you must be logged into a super-admin account and: 21 | 22 | 1. Navigate to the user's corresponding admin page (`/admin/users/###`). Note: you can appended `/moderate` to the URL of a community member's profile page (e.g. dev.to/username/moderate) to quickly jump to their corresponding admin page. 23 | 2. Click the "manage user" button in the top right corner of the page. 24 | 3. Scroll down to "Destructive Actions" and click "Toggle". 25 | 4. Click "Banish User for Spam!" 26 | 27 | ## What if the individual post a spammy post, but I'm not entirely sure that they are spammer and so don't want to banish them? 28 | 29 | You can always [unpublish a user's article](/docs/managing-your-community/managing-posts-and-comments) and then suspend them instead of banishing them. 30 | 31 | ## Steps to Suspend a User 32 | 33 | To suspend a user, you must be logged into a super-admin account and: 34 | 35 | 1. Navigate to the user's corresponding admin page (`/admin/users/###`). Note: you can appended `/moderate` to the URL of a community member's profile page (e.g. dev.to/username/moderate) to quickly jump to their corresponding admin page. 36 | 2. Click the "manage user" button in the top right corner of the page. 37 | 3. Scroll down to "User Status" and click the drop-down menu beside "Select new user status". 38 | 4. Select "Suspend" 39 | 40 | Note: Suspending a user will stop the user from posting new posts and comments. It doesn't delete any of the user's content, just prevents them from creating new content while suspended. 41 | -------------------------------------------------------------------------------- /docs/managing-your-community/suspending-users.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of the most important Forem features. 3 | sidebar_position: 0 4 | --- 5 | 6 | # Suspending Users 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | Suspending a user will stop the user from posting new posts and comments. It doesn't delete any of the user's content, just prevents them from creating new content while suspended. 15 | 16 | Users are not notified of their suspension in the UI, so if you want them to know about this, you must email them. 17 | 18 | ## Steps to Suspend a User 19 | 20 | To suspend a user, you must be logged into a super-admin account and: 21 | 22 | 1. Navigate to the user's corresponding admin page (`/admin/users/###`). Note: you can appended `/moderate` to the URL of a community member's profile page (e.g. dev.to/username/moderate) to quickly jump to their corresponding admin page. 23 | 2. Click the "manage user" button in the top right corner of the page. 24 | 3. Scroll down to "User Status" and click the drop-down menu beside "Select new user status". 25 | 4. Select "Suspend" 26 | 27 | Note: You can also select "Comment Suspend" if you just want to stop the user from leaving comments but would like to allow them to continue to post articles. 28 | -------------------------------------------------------------------------------- /docs/managing-your-community/tag-moderator-features.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of Tag Moderator's moderation features. 3 | sidebar_position: 4 4 | --- 5 | 6 | # Tag Moderator Features 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Overview 15 | 16 | Tag moderators are trusted users with an additional set of privileges related to the tags across your Forem. Familiarize yourself with the [trusted user features ](trusted-user-features.md)before diving into the additional features listed below. 17 | 18 | ### Add or remove a tag 19 | 20 | In addition to trusted user features, Tag moderators have the ability to add or remove their assigned tags from published posts. In order to take this action, the tag mod must leave a note explaining why they added or removed a tag. Their note will be sent to the user that authored the article via an on-site notification. 21 | 22 | The mod center allows tag moderators to quickly filter by their assigned tags in their inbox. 23 | 24 | Note: Tag moderators can only remove or add the tags they are assigned to, but admins can remove or add all tags. 25 | 26 | ![](/img/image-2020-10-22-at-3.54.34-pm.png) 27 | 28 | ![The recipient will receive a message like this](/img/image-2020-10-22-at-9.34.32-am.png) 29 | 30 | ### Edit Tag Pages 31 | 32 | Tag Moderators can edit the tag page of the tag they are assigned to. They can do so by navigating to `/t/{tagname}/edit` . They will be presented with the following fields: 33 | 34 | - Pretty name: name displayed on tag page 35 | - Bg color hex: background color of the tag when it appears on posts 36 | - Text color hex: font color of the tag when it appears on posts 37 | - Short summary: a short description of the meaning of the tag 38 | - Wiki Body Markdown: the 'about' section of the tag, accepts markdown 39 | - Rules Markdown: the submission guidelines for posting under the tag, accepts markdown. 40 | 41 | Here is a quick example of how these fields surface on the tag page: 42 | 43 | ![Example tag page with fields labeled.](/img/tagattributes.png) 44 | 45 | #### Featured on tag page 46 | 47 | Tag moderators get to have their profiles featured on the tag page! 48 | 49 | ![Tag page with tag moderators](/img/image-2020-10-22-at-4.11.41-pm.png) 50 | -------------------------------------------------------------------------------- /docs/managing-your-community/trusted-user-features.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: A high-level overview of Trusted Member's moderation features. 3 | sidebar_position: 5 4 | --- 5 | 6 | # Trusted User Features 7 | 8 | :::important 9 | 10 | We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit [forem.dev](https://forem.dev) to request additional support. We thank you for your patience and hope you're liking the changes! 11 | 12 | ::: 13 | 14 | ### Overview 15 | 16 | Trusted users are users with additional privileges across the platform. They have the ability to: 17 | 18 | - Mark a post as high quality 19 | - Mark a post as low quality 20 | - Flag a post to admins 21 | - Set the experience level of a post 22 | 23 | ### Mod Center 24 | 25 | Once a user has the trusted status, they'll have access to the mod center by clicking the shield button on their nav bar. 26 | 27 | ![Mod center](/img/image-2020-10-22-at-1.48.13-pm.png) 28 | 29 | From the mod center, they can quickly view recently published articles and take the trusted actions highlighted below. Features not highlighted are available to users with higher privileges. 30 | 31 | ![Trusted user priviledges](/img/image-2020-10-22-at-1.54.00-pm.png) 32 | 33 | In addition to moderating posts from the mod center, trusted users have access to a quick mod panel on each post by clicking on the badge icon in the lower right. 34 | 35 | ![Lower right badge icon for specific post.](/img/image-2020-10-22-at-1.59.00-pm.png) 36 | 37 | ![Quick mod panel](/img/image-2020-10-22-at-2.01.45-pm.png) 38 | 39 | Trusted users can also moderate specific comments by using the comment dropdown and clicking "moderate". 40 | 41 | ![Comment moderation](/img/image-2020-10-22-at-2.02.48-pm.png) 42 | -------------------------------------------------------------------------------- /docusaurus.config.js: -------------------------------------------------------------------------------- 1 | /** @type {import('@docusaurus/types').DocusaurusConfig} */ 2 | module.exports = { 3 | title: "Forem Admin Docs", 4 | tagline: "Forem is cool", 5 | url: "https://forem-admin.netlify.app", 6 | baseUrl: "/", 7 | onBrokenLinks: "throw", 8 | onBrokenMarkdownLinks: "warn", 9 | favicon: "img/favicon.ico", 10 | organizationName: "Forem", // Usually your GitHub org/user name. 11 | projectName: "admin-docs", // Usually your repo name. 12 | themeConfig: { 13 | algolia: { 14 | apiKey: process.env.ALGOLIA_SEARCH_KEY, 15 | appId: process.env.ALGOLIA_APP_ID, 16 | indexName: process.env.ALGOLIA_INDEX_NAME, 17 | }, 18 | navbar: { 19 | // title: 'Forem Admin Docs', 20 | logo: { 21 | alt: "Forem Admin Docs Logo", 22 | src: "img/forem.svg", 23 | srcDark: "img/foremDark.svg", 24 | }, 25 | items: [ 26 | { 27 | type: "doc", 28 | docId: "getting-started/creator-signup-and-onboarding", 29 | position: "left", 30 | label: "Getting Started", 31 | }, 32 | { 33 | href: "https://forem.dev", 34 | label: "Explore Forem.dev", 35 | position: "right", 36 | }, 37 | // { 38 | // href: 'https://github.com/facebook/docusaurus', 39 | // label: 'GitHub', 40 | // position: 'right', 41 | // }, 42 | ], 43 | }, 44 | footer: { 45 | style: "dark", 46 | links: [ 47 | { 48 | title: "Forem Docs", 49 | items: [ 50 | { 51 | label: "Admin Docs", 52 | to: "/", 53 | }, 54 | { 55 | label: "Selfhost Installation", 56 | to: "https://github.com/forem/selfhost", 57 | }, 58 | { 59 | label: "Developer Docs", 60 | to: "https://docs.forem.com/", 61 | }, 62 | ], 63 | }, 64 | { 65 | title: "Community", 66 | items: [ 67 | { 68 | label: "DEV", 69 | href: "https://dev.to", 70 | }, 71 | { 72 | label: "forem.dev", 73 | href: "https://forem.dev", 74 | }, 75 | { 76 | label: "Twitter", 77 | href: "https://twitter.com/forem", 78 | }, 79 | ], 80 | }, 81 | { 82 | title: "More", 83 | items: [ 84 | { 85 | label: "GitHub", 86 | href: "https://github.com/forem/admin-docs", 87 | }, 88 | { 89 | label: "Email Us", 90 | href: "mailto:hello@forem.com", 91 | }, 92 | ], 93 | }, 94 | ], 95 | copyright: `Copyright © ${new Date().getFullYear()} Forem`, 96 | }, 97 | }, 98 | presets: [ 99 | [ 100 | "@docusaurus/preset-classic", 101 | { 102 | docs: { 103 | sidebarPath: require.resolve("./sidebars.js"), 104 | editUrl: "https://github.com/forem/admin-docs/edit/main/", 105 | }, 106 | // blog: { 107 | // showReadingTime: true, 108 | // editUrl: "https://github.com/forem/admin-docs/edit/main/", 109 | // }, 110 | theme: { 111 | customCss: require.resolve("./src/css/custom.css"), 112 | }, 113 | }, 114 | ], 115 | ], 116 | }; 117 | -------------------------------------------------------------------------------- /netlify.toml: -------------------------------------------------------------------------------- 1 | # A basic redirect rule 2 | [[redirects]] 3 | from = "/docs/advanced-customization/config/" 4 | to = "/docs/advanced-customization/config/api-tokens" 5 | 6 | -------------------------------------------------------------------------------- /open-resources/README.md: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /open-resources/about-page.md: -------------------------------------------------------------------------------- 1 | > *What this community is here for, and who it is for. Why we are making a contribution to the community we serve/what needs we meet or pain points we soothe are.* 2 | 3 | We are powered by Forem, an [open source](https://github.com/forem/forem) application, meaning you can inspect every little detail of the code, or chip in yourself! Forem empowers community by fostering thoughtful connection, [learn more here](https://www.forem.com/). 4 | 5 | ## Leadership 6 | 7 | > *Forem loves transparency, so we encourage you to consider adding a photo of each of your leadership.* 8 | 9 | *Who runs your company, and what drives them?* 10 | 11 | ## Team 12 | 13 | > *Consider adding a photo of your team.* 14 | 15 | Our team is located here/there/all over the world. *What is your team's mission or a unifying goal?* 16 | 17 | If you'd like to join us, we invite you to review our [current openings](https://jobs.forem.com/) *of course, replace with your company hiring page, otherwise you'll be recruiting for Forem* 😉. 18 | -------------------------------------------------------------------------------- /open-resources/community-guidelines.md: -------------------------------------------------------------------------------- 1 | # Community Guidelines 2 | 3 | You made it! We are delighted to welcome you to the forem.dev community, where you will be able to connect with other Forem Creators to discuss all things related to using Forem and building your community. 4 | 5 | We've been working hard to make this a space where you can be curious, humble, and wise. Community builders are *our* people, and we want to help you succeed in growing healthy, sustainable communities. 🙌 6 | 7 | We encourage you to share information by both asking **and** answering questions whenever you can! Here are some of our favorite suggestions for how to do this effectively: 8 | 9 | ## Ask questions 10 | Asking questions is a really effective way to learn - especially if you can get (or figure out) the answers! 11 | 12 | - Before you ask your question, try dropping some keywords into the search bar to see if anyone has asked it before. _You'll get an answer quicker if it already exists than if you have to wait for someone to see your new question!_ 13 | - Make your question the title of your post. If you are having trouble removing a spammy user, then a good title for your post is "How can I remove a spammy user?". Simple is better! 14 | - Share context in the post, such as what the situation is, what you've tried, what has worked/not worked, what error messages you're seeing. 15 | 16 | ``` 17 | If you have logs, please share them in a code block so they're easier to parse. 18 | ``` 19 | 20 | - Tag your post with `#help` (in the example above, `#moderation` or `#spam` are also appropriate tags). 21 | - Try to be as responsive as possible to people who are replying to your question. They may request additional information to help answer you, so please be patient if they do. 22 | - Please confirm in the discussion below your post if your question has been answered. _For bonus points, reply to the most helpful answer you received to help out people looking for it in the future._ 23 | 24 | ## Answer questions 25 | If you've successfully set up and started growing your Forem community: congrats! We would love to see you supporting and helping others in this community. 26 | 27 | - Believe in your own knowledge! If you have run into the same issue and figured out how to resolve it, please feel empowered to share what you did _and how you figured it out!_ 28 | - Try to empathize with the person asking the question. We all benefit from kind, thoughtful communication, _often most of all when we're being vulnerable by asking for help._ 29 | - If your answer to the question is longer than 3-4 paragraphs, consider writing a post with your answer and sharing a link to it in the comments below the question. _This will help people looking for it in future._ 30 | - If you think the question has been answered before, please share a link to the relevant post _and the answer in the comments, if appropriate._ 31 | - If you got stuck trying to figure something out and learned from the experience, please consider writing a post about it to proactively share the knowledge with others who might find it helpful. 32 | 33 | And finally... 34 | 35 | ## Assume the best of each other 36 | Community builders are coming here to ask questions when they're frustrated, tired, or even scared. Communities are wonderful, even magical places, but they can also be full of people's emotions and opinions. 37 | 38 | **Sometimes being helpful is as simple as being kind.** Try not to take it personally if you get an unexpected response from another member, although we encourage you to [report **anything** that makes you feel uncomfortable](https://forem.dev/report-abuse). 39 | 40 | ### Thanks for reading! 41 | -------------------------------------------------------------------------------- /open-resources/community-moderation-page.md: -------------------------------------------------------------------------------- 1 | *This Forem name* gives trusted users the ability to take certain privileged actions on the platform. For instance, they can help promote valuable posts, gently reduce the visibility of low-quality posts (spammy, overly promotional, or unhelpful), and quickly flag rule-breaking content to our admin team. 2 | 3 | To sum up a few trusted user abilities, they can: 4 | * Use quick reactions to help moderate content 5 | * Seamlessly flag rule-breaking behavior to admins 6 | * Rate the experience level of an article 7 | * Access the Mod Center 8 | 9 | ***To become a trusted user or [tag moderator](/tag-moderation), please email support@forem.com*** 10 | 11 | --- 12 | 13 | ## How to Moderate Articles 14 | 15 | We have two ways to moderate **articles**: the Mod Panel and the Mod Center. Please note: you will need to be assigned Trusted User or Tag Moderator status **and** signed in to carry out all the following actions. 16 | 17 | To access the Mod Panel, click the Mod Panel button in the bottom-right corner of any article page; to access the Mod Center, go to [forem.dev/mod](/mod). 18 | 19 | ### Using the quick reactions to moderate content 20 | 21 | Trusted users are able to make use of the thumbsup, thumbsdown, and “Flag to Admins” buttons. Here's how each reaction works: 22 | 23 | 1. **Thumbsup (👍)**: a quick way to "push content up" so that it's more likely to be seen on the site (i.e. articles with high-quality content that embody the values and spirit of the community). 24 | 2. **Thumbsdown (👎)**: a quick way to "push content down" so that it's less likely to be seen on the site (e.g. articles that only have a teaser paragraph and send the reader to an external link for the rest). 25 | 3. **Flag to Admins (🧐)**: a quick way to flag content that violates the [Code of Conduct](https://forem.dev/code-of-conduct) or [Terms](https://forem.dev/terms) so the admin team is notified and can take action. 26 | 27 | ![mod-button-on-articles](https://forem.dev/remoteimages/uploads/articles/k97634cri0tcjrut7f6d.png) 28 | 29 | _Note: It is not possible to choose the "thumbsup" reaction together with either the "thumbsdown" or "Flag to Admins" reaction._ 30 | 31 | ### Examples of when to use 👎 vs. 🧐 32 | 33 | Knowing when to use a “thumbsdown” vs. a “Flag to Admins” reaction can be confusing. The following guidelines should help. 34 | 35 | #### Use 👎 for articles... 36 | * that are purely linking to external content (e.g. "read more here") 37 | * that are advertising a product or service in a distasteful way (e.g. stealthy or dishonest marketing tactics) 38 | * that are factually incorrect 39 | 40 | #### Use 🧐 for articles… 41 | * that are clearly spam (completely off-topic, etc.) 42 | * that do not abide by our [Code of Conduct](https://forem.dev/code-of-conduct) (i.e. posts that are negative and exclusive) 43 | 44 | _Note: “Thumbsdown” and “Flag to Admins” reactions are distinct from one another, but using the “Flag to Admins” reaction on an article will essentially thumbsdown the post too, so there is no need to combine them._ 45 | 46 | ### Flagging a problematic account / person 47 | 48 | If you notice a particularly harmful account and want to quickly flag all of this account’s content, then you can use the following methods. 49 | 50 | From the ModPanel, click “Flag user”: 51 | 52 | ![Flagging an account as abusive from mod panel example](https://forem.dev/remoteimages/uploads/articles/nt1fuqmjbva8a45lsmzj.png) 53 | 54 | You may also view the “Flag user” option by appending `/mod` to any of the account’s articles. 55 | 56 | ![Flagging an account as abusive from mod example](https://forem.dev/remoteimages/uploads/articles/h2osj7xgbm4o7df3qcmz.png) 57 | 58 | _Note: By clicking “Flag user”, you are bulk reacting with the 🧐 on all of this user's posts. There's no need to flag each individual post by the user once you've flagged the user._ 59 | 60 | --- 61 | 62 | ## How to Moderate Comments 63 | 64 | To moderate comments, click 'moderate' from the ellipses on the comment, or append `/mod` to the comment permalink. 65 | 66 | ![comment-dropdown](https://forem.dev/remoteimages/uploads/articles/fbl7t70dfuffzbhcn2l6.png) 67 | 68 | --- 69 | 70 | ## How to Rate the Experience Level of a Post 71 | 72 | Using the 1-5 scale (1: novice; 5: expert), rate what you believe a post's experience level to be. While this is somewhat subjective, just use your best judgment taking into account any bias you may have based on your own knowledge of the topic. This will help us bring more relevant posts to each individual's feed depending on their [chosen experience level](https://forem.dev/settings/customization). 73 | 74 | ![experience-level-buttons](https://dev-to-uploads.s3.amazonaws.com/i/19i3pvvong5l1xuwnm6y.gif) 75 | 76 | --- 77 | 78 | ## Mod Center 79 | 80 | To use all of the features described above in bulk, visit: [forem.dev/mod](/mod)! 81 | -------------------------------------------------------------------------------- /open-resources/contact.md: -------------------------------------------------------------------------------- 1 | The XYZ team would love to hear from you! 2 | 3 | 4 | 5 | Email: XYZ ✉️ 6 | 7 | Twitter: @XYZ 🐦 8 | 9 | Report a vulnerability: [dev.to/security](https://dev.to/security) 🕶 10 | 11 | To report a bug, please create [a bug report](https://github.com/forem/forem/issues/new/choose) in the open source repository for Forem. 🐛 12 | -------------------------------------------------------------------------------- /open-resources/how-to-ask-for-help.md: -------------------------------------------------------------------------------- 1 | ## How to ask for help in *Your Forem Name* community 2 | 3 | It's our fullest intention that this online community space is safe and welcoming for all. If you have any questions about how to use it, or want to report behaviour that is causing you concern or distress, please email us at *help@yourforem.name* 4 | -------------------------------------------------------------------------------- /open-resources/how-to-report-abuse.md: -------------------------------------------------------------------------------- 1 | ## How to report inappropriate content in *Your Forem Name* community 2 | 3 | If you have any reason to believe that a user is abusing their posting or commenting privileges to share inappropriate content, whether that is content that violates the community [Code of Conduct](https://forem.dev/code-of-conduct) or [Terms of Use](https://forem.dev/terms), we encourage you to report this for consideration by our Admin team. 4 | 5 | Whilst you can use the universal [Reporting Form](https://forem.dev/report-abuse) to report any URL, we also have some shortcuts to make it easier for you to report content on the fly: 6 | 7 | - From the Reactions Sidebar on any post, you'll see a More button `...` below the Heart 💜, Unicorn 🦄, and Save to Reading List 🔖 buttons. Inside this menu, you'll find the Report Abuse button that will take you straight to the [Reporting Form](https://forem.dev/report-abuse) with the Post URL pre-filled: 8 | 9 | ![Report Abuse button from Reactions menu](https://forem.dev/remoteimages/uploads/articles/8e3paniwk2m588swomu6.png) 10 | 11 | - Another shortcut is available at the bottom of every Post Discussion: 12 | 13 | ![Report Abuse button below Discussion](https://forem.dev/remoteimages/uploads/articles/ljfbaf6b6e34a6zq4pn1.png) 14 | 15 | - Meanwhile, if you'd like to report an inappropriate comment, you can do so from the same More button `...` in the top-right corner of any Comment: 16 | 17 | ![Report Abuse button on Comment](https://forem.dev/remoteimages/uploads/articles/yatnutn7w3w82p7kh1p3.png) 18 | 19 | If you're logged into your account, your username will be attached to the report in case an Admin has any questions to ask you. If you're not logged in, your report will be anonymous. If you'd like to make your report anonymously, remember to log out before opening the Report Form. 20 | 21 | ## What happens when you Report content? 22 | 23 | If you were logged in, you will receive an email acknowledging you've reported content. 24 | 25 | Reports appear in the Admin Portal for moderation. Admins can review reports and take any action that they find appropriate in line with the community Code of Conduct and/or Terms of Use. If you submitted a report and feel like timely action hasn't been taken, or disagree with the outcome of the review, please email us at *help@yourforem.name* 26 | 27 | ## Feedback 28 | 29 | We hope this information helps you feel safer whilst participating in this community, and empowered to take action at any time. 30 | 31 | If you'd ever like to request changes to the feedback procedure, the Forem team would love to hear from you. They invite you to [request changes or report bugs here](https://github.com/forem/forem/issues/new/choose). 32 | -------------------------------------------------------------------------------- /open-resources/tag-moderation-page.md: -------------------------------------------------------------------------------- 1 | Our community Tag Moderator program gives select users the ability to help organize content across the site, making all users’ feeds more relevant and the site easier to navigate. 2 | 3 | Tag mods work with each other and admins to ensure that content on the site is tagged appropriately, while also politely educating the whole community on how to follow tag guidelines. 4 | 5 | You can see who the moderators of each tag are by visiting a tag's landing page. (e.g. the [#openresources](/t/openresources) tag page). 6 | 7 | To sum up a few tag moderator abilities, they can: 8 | * Remove/add tags that they moderate from/to certain posts 9 | * Update their tag's sidebar (i.e. add a description, submission guideline, etc). 10 | * Update their tag's 'pretty name' and colors. 11 | 12 | In addition, tag moderators are also granted trusted user abilities, to help monitor overall content and site health. These privileges are described in our [Trusted User Guide](/community-moderation). 13 | 14 | ***If you're interested in becoming a trusted user or tag moderator, please email support@forem.com!*** 15 | 16 | --- 17 | 18 | Please note: you will need to be assigned Tag Moderator status and signed in to carry out all the following actions. 19 | 20 | ## How to Remove or Add Tags 21 | If you are the moderator of a tag, you have the ability to remove that tag from posts that should not contain it. Likewise, if you see a post that fits your tag and isn't using it, you can add your tag to it. These actions help us keep content categorized appropriately, so that people can confidently follow tags, knowing that they'll see the subjects they're interested in. 22 | 23 | 1. Visit an article you'd like to add or remove tags to. 24 | 2. Click the Mod Panel button in the lower-right corner. 25 | 3. Click on Adjust Tags. 26 | 4. Choose the tag you wish to remove (indicated by a red "minus" icon) or add (indicated by a green "plus" icon). Please include the reason for removing/adding your tag from/to this post, remembering to be positive and polite. **The author will receive a notification that the tag has been removed/added, along with your message.** 27 | 28 | ![adjust-tags](https://forem.dev/remoteimages/uploads/articles/8bofxmtg96oe3ahhanz4.png) 29 | 30 | _Note: once you remove the tag, the author will not be able to add it back. Only remove tags when you are confident they are inappropriate, and please do not remove tags simply because you did not like the post._ 31 | 32 | --- 33 | 34 | ## How to Update the Tag Sidebar, Pretty Name, & Color 35 | 36 | ![tag-edit form](https://forem.dev/remoteimages/uploads/articles/knhgeoqatque182j94ed.png) 37 | 38 | 1. Visit: `https://forem.dev/t/tag-name/edit` (e.g. https://forem.dev/t/openresources/edit) 39 | 2. Update the form. See the image below for a reference of each field. All fields accept Markdown _except_ the pretty name and summary. 40 | 3. Click save changes! 41 | 42 | ![example tag page](https://forem.dev/remoteimages/uploads/articles/y44a5iarb9r25n5o5ldm.png) 43 | 44 | --- 45 | 46 | Thank you for your interest in Tag Moderation in our community! If you have any further questions or would like to volunteer to moderate a specific tag, please contact us at support@forem.dev - we look forward to hearing from you! 47 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "forem-admin", 3 | "version": "0.0.0", 4 | "private": true, 5 | "scripts": { 6 | "docusaurus": "docusaurus", 7 | "start": "docusaurus start", 8 | "build": "docusaurus build", 9 | "swizzle": "docusaurus swizzle", 10 | "deploy": "docusaurus deploy", 11 | "clear": "docusaurus clear", 12 | "serve": "docusaurus serve", 13 | "write-translations": "docusaurus write-translations", 14 | "write-heading-ids": "docusaurus write-heading-ids" 15 | }, 16 | "dependencies": { 17 | "@docusaurus/core": "2.0.0-beta.0", 18 | "@docusaurus/preset-classic": "2.0.0-beta.0", 19 | "@mdx-js/react": "^1.6.21", 20 | "@svgr/webpack": "^5.5.0", 21 | "clsx": "^1.1.1", 22 | "file-loader": "^6.2.0", 23 | "react": "^17.0.1", 24 | "react-dom": "^17.0.1", 25 | "url-loader": "^4.1.1" 26 | }, 27 | "browserslist": { 28 | "production": [ 29 | ">0.5%", 30 | "not dead", 31 | "not op_mini all" 32 | ], 33 | "development": [ 34 | "last 1 chrome version", 35 | "last 1 firefox version", 36 | "last 1 safari version" 37 | ] 38 | } 39 | } -------------------------------------------------------------------------------- /sidebars.js: -------------------------------------------------------------------------------- 1 | /** 2 | * Creating a sidebar enables you to: 3 | - create an ordered group of docs 4 | - render a sidebar for each doc of that group 5 | - provide next/previous navigation 6 | 7 | The sidebars can be generated from the filesystem, or explicitly defined here. 8 | 9 | Create as many sidebars as you want. 10 | */ 11 | 12 | module.exports = { 13 | // By default, Docusaurus generates a sidebar from the docs folder structure 14 | tutorialSidebar: [{type: 'autogenerated', dirName: '.'}], 15 | 16 | // But you can create a sidebar manually 17 | /* 18 | tutorialSidebar: [ 19 | { 20 | type: 'category', 21 | label: 'Tutorial', 22 | items: ['hello'], 23 | }, 24 | ], 25 | */ 26 | }; 27 | -------------------------------------------------------------------------------- /src/components/NavigationList.js: -------------------------------------------------------------------------------- 1 | import React from "react"; 2 | import clsx from "clsx"; 3 | import styles from "./NavigationList.module.css"; 4 | import Link from "@docusaurus/Link"; 5 | 6 | const NavigationSections = [ 7 | { 8 | title: "Getting Started", 9 | links: [ 10 | { 11 | title: "Creator Signup and Onboarding", 12 | url: "docs/getting-started/creator-signup-and-onboarding", 13 | }, 14 | { 15 | title: "Forem Setup Checklist", 16 | url: "docs/getting-started/forem-setup-checklist", 17 | }, 18 | ], 19 | }, 20 | { 21 | title: "Forem Basics", 22 | links: [ 23 | { 24 | title: "Create static content with Pages", 25 | url: "docs/forem-basics/pages", 26 | }, 27 | { 28 | title: "Manage User Roles and Permissions", 29 | url: "docs/forem-basics/user-roles", 30 | }, 31 | { title: "Update and customize Tags", url: "docs/forem-basics/tags" }, 32 | ], 33 | }, 34 | { 35 | title: "Managing Your Community", 36 | links: [ 37 | { 38 | title: "Deleting Posts and Comments", 39 | url: "docs/managing-your-community/managing-posts-and-comments", 40 | }, 41 | { 42 | title: "Removing Spam", 43 | url: "docs/managing-your-community/removing-spam", 44 | }, 45 | { 46 | title: "Suspending Users", 47 | url: "docs/managing-your-community/suspending-users", 48 | }, 49 | ], 50 | }, 51 | { 52 | title: "Advanced Customization", 53 | links: [ 54 | { 55 | title: "Set up OAuth and Access Level", 56 | url: "docs/advanced-customization/config/authentication", 57 | }, 58 | { 59 | title: "Configure Email Server Settings (SMTP)", 60 | url: "docs/advanced-customization/config/email-server-settings", 61 | }, 62 | { 63 | title: "Add and sort Navigation Links", 64 | url: "docs/advanced-customization/navigation-links", 65 | }, 66 | ], 67 | }, 68 | { 69 | title: "Frequently Asked Questions", 70 | links: [ 71 | { 72 | title: 73 | "How do I change the background image of the onboarding screens?", 74 | url: "docs/frequently-asked-questions", 75 | }, 76 | { 77 | title: "How do I set the logo on my Forem?", 78 | url: "docs/frequently-asked-questions", 79 | }, 80 | { 81 | title: "Where do I go to get help with self-hosting my Forem?", 82 | url: "docs/frequently-asked-questions", 83 | }, 84 | ], 85 | }, 86 | { 87 | title: "Community Resources", 88 | links: [ 89 | { 90 | title: "Who are these docs for?", 91 | url: "docs/community-resources/who-are-these-docs-for", 92 | }, 93 | { 94 | title: "Connect with other Forem Creators", 95 | url: "docs/community-resources/connect-with-forem-builders", 96 | }, 97 | { 98 | title: "Contribute to these docs", 99 | url: "docs/community-resources/style-guide", 100 | }, 101 | ], 102 | }, 103 | ]; 104 | 105 | function Column({ title, links }) { 106 | return ( 107 |
108 |
109 |

{title}

110 |
111 | {links.map((props, idx) => ( 112 | 113 | {props.title} 114 | 115 | ))} 116 |
117 |
118 |
119 | ); 120 | } 121 | 122 | export default function NavigationList() { 123 | return ( 124 |
125 |
126 |
127 | {NavigationSections.map((props, idx) => ( 128 | 129 | ))} 130 |
131 |
132 |
133 | ); 134 | } 135 | -------------------------------------------------------------------------------- /src/components/NavigationList.module.css: -------------------------------------------------------------------------------- 1 | /* stylelint-disable docusaurus/copyright-header */ 2 | 3 | .features { 4 | display: flex; 5 | justify-content: flex-end; 6 | align-items: center; 7 | padding-bottom: 2.5rem; 8 | margin: 0 auto; 9 | width: 80%; 10 | /* background-color: var(--ifm-footer-background-color); Maybe set the link background to the same color as the footer? */ 11 | } 12 | 13 | .row { 14 | justify-content: center; 15 | } 16 | 17 | a { 18 | margin: 5px 0; 19 | line-height: 22px; 20 | } 21 | 22 | .links { 23 | display: flex; 24 | flex-direction: column; 25 | } 26 | -------------------------------------------------------------------------------- /src/css/custom.css: -------------------------------------------------------------------------------- 1 | /* stylelint-disable docusaurus/copyright-header */ 2 | /** 3 | * Any CSS included here will be global. The classic template 4 | * bundles Infima by default. Infima is a CSS framework designed to 5 | * work well for content-centric websites. 6 | */ 7 | 8 | /* You can override the default Infima variables here. 9 | :root { 10 | --ifm-color-primary: #25c2a0; 11 | --ifm-color-primary-dark: rgb(33, 175, 144); 12 | --ifm-color-primary-darker: rgb(31, 165, 136); 13 | --ifm-color-primary-darkest: rgb(26, 136, 112); 14 | --ifm-color-primary-light: rgb(70, 203, 174); 15 | --ifm-color-primary-lighter: rgb(102, 212, 189); 16 | --ifm-color-primary-lightest: rgb(146, 224, 208); 17 | --ifm-code-font-size: 95%; 18 | } 19 | */ 20 | 21 | :root { 22 | --ifm-color-primary: #005b30; 23 | --ifm-code-font-size: 95%; 24 | --ifm-footer-background-color: #022830; 25 | --ifm-spacing-horizontal: 3rem; 26 | --ifm-link-decoration: underline; 27 | } 28 | 29 | html[data-theme="dark"] { 30 | --ifm-color-primary: #fbc1f5; 31 | --ifm-background-color: #022830; 32 | --ifm-navbar-background-color: #022830; 33 | } 34 | 35 | .navbar__logo { 36 | height: 1.25rem; 37 | } 38 | 39 | .footer__links { 40 | text-align: center; 41 | } 42 | 43 | .heroBanner_src-pages- a, 44 | .features_src-components- a { 45 | text-decoration: underline; 46 | } 47 | 48 | .heroBanner_src-pages- a:hover, 49 | .features_src-components- a:hover { 50 | color: #057e44; 51 | } 52 | 53 | .container { 54 | padding: 0; 55 | } 56 | 57 | .footer { 58 | background-color: #012026; 59 | } 60 | 61 | .docusaurus-highlight-code-line { 62 | background-color: rgb(72, 77, 91); 63 | display: block; 64 | margin: 0 calc(-1 * var(--ifm-pre-padding)); 65 | padding: 0 var(--ifm-pre-padding); 66 | } 67 | 68 | details summary { 69 | cursor: pointer; 70 | padding: 5px 0; 71 | transition: 0.3s; 72 | } 73 | 74 | details summary:hover { 75 | color: var(--ifm-color-primary); 76 | } 77 | 78 | code { 79 | border: var(--ifm-color-primary) solid 0.1rem; 80 | } 81 | 82 | .testDetail summary { 83 | font-size: 1.5rem; 84 | font-weight: var(--ifm-heading-font-weight); 85 | } 86 | -------------------------------------------------------------------------------- /src/pages/index.js: -------------------------------------------------------------------------------- 1 | import React from "react"; 2 | import clsx from "clsx"; 3 | import Layout from "@theme/Layout"; 4 | import Link from "@docusaurus/Link"; 5 | import useDocusaurusContext from "@docusaurus/useDocusaurusContext"; 6 | import styles from "./index.module.css"; 7 | import NavigationList from "../components/NavigationList"; 8 | import ForemLogo from "@site/static/img/forem.svg"; 9 | import ForemLogoDark from "@site/static/img/foremDark.svg"; 10 | import useThemeContext from "@theme/hooks/useThemeContext"; 11 | 12 | function HomepageHeader() { 13 | const { siteConfig } = useDocusaurusContext(); 14 | const { isDarkTheme } = useThemeContext(); 15 | return ( 16 |
17 |
18 | {isDarkTheme ? ( 19 | 20 | ) : ( 21 | 22 | )} 23 |

24 | This documentation is for those who have launched and are managing a 25 | Forem community. If you haven’t yet installed the app and are hoping 26 | to self-host, please check out our
27 | 28 | Forem Selfhost Installation Documentation 29 | 30 | . 31 |

32 |
33 |
34 | ); 35 | } 36 | 37 | export default function Home() { 38 | const { siteConfig } = useDocusaurusContext(); 39 | return ( 40 | 44 | 45 |
46 | 47 |
48 | 49 | ); 50 | } 51 | -------------------------------------------------------------------------------- /src/pages/index.module.css: -------------------------------------------------------------------------------- 1 | /* stylelint-disable docusaurus/copyright-header */ 2 | 3 | /** 4 | * CSS files with the .module.css suffix will be treated as CSS modules 5 | * and scoped locally. 6 | */ 7 | 8 | .heroBanner { 9 | padding: 4rem 0; 10 | text-align: center; 11 | position: relative; 12 | overflow: hidden; 13 | background: var(--ifm-background-color); 14 | } 15 | 16 | @media screen and (max-width: 966px) { 17 | .heroBanner { 18 | padding: 2rem; 19 | } 20 | } 21 | 22 | .subtext { 23 | width: 100%; 24 | max-width: 500px; 25 | margin: 25px auto; 26 | } 27 | 28 | .buttons { 29 | display: flex; 30 | align-items: center; 31 | justify-content: center; 32 | } 33 | -------------------------------------------------------------------------------- /static/.nojekyll: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/.nojekyll -------------------------------------------------------------------------------- /static/img/85eo1v89vklsfcvb3b5b.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/85eo1v89vklsfcvb3b5b.png -------------------------------------------------------------------------------- /static/img/ImagesFavicon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/ImagesFavicon.png -------------------------------------------------------------------------------- /static/img/ImagesLogo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/ImagesLogo.png -------------------------------------------------------------------------------- /static/img/ImagesSocial.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/ImagesSocial.png -------------------------------------------------------------------------------- /static/img/adminCustomizationConfig.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/adminCustomizationConfig.png -------------------------------------------------------------------------------- /static/img/adminGuideButton.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/adminGuideButton.png -------------------------------------------------------------------------------- /static/img/campaign_sidebar_image.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/campaign_sidebar_image.png -------------------------------------------------------------------------------- /static/img/commentTemplateDelete.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/commentTemplateDelete.png -------------------------------------------------------------------------------- /static/img/commentTemplateMenu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/commentTemplateMenu.png -------------------------------------------------------------------------------- /static/img/commentTemplateModerator.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/commentTemplateModerator.png -------------------------------------------------------------------------------- /static/img/commentTemplatePersonal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/commentTemplatePersonal.png -------------------------------------------------------------------------------- /static/img/commentTemplatePreview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/commentTemplatePreview.png -------------------------------------------------------------------------------- /static/img/commentTemplateSelect.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/commentTemplateSelect.png -------------------------------------------------------------------------------- /static/img/contactPage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/contactPage.png -------------------------------------------------------------------------------- /static/img/creatorEmailConfirmation.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/creatorEmailConfirmation.png -------------------------------------------------------------------------------- /static/img/creatorSettingsPage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/creatorSettingsPage.png -------------------------------------------------------------------------------- /static/img/creatorSignupPage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/creatorSignupPage.png -------------------------------------------------------------------------------- /static/img/creditsPurchasePage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/creditsPurchasePage.png -------------------------------------------------------------------------------- /static/img/defaultEmailField.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/defaultEmailField.png -------------------------------------------------------------------------------- /static/img/deleteUserConformation.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/deleteUserConformation.png -------------------------------------------------------------------------------- /static/img/deleteUserGDPR.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/deleteUserGDPR.png -------------------------------------------------------------------------------- /static/img/developerToolsExtensions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/developerToolsExtensions.png -------------------------------------------------------------------------------- /static/img/displayAdsEdit.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/displayAdsEdit.png -------------------------------------------------------------------------------- /static/img/displayAdsExample.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/displayAdsExample.png -------------------------------------------------------------------------------- /static/img/docusaurus.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/docusaurus.png -------------------------------------------------------------------------------- /static/img/edafdaf3-cc2b-4560-a497-0e671b41c466.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/edafdaf3-cc2b-4560-a497-0e671b41c466.png -------------------------------------------------------------------------------- /static/img/emailUserOptions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/emailUserOptions.png -------------------------------------------------------------------------------- /static/img/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/favicon.ico -------------------------------------------------------------------------------- /static/img/firstAdminPortal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstAdminPortal.png -------------------------------------------------------------------------------- /static/img/firstAgreement.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstAgreement.png -------------------------------------------------------------------------------- /static/img/firstConfig.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstConfig.png -------------------------------------------------------------------------------- /static/img/firstConfigFilled.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstConfigFilled.png -------------------------------------------------------------------------------- /static/img/firstConfigUpdated.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstConfigUpdated.png -------------------------------------------------------------------------------- /static/img/firstDropdownAdmin.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstDropdownAdmin.png -------------------------------------------------------------------------------- /static/img/firstHome.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstHome.png -------------------------------------------------------------------------------- /static/img/firstProfileBlank.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstProfileBlank.png -------------------------------------------------------------------------------- /static/img/firstProfileFilled.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstProfileFilled.png -------------------------------------------------------------------------------- /static/img/firstSplash.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstSplash.png -------------------------------------------------------------------------------- /static/img/firstTags.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/firstTags.png -------------------------------------------------------------------------------- /static/img/foremLogoDark.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /static/img/foremLogoLight.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /static/img/hacktoberfest-card-6x4.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/hacktoberfest-card-6x4.pdf -------------------------------------------------------------------------------- /static/img/htmlVariantExample.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/htmlVariantExample.png -------------------------------------------------------------------------------- /static/img/image (4).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image (4).png -------------------------------------------------------------------------------- /static/img/image (5).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image (5).png -------------------------------------------------------------------------------- /static/img/image-2020-09-28-at-6.15.55-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-09-28-at-6.15.55-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-15-at-5.42.44-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-15-at-5.42.44-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-15-at-5.45.10-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-15-at-5.45.10-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-19-at-3.38.53-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-19-at-3.38.53-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-19-at-3.58.42-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-19-at-3.58.42-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-21-at-11.55.07-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-21-at-11.55.07-am.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-1.37.33-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-1.37.33-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-1.48.13-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-1.48.13-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-1.54.00-pm (1).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-1.54.00-pm (1).png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-1.54.00-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-1.54.00-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-1.59.00-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-1.59.00-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-2.01.45-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-2.01.45-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-2.02.48-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-2.02.48-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-3.54.34-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-3.54.34-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-4.11.41-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-4.11.41-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-4.21.10-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-4.21.10-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-4.43.28-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-4.43.28-pm.png -------------------------------------------------------------------------------- /static/img/image-2020-10-22-at-9.34.32-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-2020-10-22-at-9.34.32-am.png -------------------------------------------------------------------------------- /static/img/image-202020-08-13-20at-201.19.09-20pm (1).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-202020-08-13-20at-201.19.09-20pm (1).png -------------------------------------------------------------------------------- /static/img/image-202020-08-13-20at-201.19.09-20pm (2).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-202020-08-13-20at-201.19.09-20pm (2).png -------------------------------------------------------------------------------- /static/img/image-202020-08-13-20at-201.19.09-20pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/image-202020-08-13-20at-201.19.09-20pm.png -------------------------------------------------------------------------------- /static/img/imageUploader.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/imageUploader.png -------------------------------------------------------------------------------- /static/img/l2s27233mbg7t1kv3dw4.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/l2s27233mbg7t1kv3dw4.png -------------------------------------------------------------------------------- /static/img/large_banner_on_homepage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/large_banner_on_homepage.png -------------------------------------------------------------------------------- /static/img/listingsBump.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/listingsBump.png -------------------------------------------------------------------------------- /static/img/listingsCreateNew.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/listingsCreateNew.png -------------------------------------------------------------------------------- /static/img/listingsCreateNewExpandCategories.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/listingsCreateNewExpandCategories.png -------------------------------------------------------------------------------- /static/img/listingsDashboardExpired.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/listingsDashboardExpired.png -------------------------------------------------------------------------------- /static/img/listingsDashboardNoOrg.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/listingsDashboardNoOrg.png -------------------------------------------------------------------------------- /static/img/listingsDashboardOrg.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/listingsDashboardOrg.png -------------------------------------------------------------------------------- /static/img/listingsNewCategory.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/listingsNewCategory.png -------------------------------------------------------------------------------- /static/img/mailchimp-api-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/mailchimp-api-example.png -------------------------------------------------------------------------------- /static/img/mailchimpAPI.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/mailchimpAPI.png -------------------------------------------------------------------------------- /static/img/mailchimpAPItoConfig.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/mailchimpAPItoConfig.png -------------------------------------------------------------------------------- /static/img/mailchimpCreateAudience.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/mailchimpCreateAudience.png -------------------------------------------------------------------------------- /static/img/mailchimpMainNewsletterAudienceID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/mailchimpMainNewsletterAudienceID.png -------------------------------------------------------------------------------- /static/img/mascotConfig.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/mascotConfig.png -------------------------------------------------------------------------------- /static/img/moderatorNotifications.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/moderatorNotifications.png -------------------------------------------------------------------------------- /static/img/navigationAdd.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/navigationAdd.png -------------------------------------------------------------------------------- /static/img/navigationEdit.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/navigationEdit.png -------------------------------------------------------------------------------- /static/img/navigationLinks.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/navigationLinks.png -------------------------------------------------------------------------------- /static/img/onboardingNewUserActions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/onboardingNewUserActions.png -------------------------------------------------------------------------------- /static/img/open-reports.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/open-reports.png -------------------------------------------------------------------------------- /static/img/orgBrandingTwilio.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/orgBrandingTwilio.png -------------------------------------------------------------------------------- /static/img/orgCTAtriplebyte.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/orgCTAtriplebyte.png -------------------------------------------------------------------------------- /static/img/orgDemoHeroku.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/orgDemoHeroku.png -------------------------------------------------------------------------------- /static/img/overridePageNewForm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/overridePageNewForm.png -------------------------------------------------------------------------------- /static/img/pageManager.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/pageManager.png -------------------------------------------------------------------------------- /static/img/pageNew.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/pageNew.png -------------------------------------------------------------------------------- /static/img/podcastBackgroundImage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/podcastBackgroundImage.png -------------------------------------------------------------------------------- /static/img/podcastBrowserPlayer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/podcastBrowserPlayer.png -------------------------------------------------------------------------------- /static/img/podcastEpisodesInFeed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/podcastEpisodesInFeed.png -------------------------------------------------------------------------------- /static/img/podcastFetch.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/podcastFetch.png -------------------------------------------------------------------------------- /static/img/podcastPublish.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/podcastPublish.png -------------------------------------------------------------------------------- /static/img/podcastSuggest.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/podcastSuggest.png -------------------------------------------------------------------------------- /static/img/podcastSuggestionForm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/podcastSuggestionForm.png -------------------------------------------------------------------------------- /static/img/publicConfigFalse.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/publicConfigFalse.png -------------------------------------------------------------------------------- /static/img/publicConfigTrue.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/publicConfigTrue.png -------------------------------------------------------------------------------- /static/img/recaptcha-checkbox-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/recaptcha-checkbox-example.png -------------------------------------------------------------------------------- /static/img/recaptcha-forem-config-2.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/recaptcha-forem-config-2.jpg -------------------------------------------------------------------------------- /static/img/recaptcha-forem-config.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/recaptcha-forem-config.jpg -------------------------------------------------------------------------------- /static/img/recaptcha-registration-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/recaptcha-registration-example.png -------------------------------------------------------------------------------- /static/img/recaptcha-submit-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/recaptcha-submit-example.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-09-at-11.49.56-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-09-at-11.49.56-am.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-09-at-11.53.11-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-09-at-11.53.11-am.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.18.21-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.18.21-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.22.37-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.22.37-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.25.50-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.25.50-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.26.40-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.26.40-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.29.07-pm-1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.29.07-pm-1.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.29.07-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.29.07-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.44.30-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.44.30-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.50.26-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.50.26-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-12-at-1.53.03-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-12-at-1.53.03-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-15-at-6.33.41-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-15-at-6.33.41-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-21-at-5.17.24-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-21-at-5.17.24-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-21-at-5.21.04-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-21-at-5.21.04-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-21-at-5.22.29-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-21-at-5.22.29-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-21-at-5.23.29-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-21-at-5.23.29-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-22-at-12.35.12-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-22-at-12.35.12-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-22-at-12.55.14-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-22-at-12.55.14-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-09-22-at-12.55.29-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-09-22-at-12.55.29-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-08-at-9.54.03-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-08-at-9.54.03-am.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-16-at-4.09.29-pm (2) (1).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-16-at-4.09.29-pm (2) (1).png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-16-at-4.09.29-pm (2) (2).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-16-at-4.09.29-pm (2) (2).png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-16-at-4.09.29-pm (2).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-16-at-4.09.29-pm (2).png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-19-at-2.01.07-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-19-at-2.01.07-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-21-at-11.26.10-am (1).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-21-at-11.26.10-am (1).png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-21-at-11.26.10-am (2).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-21-at-11.26.10-am (2).png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-21-at-11.26.10-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-21-at-11.26.10-am.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-21-at-11.26.22-am (1).png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-21-at-11.26.22-am (1).png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-10-21-at-11.26.22-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-10-21-at-11.26.22-am.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-11-09-at-3.08.09-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-11-09-at-3.08.09-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-11-16-at-11.33.41-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-11-16-at-11.33.41-am.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-11-16-at-6.17.02-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-11-16-at-6.17.02-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-12-03-at-12.41.06-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-12-03-at-12.41.06-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-12-03-at-12.41.18-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-12-03-at-12.41.18-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-12-24-at-3.20.38-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-12-24-at-3.20.38-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-12-24-at-3.27.23-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-12-24-at-3.27.23-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2020-12-24-at-3.47.09-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2020-12-24-at-3.47.09-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2021-02-04-at-3.20.29-pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2021-02-04-at-3.20.29-pm.png -------------------------------------------------------------------------------- /static/img/screen-shot-2021-02-08-at-10.16.44-am.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen-shot-2021-02-08-at-10.16.44-am.png -------------------------------------------------------------------------------- /static/img/screen_shot_2020-10-15_at_2_44_39_pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen_shot_2020-10-15_at_2_44_39_pm.png -------------------------------------------------------------------------------- /static/img/screen_shot_2020-10-19_at_1_59_53_pm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screen_shot_2020-10-19_at_1_59_53_pm.png -------------------------------------------------------------------------------- /static/img/screencapture-localhost-3000-admin-advanced-tools-2021-05-06-12_55_40.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/screencapture-localhost-3000-admin-advanced-tools-2021-05-06-12_55_40.png -------------------------------------------------------------------------------- /static/img/sort-abuse-reports.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/sort-abuse-reports.png -------------------------------------------------------------------------------- /static/img/tagConfig.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/tagConfig.png -------------------------------------------------------------------------------- /static/img/tagManager.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/tagManager.png -------------------------------------------------------------------------------- /static/img/tagNew.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/tagNew.png -------------------------------------------------------------------------------- /static/img/tagSupportedFalse.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/tagSupportedFalse.png -------------------------------------------------------------------------------- /static/img/tagSupportedTrue.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/tagSupportedTrue.png -------------------------------------------------------------------------------- /static/img/tagattributes.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/tagattributes.png -------------------------------------------------------------------------------- /static/img/thank-you-reporter.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/thank-you-reporter.png -------------------------------------------------------------------------------- /static/img/tutorial/docsVersionDropdown.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/tutorial/docsVersionDropdown.png -------------------------------------------------------------------------------- /static/img/tutorial/localeDropdown.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/tutorial/localeDropdown.png -------------------------------------------------------------------------------- /static/img/userMenuAccessingAdminPortal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/userMenuAccessingAdminPortal.png -------------------------------------------------------------------------------- /static/img/userNotificationsFullpage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/userNotificationsFullpage.png -------------------------------------------------------------------------------- /static/img/userOrgAlt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/userOrgAlt.png -------------------------------------------------------------------------------- /static/img/userOrgNew.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/userOrgNew.png -------------------------------------------------------------------------------- /static/img/userRolesCurrentRole.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/userRolesCurrentRole.png -------------------------------------------------------------------------------- /static/img/userRolesManage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/userRolesManage.png -------------------------------------------------------------------------------- /static/img/userRolesNewStatus.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/userRolesNewStatus.png -------------------------------------------------------------------------------- /static/img/welcomeTag.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/forem/admin-docs/893bf7a9a1c0684a29a65c8ecc905f3a64b28a49/static/img/welcomeTag.png --------------------------------------------------------------------------------