Help & Support

Formatting messages with boxcode

When boxcode is disabled in Posting options, it is only disabled for user messages. You will still be able to use it for your Sticky message and Custom filtering rules.

Cbox supports boxcode, which is a way to add markup to messages. You can also use it to style your Sticky message and Custom filtering replacement text.

The boxcodes supported by Cbox are:

  • [color=#ff0000]hex colour[/color] or [color=forestgreen]named colour[/color]
  • [color=#f00,#ff0]foreground and background[/color]
  • [b]bold text[/b]
  • [u]underlined text[/u]
  • [i]italicized text[/i]
  • [s]struck-out text[/s]
  • [q]quoted text[/q]
  • [sub]subscript[/sub]
  • [sup]superscript[/sup]
  • [center]centered text[/center]
  • [br]
    (line break)
  • [big]larger font[/big]
  • [small]smaller font[/small]
  • [class=custom]custom-styled text[/custom]
  • [code]fixed-width text[/code]
  • [url=http://address.com/hyperlink]link text[/url] or [url]http://address.com/hyperlink[/url]
  • [img=http://address.com/image.jpg]image title[/img] or [img]http://address.com/image.jpg[/img]

Combining boxcode

Besides using boxcode in Custom filtering replacement text, you can also match boxcodes in filter rules. See more.

It's possible to combine boxcode by nesting it, with some caveats:

  1. Tags must be nested in the correct order: [b][u]bold underline[/u][/b] is valid but [b][u]broken[/b][/u] is not.
  2. The same tag cannot be nested. For example, [class=one][class=two]some text[/class][/class] will not work. To get the intended behaviour in this case, you could have a combined class instead: [class=onetwo]some text[/class].
  3. The no-attribute form of [url] (e.g. without link text), and both forms of the [img] tag, must be the innermost element in any nested sequence.

Styling boxcode

Boxcode is translated internally to HTML. You can thus affect the presentation of boxcode by editing your CSS. For example, to change the presentation of the [s] tag:

s {
	text-decoration: none; /* reset default */
	opacity: 0.2;
}

[class] parameters must start with a letter, and are limited to 20 alphanumeric characters. [class=blink] is valid but [class=2] is not.

The [class] boxcode is intended for open-ended styling. It produces a span with no default CSS. You can create a corresponding class using a cc_ prefix. For example, for blurred text, copy this to your CSS:

.cc_blur {
	text-shadow: #000 0 0 0.5em;
	color: transparent;
}

Now users can blur the text in their messages: [class=blur]this will be blurred![/class].

Find out more about custom CSS.

Last updated 3 February 2017

« Support home

Loading...