websitetoolbox/websitetoolboxforum

Your CraftCMS forum doesn’t need to be basic. Website Toolbox is a cloud-based forum plugin that allows you to easily add a powerful, intuitive, and maintenance-free forum to CraftCMS without slowing it down. No database, servers, or coding required

1.0.0 2020-10-27 13:16 UTC

This package is not auto-updated.

Last update: 2021-04-14 13:54:29 UTC


README

wt_logo_blue.svg

Website Toolbox Forums plugin for Craft CMS 3.x

About Website Toolbox Forum

Your Craft forum doesn’t need to be basic. Website Toolbox is a cloud-based forum plugin that allows you to easily add a powerful, intuitive, and maintenance-free forum to Craft without slowing it down. No database, servers, or coding required.

Plugin Features

  • Embedded Forum: The forum is seamlessly embedded into the layout of your Craft website.
  • Single Sign On: Users are automatically signed in to your forum when they sign in to your Craft website.
  • Registration Integration: Forum accounts are automatically created for your existing or new Craft users. Screenshot

Key Forum Benefits

  • Instant setup
  • Phone/Chat/Email support
  • SEO and mobile friendly
  • Fully customizable
  • Public or Private
  • White label

Key Forum Features

  • Make money using ads or subscription fees
  • Facebook integration
  • Instant messaging
  • Chat room
  • Share files, photos, and videos
  • “Like” posts
  • User reputation
  • Easy theme editor
  • Announce and organize events
  • Create polls
  • Set user permissions
  • Moderate content and users
  • Import or export your data

Requirements

This plugin requires Craft CMS 3.0.0 or later.

Installation

Plugin Store

Log into your control panel, hit up the 'Plugin Store', search for this plugin and install.

Composer

Open terminal, go to your Craft project folder and use composer to load this plugin. Once loaded you can install via the Craft Control Panel, go to Settings → Plugins, locate the plugin and hit “Install”.

cd /path/to/project
composer require websitetoolbox/websitetoolboxforum   

Configuring Website Toolbox Forum

  1. Create a Website Toolbox Forum.

  2. Go to your Website Toolbox forum Settings. Dashboard > Settings > Website Toolbox Forum.
    Add Login Credentials received from Website Toolbox.

    settings.jpg
  3. Review the plugin settings and click the Save button.

    update-settings.jpg

Configuring Website Toolbox SSO Settings

  1. Visit the Single Sign On Section.

  2. Add your website Log In, Log Out and Sign Up links.

    SSO-section.png

For Embedded Forum Front-End Template

Add below code to website’s Forum template page.Exclude the tag if it’s already included in template header.

<body><div id="embedForum"></div></body>

Steps to Create Menu Item For Forum

  1. Non-Embedded Forum Menu
  2. Embedded Forum Template Menu

For Non-Embedded Forum Menu

  1. Go to Admin > Dashboard > Settings > Fields > New Field
    (For more details please visit. https://craftcms.com/docs/2.x/fields.html#translatable-fields)

  2. Select Field type as "Matrix".

    unembedded_menu_step1.png
  3. Go to Configuration section on same page.

  4. Add details for "Menu Name".

    unembedded_menu_step2-a.png
  5. Add details for "URL".

    unembedded_menu_step2-b.png
  6. Go to admin > dashboard > settings > Globals > New Global Set

  7. Add Name for global set.

    unembedded_menu_step3.PNG
  8. Go to Field layout.

  9. Drag and drop new created field item.

    unembedded_menu_step3-a.png
  10. Go to Admin > dashboard > Globals

  11. Select the new global set you created.

  12. Add menu name you want to display and URL for forum (https://forumname.discussion.community).

    unembedded_menu_step4.png

For Embedded Forum Template Menu

  1. Go to Admin > Dashboard > Settings > Fields > New Field
    (For more details please visit. https://craftcms.com/docs/2.x/fields.html#translatable-fields)

  2. Select Field type as "Matrix".

    unembedded_menu_step1.png
  3. Go to Configuration section on same page.

  4. Add details for "Menu Name".

    unembedded_menu_step2-a.png
  5. Add details for "URL".

    unembedded_menu_step2-b.png
  6. Go to Admin > dashboard > Globals

  7. Select the new global set you created.

  8. Add Menu name you want to display.

  9. Add URL for forum template page created using above instructions.
    i.e. If your template name is "Forum.twig/forum.html". Then template path would be like "/forum".

    embeddedforum-step1.png