Pastacode

Description

With Pastacode, you can easily add code into your posts with the awesome PrismJs coloration library.
You can insert source code into the post editor, from a file, or from webservices like GitHub, Gist, Pastebin, BitBucket or BitBucket snippets. Webservices responses are cached in order to avoid too many HTTP requests.
It also work in comments and bbPress topics and replies.

Don’t worry about posts updates while upgrading codes!

Pastacode allows to enhance your snippets using PrismJs plugins (highlightning lines, link functions…).

7 different color schemes are included, and you can build yours.

Available programming languages:

  • HTML
  • CSS
  • JavaScript
  • PHP
  • C
  • C++
  • Java
  • Sass
  • Python
  • SQL
  • Ruby
  • CoffeeScript
  • Bash
  • Apache config
  • less
  • haml
  • markdown

If you use another syntax highligther plugins, migration scripts are available 🙂

Screenshots

  • View of the Past'a code lightbox
  • Default prismJS color scheme
  • Dark color scheme
  • Coy color scheme
  • Okaidia color scheme
  • Tomorrow color scheme
  • Twilight color scheme
  • Funky color scheme

Installation

  1. Unzip Pastacode into your plugin folder
  2. Go to Pastacode settings, and configure your color scheme and cache expiration
  3. Host your snippets on repositories (or localy)
  4. Editing a post, use Past’a code button to embed your source code into articles

Ajax compatibility

To enable Pastacode on ajax based websites, it need two steps:

  1. Paste this line into your functions.php theme file: add_filter( 'pastacode_ajax', '__return_true' );
  2. After each change on your DOM, you will have to run this javascript function: Prism.highlightAll();

FAQ

For more information, please visit Pastacode Wiki

How to setup a custom cache expiration ?

Paste these lines into your functions.php theme file:
add_filter( ‘option_pastacode_cache_duration’, ‘my_pastacode_cache_duration’ );
function my_pastacode_cache_duration( $duration ) {
$duration = DAY_IN_SECOND*3; // 3 days
return $duration;
}

How define a custom color scheme ?

Paste these lines into your functions.php theme file:
add_action( ‘wp_enqueue_scripts’, ‘custom_enqueue_script’, 11 );
function custom_enqueue_script() {
$urlofmynewscheme = get_stylesheet_directory_uri() . ‘/prism-okaida-willy.css’; //this is an example
wp_deregister_style( ‘prismcss’ );
wp_register_style( ‘prismcss’, $urlofmynewscheme, false, ‘1’, ‘all’ );
}
Get inspired of the default scheme to build your schemes

How to filter supported languages ?

Paste these lines into your functions.php theme file:
//If you just want php, html, css and javascript support
add_filter( ‘pastacode_langs’, ‘_pastacode_langs’ );
function _pastacode_langs( $langs ) {
$langs = array(
‘php’ => ‘PHP’,
‘markup’ => ‘HTML’,
‘css’ => ‘CSS’,
‘javascript’ => ‘JavaScript’, );
return $langs;
}

How to add a new provider ?

Paste these lines into your functions.php theme file:
//Take WordPress SVN, for example
//register a provider
add_filter( ‘pastacode_services’, ‘_pastacode_services’ );
function _pastacode_services( $services ) {
$services[‘wordpress’] = ‘core.svn.wordpress.org’;
return $services;
}

//Define pastabox lightbox inputs
add_action( 'pastacode_fields', '_pastacode_fields' );
function _pastacode_fields( $fields ) { 
    $fields['wordpress'] = array(  // 'wordpress' or 'whatever'
        'classes'     => array( 'wordpress' ), // same value as the key
        'label'       => sprintf( __('File path relative to %s', 'pastacode'), 'https://core.svn.wordpress.org/' ), 
        'placeholder' =>'trunk/wp-config-sample.php', //if placeholder isn't defined, it will be a textarea
        'name'        => 'path_id' //these value return shortcode attribute (path_id, repos, name, user, version)
        );
    $fields['pastacode-lines']['classes'][] = 'wordpress'; // Add ability to select lines
    $fields['pastacode-highlight']['classes'][] = 'wordpress'; // Add ability to highlight somes

    return $fields;
}

