Documente Academic
Documente Profesional
Documente Cultură
Joomlaboard Manual
For v1.1.5
Table of Contents
Part I Introduction 3
1 License ................................................................................................................................... 3
1 Introduction
This document is a copy of the Joomlaboard online documentation available here:
http://www.tsmf.net/content/category/4/14/33/
The information was simply copied and output in PDF and CHM formats for the FireBoard
community.
Minor formatting changes were made, but the content is virtually identical.
It is my understanding that the FireBoard Documentation Team will produce documentation when
FireBoard is stable. Makes sense to me. Hard to chase a moving target. You end up writing things
multiple times.
Regards.
1.1 License
Documentation
Documentation released under this license will be marked with the following logo:
A - Forum search
Use this to search through the forum for a specific word or short phrase. eg. click in the box, type a
word or short phrase and press your keyboard's enter key - the search results will appear with
successful results in bold text. Click on the bold text entry, and you'll be taken to that particular post.
If you have no luck finding something on your first try - don't give up. Be less specific and more
general, or try words with a similar meaning.
B - Board title
This is the title of your board, and should probably reflect your site - eg. what your site is about,
theme, content etc. You set this title via the admin configuration area.
C - Main menu
* Home - Clicking on this link takes you to the forum's home page.
* My Profile - Click on this to set up personal preferences for the forum - eg. give yourself an
avatar (little picture) or set a signature that appears at the bottom of every post you make. More on
this later.
* Show latest posts - this area allows you to view the latest posts based on specific time variables.
* Help - Has some quick and useful information on using bulletin board code etc.
* Rules - This is where people can read the rules of expected conduct on your forum. You can
enable/disable this feature via the admin configuration area, and you insert your own rules by editing
the rules.php file.
D - Category name
Think of a category as a "container" for a number of forums. In a way, it's a means to group and
describe a number of similar forums within a single over-arching concept. For example, I usually
have a forum category called "Housekeeping", and within that category I have forums called "Site
Suggestions" and "Bug Reports" - the common theme is web site maintenance (housekeeping) - but
E - Forum name
This is a forum name - click on it and the forum with it's topic list will open up. There are 2 forums
defined here.
F - Forum description
This is a brief description of the forum - it gives you an idea as to where to post something. If you
can't make up your mind - most forum operators tend to have a fairly general forum :)
H - Topics
This indicates the number of different topics in the forum.
I - Replies
This indicates the number of replies in the forum. If you consider the number of topics and replies as
a ratio - you'll get an idea of how active/busy/inefficient a forum is.
K - Newest post
Clicking on the little page graphic will take you to the latest (newest) post in that forum.
L - Mark read
Mark all forums read - clicking on this will change all of the exclamation marks in the column marked
"G" to show that there are no new unread posts. This is particularly useful on busy forums if you've
been offline for a bit and are unable to catch up on all of the reading.
M - Indicator key
This is an explanation of the colour/icon coding used to show whether there are new posts (see "G")
in a forum since your last visit.
N - Version/copyright details
This is the software version number and copyright details. You must leave these intact - for various
reasons - including the occasional need to quote a version number when seeking help, and legal
requirements associated with copyright laws.
A - Forum search
Use this to search through the forum for a specific word or short phrase. eg. click in the box, type a
word or short phrase and press your keyboard's enter key - the search results will appear with
successful results in bold text. Click on the bold text entry, and you'll be taken to that particular post.
If you have no luck finding something on your first try - don't give up. Be less specific and more
general, or try words with a similar meaning.
B - Board title
This is the title of your board, and should probably reflect your site - eg. what your site is about,
theme, content etc. You set this title via the admin configuration area.
C - Main menu
This menu is slightly different to that which appears on the forum's home page.
* Home - Clicking on this link takes you to the forum's home page.
* My Profile - Click on this to set up personal preferences for the forum - eg. give yourself an
avatar (little picture) or set a signature that appears at the bottom of every post you make. More on
this later.
* Threaded view - click this to change from the current flat view to the alternative threaded view of
the forum.
* Pending/No pending messages - click this to review posts that must be approved prior to
publishing. A common misconception is this link is related to myPMS - it's not though :)
* Help - Has some quick and useful information on using bulletin board code etc.
* Rules - This is where people can read the rules of expected conduct on your forum. You can
enable/disable this feature via the admin configuration area, and you insert your own rules by editing
the rules.php file.
E - Page
This is where pagination is listed, enabling forum visitors to skip from one page to another.
F - Boardwalk
This indicates the path you follow while moving through the forum setup, and you can click on the
various links to move back up the path you've traveled. You can also change the word "Boardwalk"
via the forum's language file if you want.
J - Topics column
This is the topic title. The topic title is hyperlinked, and clicking on it will open up the post for reading.
K - Replies column
The number of replies to the corresponding post.
L - Views column
The total number of view for the corresponding post.
M - Author column
The name of the initial post's author.
P - Jump box
Use this to jump directly to other forums, rather than using the Boardwalk to move upwards and then
across into other forums.
S - Indicator key
This is an explanation of the colour/icon coding used to show whether there are new posts (see "G")
in a forum since your last visit.
A - Forum search
Use this to search through the forum for a specific word or short phrase. eg. click in the box, type a
word or short phrase and press your keyboard's enter key - the search results will appear with
successful results in bold text. Click on the bold text entry, and you'll be taken to that particular post.
If you have no luck finding something on your first try - don't give up. Be less specific and more
general, or try words with a similar meaning.
B - Board title
This is the title of your board, and should probably reflect your site - eg. what your site is about,
theme, content etc. You set this title via the admin configuration area.
C - Main menu
This menu is slightly different to that which appears on the forum's home page.
* Home - Clicking on this link takes you to the forum's home page.
* My Profile - Click on this to set up personal preferences for the forum - eg. give yourself an
avatar (little picture) or set a signature that appears at the bottom of every post you make. More on
this later.
* Flat view - click this to change from the current threaded view to the alternative flat view of the
forum.
* Pending/No pending messages - click this to review posts that must be approved prior to
publishing. A common misconception is this link is related to myPMS - it's not though :)
* Help - Has some quick and useful information on using bulletin board code etc.
* Rules - This is where people can read the rules of expected conduct on your forum. You can
enable/disable this feature via the admin configuration area, and you insert your own rules by editing
the rules.php file.
E - Page
This is where pagination is listed, enabling forum visitors to skip from one page to another.
F - Boardwalk
This indicates the path you follow while moving through the forum setup, and you can click on the
various links to move back up the path you've traveled. You can also change the word "Boardwalk"
via the forum's language file if you want.
J - Topics column
This column has a different layout compared to the flat view. When in threaded view, the topics
column contains a hyperlinked topic title and indicates the relationship of replies to their parent post.
It's somewhat like a tree - and this view enables you to follow the various twists and turns that
sometimes arise in lengthy online post conversations. Unlike the flat view, the threaded view doesn't
show the number of replies or views - or the most recent post indicator.
K - Author column
The name of the initial post's author.
M - Jump box
Use this to jump directly to other forums, rather than using the Boardwalk to move upwards and then
across into other forums.
P - Indicator key
This is an explanation of the colour/icon coding used to show whether there are new posts (see "G")
in a forum since your last visit.
A - Forum search
Use this to search through the forum for a specific word or short phrase. eg. click in the box, type a
word or short phrase and press your keyboard's enter key - the search results will appear with
successful results in bold text. Click on the bold text entry, and you'll be taken to that particular post.
If you have no luck finding something on your first try - don't give up. Be less specific and more
general, or try words with a similar meaning.
B - Board title
This is the title of your board, and should probably reflect your site - eg. what your site is about,
theme, content etc. You set this title via the admin configuration area.
C - Main menu
* Home - Clicking on this link takes you to the forum's home page.
* My Profile - Click on this to set up personal preferences for the forum - eg. give yourself an
avatar (little picture) or set a signature that appears at the bottom of every post you make. More on
this later.
* Post reply - You can use this link/button to post a reply to the topic thread, in addition to the reply
links/buttons associated with each post in the thread.
* Threaded view - This link/button gives you the ability to change from flat to threaded view on the
fly, rather than changing preferences via your profile page.
* Help - Has some quick and useful information on using bulletin board code etc.
* Rules - This is where people can read the rules of expected conduct on your forum. You can
enable/disable this feature via the admin configuration area, and you insert your own rules by editing
the rules.php file.
D - Boardwalk
This indicates the path you follow while moving through the forum setup, and you can click on the
various links to move back up the path you've traveled. You can also change the word "Boardwalk"
via the forum's language file if you want.
F - Submission details
This line includes the post title and the date/time the post was made.
G - Post body
This area contains the body of the post made. It can contain normal/formatted text, images, file
attachments, and code. After the body of the post you'll find a persons forum signature - if they've
defined one that is.
H - IP address
A poster's address isn't visible to all forum posters - only admins/moderators. It's useful if you need
to track down or take action against unruly posters who may need to be banned/blocked from access
to site. Blocking/banning users is done via the Mambo side of your site - not the Joomlaboard side of
things.
J - Poster details
Depending on what features have been enabled in the administration area, you'll see a variety of
things here - including an avatar, rankname and posts indicator.
L - Subscribe
Click the link/icon to subscribe to the topic you're reading. This will result in emails being sent to your
email account when replies are made to the post.
Depending on what additional components you've got integrated via the Joomlaboard administration
area, you'll also find Karma indicators (used to applaud/smite posters depending on the quality of
their posts), personal messaging icon and links to a person's community builder profile page. Also, if
you have the pro versions of various integrated components, you'll also be able to use additional
messaging icons (ICQ, AIM etc).
A - Forum search
Use this to search through the forum for a specific word or short phrase. eg. click in the box, type a
word or short phrase and press your keyboard's enter key - the search results will appear with
successful results in bold text. Click on the bold text entry, and you'll be taken to that particular post.
If you have no luck finding something on your first try - don't give up. Be less specific and more
general, or try words with a similar meaning.
B - Board title
This is the title of your board, and should probably reflect your site - eg. what your site is about,
theme, content etc. You set this title via the admin configuration area.
C - Main menu
* Home - Clicking on this link takes you to the forum's home page.
* My Profile - Click on this to set up personal preferences for the forum - eg. give yourself an
avatar (little picture) or set a signature that appears at the bottom of every post you make. More on
this later.
* Post reply - You can use this link/button to post a reply to the topic thread, in addition to the reply
links/buttons associated with each post in the thread.
* Flat view - This link/button gives you the ability to change from threaded to flat view on the fly,
rather than changing preferences via your profile page.
* Help - Has some quick and useful information on using bulletin board code etc.
* Rules - This is where people can read the rules of expected conduct on your forum. You can
enable/disable this feature via the admin configuration area, and you insert your own rules by editing
the rules.php file.
D - Boardwalk
This indicates the path you follow while moving through the forum setup, and you can click on the
various links to move back up the path you've traveled. You can also change the word "Boardwalk"
via the forum's language file if you want.
F - Submission details
This line includes the post title and the date/time the post was made.
G - Post body
This area contains the body of the post made. It can contain normal/formatted text, images, file
attachments, and code. After the body of the post you'll find a persons forum signature - if they've
defined one that is.
H - IP address
A poster's address isn't visible to all forum posters - only admins/moderators. It's useful if you need
to track down or take action against unruly posters who may need to be banned/blocked from access
to site. Blocking/banning users is done via the Mambo side of your site - not the Joomlaboard side of
things.
K - Thread relationship
In threaded view, you're able to see how all of the posts are related to each other. This enables you
to follow the thread of a conversation, as there can be multiple themes - particularly within an active
post.
L - Submission details
The 2 columns here contain the author names and time/date for each post within the thread - so you
can see who is replying to whom and when.
M - Subscribe
Click the link/icon to subscribe to the topic you're reading. This will result in emails being sent to your
email account when replies are made to the post.
A - Forum search
Use this to search through the forum for a specific word or short phrase. eg. click in the box, type a
word or short phrase and press your keyboard's enter key - the search results will appear with
successful results in bold text. Click on the bold text entry, and you'll be taken to that particular post.
If you have no luck finding something on your first try - don't give up. Be less specific and more
general, or try words with a similar meaning.
B - Board title
This is the title of your board, and should probably reflect your site - eg. what your site is about,
theme, content etc. You set this title via the admin configuration area.
C - Main menu
* Home - Clicking on this link takes you to the forum's home page.
* My Profile - Click on this to set up personal preferences for the forum - eg. give yourself an
avatar (little picture) or set a signature that appears at the bottom of every post you make. More on
this later.
* Help - Has some quick and useful information on using bulletin board code etc.
* Rules - This is where people can read the rules of expected conduct on your forum. You can
enable/disable this feature via the admin configuration area, and you insert your own rules by editing
the rules.php file.
D - Forum title
When making a new post, this heading simply indicates the name of the forum you're posting to.
E - Name of poster
This text box contains the name of the person making the post. If you have set your forum options to
allow members to change their name, this text box will be editable - otherwise it will be set. Site
admins will be able to change their name regardless of whether this setting allows changes or not.
F - Topic title
This is where you give your post a topic title. Make your topic line appropriate to the content of your
problem. The topic line is essentially a brief summary of the problem, and this is used during the
forum search procedure - so make it relevant, useful and full of keywords! A bad topic is "help me",
good topic lines include:- "missing icon after upgrade", "hacker attempt warning when editing post",
"forum link doesn't work after new installation".
G - Topic icon
You can give your topic a little icon to make it stand out in the crowd. None is selected by default.
To select one, position the mouse pointer in the circle to the left of the icon and click. The little circle
should now have a dark spot in it.
H - Board code
This area really needs an information section all to itself, and the good news is you don't have to use
it to post a message. The buttons will insert "tags" to format text - eg. bold, underline, italics etc,
some will do dot point, and some will enable an image or hyperlink to be inserted. These tags then
have to be closed after the text affected.
I - Text effects
This extends upon board code, and enables you to change the size and colour of your forum
signature.
K - bbCode help
As you move your mouse over the bb code buttons, you'll see a help message flash up in this area to
give you tips on applying bb code to your signature.
M - Smilies
These are the smilies - just click on one or more to insert them into your post. You won't actually see
the smilie in the text box though - it will be represented by things like brackets, colons, semi-colons,
numbers etc. This is "smilie code" - and it will be converted once you look in the preview window or
at the published post. The smilies used with Joomlaboard are transparent png files, which will not
show up as transparent in MS explorer. While this isn't an issue with light template backgrounds, it
can look unsightly on dark templates. Simply edit the smilies and give them dark backgrounds.
N - Image attachments
If you have a photo you want to make available for whatever reason on the forum, use this feature.
Click the browse button to open up a new window showing your computor's file tree. Navigate your
way to the image file, click on it to highlight it, click open, and you will notice the blank area preceding
the browse button now has a local computor path in it - this is where the image file will come from.
All that's left to do is to press the [img] button to the right of the browse button and your file will be
uploaded to the server. Image attachments have certain parameters regarding who can upload, size
and type, and these are set via the admin configuration area. You're also only able to attach one
image, so if you need to display multiple images this can be done by uploading the image to a web
server and then using the bb code to insert the image url's.
O - File attachments
This bit is the same as the photo/image bit - except it's to do with uploading a file - eg. text document.
You follow the same procedure to attach a file as you did to attach an image. There are also
parameters such as who can upload, allowable file types/extensions, as well as file size - and these
can be set via the admin configuration area. You can only upload one file attachment, yet you can
work you way around this by being a little creative. Use the "code" function of bb code to insert code
into your post, or upload the file to a web server and insert a url to it. Alternatively, zip a number of
documents into a single zip file and attach it.
P - Subscribe
If you're posting something important and want to get replies sent to you via email - this is where you
can subscribe to the post at the time of writing - that way you don't miss a thing.
A - Forum search
Use this to search through the forum for a specific word or short phrase. eg. click in the box, type a
word or short phrase and press your keyboard's enter key - the search results will appear with
successful results in bold text. Click on the bold text entry, and you'll be taken to that particular post.
If you have no luck finding something on your first try - don't give up. Be less specific and more
general, or try words with a similar meaning.
B - Board title
This is the title of your board, and should probably reflect your site - eg. what your site is about,
theme, content etc. You set this title via the admin configuration area.
C - Main menu
* Home - Clicking on this link takes you to the forum's home page.
* My Profile - Click on this to set up personal preferences for the forum - eg. give yourself an
avatar (little picture) or set a signature that appears at the bottom of every post you make. More on
this later.
* Help - Has some quick and useful information on using bulletin board code etc.
* Rules - This is where people can read the rules of expected conduct on your forum. You can
enable/disable this feature via the admin configuration area, and you insert your own rules by editing
the rules.php file.
D - Forum title
When making a new post, this heading simply indicates the name of the forum you're posting to.
E - Name of poster
This text box contains the name of the person making the post. If you have set your forum options to
allow members to change their name, this text box will be editable - otherwise it will be set. Site
admins will be able to change their name regardless of whether this setting allows changes or not.
F - Topic title
When replying to an existing post this area already contains the post's topic title.
G - Topic icon
You can give your topic a little icon to make it stand out in the crowd. None is selected by default.
To select one, position the mouse pointer in the circle to the left of the icon and click. The little circle
should now have a dark spot in it.
H - Board code
This area really needs an information section all to itself, and the good news is you don't have to use
it to post a message. The buttons will insert "tags" to format text - eg. bold, underline, italics etc,
some will do dot point, and some will enable an image or hyperlink to be inserted. These tags then
have to be closed after the text affected.
I - Text effects
This extends upon board code, and enables you to change the size and colour of your forum
signature.
K - bbCode help
As you move your mouse over the bb code buttons, you'll see a help message flash up in this area to
give you tips on applying bb code to your signature.
links. The width of this text box can break out of narrow, fixed-width templates - and you can set this
width via the admin configuration area.
M - Smilies
These are the smilies - just click on one or more to insert them into your post. You won't actually see
the smilie in the text box though - it will be represented by things like brackets, colons, semi-colons,
numbers etc. This is "smilie code" - and it will be converted once you look in the preview window or
at the published post. The smilies used with Joomlaboard are transparent png files, which will not
show up as transparent in MS explorer. While this isn't an issue with light template backgrounds, it
can look unsightly on dark templates. Simply edit the smilies and give them dark backgrounds.
N - Image attachments
If you have a photo you want to make available for whatever reason on the forum, use this feature.
Click the browse button to open up a new window showing your computor's file tree. Navigate your
way to the image file, click on it to highlight it, click open, and you will notice the blank area preceding
the browse button now has a local computor path in it - this is where the image file will come from.
All that's left to do is to press the [img] button to the right of the browse button and your file will be
uploaded to the server. Image attachments have certain parameters regarding who can upload, size
and type, and these are set via the admin configuration area. You're also only able to attach one
image, so if you need to display multiple images this can be done by uploading the image to a web
server and then using the bb code to insert the image url's.
O - File attachments
This bit is the same as the photo/image bit - except it's to do with uploading a file - eg. text document.
You follow the same procedure to attach a file as you did to attach an image. There are also
parameters such as who can upload, allowable file types/extensions, as well as file size - and these
can be set via the admin configuration area. You can only upload one file attachment, yet you can
work you way around this by being a little creative. Use the "code" function of bb code to insert code
into your post, or upload the file to a web server and insert a url to it. Alternatively, zip a number of
documents into a single zip file and attach it.
P - Subscribe
If you're posting something important and want to get replies sent to you via email - this is where you
can subscribe to the post at the time of writing - that way you don't miss a thing.
S - Content
If displaying the history of a post has been enabled via the admin configuration area, you'll see
details of the author and content of their post/reply here. The extent of a post's history shown is also
configurable via the admin area, so you can define how far back someone can read when replying to
a post. Having this feature enabled is handy, as some replies can be complex and it's often
necessary to refer back to the post and its history.
A - Forum search
Use this to search through the forum for a specific word or short phrase. eg. click in the box, type a
word or short phrase and press your keyboard's enter key - the search results will appear with
successful results in bold text. Click on the bold text entry, and you'll be taken to that particular post.
If you have no luck finding something on your first try - don't give up. Be less specific and more
general, or try words with a similar meaning.
B - Board title
This is the title of your board, and should probably reflect your site - eg. what your site is about,
theme, content etc. You set this title via the admin configuration area.
C - Main menu
This menu is slightly different to that which appears on other pages.
* Home - Clicking on this link takes you to the forum's home page.
* Help - Has some quick and useful information on using bulletin board code etc.
* Rules - This is where people can read the rules of expected conduct on your forum. You can
enable/disable this feature via the admin configuration area, and you insert your own rules by editing
the rules.php file.
D - Profile title
This is the name of the member a profile page relates to.
G - Signature length
This is the allowable length a signature can be. The length is set via the admin configuration area.
H - Countdown box
When typing in the signature, you'll see a countdown to indicate how many characters are left in the
allowable length.
K - Text effects
This extends upon board code, and enables you to change the size and colour of your forum
signature.
L - bbCode help
As you move your mouse over the bb code buttons, you'll see a help message flash up in this area to
give you tips on applying bb code to your signature.
O - Your avatar
Another way to give yourself an "online personality" is the avatar - a pictorial representation of you -
and this is where a member's current avatar would be displayed. Avatars tend to be subject to
certain guidelines, and you can set height, width and KB size parameters via the Joomlaboard
configuration area. For more on avatars, see the section that deals with selecting an avatar.
R - Submit button
Once you've made various changes to your forum profile (eg. removing an avatar, updating your
signature), you need to press the submit button for these changes to take effect.
S - Subscription list
If you subscribe to certain forum posts to receive email notifications, this is where you'll find a list of
subscriptions. As they become irrelevant with time, you can unsubscribe from a post by clicking its
corresponding unsubscribe link.
T - Moderator notifications
If you have moderator status, this is where you'll see a list of forums you're responsible for. As a site
super admin, you'll automatically have moderator status on all forums - so you won't actually see a
list.
When you click on the select new avatar link in the Joomlaboard forum profile area, you'll come to a
page that looks a little like the one below. This is where you either select an avatar of your own to
upload (if that function has been enabled), or you select an avatar from those available in the gallery.
1. This is your first option in choosing an avatar - upload one of your own.
2. If you choose to upload your own avatar, the path to your image file on your local computor will
show here. You don't need to type anything in this area.
3. This is the image upload button. Once you find an image on your local computer using the
browse button (see next bit), you click this button to send it to the server.
4. Click this button to browse through your local computor files for an image to upload.
5. This is your second option in choosing an avatar - select one from what's already available.
6. If you'd rather use one of the avatars already on the system, click in the little circle to the right of
the image - a dark spot should appear.
7. Once you're done choosing - click this button to confirm your choice.
To use your own avatar, you'd click the browse button shown in the image under avatar selection.
Clicking the browse button will open up your local computor screen as shown in the small image here.
It's then just a matter of browsing through your files until you find the image you want.
1. This is my avatar's image file on my local computor. I've highlighted it by clicking on it once.
The little information box that has appeared gives me the image file's dimensions, type and size -
which allows me to determine if it's the right size and type.
2. Once selected (highlighted), the file name will appear here.
3. This area shows the allowed file types.
4. Press the "open" button to take the next step in uploading your avatar to the web server, or press
cancel to exit the process.
1. Once you press the "open" button described above, you can see part of the avatar's path on your
local computor. This is where the your avatar's image file will be uploaded from.
2. All you have to do now is press the "upload" button and wait for the computor to upload the
image, and then tell you it's finished.
3. Once the image upload has finished, this is the message you will get (see below).
OK, so you've typed something and you really want the next bit to stick out. In this example I've
typed "this is" followed by a space, and then I clicked the "B" button - and you can now see [b] has
appeared after the text and the "B" button now has an asterisk on it. You've successfully opened the
"bold" tag.
Now you just have to type in the text you want to stand out with bold - in this case I've typed "just a
test". Then I've clicked the "B" button again - the asterisk disappears, and after my text you can now
see [/b]. This has closed the "bold" tag, and we're done.
Looking at it in the preview window, you can now see the normal text I typed in at the beginning, and
it is followed by the text I enclosed in "bold" tags.
OK, so you've typed something and you'd like to give the next bit you say some emphasis. In this
example I've typed "this is" followed by a space, and then I clicked the "i" button - and you can now
see [i] has appeared after the text and the "i" button now has an asterisk on it. You've successfully
opened the "italics" tag.
Now you just have to type in the text you want to give some emphasis to - in this case I've typed "just
a test". Then I've clicked the "i" button again - the asterisk disappears, and after my text you can now
see [/i]. This has closed the "italics" tag, and we're done.
Looking at it in the preview window, you can now see the normal text I typed in at the beginning, and
it is followed by the text I enclosed in the "italics" tags.
OK, so you've typed something and now you've got a list you want to rattle off. How about the good
old dot point format? In this example I've typed "how about lists with dots?", hit enter a couple of
times, and then I clicked the "li" button - and you can now see [li] has appeared at the beginning of
the line, and the "li" button now has an asterisk on it. You've successfully opened the "list" tag.
Now you just have to type in the text you want to make a point out of - in this case I've typed "this is
one". Then I've clicked the "li" button again - the asterisk disappears, and after my text you can now
see [/li]. This has closed the "list" tag, and we're done with the first point in our list.
Press the enter key to go to the next line, and repeat the process of opening and closing the "list" tag
around the second and subsequent points you want to make and you're done.
Looking at it in the preview window, you can now see the normal text I typed on the first line, and it is
followed by the two points I made enclosed in "list" tags - they now have dots in front of them.
You've been discussing this and that in the forum, and you know of a really good web site relevant to
the discussion. So, let's give your readers a working hyperlink to click on so they can go and see
what you mean. In this example I've typed "what about putting in web links?" and pressed the enter
key a few times. I clicked the "URL" button - and you can now see [url] has appeared at the
beginning of the line, and the "URL" button now has an asterisk on it. You've successfully opened the
"url" tag.
Now you just have to type in the web address - in this case I've typed my other website "http://www.
pixelbunyip.com". Then I've clicked the "URL" button again - the asterisk disappears, and after my
web address you can now see [/url]. This has closed the "url" tag, and we're done. This is the quick
and easy way to insert a hyperlink, and it will just show up as a url. To insert a hyperlinked word or
phrase requires a slightly different technique. Simply open up the "URL" tag, type in the text to be
hyperlinked, then close the "URL" tag. Once you've done that, insert the url into the tag so that it
looks something like this:- [url=http://www.yourdomain.com]YourLinkText[/url]
Looking at it in the preview window, you can now see the normal text I typed in at the beginning, and
on the line below is the hyperlink. Move your cursor over it and you'll see it's active - so you can click
on it and a new window to that address will open.
Notes on Moderation
1. Moderator are assigned by the site admins and their work from the frontend. It is not possible to
moderate your forums from the backend of the Joomla System.
2. Moderators don't need access to the backend of your Joomla installation!
3. Site administrations are always moderators and have full moderator privileges.
About Moderators
Moderators are people with the privileges to delete,edit,move,stick and lock topics,they can also
delete and edit messages. The site admin can ssign moderators to forums (not categories). These
moderators then have extended privileges on those forums only. They will be regular users on other
forums!
To make someone a moderator the administrator must flag a registered user with a JB Forum profile
as a Moderator. In order to do this: go to Components->Joomlaboard Forum->User Administration. In
here, search for the person you want to make moderator and open his or her profile. Set the "Is
Moderator" flag to 'Yes' and save the profile. You can now select this person as a Moderator when
assigning Moderators to a Forum.
Now click the 'New' button, to assign a new Moderator. A window with a list of all available
Moderators will be opened. Choose one or more Moderators and Publish them by clicking the
'Publish' button.
Remove Moderators
In either window where the Moderators are shown, there is an 'Unpublish' button. Select the
Moderator(s) you want to remove from the list and click 'Unpublish'... that's all!
Email Moderators
In the Joomlaboard Configuration, the Site Admin can specify that Moderators should receive email
notifications upon new post to the forum they are assigned to.
Please note: Although Site admins have full Moderator privileges by default, they will not receive
email notifications upon new post by default. You will have to explicitly add them as Moderator to a
Forum to have them receiving emails notifications too. This is to prevent a flood of emails to admins
on busy forums.
Post review give you extra control over Joomlaboard, as it allows you to review all posts before they
are published. Open Components->Joomlaboard Forum->Forum Administration. Click on the forum
name, and open the Advanced Tab. The last item is where you define whether or not you want posts
reviewed prior to publishing. Set to "yes" to enable the Review Posts feature, and then click the save
button.
Now, login and go to your forum's entry page where the categories/forums are listed. You'll see an
indicator next to the forum that has the review feature activated. When new posts are awaiting
review, a red text notice will appear below the forum description. Go into the forum, and click the
"pending messages" link/button. Review the post, and then either approve it or delete it.
4 Administration Guide
This is the new Joomlaboard Administrator's Manual, and it's written for use with Joomlaboard 1.1.5
and above. It has been updated since it's original publication for Simpleboard and now provides up
to date information regarding the joomlaboard backend. I'd like to take the chance to thank the
previous author for her excellent work on this document: Splendid work Pixelbunnyip!
While all care has been taken in the development and writing of this manual, mistakes can happen. If
you find an error please notify the team of it.
Joomlaboard Configuration
The configuration area determines the parameters within which your forum functions - what its
limitations are (eg. file sizes, post history), who can access it (public/registered), what it looks like
(templates, widths, smilies etc), access to various features (eg. ranks, RSS feed, rules), integration
with other Joomla! components (eg. PMS, Community Builder) etc. You need to work your way right
through the configuration area - and read everything!
Forum Administration
This is where you define the categories for your forums, the forums that go into these categories, as
well as moderator privileges for each of the forums.
User Administration
While you probably won't need to do much with the user administration area, it is a handy little spot if
you've got members with unacceptable signature tags. You can't block/ban member postings from
this area though - you need to use Joomla's member management for this.
Prune Forums
Use this area to do a bit of "spring cleaning". With time, a busy forum will have a very large
database - and much of it may be insignificant. A database with lots of information will also slow
down forum performance, so pruning is helpful.
Prune Users
As registered users on your Joomla! site come and go, it's necessary to prune your forum list to
Support Website
This is where you can donate to TSMF - to help with continued development of the only fully
integrated forum solution for Joomla!.
Forum Offline:
Set to "Yes" if you want to take the Forum section offline, eg. when performing maintenance or
upgrades. The forum will remain browsable by site (super)admins, but you must be logged into the
front-end of your site in order to do this.
Show History:
Set to "Yes" if you want the topic history shown when a reply/quote is made. When deciding whether
or not to show the history of a post, remember it's sometimes good to have a little something to refer
to when formulating a reply.
History Limit:
Number of posts to show in the history. When deciding on the number of posts to show in the history,
consider how much information from previous posts may be required when formulating a reply.
"New" indicator:
Define here what should be used to indicate new posts (like an "!" or "New!"). If using icons, this
indicator will be replaced by a graphic.
Disable emoticons:
Set to "Yes" to completely disable graphic emoticons (smileys).
Template:
Choose the template you want to use on your forum here. The template you choose affects the page
layout when viewing the content of a post - it does not affect the entire forum layout. The templates
used by this setting are kept here:- components/com_joomlaboard/template/ .
If set to "Yes" a selector will be shown on the forum pages that allow for a quick jump to another
forum or category.
User Related
Username:
Set to "Yes" if you want the username (as in login) to be used instead of the users real name.
Require Email:
Require an email address when users or visitors make a post. Set to "No" if you want this feature to
be skipped on the front-end. Posters will not be asked for their email address.
Show Email:
Set to "No" if you never want to display the users email address; not even to registered users. If you
choose to show emails, your users will be vulnerable to spam bots, as Mambo's standard email
cloaking is limited to content items.
User Edits:
Set to "Yes" to allow registered Users to edit their own posts.
Allow Subscriptions:
Set to "Yes" if you want to allow registered users to subscribe to a topic and receive email
notifications on new posts.
Public Read/Write:
Set to "Yes" to allow for public write privileges, Set to "No" to allow any visitor to see posts, but only
registered users to write posts. This setting works in conjunction with the Registered Users Only
setting
Flood Protection:
The amount of seconds a user has to wait between two consecutive post. Set to 0 (zero) to turn
Flood Protection off. NOTE: Flood Protection can cause degradation of performance, and is usually
only necessary if allowing unregistered users to post on a forum.
Email Moderators:
Set to "Yes" if you want email notifications on new posts sent to the forum moderator(s). Note:
although every (super)administrator has automatically all Moderator privileges, you must assign them
explicitly as moderators on the forum to receive emails too!
Allow Avatars:
Set to "Yes" if you want registered users to have an avatar. They are able to manage this feature via
their profile settings in the forum's front-end.
Images
Allow Public Upload for Images:
Set to "Yes" if you want everybody (public) to be able to upload an image. Allowing the public to
upload images opens your forum up to potential abuse though.
Files
Allow File Upload for Public:
Set to "Yes" if you want everybody (public) to be able to upload a file.
The catid is the category in which the Content Item can be discussed. To find the proper catid, just
look into the forums and check the category id from the URLs from your browsers status bar.
An easier way is to just have a look at the "Show bot Reference Chart". This will give you the correct
mosbot tag for each forum.
Click the "New" button to make a new category/forum. You must make a category first - then make a
forum to go into the category.
Basics Tab
Parent:
This is a drop-down box that allows you to choose an existing category name for a forum, or to define
a new "Top Level Category" for putting forums in at a later stage.
Name:
Enter the name of your category or forum here.
Description:
Enter the description of your category or forum here. This information appears in your forum's front
end, so it should be descriptive - to enable people to choose the correct category/forum to read and
post in.
Advanced Tab
Locked:
Set to "Yes" if you want to lock this forum. Nobody, except Moderators and Admins can create new
topics or replies in a locked forum (or move posts to it).
Review Posts:
Set to "Yes" if you want posts to be reviewed by Moderators prior to publishing them in this forum.
This is useful in a Moderated forum only! If you set this without any Moderators specified, the Site
Admin is solely responsible for approving/deleting submitted posts as these will be kept 'on hold'!
Moderation Tab
Moderated:
Set to "Yes" if you want to be able to assign Moderators to this forum.
Note: This doesn't mean that new posts must be reviewed prior to publishing them to the forum! You
will need to set the "Review" option for that on the advanced tab.
Please do note: After setting Moderation to "Yes" you must save the forum configuration first before
you will be able to add Moderators using the new button.
Click the "New Moderator" icon in the top right hand corner and assign moderator privileges to those
you wish to.
You probably won't need to use this area very often, but it does give you an overview of who has
Moderator privileges, their preferred view type (which may be useful to determine the default view
type), and individual signatures used. As mentioned previously, the ability to edit/delete user sigs
from the Admin interface may prove useful if members use inappropriate links or images in their
signature.
The user manager also enables you to sort profiles based on various parameters - user id, moderator
status, or user name - again handy for finding who you want.
Left-click to view the full-size image and right-click to open up the save options. Information
associated with each image includes its file name, size (in bytes), dimensions, and whether there is
an associated post - this bit is important if you've pruned the forum posts - because some images
may no longer have an associated post and can therefore be removed safely. There are also other
options here - remove the image entirely, or replace the image with a "dummy" - useful if you don't
want to affect the post, yet want to let posters know there was an image there that has been removed.
While you can edit and save the CSS file - this file must be Writable to save any changes. If the file
isn't Writable, FTP into your site or use JoomlaXplorer. A chmod of 666 will usually work without
introducing the security issues associated with executable files.
This does not remove topics with the sticky bit set or which are explicitly locked - these must be
removed manually. Threads in locked forums can not be pruned either.
When deciding how many days to specify for the pruning process - consider this:
* The smaller the number of days - the more aggressive the pruning.
* The larger the number of days - the less you will be removing from your forum.
5 Install Guide
This article will guide you true the easy installation process of joomlaboard. It was based on
instructions originally posted in the joomla forums by eyezberg.
The first thing you need to do, is download the latest version of the joomlaboard component from our
repository. Now log into your joomla site's admin, go to "installers/component", browse to the
downloaded zip, hit the button to upload and install.
Hopefully all went well and your forum is now installed, if not check our forums for any existing
problems or post a new help request.
To make your forum accessible to your visitors you will need to create a menu item, linking to
joomlaboard. Go to the "Menu" menu and select mainmenu. Create a new link, select
"Component" (not "Link-Component Item"), enter a name, select Joomlaboard Forum as the
component and press save.
That's it you've installed and configured joomlaboard, now quickly go and test it ;-).
----------------------
Original post from here:
http://forum.joomla.org/index.php/topic,25409.msg147493.html#msg147493
6 Upgrade Guide
Legend
[optional] Means this step is optional to perform; We did but you don't have to.
[optional] Means this step is optional to perform, but recommended by tsmf.
[required] Means this step is required to upgrade joomlaboard.
<joomlaboard-dir> The path to joomlaboard: <joomla-root-dir>/components/com_joomlaboard
Instructions
1. [optional] Create a static content item with an explanation why the forum is down.
2. [optional] Create a link to this content item with the same name as the link to your forums.
3. [optional] Publish the link to the content item and unpublish the one to your forums.
4. [optional] Switch your forum offline in the joomlaboard configuration.
5. [optional] Backup <you_prefix>_sb_* tables, make sure you backup both data AND structure.
6. [optional] Backup any custom templates (they're in <joomlaboard-dir>/templates)
7. [optional] Backup any custom emoticons (they're in <joomlaboard-dir>/emoticons)
8. [optional] Backup your custom rules.php (in <joomlaboard-dir>)
9. [optional] Backup user avatars (they're in <joomlaboard-dir>/avatars)
10. [optional] Backup user uploads (they're in <joomlaboard-dir>/uploaded)
11. [required] Uninstall Joomlaboard via the joomla! backend
12. [required] Install the new version of joomlaboard
13. [optional] Restore user uploads & avatars
14. [optional] Restore your rules.php
15. [optional] Restore any custom emoticons by placing them back in the correct directory
16. [optional] Restore any custom templates by placing them back in the correct directory
17. [optional] Create a new forum menu item for the Main Menu and publish it.
-- It's recommended to create a new menu item, since the internal itemid will have changed
(needed for the 'pathway' functionality and template assignment processes in Joomla)
18. [optional] Unpublish the menu link to the static content article.
7 Joomlaboard FAQs
I created a Forum but I don't see a 'create new topic' link
You probably only created a Category. Categories are 'containers' for Forums and only in a Forum
you can create a new Topic.
A Category can contain multiple Forums and a Forum can contain multiple Topics.
A Category is created by selecting the 'Top Level Category' value as its Parent.
A Forum is created by selecting a Category as its Parent.
Icons are provided by an icon packs provided by artists in the joomla community, you can find some
of them on the joomla extensions website. After picking one to your liking, you can install it as a
module via the backend of your joomla installation. There is no need to publish them, joomlaboard
will detect and use them automatically. Please note that you should uninstall an icon pack before
installing a new one.