Show Support Ribbon

Description

Show support for your favorite cause, event, charity, political event, or anything else that’s awesome. Show Support Ribbon includes four built-in ribbon styles and makes it easy to customize with your own CSS.

Features

  • Plug-n-play functionality
  • No configuration required
  • Regularly updated and “future proof”
  • Shortcode and template tag to display the ribbon anywhere
  • Limit display of the ribbon to any URL(s)
  • Choose one of four built-in ribbon styles
  • Customize the ribbon with your own CSS
  • Control the link text, link URL, and title text
  • Includes copy/paste CSS recipes to customize the ribbon
  • Includes option to restore default settings
  • Super-slick toggling settings page
  • Works with or without Gutenberg Block Editor

Ribbon Styles

Choose one of the following ways to display your ribbon:

  • Badge
  • Banner
  • Ribbon
  • Link
  • Custom (any text/HTML/CSS)

Much more is possible via the Custom option, which enables you to add your own CSS for custom styling.

Privacy

This plugin does not collect or store any user data. It does not set any cookies, and it does not connect to any third-party locations. Thus, this plugin does not affect user privacy in any way.

Support development of this plugin

I develop and maintain this free plugin with love for the WordPress community. To show support, you can make a donation or purchase one of my books:

And/or purchase one of my premium WordPress plugins:

Links, tweets and likes also appreciated. Thanks! 🙂

Screenshots

  • Show Support Ribbon: Plugin Settings (panels toggle open/closed)

Installation

Installation

  1. Upload the plugin to your blog and activate
  2. Visit the settings to configure your options

More info on installing WP plugins

Custom Markup

Note: For the “Custom” markup option, you can use the following shortcodes to display related information:

{{css_div}} = adds the CSS from the custom option, "CSS for <div>"
{{css_a}}   = adds the CSS from the custom option, "CSS for <a>"
{{url}}     = adds the URL from the option, "Link URL"
{{title}}   = adds the title from the option, "Link title"
{{text}}    = adds the text from the option, "Link text"

Upgrades

To upgrade Show Support Ribbon, remove the old version and replace with the new version. Or just click “Update” from the Plugins screen and let WordPress do it for you automatically.

Note: uninstalling the plugin from the WP Plugins screen results in the removal of all settings from the WP database.

Restore Default Options

To restore default plugin options, either uninstall/reinstall the plugin, or visit the plugin settings > Restore Default Options.

Uninstalling

Show Support Ribbon cleans up after itself. All plugin settings will be removed from your database when the plugin is uninstalled via the Plugins screen.

Like the plugin?

If you like Show Support Ribbon, please take a moment to give a 5-star rating. It helps to keep development and support going strong. Thank you!

FAQ

Where do I place the image for the button? How do I include a graphic for the button?

Images may be displayed using CSS. Upload the desired file and then display it using CSS, like so:

background-image { url(/path/to/image.png) fixed no-repeat center top; }

Fine-tune as needed to dial it in. To add via plugin settings, select “Custom” for the “Select your style” option and include for either <div> or <a> styles.

What is the Targeted Display option?

That setting enables you to limit the display of the ribbon to any specified URLs. So if you enter some URLs (separated by a comma), the plugin will display the ribbon only on those pages. Otherwise if no URLs are entered and the option is empty/blank, then the ribbon will be displayed on all pages on the site.

How to override inline custom styles?

First, you can customize any of the CSS/HTML for the “Custom” button option. For the other predefined options, you can override the default inline styles as follows:

To override the button’s outer <div> tag:

.show-support-ribbon[style] { font-size: 14px !important; }

To override the button’s inner <a> tag:

.show-support-ribbon a[style] { font-size: 14px !important; }

Then you can change the font-size to whatever properties are required.

How to make a plain-text badge with no link?

Select “Custom” for the option “Select your style”. Then replace the “Markup” option with the following code:

<div id="show-support-ribbon" class="show-support-ribbon" style="{{css_div}}">{{text}}</div>

Actually you can customize the markup however you want. And as explained in the Installation section of these docs, you can use {{css_div}} and other shortcodes to display related information from the plugin options. Or you can just skip the shortcodes and add whatever text/markup is required.

How to style the ribbon on mobile (small screens)?

This can be done with a CSS @media query. Here is an example that you can add via the plugin settings:

@media (max-width: 400px) {
    .show-support-ribbon[style] { right: 15px !important; top: 15px !important; }
}

That will apply to screens up to 400px wide, so you can adjust to whatever is needed. You can add whatever styles you want. In the example, we’re just moving the ribbon a little bit on the page. The !important declaration is needed only if overriding default styles.

Got a question?

To ask a question, suggest a feature, or provide feedback, contact me directly.

Reviews

October 26, 2020
Show Support Ribbon is easy to use, and just as easy to customize. I created a "badge" style ribbon with Show Support Ribbon using a custom image and developed a nice, floating link to our restaurant's online ordering site in very little time. Phenomenal support by Jeff is the other part of the success I had using the plugin. He responded to my support question in just a couple of hours. Even in the enterprise software world, that's a very short response window. Many thanks for Show Support Ribbon!
January 1, 2020
Really, I wasn't expecting this "ribbon" to be much of anything - but damn - it's amazing little plugin! It should have been called Corner Ribbon - that's what I wanted and the options available made that happen with no effort! But there are several options (badge, banner, link, etc.) - very cool treat - thank you! I purchased several of Jeff's plugins - I honestly didn't know he offered free WP plugins like this little gem, or written books too! Thank you for your hard work, Jeff, and very reasonably priced plugins - and free plugins - life saver, trust.
Read all 10 reviews

