Title: Prism Syntax Highlighter (detached)
Author: apfelbox
Published: <strong>September 4, 2012</strong>
Last modified: July 30, 2013

---

Search plugins

![](https://ps.w.org/prism-detached/assets/banner-772x250.png?rev=594348)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/prism-detached_090c0c.svg)

# Prism Syntax Highlighter (detached)

 By [apfelbox](https://profiles.wordpress.org/apfelbox/)

[Download](https://downloads.wordpress.org/plugin/prism-detached.1.5.zip)

 * [Details](https://pirate.wordpress.org/plugins/prism-detached/#description)
 * [Reviews](https://pirate.wordpress.org/plugins/prism-detached/#reviews)
 *  [Installation](https://pirate.wordpress.org/plugins/prism-detached/#installation)
 * [Development](https://pirate.wordpress.org/plugins/prism-detached/#developers)

 [Support](https://wordpress.org/support/plugin/prism-detached/)

## Description

Integrates the [Prism Syntax Highlighting Library](https://github.com/LeaVerou/prism)
in WordPress.

It is called _detached_, since the code examples are not stuffed into the rich text
editor, together with all the
 other texts and content, but they are added separately
as custom fields and just referenced via short tags (like footnotes).

Check _Other Notes_ for usage documentation.

The official development repository is [hosted on Github](https://github.com/apfelbox/Prism-Detached).

### Usage

The basic procedure is:

 1. Create a custom field and paste the code into it.
 2. Insert the `[prism ...]` shorttag in your code, where you want the code block to
    appear.

#### Shorttag

    ```
    [prism key=".." language=".." line=".." line_offset=".." post=".."]
    ```

 * `key`: the name of the custom field, which contains the code (**required**)
 * `language`: the language to highlight
 * `line`: highlighted lines (for syntax, check the [offical docs](http://prismjs.com/plugins/line-highlight/))
 * `line_offset`: the offset, with which the line numbering should start
 * `post`: if you want to include a code piece of another post, you can explicitly
   specify the post id here

#### Cached Assets loader

The plugin includes (from v1.3 on) a cached assets loader, so that all needed assets
are concatenated into
 one js and one css file to minimize the HTTP requests. To
make use of the cached assets loader, just create a directory `/cache/` inside your
plugin directory and make it writable for PHP.

#### Supported languages

Only the ones from the official PrismJS repository

 * bash (Bash Unix Shell)
 * c
 * clike
 * coffeescript
 * cpp (C++)
 * css
 * groovy
 * java
 * javascript
 * markup (like: xHTML, MathML, SVG, LaTeX, RSS, XML, OWL, etc.)
 * php
 * python
 * scss (Sassy CSS)
 * sql

#### Creating Custom Extensions

Please read the wiki page: [Creating A Custom Extension](https://github.com/apfelbox/Prism-Detached/wiki/Creating-A-Custom-Extension).

## Screenshots

 * [[
 * Add the code as custom field and reference it in the rich text editor via shortcode.
 * [[
 * Code highlighting in the frontend
 * [[
 * You can also specify some lines, which should be marked
 * [[
 * Code highlighting with marked lines in the frontend
 * [[
 * Plugin options screen

## Installation

 1. Upload the files to your `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress

## FAQ

  Why use custom tags?

The (rich text) editor of WordPress is quite good in mangling in manually added 
code. This cannot happen with custom fields.
 Also, I personally, think it is more
user-friendly.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Prism Syntax Highlighter (detached)” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ apfelbox ](https://profiles.wordpress.org/apfelbox/)

[Translate “Prism Syntax Highlighter (detached)” into your language.](https://translate.wordpress.org/projects/wp-plugins/prism-detached)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/prism-detached/), check
out the [SVN repository](https://plugins.svn.wordpress.org/prism-detached/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/prism-detached/)
by [RSS](https://plugins.trac.wordpress.org/log/prism-detached/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.5

 * Updated PrismJS to commit: 07c0f4f6b2
 * Added plugin descriptions
 * Added new plugins: File Highlight, WebPlatform Docs
 * Added language-code descriptions
 * Added new languages: Bash (Unix Shell), C, C-like, Coffeescript, C++, Groovy,
   PHP, Python, Sassy CSS, and SQL
 * Added new themes: Okaida, Tomorrow, Twilight
    ** 1.5 update brought to you by
   JC John Sese Cuneta (http://jcsesecuneta.com) ** thank you!

#### 1.4

 * Fixed a compatibility problem with older PHP versions (< 5.4)

#### 1.3

 * Minor optical updates of the admin interface
 * Refactored nearly complete plugin
 * Added support for generic extensions
 * Added cached assets loader
 * Added support for experimental PHP plugin

#### 1.2

 * Updated the prism library to `34f0bd5247`

#### 1.1

 * Load line-highlight correctly
 * Moved html attributes to the correct tag
 * Fixed wrong asset loading

#### 1.0

 * Initial commit

## Meta

 *  Version **1.5**
 *  Last updated **13 years ago**
 *  Active installations **10+**
 *  WordPress version ** 3.4.0 or higher **
 *  Tested up to **3.5.2**
 *  Language
 * [English (US)](https://wordpress.org/plugins/prism-detached/)
 * Tags
 * [prism](https://pirate.wordpress.org/plugins/tags/prism/)[syntax highlighting](https://pirate.wordpress.org/plugins/tags/syntax-highlighting/)
 *  [Advanced View](https://pirate.wordpress.org/plugins/prism-detached/advanced/)

## Ratings

 4.3 out of 5 stars.

 *  [  3 5-star reviews     ](https://wordpress.org/support/plugin/prism-detached/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/prism-detached/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/prism-detached/reviews/?filter=3)
 *  [  1 2-star review     ](https://wordpress.org/support/plugin/prism-detached/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/prism-detached/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/prism-detached/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/prism-detached/reviews/)

## Contributors

 *   [ apfelbox ](https://profiles.wordpress.org/apfelbox/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/prism-detached/)