cogProvides XWiki users with a basic yet effective Bulletin Board (Forum) feature
TypeXAR
Developed by

Guillaume Lerouge, Oana Tabaranu, Thomas Delafosse

Active Installs12
Rating
Rate!
2 Votes
LicenseGNU Lesser General Public License 2.1
Installable with the Extension Manager

Description

This application is superseded by the Forum Application.

Bulletin Board Home

The Bulletin Board Application works as a standard XWiki Application. It gives you the possibility to create new categories and discuss topics within them. Creating a new category is allowed only to admins, who can do so from a field on the Bulletin Board's front page. Then new topics can be created within existing categories.

BulletinBoardHome.png

Categories

The Bulletin Board can be divided into categories according to the wishes of its admins. Admins can delete categories, topics as well as individual messages. Each category has a title as well as a short descriptions of its subject. RSS Feeds are available for the whole Bulletin Board as well as for every single category.

BuletinBoardCategory.png

Topics

Conversation are built sorted in topics. Each topics has its own thread of replies. You can quote previous messages and answer them. As of now, it is recommended that the number of messages on any given topic page does not exceed 50 to keep an acceptable level of performance. 

BulletinBoardTopic.png

Bulletin Board Skin

The current Bulletin Board Skin has been chosen to match Albatross, Toucan & Colibri's color schemes. Its look can be adapted to suit another website's needs easily. All the CSS is stored on the BBCode.Skin wiki page. Edit it in wiki mode, change the values you need to and you're done!

See also

Tested on

This extension has been tested with the following configurations.

Extension VersionXWiki FlavorNotes
1.8XWiki Enterprise 6.0.1

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki

Please do not forget to use a user with Programming Rights (Such as the Admin) to import this XAR as some of the pages require to be saved by a user with Programming Rights to work.

You will have to import the Bulletin Board Application in your wiki. To do so, follow these steps:

  • Click on the "administration" link at the top right corner
  • Step 1 : Import the application
    • Click on the "import" tab
    • Upload the Bulletin+Board.xar file
    • Click on its name once it can be seen in the list
    • Click on "import" -> the application is now available on your wiki
  • Step 2 : Tell the wiki where to find the right languages resources (you don't need to do this if you are using XWiki 4.3 or a more recent version)
    • In the administration menu, click on "Localization"
    • Scroll in this menu until you see "Internationalization Document Bundles"
    • In that field, copy-paste the following text : "BBCode.Translations,"
    • Save the page.
  • Step 3 : setup your Bulleting Board Panels
    • Go to the http://<server>/xwiki/bin/view/Panels/PanelWizard page
    • Select your favorite layout. You need to have at least one column to use the task panels.
    • Drag & Drop the bulleting board panel from the panel list in the center to the side column of your choice. There is one panel built specifically for the Bulletin Board: Panels.BulletinBoardList
    • Click on "Save the new layout" at the bottom of the page. You're done!
  • Your application is now available on the following page: http://<server>/xwiki/bin/view/BBCode/
  • One default Bulleting Board is included with the application. You can view it at http://<server>/xwiki/bin/view/BulletinBoard/

Release Notes

v1.8

XBB-7: Complete the French translation

v1.7

XBB-6: Automatically register translations for the Bulletin Board application

v1.6

Various fixes in the pom.xml

v1.5

XBB-3: First post in a topic is created with the wrong date
XBB-4: Getting CSRF warning when trying to delete a post
XBB-5: Post with empty content is not visible

v1.4

XCONTRIB-152 : Mark Bulletin Board technical pages as hidden  
XCONTRIB-151: Provide a Bulletin Board entry in the Applications panel

v1.3

Added CSRF token authentication for the form submission and fixed the js for the quote creation and insertion in the replay box.

v1.1

The second version of this Bulletin Board application. The application includes most standard features (categories, topics, posts...) of a Bulletin Board. Here is a short list of them:

  • Categories
  • Topics
  • Discussion Threads
  • RSS Feeds
  • User profiles
  • Message deletion tools
  • Fully customizable skin
  • Internationalization - ready

You can localize this application in your language by editing the BBCode.Translations wiki page and duplicating it in the language of your choice. More information about what you can do is available on the http:///xwiki/bin/view/BBCode/ page of your wiki once you've completed the installation process.

Tags: social forum
Created by Guillaume Lerouge on 2008/02/17 23:09
    

Get Connected