MediaWiz Forums

Platform NuGet GitHub

MediaWiz Forums provides a basic Forum add on for Umbraco.

Installation

[!IMPORTANT] v17.x supports Umbraco v17

v16.x supports Umbraco v16

v14.x supports Umbraco v14+

For previous versions Please use https://github.com/huwred/MediaWizForums

To understand more about which Umbraco CMS versions are actively supported by Umbraco HQ, please see Umbraco's Long-term Support (LTS) and End-of-Life (EOL) policy.

The Umbraco 17 version of this package is available via NuGet.

To install the package, you can use either .NET CLI:

dotnet add package MediaWiz.Forums.14 --version 17.0.0

or the NuGet Package Manager:

Install-Package MediaWiz.Forums.14 -Version 17.0.0

Setup

The package can then be configured in appsettings.json:

  "MediaWizOptions": {
    "MaxFileSize": 8, 
    "AllowedFiles": [ ".gif", ".jpg", ".png", ".svg", ".webp", ".mp4" ],
  },

Options

The following options are available, in appsettings.json:

  "MediaWizOptions": {
    "MemberTypeAlias": "",
    "ForumDoctypes": "", 
    "MaxFileSize": 8,
    "AllowedFiles": [], 
    "UniqueFilenames": false
  },

Settings

MediaWiz Forums
Property Type Description
MediaWizOptions MediaWizOptions Configure settings for the MediaWiz Forums
Options
Property Type Description
MemberTypeAlias string Defaults to "forumMember" if not set
ForumDoctypes string If your site already contains any Document Types using the same aliases as the forum, set a prefix to avoid conflicts.
MaxFileSize integer Maximum file size in MB.
AllowedFiles string[] | List<string> A list of file extensions that can be uploaded in a post. If left blank, no files will be allowed.
UniqueFilenames boolean When uploading, if true a random guid is used for all filenames, default uses the name of uploaded file.

Document Types

Property Type Description
searchPage searchPage Search page node
members members Members root node (dummy holding node)
profile profile Member profile node
login login Login node
register register Registration node
reset signatures Password reset node
verify verify Email verification node

Getting Started

After installation, you'll need to:

  1. Register TagHelpers: In your Umbraco project, open the _ViewImports file and add the following ... @addTagHelper *, MediaWiz.Forums
  2. Login to Umbraco: Navigate to /umbraco and login with the credentials you specified (default: admin@example.com / 1234567890)
  3. Publish the Forums Page: Go to the Content section and publish the forums holder page including it's children
  4. Set Master template: Got to the Settings section and navigate to Templates, select the forumMaster template and assign your main site Layout file.
  5. Save Dictionary Items: Navigate to the Translation section and save at least one dictionary item to initialize translations
  6. View Your Site: The forum should now be accessible at the /forums URL

License

Copyright © 2022-2025 Huw Reddick, and other contributors.

Licensed under the MIT License.