Contributors & Developers

“Show Support Ribbon” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Show Support Ribbon” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

If you like Show Support Ribbon, please take a moment to give a 5-star rating. It helps to keep development and support going strong. Thank you!

Version 20201112

  • Adds option to add custom CSS
  • Fixes some issue(s) with PHP 8.0
  • Updates readme/documentation
  • Updates translation template
  • Tests on PHP 7.4 and 8.0
  • Tests on WordPress 5.6

Version 20200808

  • Refines readme/documentation
  • Tests on WordPress 5.5

Version 20200314

  • Adds function ssr_display_styles()
  • Adds .show-support-ribbon to outer div
  • Makes HTML/markup editable in custom option
  • Improves/updates all default button styles
  • Improves ssr_display_ribbon() function
  • Updates CSS button styles and examples
  • Improves plugin settings page UI
  • Generates new translation template
  • Tests on WordPress 5.4

Version 20191102

  • Updates styles for plugin settings page
  • Tests on WordPress 5.3

Version 20190902

  • Adds Targeted Display feature
  • Improves logic of ssr_validate_options()
  • Updates some links to https
  • Tests on WordPress 5.3 (alpha)

Version 20190429

  • Bumps minimum PHP version to 5.6.20
  • Tweaks plugin settings screen content
  • Updates default translation template
  • Tests on WordPress 5.2

Version 20190308

  • Adds check for admin user for settings shortcut link
  • Tweaks plugin settings screen UI
  • Generates new default translation template
  • Tests on WordPress 5.1 and 5.2 (alpha)

Version 20190220

  • Tests on WordPress 5.1

20181114

  • Adds missing closing tag to ribbon markup
  • Adds homepage link to Plugins screen
  • Updates default translation template
  • Tests on WordPress 5.0

20180817

  • Adds rel="noopener noreferrer" to all blank-target links
  • Replaces sanitize_text_field with wp_strip_all_tags for style settings
  • Tweaks appearance of plugin settings page
  • Updates GDPR blurb and donate link
  • Regenerates default translation template
  • Further tests on WP versions 4.9 and 5.0 (alpha)

20180508

  • Updates Show Support panel
  • Generates new translation template
  • Updates plugin image files
  • Tests on WordPress 5.0 (alpha)

20171103

  • Removes extra manage_options check for settings validation
  • Tests on WordPress 4.9

20171102

  • Fixes typo on plugin settings page
  • Tests on WordPress 4.9

20171022

  • Adds extra manage_options capability check to modify settings
  • Streamlines Support panel in plugin settings
  • Tests on WordPress 4.9

20170731

  • Updates GPL license blurb
  • Adds GPL license text file
  • Tests on WordPress 4.9 (alpha)

20170324

  • Refines display of settings panels
  • Updates show support panel in plugin settings
  • Adds note about hiding the ribbon on small screens
  • Fixes some incorrect translation domains
  • Replaces global $wp_version with get_bloginfo('version')
  • Tests on WordPress version 4.8

20161116

  • Updates plugin author URL
  • Updates Twitter URL to https
  • Changes stable tag from trunk to latest version
  • Refactors add_ssr_links() function
  • Updates URL for rate this plugin links
  • Tests on WordPress version 4.7 (beta)

20160811

  • Streamlined and optimized the plugin settings page
  • Fixed apostrophe-backslash bug via esc_attr() and sanitize_text_field()
  • Renamed menu link from “Show Support Ribbon” to “Support Ribbon”
  • Replaced _e() with esc_html_e() or esc_attr_e()
  • Replaced __() with esc_html__() or esc_attr__()
  • Added plugin icons and larger banner image
  • Renamed text-domain from “ssr” to “show-support-ribbon”
  • Improved translation support
  • Tested on WordPress 4.6

20160331

  • Replaced icon with retina version
  • Added screenshot to readme/docs
  • Added retina version of banner
  • Reorganized and refreshed readme.txt
  • Tested on WordPress version 4.5 beta

20151110

  • Updated heading hierarchy in plugin settings
  • Updated translation template file
  • Updated minimum version requirement
  • Tested on WordPress 4.4 beta

20150808

  • Tested on WordPress 4.3
  • Updated minimum version requirement

20150507

  • Tested with WP 4.2 + 4.3 (alpha)
  • Changed a few “http” links to “https”

20150315

  • Tested with latest version of WP (4.1)
  • Increased minimum version to WP 3.8
  • Removed deprecated screen_icon()
  • Added $ssr_wp_vers for version check
  • Streamline/fine-tune plugin code
  • Added Text Domain and Domain Path to file header
  • Added translation .pot template in /languages/

20140923

  • Tested on latest version of WordPress (4.0)
  • Increased minimum version requirement to WP 3.7
  • Added conditional check for min-version function

20140123

  • Tested with latest WordPress (3.8)
  • Added trailing slash to load_plugin_textdomain()

20131107

  • Added uninstall.php file
  • Added “rate this plugin” links
  • Added i18n support

20131104

  • Added line to prevent direct loading of script
  • Removed closing “?>” from show-support-ribbon.php
  • Tested with latest version of WordPress (3.7)

20130705

  • Improved preset CSS (upped the z-index)
  • General code check n clean
  • Overview and Updates admin panels toggled open by default

20130103

  • Added margins to submit button (now required in WP 3.5)
  • Added option to open ribbon-link in new tab or same tab

20121104

  • Rebuilt plugin, generalized functionality, changed name, etc.

2012-06-01a

  • Added z-index to ribbon styles.

2012-06-01

  • Initial release