Forum_XH

Forum_XH facilitates the embedding of simple forums on a CMSimple_XH site. The user management relies on Memberpages or Register_XH.

Posting requires to be logged in as member, though the forums can be viewed publicly. This way no further provisions are necessary to avoid spam, and posting does not require any additional input such as user name, email address etc.

Forum_XH features a markup editor allowing basic BBCode markup. All data are stored in flat files, so Forum_XH is not suitable for large amounts of data. Furthermore common advanced forum features such as user signatures, PMs, subscribing to topics etc. are not available.

Table of Contents

• Requirements
• Download
• Installation
• Settings
• Usage
  • BBCode
• Troubleshooting
• License
• Credits

Requirements

Forum_XH is a plugin for CMSimple_XH. It requires CMSimple_XH ≥ 1.7.0 with the Fa_XH plugin,. It requires PHP ≥ 7.1.0 with the JSON and Session extensions.

Download

The lastest release is available for download on Github.

Installation

The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.

1. Backup the data on your server.
2. Unzip the distribution on your computer.
3. Upload the whole directory forum/ to your server into the plugins/ directory of CMSimple_XH.
4. Set write permissions for the subdirectories config/, css/, and languages/.
5. Navigate to Plugins → Forum in the back-end to check if all requirements are fulfilled.

Settings

The configuration of the plugin is done as with many other CMSimple_XH plugins in the back-end of the website. Select Plugins → Forum.

You can change the default settings of Forum_XH under Config. Hints for the options will be displayed when hovering over the help icon with your mouse.

Localization is done under Language. You can translate the character strings to your own language if there is no appropriate language file available, or customize them according to your needs.

The look of Forum_XH can be customized under Stylesheet.

Usage

Inserting a forum on a page is done with the following plugin call:

{{{forum('name-of-the-forum')}}}

You can have as many forums as you like, but at most one per CMSimple_XH page. The forums are distinguished by their name, which may contain lowercase letters (a-z), digits (0-9) and hyphens (-) only.

After switching to view mode you will see the forum, and if it already contains topics, you can navigate through them. Posting new comments requires that you are logged in via Memberpages or Register_XH. Then you can also edit and delete your own posts. The CMSimple_XH administrator can edit and delete the posts from all users, but in order to post new comments, the administrator has to log in additionally as member. No additional admin functionality is provided in the back-end.

BBCode

To allow users to markup their comments, basic BBCode is available. The following elements are supported:

• [b]bolded text[/b]: bolded text
• [i]italicized text[/i]: italicized text
• [u]underlined text[/u]: underlined text
• [s]strikethrough text[/s]: strikethrough text
• [url]https://cmsimple-xh.org/[/url]: https://cmsimple-xh.org/
• [url=https://cmsimple-xh.org/]CMSimple\_XH[/url]: CMSimple_XH
• [img]https://cmsimple-xh.org/userfiles/images/flags/en.gif[/img]:
• [iframe]https://cmsimple-xh.org/userfiles/images/flags/en.gif[/iframe]:
  Iframes are used to embed external content, for instance, Youtube videos.
• [size=150]large text[/size]: large text
• [list][*]One [*]Two[/list]:
  • One
  • Two
• [list=1][*]One [*]Two[/list]:
  1. One
  2. Two
• [quote]quoted text[/quote]:

  quoted text

• [code]monospaced text[/code]: monospaced text

Note that nesting of the same kind of elements is not allowed (for instance, nested lists are not possible). The HTML created by the BBCode converter is always valid and secure (i.e. no script injection is possible). If any nesting of BBCode elements would result in invalid HTML, the offending elements will simply be ignored.

The usage of the markup editor should be pretty much self explaining. Please note that a simple preview is available via the rightmost button. If JavaScript is not available in the browser of the user, the editor is not available, but using BBCode in the textarea is still possible.

Troubleshooting

Report bugs and ask for support either on Github or in the CMSimple_XH Forum.

License

Forum_XH is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Forum_XH is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantibility or fitness for a particular purpose. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Forum_XH. If not, see https://www.gnu.org/licenses/.

© 2012-2023 Christoph M. Becker

Danish translation © 2012 Jens Maegard
Russian translation © 2012 Lybomyr Kydray

Credits

The plugin logo is designed by Dezinerfolio. Many thanks for publishing this icon as freeware.

The emoticons were taken from the LED icon pack. Many thanks for publishing these icons under CC BY-SA.

Many thanks to the community at the CMSimple_XH forum for tips, suggestions and testing. Especially I want to thank Traktorist and Old for many good suggestions. Also many thanks to Ulrich for reviving the plugin, and lck for contributing iframe markup support.

And last but not least many thanks to Peter Harteg, the “father” of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS would not exist.