What is BBCode? BBCode is a special implementation of HTML. Whether you can actually use BBCode in your posts on the forum is determined by the administrator. In addition you can disable BBCode on a per post basis via the posting form. BBCode itself is similar in style to HTML, tags are enclosed in square braces [ and ] rather than < and > and it offers greater control over what and how something is displayed. Depending on the template you are using you may find adding BBCode to your posts is made much easier through a clickable interface above the message area on the posting form. Even with this you may find the following guide useful. Back to top
Text Formatting
How to create bold, italic and underlined text BBCode includes tags to allow you to quickly change the basic style of your text. This is achieved in the following ways:
To make a piece of text bold enclose it in [b][/b], eg.
How to change the text colour or size To alter the color or size of your text the following tags can be used. Keep in mind that how the output appears will depend on the viewers browser and system:
Changing the colour of text is achieved by wrapping it in [color=][/color]. You can specify either a recognised colour name (eg. red, blue, yellow, etc.) or the hexadecimal triplet alternative, eg. #FFFFFF, #000000. For example, to create red text you could use:
[color=red]Hello![/color]
or
[color=#FF0000]Hello![/color]
will both output Hello!
Changing the text size is achieved in a similar way using [size=][/size]. This tag is dependent on the template you are using but the recommended format is a numerical value representing the text size in pixels, starting at 1 (so tiny you will not see it) through to 29 (very large). For example:
Can I combine formatting tags? Yes, of course you can, for example to get someones attention you may write:
[size=18][color=red][b]LOOK AT ME![/b][/color][/size]
this would output LOOK AT ME!
We don't recommend you output lots of text that looks like this though! Remember it is up to you, the poster to ensure tags are closed correctly. For example the following is incorrect:
Quoting text in replies There are two ways you can quote text, with a reference or without.
When you utilise the Quote function to reply to a post on the board you should notice that the post text is added to the message window enclosed in a [quote=""][/quote] block. This method allows you to quote with a reference to a person or whatever else you choose to put! For example to quote a piece of text Mr. Blobby wrote you would enter:
[quote="Mr. Blobby"]The text Mr. Blobby wrote would go here[/quote]
The resulting output will automatically add, Mr. Blobby wrote: before the actual text. Remember you must include the parenthesis "" around the name you are quoting, they are not optional.
The second method allows you to blindly quote something. To utilise this enclose the text in [quote][/quote] tags. When you view the message it will simply show, Quote: before the text itself.
Outputting code or fixed width data If you want to output a piece of code or in fact anything that requires a fixed width, eg. Courier type font you should enclose the text in [code][/code] tags, eg.
[code]echo "This is some code";[/code]
All formatting used within [code][/code] tags is retained when you later view it. Back to top
Generating lists
Creating an Un-ordered list BBCode supports two types of lists, unordered and ordered. They are essentially the same as their HTML equivalents. An unordered list ouputs each item in your list sequentially one after the other indenting each with a bullet character. To create an unordered list you use [list][/list] and define each item within the list using [*]. For example to list your favorite colours you could use:
Creating an Ordered list The second type of list, an ordered list gives you control over what is output before each item. To create an ordered list you use [list=1][/list] to create a numbered list or alternatively [list=a][/list] for an alphabetical list. As with the unordered list items are specified using [*]. For example:
[list=1] [*]Go to the shops [*]Buy a new computer [*]Swear at computer when it crashes [/list]
will generate the following:
Go to the shops
Buy a new computer
Swear at computer when it crashes
Whereas for an alphabetical list you would use:
[list=a] [*]The first possible answer [*]The second possible answer [*]The third possible answer [/list]
Linking to another site phpBB BBCode supports a number of ways of creating URIs, Uniform Resource Indicators better known as URLs.
The first of these uses the [url=][/url] tag, whatever you type after the = sign will cause the contents of that tag to act as a URL. For example to link to phpBB.com you could use:
[url=http://www.phpbb.com/]Visit phpBB![/url]
This would generate the following link, Visit phpBB! You will notice the link opens in a new window so the user can continue browsing the forums if they wish.
If you want the URL itself displayed as the link you can do this by simply using:
Additionally phpBB features something called Magic Links, this will turn any syntatically correct URL into a link without you needing to specify any tags or even the leading http://. For example typing www.phpbb.com into your message will automatically lead to www.phpbb.com being output when you view the message.
The same thing applies equally to email addresses, you can either specify an address explicitly for example:
[email]no.one@domain.adr[/email]
which will output no.one@domain.adr or you can just type no.one@domain.adr into your message and it will be automatically converted when you view.
As with all the BBCode tags you can wrap URLs around any of the other tags such as [img][/img] (see next entry), [b][/b], etc. As with the formatting tags it is up to you to ensure the correct open and close order is following, for example:
is not correct which may lead to your post being deleted so take care. Back to top
Showing images in posts
Adding an image to a post phpBB BBCode incorporates a tag for including images in your posts. Two very important things to remember when using this tag are; many users do not appreciate lots of images being shown in posts and secondly the image you display must already be available on the internet (it cannot exist only on your computer for example, unless you run a webserver!). There is currently no way of storing images locally with phpBB (all these issues are expected to be addressed in the next release of phpBB). To display an image you must surround the URL pointing to the image with [img][/img] tags. For example:
Can I add my own tags? No, I am afraid not directly in phpBB 2.0. We are looking at offering customisable BBCode tags for the next major version Back to top
Advanced BBCode Features
Font Types and Custom CSS Classes
Use the font type buttons to wrap highlighted text, or to toggle between open/closed tags if no text is selected. Any previously declared CSS class that is valid for inline elements can be used. As a general rule anything to do with positioning or padding/margin (on the top/bottom) will not apply. Also note that the display and visibilty properties have been overidden and are not allowed. Multiple classes can be applied at one time, seperating with a space in the same syntax as used in html
[class="palatino uppercase"]Lorem ipsum dolor sit[/class]
Lorem ipsum dolor sit
Important: If selecting text to wrap in a custom class, first enter the class (or classes) in the text box (that defaults to the "uppercase" class) then highlight the desired text and click "CSS CLASS". If you select the desired text first, some browsers may overwrite the selected text.
[class="overline"]Lorem ipsum dolor sit[/class] [class="line-through"]Lorem ipsum dolor sit[/class] [class="underline"]Lorem ipsum dolor sit[/class] [class="small-caps"]Lorem ipsum dolor sit[/class] [class="uppercase"]lorem ipsum dolor sit[/class] [class="lowercase"]LOREM IPSUM DOLOR SIT[/class] [class="smaller"]Lorem ipsum dolor sit[/class] [class="larger"]Lorem ipsum dolor sit[/class]
[class="arialblack"]Lorem ipsum dolor sit[/class] [class="centurygothic"]Lorem ipsum dolor sit[/class] [class="comicsans"]Lorem ipsum dolor sit[/class] [class="couriernew"]Lorem ipsum dolor sit[/class] [class="georgia"]Lorem ipsum dolor sit[/class] [class="impact"]Lorem ipsum dolor sit[/class] [class="lucidac"]Lorem ipsum dolor sit[/class] [class="lucidau"]Lorem ipsum dolor sit[/class] [class="palatino"]Lorem ipsum dolor sit[/class] [class="tahoma"]Lorem ipsum dolor sit[/class] [class="trebuchet"]Lorem ipsum dolor sit[/class] [class="verdana"]Lorem ipsum dolor sit[/class]
Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit
Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit
Most importantly, DO NOT use the embed code provided by YouTube. All that is required is the URL to the video, and both the standard and shorturl versions are supported
Note that the YouTube video ID is always 11 characters, and make sure to exclude any additional info that appears in the URL after that (such as &related= etc).
To embed a video with default options, simply wrap the YouTube URL in [youtube][/youtube]
Most importantly, DO NOT use the embed code provided by the Internet Archive. All that is required is the URL to the audio or video, and both the detail and/or embed URL's are supported
Use the color swatch buttons to wrap highlighted text, or to toggle between open/closed color tags if no text is selected. To use custom colors, either choose a hex color code or use the javascript color picker
[class="color1"]Lorem ipsum dolor sit[/class] [class="color2"]Lorem ipsum dolor sit[/class] [class="color3"]Lorem ipsum dolor sit[/class] [class="color4"]Lorem ipsum dolor sit[/class] [class="color5"]Lorem ipsum dolor sit[/class] [class="color6"]Lorem ipsum dolor sit[/class] [class="color7"]Lorem ipsum dolor sit[/class] [class="color8"]Lorem ipsum dolor sit[/class] [class="color9"]Lorem ipsum dolor sit[/class] [class="color10"]Lorem ipsum dolor sit[/class] [class="color11"]Lorem ipsum dolor sit[/class] [class="color12"]Lorem ipsum dolor sit[/class] [class="color13"]Lorem ipsum dolor sit[/class] [class="color14"]Lorem ipsum dolor sit[/class]
Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit Lorem ipsum dolor sit
Use the simple wizard within the ABBC editor to help choose which type of code tags to deploy. After you have selected your options, hit the code button, which will either wrap highlighted text, or toggle between open/closed code (or pre) tags if no text is selected.
Inserting Generic Code
Generic code snippets can be inserted in the same method that has been used for years, by simply wrapping your code in [code] tags
[code]your generic code here[/code]
Language Specific Snippets
Language specific snippets can be inserted via the [pre=language] tags
16 languages are supported by default, although over 40 languages can be used if required by an individual site. Please refer to the drop-down menu on the posting page to determine which languages are actually supported. The basic 16 valid classes are: apache, bash, cpp, cs, css, diff, html, ini, java, javascript, perl, php, python, ruby, sql, xml
Declaring a language with code tags is NOT supported, and the opposite is true of pre tags as a language MUST be declared. Also, do NOT wrap the language in quotes.