Setting up the initial settings
Choose and setup the Default and Custom module instance settings
There are two types of available settings - Default settings and Custom module instance settings. The Default settings are settings that are applied to multiple instances of the module so that it is not necessary, for example, to provide a Facebook APP ID for each instance of the module. The Module instance settings override the Default settings and only apply to one instance at a time.
It is possible to combine the Default settings with the Module settings per section. For example, the Comments settings section can be set to use the Default settings, while the Category filter can be set to use the Module instance settings.
Main display settings
Number of topics per page - Setting the amount of visible topics per page. Defines the paging page size
Pagination type - Choice of pagination type. There are three options: Infinite scroll, Infinite scroll on button click and Classic pagination
- Infinite scroll - Topics are loaded automatically as the page is being scrolled, until all the topics have been loaded
- Infinite scroll on button click - Topics are loaded by clicking the "Load more" button
- Classic - Paging with page numbers, topics are listed by selecting the page numbers
Display type - There are two types of initial display: View categories or View all topics without categories. Eg. if the forum has only one category then it is enough to immediately show all the topics without a category view
Categories > Topics > Details: A 3-level initial display. It shows the categories, which when selected show their respective topics, which in turn, once selected open the details of the topic in question
Topics > Details: A 2-level initial display. It shows all topics regardless of the category, which when selected open the details of the topic in question
Display related topics - Allows the related topics top be listed in the details of the original topic, if applicable. Related topics are shown depending on the tags provided in the original topic
Setting up the Facebook APP integration, as well as the appearance and sorting method of Facebook comments.
To integrate with Facebook comments, you need to provide a valid Facebook APP ID as well as a valid Facebook App Secret key. Both values are generated after creating a Facebook application. A tutorial on how to create a Facebook application can be found here:
Facebook comments can also work without the Facebook APP ID and Facebook App Secret, in which case there is no way to moderate the comments, so it is recommended to fill in both values. In the Facebook application, it is also advised to add a Callback URL that allows you to receive a notification when someone adds or deletes a comment. A callback URL can only be added to sites using the HTTPS protocol.
Number of comments per page - Setting the amount of Facebook comments per page
Color sheme - Choosing the default color scheme for Facebook comments amongst two versions (Light and Dark)
Order by - Sorting method for Facebook comments. Comments can be sorted by Social network, (regular) Time or Reverse time
Important notice for module setup and comment display
Facebook comments are bound to links. The Absolute link from the site is the ID for the comments. That's why it is important to make sure not to change the page name once the forum has been made public, because comments that have already been added will not be displayed due to the change in page name or URL.
All categories created in the module are available in all module instances. With the category filter you can choose which categories will appear in which module instance. All categories are displayed by default, so if you wish to disable the "Display all categories" option, you can select a single category or multiple categories to display instead.
Theme and template selection
Selecting the layout of the forum module. It is possible to choose a theme and individual templates for categories, topic list and topic details. CSS style allows you to select a color scheme. Module layouts are created using the Razor template engine.