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:
- The Tao of WordPress
- Digging into WordPress
- .htaccess made easy
- WordPress Themes In Depth
- Wizard’s SQL Recipes for WordPress
And/or purchase one of my premium WordPress plugins:
- BBQ Pro – Super fast WordPress firewall
- Blackhole Pro – Automatically block bad bots
- Banhammer Pro – Monitor traffic and ban the bad guys
- GA Google Analytics Pro – Connect WordPress to Google Analytics
- USP Pro – Unlimited front-end forms
Links, tweets and likes also appreciated. Thanks! 🙂
Installation
Installation
- Upload the plugin to your blog and activate
- 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
-
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. -
How to make a non-linked ribbon?
-
By default, the message displayed in the ribbon/badge is linked. To change that to display the message only (with no link), follow these steps:
1) For the option, “Select your style” choose “Custom”
2) In the “Markup” setting that appears, replace whatever is there with this:
<div id="show-support-ribbon" class="show-support-ribbon" style="{{css_div}}">{{text}}</div>
3) Then in the “CSS for div” setting, replace whatever is there with this:
position:fixed;right:-60px;top:30px;z-index:9999;box-sizing:border-box;display:block;width:220px;padding:10px 0;color:#fff;background:rgba(102,153,204,.9);font-size:12px;line-height:16px;font-family:'Lucida Grande','Lucida Sans Unicode','Lucida Sans',Geneva,Verdana,sans-serif;text-align:center;text-decoration:none;border:1px solid rgba(255,255,255,.7);transform:rotate(40deg);box-shadow:1px 1px 3px 0 rgba(0,0,0,.3);
Save changes and done. You may want to customize the CSS and/or other settings as desired. Results in a non-linked ribbon.
-
Got a question?
-
To ask a question, suggest a feature, or provide feedback, contact me directly.
Reviews
Contributors & Developers
“Show Support Ribbon” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “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 20220115
- Updates support panel
- Improves loading of translations
- Updates some links to external resources
- Changes minimum required WP version to 4.6
- Tests on WordPress 5.9
Version 20210714
- Tests on WordPress 5.8
Version 20210210
- Increases maximum allowed characters on plugin options
- Tests on WordPress 5.7
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
withwp_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
withget_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()
withesc_html_e()
oresc_attr_e()
- Replaced
__()
withesc_html__()
oresc_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