Github Ribbon WordPress Plugin

download
3,114 downloads

Github Ribbons is a WordPress Plugin that allows you to add “Fork me on Github” ribbons to your WordPress posts or pages. You can enable the ribbon per post/page level or at global level.

Features

The following are some of the features of the Plugin

  • You can choose between image based ribbons or CSS3 based ribbons.
  • You can choose whether to show the ribbon on the right side or on the left side.
  • You can choose whether the link has to open in a new tab or not.
  • You can choose any one of the 6 different colours that are available.
  • Configuration can be set either globally or on a post by post basic.

Styling using CSS

If you want to style the ribbon yourself or add additional CSS styles to it (like adding z-index etc) then add it to the .robbon-holder CSS class.

Development

The development of the Plugin happens over at github. If you want to contribute to the Plugin, fork the project at github and send me a pull request.

If you are not familiar with either git or Github then refer to this guide to see how fork and send pull request.

If you are looking for ideas, then you can start with one of the following TODO items :)

TODO

The following are the features that I am thinking of adding to the Plugin, when I get some free time. If you have any feature request or want to increase the priority of a particular feature, then let me know.

  • Add an ability to translate the text used inside the ribbon

Support

  • If you have found a bug/issue or have a feature request, then post them in github issues
  • If you have a question about usage or need help to troubleshoot, then post in WordPress forums or leave a comment in Plugins’s home page
  • If you like the Plugin, then kindly leave a review/feedback at WordPress repo page.
  • If you find this Plugin useful or and wanted to say thank you, then there are ways to make me happy :) and I would really appreciate if you can do one of those.
  • Checkout other WordPress Plugins that I have released.
  • If anything else, then contact me in twitter.

Download

You can download the Plugin as a zip file from the WordPress official Plugin directory.

Screenshots

  1. github-ribbon screenshot 1

    Plugin in action in author’s blog

  2. github-ribbon screenshot 2

    Configuration screen

Installation

Extract the zip file and just drop the contents in the wp-content/plugins/ directory of your WordPress installation and then activate the Plugin from Plugins page.

Translation

  • Dutch (Thanks Rene of WPwebshop)
  • Spanish (Thanks Mike Arias of InMotion Hosting)
  • Hindi (Thanks Love Chandel)
  • Lithuanian (Thanks Vincent G)
  • German (Thanks Robert Wetzlmayr)

The pot file is available with the Plugin. If you are willing to do translation for the Plugin, use the pot file to create the .po files for your language and let me know. I will add it to the Plugin after giving credit to you.

Readme Generator

This Readme file was generated using wp-readme, which generates readme files for WordPress Plugins.

Changelog

v1.1.3 (2014-10-04) (Dev time: 0.1 hour)

  • Fix: Resolve SSL mixed content warnings by referencing the ribbon image without a hard coded scheme

v1.1.2 (2014-02-06) (Dev time: 0.5 hour)

  • Fix: Fix undefined notice in add/edit post page

v1.1.1 (2014-02-03) (Dev time: 0.5 hour)

  • Fix: Fix warnings and undefined notices
  • Tweak: Make it compatible with WordPress 3.8

v1.1.0 (2013-07-30) (Dev time: 0.5 hour)

  • Added the ability to open links in a new tab

v1.0 (2013-05-20) (Dev time: 0.5 hour)

  • Fixed a bug which prevented the gray ribbon from showing up properly.

v0.9 (2013-05-18) (Dev time: 0.5 hour)

  • Fixed a bug which prevented the ribbon from showing on non pages

v0.8 (2013-05-14) (Dev time: 0.5 hour)

  • Fixed a bug which prevented the ribbon from showing on pages

v0.7 (2012-12-08) (Dev time: 0.5 hour)

  • Added German translations

v0.6 (2012-07-10) (Dev time: 0.5 hour)

  • Added Hindi translations
  • Added Lithuanian translations

v0.5 (2011-11-28)

  • Added Spanish translations

v0.4 (2011-09-07)

  • Added CSS style to hide ribbon on printed pages

v0.3 (2011-01-23)

  • Added Dutch translations

v0.2 (2010-11-08)

  • Added option to use CSS3 ribbons

