CodeColorer

1. 01Download and unpack plugin files to wp-content/plugins/codecolorer directory.
2. 02Enable CodeColorer plugin on your Plugins page in Site Admin .
3. 03Go to the Settings > CodeColorer page in Site Admin and change the plugin options as you wish.
4. 04Use [cc lang="lang"]code[/cc] or <code lang="lang">code</code> syntax to insert a code snippet into the post (you can skip lang="lang" if you want a plain CodeColorer block without syntax highlighting). You can also use [cci lang="lang"]code[/cci] to format inline code (see the “inline” option description).
5. 05Have fun!

Syntax

To insert a code snippet into your post (or comment) you can use [cc lang="lang"]code[/cc] or <code lang="lang">code</code> syntax. Starting from version 0.6.0 you can specify additional CodeColorer options inside the [cc] tag:

[cc lang="php" tab_size="2" lines="40"] // some code [/cc]

Note: You should always use double quotes or single quotes around the parameter value. Boolean values could be passed using string true or false , on or off , number 1 or 0 .

Shortcodes

Starting from CodeColorer 0.8.6 you can use shortcodes to insert code snippets. The general form looks like [ccM_LANG] , where LANG is your programming language, and M is one or more of the following modes:

1. 06i – inline
2. 07e – escaped
3. 08s – strict
4. 09n – line_numbers
5. 10b – no_border
6. 11w – no_wrap
7. 12l – no_links

Small letter means enabled , capital – disabled . Examples:

PHP code with links enabled and line numbers disabled:

[cclN_php] echo "hello" [/cclN_php]

Already escaped HTML code:

[ccie_html]&lt;html&gt;[/ccie_html]

Ruby code without wrapping having tab size equal to 4:

[ccW_ruby tab_size="4"] attr_accessor :title [/ccW_ruby]

More examples could be found on the CodeColorer Examples page. You can find modes explained below.

Possible parameters

1. 13lang ( string ) – source language.
2. 14tab_size ( integer ) – how many spaces would represent TAB symbol.
3. 15lines ( integer ) – how many lines would be block height without scroll; could be set to -1 to remove vertical scrollbar.
4. 16width ( integer or string ) – block width.
5. 17height ( integer or string ) – height in pixels; used when the number of lines is greater than the “lines” value.
6. 18rss_width ( integer or string ) – block width in RSS feeds.
7. 19theme ( string ) – color theme (default, blackboard, dawn, mac-classic, twitlight, vibrant, geshi, railscasts, solarized-light, solarized-dark).
8. 20first_line ( integer ) – a number of the first line in the block.
9. 21highlight ( string ) — a comma-separated list of line numbers or ranges of line numbers to highlight (e.g. 1,5,8-11 ).
10. 22escaped ( boolean ) – when true special HTML sequences like &lt; or &#91; will be treated as encoded (in this example as < and [ respectively.)
11. 23line_numbers ( boolean ) – when true line numbers will be added.
12. 24no_links ( boolean ) – when false keywords will be represented as links to manual.
13. 25inline ( boolean ) – when true forces code block to render inside “`. Used to paste a single line of code into the regular text.
14. 26strict ( boolean ) – when true strict mode will be enabled. By default CodeColorer tries to guess whether strict mode is needed, so this option allows to force it on or off when automatic suggestion is wrong.
15. 27nowrap ( boolean ) – when false no horizontal scrollbar will be shown; instead code will be wrapped in the end of code box.
16. 28noborder ( boolean ) – when true no border will be shown around the code block.
17. 29no_cc ( boolean ) – when true the syntax in code block will not be highlighted, code will be rendered inside ` `` tag.
18. 30class ( string ) – additional CSS classes to add to the wrapper HTML element.
19. 31file ( string ) — when specified, code will be loaded from external file. Should be a relative to uploads folder path, only files from uploads are allowed to be embedded.

You can use special tag [cci] instead of [cc] to force inline mode:

[cci lang="php"]some code[/cci]

Most of these parameters could be configured via the CodeColorer options page.

To insert an example of CodeColorer shortcodes you can use something like this:

[cce_bash] &amp;#91;cc lang="html"] <title>CodeColorer short code colorized</title> &amp;#91;/cc] [/cce_bash]