//Build the function to retrieve the code
// "pastacode_wordpress" hook name (1st param) = "pastacode_" + "wordpress" or "whatever"
add_action( 'pastacode_wordpress', '_pastacode_wordpress', 10, 2 );
function _pastacode_wordpress( $source, $atts ) {
    extract( $atts );
    if( $path_id ) {
        $req  = wp_sprintf( 'https://core.svn.wordpress.org/%s', str_replace( 'https://core.svn.wordpress.org/', '', $path_id ) );
        $code = wp_remote_get( $req );
        if( ! is_wp_error( $code ) && 200 == wp_remote_retrieve_response_code( $code ) ) {
            $data = wp_remote_retrieve_body( $code );
            $source[ 'url' ]  = $req; //url to view source
            $source[ 'name' ] = basename( $req ); //filename
            $source[ 'code' ] = esc_html( $data ); //the code !!   
            //$source[ 'raw' ] contain raw source code. But there are no raw source code delivered by WordPress SVN             
        }
    }
    return $source;
}

Do not add you root website!! A contributor can add the shortcode to point your “wp-config.php” to read it!!

Reviews

Best plugin to embed code

I’ve been waiting for years for such a plugin! Pastacode is easy to use, well coded and looks gorgeous with any WordPress theme. Keep going!

Great plugins !

I love this plugins it’s great to finaly find an easy to use, syntax highlighter plugin, that works fine !

The great thing about this plugin is the “source management” of the code you add in your article. All my code is hosted on github or gist and the plugin fetch the code, cache it and display on my post. It’s great in order to avoid broken code when you switch to the advanced editor.

Read all 11 reviews

Contributors & Developers

“Pastacode” is open source software. The following people have contributed to this plugin.

Contributors

“Pastacode” has been translated into French. Thank you to the translators for their contributions.

Translate “Pastacode” into your language.

Interested in development?

Browse the code or subscribe to the development log by RSS.

Changelog

2.0

  • 15 december 2016
  • compatibility with WordPress comments
  • normalize withespace in PrismJs
  • hide empty titles in manual snippets
  • codemirror editing improvments
  • hdpi icons
  • TinyMCE smartphone compatibility
  • PrismJS stylesheets and TinyMCE improvments
  • new method to retrieve GitHub snippets (without base 64 encryption)
  • fancy new website for demos
  • fix: resolve bug while old shortcode conversion
  • fix: conflict between manual code and %

1.8

  • 22 august 2016
  • Pastacode preview mode on tinyMCE views

1.7

  • 19 august 2016
  • Pastacode now compatible with bbPress

1.6

  • 27 may 2016
  • CodeMirror is now used for editing manual code on backend
  • manual shortcode improvements (this version will converts old « manual code » shortcodes to new ones. You’re invited to save your database before upgrade).
    This solves problem reported by users with new lines feeds.
  • support Bitbucket snippets as a provider
  • line-numbers css improvements
  • fix bug with empty lines at the end of a snippet.

1.5.1

  • 24 july 2015
  • fix bug of code wrapper not removed support

1.5

  • 23 july 2015
  • API views implementation.
  • fix bug when creating new shortcodes (persistent values)

1.4.2

  • 21 january 2015
  • can target a specific file inside a gist
  • remove prismJS plugin demo file (index.html, inside the plugin rep)

1.4.1

1.4

  • 16 january 2015
  • New feature: you can now edit your manual code into a full screen window
  • update prism.js and prism plugins
  • New option for display code description above or below code

1.3

  • 5 may 2014
  • TinyMCE Editor support improvment (visual placeholder on editor mode, new tinyMCE button…)
  • Github API restriction fallback (support now more than 30 requests / hour)
  • New ajax compatibility (using hook pastacode_ajax)
  • Fix bug: No more disgracefull linebreaks on code view.

1.2.1

  • 21 nov 2013
  • Fix bug: when manual provider is selected, no cache.

1.2

  • 15 oct 2013
  • The modification of the cache duration do not purge cache anymore
  • New button “Purge Cache” in option page, use it to delete all transients (they contains the responded source codes)
  • Fix bug when updating option

1.1

  • 12 oct 2013
  • Hooks, hooks and hooks.
  • Update shortcode format (“type” became “provider”, and add “/” before the closing tag)

1.0

  • 10 oct 2013
  • Initial release
  • Insert codes using a nice lightbox
  • Import codes from file, Github, Gist, Pastebin or BitBucket
  • 13 languages available
  • 6 color schemes
  • Cache support for webservices (default duration: 1 week)