v0.1 (2010-08-04)

  • Initial Release

28 Comments so far

Follow up comments through RSS Feed | Post a comment

  • Hi,

    Basically this could be a great plugin for WordPress but for some reason the white (left/right) and grey (left/right) options kill the whole site when it’s used. Might worth a check.

    FYI I am using the Social Media Widget as well and the last file the site calls before it stops working is the all.js (http://connect.facebook.net/en_US/all.js) for the facebook like button.

    Check out the site(http://heartcode.robertpataki.com), I hope I could help in your development somehow :)

    Keep up with the good work and thanks.

    Rob

    • Sudar says:

      Can you tell me exactly how it is breaking the site? Are you getting some JavaScript errors or the page completely stops loading?

      • Hi Sudar,

        I haven’t got any js errors or 404. The site simply stops loading after the header is loaded. I am using the Twenty-Ten theme. When this issue happens, I can’t see anything but the header of the site.

        I hope it helps,
        Rob

  • Alan says:

    I sat down to write one of these but decided to google it first… thanks for saving me a few hours of WordPress hacking! Now I can go back to recompiling Android kernels. :)

  • Brandon says:

    Do you know if this plugin still works with the current version? I have it set up with the global display hidden and a specific page overriding it but I can not get the page to display anything. There are no errors or warnings and nothing shows up in the page html even hinting that its being loaded. Thanks!

    • Sudar says:

      @Brandon,

      It is compatible with the latest version of WordPress. Not sure why it is not working for you. Did you check your error log?

  • Hello, great plugin thank you. For some reason it works ok on WP Posts but it won’t show up on Pages. I have exactly one page set up like the two articles where it is working, but it keeps *not* showing the ribbon. Any idea on what might be going on? – Thanks.

  • MKzero says:

    The idea is cool, but it doesn’t work on my page, as you inject the HTML into posts and that really doesn’t go good together with my template so you should really bring it to some top level in the DOM.

    Also the CSS3 ribbons won’t work. They just display as a flat bar.

  • I’ve done a German translation for Github Ribbons. Please find the POMO files on http://talkpress.de/file_download/20/github-ribbon-de_DE.zip.

    If you happen to release a new version it’d be nice to have “Image ribbons”, “CSS3 ribbons”, “Show”, and “Hide” as additional localisable strings.

  • Natyvw says:

    How to insert this inner featured image?

  • Nicolaicola says:

    The ribbon shows up fine on articles but not on pages (see http://nicolaiarocci.com/opensource/ where I have overridden the standard ‘hide’ option but the ribbon doesn’t show up).

  • Excellent plugin, does exactly as advertised. One feature I would like to see is to have an option to open in a new window (I don’t want users leaving the website).

  • Eric Uldall says:

    Still needs some work. I like the simplicity of the idea though.

    Issues I found:

    The z-index of the ribbon needs to be set higher so other elements don’t cover it up. I’m guessing you developed it on an out of the box wordpress install and didn’t think about people using custom themes, especially themes with fixed navbars at the top.

    If someone is using a fixed navbar you should allow an option to set a top margin so the ribbon shows just below the nav.

    In the case of the css3 style you should get rid of the outer div, because it blocks being able to click content behind the empty area. If you just use the anchor tag alone you could easily achieve the same result and allow all blank areas to be free for click throughs.

    The background color on the css3 ribbon didn’t show up for me.

    It would also be nice to get an option for bottom corner placement too.

    Good concept, just gotta push it that last mile.

  • Univer says:

    Nice one, while unfortunately not compatible when I have a menu on the top. This can probably be solved after fixing the z-index.

    And I was trying to use this in a child page instead of the home page, not sure if this is supported. Anyway I have did it using HTML, but you can try adding support on single page? I have no experience on wp plugins so ignore me if this is something unimplementable.

    Univer

    • Sudar says:

      Yes, you need to change the z-index.

      It is possible to invoke the ribbon only on certain post single pages. All you need to do is to disable the global ribbon and enable it only in individual pages.

      Try it out and let me know if it works or not.

1 Tweetbacks so far

13 Trackbacks/Pingbacks so far

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>