====== NP_MiniForum ======

With this plugin you can easily add simple forum (or more) to your weblog.

^General Plugin info ^^
^Current Version: | 0.3.1|
^Download: | [[http://files.pepiino.info/NP_MiniForum/NP_MiniForum-0_3_1.zip|NP_MiniForum-0_3_1.zip]] ,20kb,8 files|
^Demo: | [[http://nucleus.pepiino.info]] (login: admin password: password) |
^Forum Thread: | [[http://forum.blogcms.com/viewtopic.php?id=1319]]|
^Information in czech language | [[http://blog.pepiino.info/?item=miniforum-jednoduche-forum-do-vaseho-blogu-plugin-pro-blog-cms|here]]|
^Requiremets: | BLOG:CMS version 3.5.2 or newer, php version 4.1.1 or newer (probably it can work on older version, but not tested)|
^Author: | [[josef.adamcik@gmail.com|Josef 'Pepiino' Adamcik]] \\ [[http://blog.pepiino.info]],|

=====Features=====
  * linebreaks are converted to <br /> tags (can be turned of in the options)
  * full skinable output
  * an admin area for creating/editing/erasing discussions and posts
  * multilanguage support (english and czech supported now, but you can simply add your language)
  * an anonymous user can't use the same name as any registered user
  * converts charcters < > & to the (x)html entities in post body
  * detects a logged in user, so he needn't to fill name and url
  * the plugin is compatible with Nucleus CMS too.
  


=====Installing=====
  - Unzip the file and upload the contents to your plugin directory
  - If you want to use different language than English, go to the miniforum directory. There are lang.php.xx files, where ‘xx’ are language shortcuts (e.g.: en, cs …). Choose your preffered language and rename the file to lang.php. If you do this after the installation, the plugin options will not be translated.
  - Install the plugin.

=====Upgrading=====
  * from version 0.2.2 to 0.3.1: 
    - Unzip the file and upload the contents to your plugin directory (rewrite old files)
    - If you want to use different language than English, go to the miniforum directory. There are lang.php.xx files, where ‘xx’ are language shortcuts (e.g.: en, cs …). Choose your preffered language and rename the file to lang.php. If you do this after the upgrade, the plugin options will not be translated.    
    - Point your browser to http://yoursite.com/nucleus/plugins/miniforum/upgrade.php . This script will do everything necessary. You have to be logged in as site administrator!


=====How to use the plugin=====
In an admininstration area of the plugin you can create the forums and manage the posts. Installation creates one default forum (named  'default'). If you want to show the forum on your page, use skinvars as described in a next section.

Tempelates for output of the plugin are in options.

=====Available SkinVars and/or TemplateVars=====
You can use fallowing skinvars (where 'myforum' is the short name of your forum ):
<code><%MiniForum(ShowPosts,myforum)%></code> - inserts list of posts from the forum 
<code><%MiniForum(ShowForm,myforum)%></code> - shows a form for adding posts to the forum
<code><%MiniForum(ShowPosts)%></code> - inserts list of posts from the default forum 
<code><%MiniForum(ShowForm)%></code> - shows a form for adding posts to the default forum     

=====Options=====
I hope, you can figure out meaning of the options. Meybe I add here detailed description sometimes. :-)

=====Tips and Tricks=====

No tricks yet. Find some! :-D

=====Wishlist=====

=====Bugs=====

=====History=====
  * Version 0.3.1, released 2005-03-21
    * Fixed some major bugs
  * Version 0.3.0, (not released)
    * Nucleus CMS and Blog:CMS versions merged (So you can use this version in both now.)
    * linebreaks are converted to <br /> tags (can be turned of in plugin options)
    * You can make another tempelate for tag <%name%> for members. (So you can discriminate  between non-member's post and member's.)
    * Checks word length in post. If word is too long (maximum length can be set in options) plugin splits it into more parts separated by '-', accordingly users can't break layout of your page.
    * Few bugs fixed

  * Version 0.2, released 2005-02-26
    * First public release
    

=====Note=====
As you can see, my english isn't the best. Feel free to correct my mistakes and unclear formulations. LOL




