{"id":276388,"date":"2026-02-11T07:49:58","date_gmt":"2026-02-11T07:49:58","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/cancer-awareness-ribbon-shortcode\/"},"modified":"2026-02-20T20:22:34","modified_gmt":"2026-02-20T20:22:34","slug":"cancer-awareness-ribbon-shortcode","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/cancer-awareness-ribbon-shortcode\/","author":14561482,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.5.3","stable_tag":"1.5.3","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Cancer Awareness Ribbon Shortcode","header_author":"Parallel Media","header_description":"Adds a shortcode to display a cancer awareness ribbon whose colors change based on the current month (or by type override).","assets_banners_color":"8c8ec9","last_updated":"2026-02-20 20:22:34","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.parallelmedia.co.za\/cancer-awareness-ribbon-demo\/","header_author_uri":"http:\/\/parallelmedia.co.za","rating":0,"author_block_rating":0,"active_installs":0,"downloads":307,"num_ratings":0,"support_threads":1,"support_threads_resolved":1,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"FreelanceDirectZA","date":"2026-02-11 07:51:56"},"1.4.0":{"tag":"1.4.0","author":"FreelanceDirectZA","date":"2026-02-11 10:58:59"},"1.5.0":{"tag":"1.5.0","author":"FreelanceDirectZA","date":"2026-02-11 13:02:26"},"1.5.1":{"tag":"1.5.1","author":"FreelanceDirectZA","date":"2026-02-11 13:29:18"},"1.5.2":{"tag":"1.5.2","author":"FreelanceDirectZA","date":"2026-02-12 07:54:43"},"1.5.3":{"tag":"1.5.3","author":"FreelanceDirectZA","date":"2026-02-20 20:22:34"}},"upgrade_notice":{"1.5.3":"<p>Improves ribbon sizing consistency and background contrast handling, plus adds an admin review prompt card.<\/p>","1.5.0":"<p>Adds admin shortcode builder, default settings support, internal awareness refactor, developer extensibility hook, and builder integrations.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3458719,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3458719,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3458969,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3458969,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.4.0","1.5.0","1.5.1","1.5.2","1.5.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3459628,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3459628,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3459628,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3459628,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3459628,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3459628,"resolution":"6","location":"assets","locale":""},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3459628,"resolution":"7","location":"assets","locale":""}},"screenshots":{"1":"<strong>Adjust Ribbon Size in WordPress<\/strong> - Customize the cancer awareness ribbon size directly within the WordPress shortcode to match your website layout and design.","2":"<strong>Select Awareness Type (Cancer, Medical, Social, Global)<\/strong> - Choose from multiple awareness ribbon types including cancer awareness, medical awareness, social causes, and global awareness categories.","3":"<strong>Manually Override Ribbon Type<\/strong> - Force a specific awareness ribbon type in WordPress regardless of the automatic awareness month detection.","4":"<strong>Set a Custom Awareness Month<\/strong> - Override the current month and display a specific cancer or awareness ribbon month using shortcode settings.","5":"<strong>Support for Non-Cancer Awareness Ribbons<\/strong> - Display medical, social, and global awareness ribbons in addition to traditional cancer awareness ribbons.","6":"<strong>Advanced Shortcode Customization Options<\/strong> - Fully customize your WordPress awareness ribbon using shortcode attributes including size, type, month, category filtering, label display, and list mode.","7":"<strong>Admin Ribbon Builder with Live Preview (WordPress Dashboard)<\/strong> - Generate and preview your awareness ribbon inside the WordPress admin panel with real-time updates and automatic shortcode generation."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1953,14203,15130,189,80],"plugin_category":[34,43],"plugin_contributors":[255621],"plugin_business_model":[],"class_list":["post-276388","plugin","type-plugin","status-publish","hentry","plugin_tags-accessibility","plugin_tags-cancer","plugin_tags-nonprofit","plugin_tags-ribbon","plugin_tags-shortcode","plugin_category-accessibility","plugin_category-customization","plugin_contributors-freelancedirectza","plugin_committers-freelancedirectza"],"banners":{"banner":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/banner-772x250.png?rev=3458969","banner_2x":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/banner-1544x500.png?rev=3458969","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/icon-128x128.png?rev=3458719","icon_2x":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/icon-256x256.png?rev=3458719","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/screenshot-1.png?rev=3459628","caption":"<strong>Adjust Ribbon Size in WordPress<\/strong> - Customize the cancer awareness ribbon size directly within the WordPress shortcode to match your website layout and design."},{"src":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/screenshot-2.png?rev=3459628","caption":"<strong>Select Awareness Type (Cancer, Medical, Social, Global)<\/strong> - Choose from multiple awareness ribbon types including cancer awareness, medical awareness, social causes, and global awareness categories."},{"src":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/screenshot-3.png?rev=3459628","caption":"<strong>Manually Override Ribbon Type<\/strong> - Force a specific awareness ribbon type in WordPress regardless of the automatic awareness month detection."},{"src":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/screenshot-4.png?rev=3459628","caption":"<strong>Set a Custom Awareness Month<\/strong> - Override the current month and display a specific cancer or awareness ribbon month using shortcode settings."},{"src":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/screenshot-5.png?rev=3459628","caption":"<strong>Support for Non-Cancer Awareness Ribbons<\/strong> - Display medical, social, and global awareness ribbons in addition to traditional cancer awareness ribbons."},{"src":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/screenshot-6.png?rev=3459628","caption":"<strong>Advanced Shortcode Customization Options<\/strong> - Fully customize your WordPress awareness ribbon using shortcode attributes including size, type, month, category filtering, label display, and list mode."},{"src":"https:\/\/ps.w.org\/cancer-awareness-ribbon-shortcode\/assets\/screenshot-7.png?rev=3459628","caption":"<strong>Admin Ribbon Builder with Live Preview (WordPress Dashboard)<\/strong> - Generate and preview your awareness ribbon inside the WordPress admin panel with real-time updates and automatic shortcode generation."}],"raw_content":"<!--section=description-->\n<p><strong>Cancer Awareness Ribbon Shortcode<\/strong> is a lightweight WordPress plugin that adds a shortcode for displaying a professionally designed awareness ribbon anywhere on your website.<\/p>\n\n<p><a href=\"https:\/\/www.parallelmedia.co.za\/cancer-awareness-ribbon-demo\/\">Live Demo<\/a><\/p>\n\n<p>The ribbon automatically adapts to the current awareness month and supports a wide range of awareness types including Cancer, Medical, Social, and Global causes.<\/p>\n\n<p>The ribbon:\n- Automatically changes color based on the current awareness month\n- Supports single-color and multi-color (gradient) ribbons\n- Uses a clean, scalable SVG with no background\n- Works seamlessly with Elementor, Divi, WPBakery, Beaver Builder, Gutenberg, headers, footers, and widgets\n- Includes a built-in admin shortcode builder with live preview\n- Includes a friendly admin review prompt card\n- Scales crisply at any size\n- Improves visibility on light\/dark backgrounds automatically\n- Does not rely on external libraries or image files\n- Includes accessibility-friendly ARIA labels<\/p>\n\n<p>This plugin is ideal for:\n- Awareness campaigns\n- Non-profits and charities\n- Medical practices\n- Schools and community organizations\n- Corporate social responsibility initiatives\n- Site-wide awareness displays<\/p>\n\n<p>Version 1.5.0 introduces:\n- Admin settings page with live shortcode preview\n- Default ribbon settings (size, type, month, category, label, list mode)\n- Internal data structure refactor from cancer-only to awareness types\n- Developer filter hook for registering custom awareness ribbons\n- Improved builder integrations (Elementor, Divi, WPBakery, Beaver Builder)\n- Foundation for future Pro features<\/p>\n\n<h3>Features<\/h3>\n\n<ul>\n<li>Automatic ribbon selection based on the current month<\/li>\n<li>Supports Cancer, Medical, Social, and Global awareness types<\/li>\n<li>Multi-color gradient support for applicable ribbons<\/li>\n<li>Fully responsive SVG (no images required)<\/li>\n<li>Admin shortcode builder with live preview<\/li>\n<li>Friendly admin review card with direct link to WordPress.org reviews<\/li>\n<li>Save default ribbon display settings<\/li>\n<li>Compatible with major page builders<\/li>\n<li>Lightweight and fast (no external libraries)<\/li>\n<li>Accessible SVG with ARIA labels<\/li>\n<li>Automatic contrast assist for low-visibility color\/background combinations<\/li>\n<li>Customizable size, label, type, month, category filtering, and month listing via shortcode attributes<\/li>\n<li>Developer hook to extend awareness ribbon library<\/li>\n<\/ul>\n\n<h3>Usage<\/h3>\n\n<p>Insert the ribbon anywhere using the shortcode:<\/p>\n\n<p>[cancer_ribbon]<\/p>\n\n<h3>Optional Shortcode Attributes<\/h3>\n\n<p>[cancer_ribbon size=\"64\"]\n[cancer_ribbon label=\"1\"]\n[cancer_ribbon type=\"breast_cancer\"]\n[cancer_ribbon month=\"10\"]<\/p>\n\n<p>[cancer_ribbon category=\"Medical\"]\n[cancer_ribbon list=\"1\" month=\"11\" label=\"1\"]\n[cancer_ribbon list=\"1\" month=\"10\" category=\"Social\" label=\"1\"]<\/p>\n\n<p><strong>Available attributes:<\/strong><\/p>\n\n<ul>\n<li><code>size<\/code> \u2013 Size in pixels (default: 64)<\/li>\n<li><code>label<\/code> \u2013 Show label text (1 or 0)<\/li>\n<li><code>type<\/code> \u2013 Force a specific ribbon type key<\/li>\n<li><code>month<\/code> \u2013 Force a specific month (1\u201312)<\/li>\n<li><code>category<\/code> \u2013 Filter by category: Cancer, Medical, Social, Global (optional)<\/li>\n<li><code>list<\/code> \u2013 If set to 1\/true, lists all ribbons for the selected month (optional)<\/li>\n<\/ul>\n\n<h3>Admin Shortcode Builder<\/h3>\n\n<p>Version 1.5.0 adds a top-level <strong>Awareness Ribbon<\/strong> admin page where you can:<\/p>\n\n<ul>\n<li>Select ribbon type<\/li>\n<li>Choose month or auto-detect<\/li>\n<li>Adjust ribbon size<\/li>\n<li>Enable label display<\/li>\n<li>Filter by category<\/li>\n<li>Enable list mode<\/li>\n<li>Add custom CSS class<\/li>\n<li>View live preview instantly<\/li>\n<li>Access a direct \"Leave a Review\" button<\/li>\n<li>Copy generated shortcode<\/li>\n<li>Save global defaults<\/li>\n<\/ul>\n\n<h3>Developer Extensibility<\/h3>\n\n<p>Developers can extend the ribbon library using a filter hook:<\/p>\n\n<pre><code>add_filter( 'car_awareness_types', 'my_custom_awareness_ribbon' );\nfunction my_custom_awareness_ribbon( $types ) {\n    $types['my_custom_cause'] = array(\n        'label'    =&gt; 'My Custom Cause',\n        'month'    =&gt; 6,\n        'colors'   =&gt; array( '#123456', '#abcdef' ),\n        'category' =&gt; 'Global',\n    );\n    return $types;\n}\n<\/code><\/pre>\n\n<p>This allows plugins and themes to register custom awareness ribbons without modifying core plugin files.<\/p>\n\n<h3>Supported Awareness Types<\/h3>\n\n<p>The plugin includes ribbon colors for many cancer awareness months and additional awareness types.<\/p>\n\n<p>Examples include:<\/p>\n\n<ul>\n<li>Breast Cancer (October) \u2013 Pink<\/li>\n<li>Prostate Cancer (September) \u2013 Light Blue<\/li>\n<li>Childhood Cancer (September) \u2013 Gold<\/li>\n<li>Lung Cancer (November) \u2013 White<\/li>\n<li>Colorectal Cancer (March) \u2013 Dark Blue<\/li>\n<li>Pancreatic Cancer (November) \u2013 Purple<\/li>\n<li>Cervical Cancer (January) \u2013 Teal &amp; White<\/li>\n<li>Thyroid Cancer (September) \u2013 Purple, Teal &amp; Pink<\/li>\n<\/ul>\n\n<p>Additional awareness ribbons include (among others):<\/p>\n\n<ul>\n<li>HIV \/ AIDS Awareness<\/li>\n<li>Autism Awareness<\/li>\n<li>Mental Health Awareness<\/li>\n<li>Diabetes Awareness<\/li>\n<li>Heart Disease Awareness<\/li>\n<li>Domestic Violence Awareness<\/li>\n<li>Alzheimer\u2019s Awareness<\/li>\n<li>Pride Awareness (multi-color)<\/li>\n<li>Anti-Bullying Awareness<\/li>\n<li>Organ Donation Awareness<\/li>\n<li>Veterans Awareness<\/li>\n<li>Child Protection Awareness<\/li>\n<\/ul>\n\n<h3>License<\/h3>\n\n<p>This plugin is licensed under the GPLv2 or later.<\/p>\n\n<p>You are free to modify and redistribute this plugin under the same license.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code><\/li>\n<li>Activate <strong>Cancer Awareness Ribbon Shortcode<\/strong> via the Plugins menu<\/li>\n<li>Add <code>[cancer_ribbon]<\/code> anywhere on your site<\/li>\n<\/ol>\n\n<p>Or install directly from the WordPress plugin repository.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20work%20with%20page%20builders%3F\"><h3>Does this work with page builders?<\/h3><\/dt>\n<dd><p>Yes. It works with Elementor, Divi, WPBakery, Beaver Builder, Gutenberg, and any builder that supports shortcodes.<\/p><\/dd>\n<dt id=\"does%20it%20add%20any%20images%20or%20external%20files%3F\"><h3>Does it add any images or external files?<\/h3><\/dt>\n<dd><p>No. The ribbon is rendered as an inline SVG for maximum performance and quality.<\/p><\/dd>\n<dt id=\"can%20i%20force%20a%20specific%20ribbon%20regardless%20of%20month%3F\"><h3>Can I force a specific ribbon regardless of month?<\/h3><\/dt>\n<dd><p>Yes. Use the <code>type<\/code> attribute in the shortcode.<\/p><\/dd>\n<dt id=\"can%20i%20filter%20by%20category%3F\"><h3>Can I filter by category?<\/h3><\/dt>\n<dd><p>Yes. Use <code>category=\"Cancer\"<\/code>, <code>category=\"Medical\"<\/code>, <code>category=\"Social\"<\/code>, or <code>category=\"Global\"<\/code>.<\/p><\/dd>\n<dt id=\"can%20i%20list%20all%20awareness%20ribbons%20for%20a%20selected%20month%3F\"><h3>Can I list all awareness ribbons for a selected month?<\/h3><\/dt>\n<dd><p>Yes. Use <code>list=\"1\"<\/code> and a month, for example: <code>[cancer_ribbon list=\"1\" month=\"11\" label=\"1\"]<\/code>.<\/p><\/dd>\n<dt id=\"will%20this%20affect%20my%20site%20performance%3F\"><h3>Will this affect my site performance?<\/h3><\/dt>\n<dd><p>No. The plugin is extremely lightweight and outputs minimal markup.<\/p><\/dd>\n<dt id=\"is%20the%20ribbon%20background%20transparent%3F\"><h3>Is the ribbon background transparent?<\/h3><\/dt>\n<dd><p>Yes. The SVG remains transparent. A subtle contrast outline is applied only when needed for visibility against certain backgrounds.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.5.3<\/h4>\n\n<ul>\n<li>Improved SVG sizing\/cropping so displayed dimensions better match configured size<\/li>\n<li>Added automatic foreground\/background contrast assist for better visibility on light and dark sections<\/li>\n<li>Added small edge spacing around rendered ribbons for cleaner presentation<\/li>\n<li>Added admin review card below the live preview with a direct review link<\/li>\n<\/ul>\n\n<h4>1.5.2<\/h4>\n\n<ul>\n<li>Added screenshots<\/li>\n<li>Cleaned up some functions<\/li>\n<\/ul>\n\n<h4>1.5.0<\/h4>\n\n<ul>\n<li>Added admin shortcode builder with live preview<\/li>\n<li>Added global default ribbon settings<\/li>\n<li>Refactored internal data structure from cancer-only to awareness types<\/li>\n<li>Added developer filter hook for registering custom awareness ribbons<\/li>\n<li>Added full builder integrations (Elementor, Divi, WPBakery, Beaver Builder)<\/li>\n<li>Improved internal structure for future Pro version expansion<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Added awareness categories: Cancer, Medical, Social, Global<\/li>\n<li>Added <code>category<\/code> shortcode attribute for filtering<\/li>\n<li>Added <code>list<\/code> shortcode attribute to display all ribbons for a selected month<\/li>\n<li>Added grouped output by category when using list mode<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Added Pride awareness ribbon<\/li>\n<li>Added Veterans awareness ribbon<\/li>\n<li>Added Child Protection awareness ribbon<\/li>\n<li>Added Anti-Bullying awareness ribbon<\/li>\n<li>Added Organ Donation awareness ribbon<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Added Domestic Violence awareness ribbon<\/li>\n<li>Added Prostate Health awareness ribbon<\/li>\n<li>Added Ovarian Health awareness ribbon<\/li>\n<li>Added Lung Health awareness ribbon<\/li>\n<li>Added Alzheimer\u2019s awareness ribbon<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added HIV \/ AIDS awareness ribbon<\/li>\n<li>Added Autism awareness ribbon<\/li>\n<li>Added Mental Health awareness ribbon<\/li>\n<li>Added Diabetes awareness ribbon<\/li>\n<li>Added Heart Disease awareness ribbon<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Scalable awareness ribbon shortcode with monthly colors, gradients, category filtering, and month list mode.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/276388","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=276388"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/freelancedirectza"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=276388"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=276388"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=276388"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=276388"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=276388"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=276388"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}