added gist shortcoder

This commit is contained in:
Kenneth Reitz
2010-03-03 22:07:23 -05:00
parent c6699bca07
commit 9839681eca
3 changed files with 97 additions and 0 deletions
@@ -0,0 +1,3 @@
0.2: Added ability to include text inside gist.
0.1 : First release
@@ -0,0 +1,45 @@
<?php
/*
Plugin Name: GitHub Gist Shortcode
Plugin URI: http://www.entropytheblog.com/blog/2008/12/wordpress-github-gist-shortcode-plugin/
Description: Allows the use of a simple shortcode [gist id="12345"] to embed <a href="http://gist.github.com">GitHub Gists</a> in a post or page.
Version: 0.2
Author: Paul William
Author URI: http://www.entropytheblog.com/blog/
Copyright 2008 Paul William
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
// [gist id="gist-id-number"]
function gist_shortcode_func($atts, $content = null) {
extract(shortcode_atts(array(
'id' => '30948'
), $atts));
$html = "<script src=\"http://gist.github.com/".trim($id).".js\"></script>";
if($content != null){
$html = $html."<noscript><code class=\"gist\"><pre>".$content."</pre></code></noscript>";
}
return $html;
}
add_shortcode('gist', 'gist_shortcode_func');
?>
@@ -0,0 +1,49 @@
=== GitHub Gist Shortcode Plugin ===
Contributors: paul1999
Requires at least: 2.5.1
Tested up to: 2.8
Stable tag: trunk
Tags: github, gist, shortcode, embed, git, code, script
Allows the use of a simple shortcode to embed GitHub Gists in a post or page.
== Description ==
Instead of embedding a [GitHub Gist](http://gist.github.com) (a [pastie](http://pastie.org/) like service on steroids) by copying and pasting HTML you can simple embed it with a [gist] shortcode.
For example, to embed the [gist: 30948](http://gist.github.com/30948) enter this in a post or page:
[gist id=30948]
It is that simple.
One problem with gists is that a search engine spiders (and users with javascript disabled) will not see your code in a blog entry. This plugin allows you to get around this by including text, such as content of the gist inside the shortcode. The text is wrapped inside these tags:
<noscript><code class="gist"><pre>
You would use it like this:
[gist id=30948]
puts hello_world_test;
i = 0
5.times do
i = i + 1
puts i
end
[/gist]
The content inside a gist shortcode is optional.
View the [CHANGELOG](http://svn.wp-plugins.org/github-gist-shortcode/trunk/CHANGELOG) to see what has changed between versions.
== Installation ==
1) Download the plugin zip file.
2) Unzip.
3) Upload the github_gist_shortcode directory to your wordpress plugin directory (/wp-content/plugins).
4) Activate the plugin.
5) Use the gist shortcode in your posts or pages