Title: Cancer Awareness Ribbon Shortcode
Author: Parallel Media
Published: <strong>11 fevereiro, 2026</strong>
Last modified: 25 maio, 2026

---

Pesquisar plugins

![](https://ps.w.org/cancer-awareness-ribbon-shortcode/assets/banner-772x250.png?
rev=3458969)

![](https://ps.w.org/cancer-awareness-ribbon-shortcode/assets/icon-256x256.png?rev
=3458719)

# Cancer Awareness Ribbon Shortcode

 Por [Parallel Media](https://profiles.wordpress.org/freelancedirectza/)

[Baixar](https://downloads.wordpress.org/plugin/cancer-awareness-ribbon-shortcode.1.5.4.zip)

 * [Detalhes](https://br.wordpress.org/plugins/cancer-awareness-ribbon-shortcode/#description)
 * [Avaliações](https://br.wordpress.org/plugins/cancer-awareness-ribbon-shortcode/#reviews)
 *  [Instalação](https://br.wordpress.org/plugins/cancer-awareness-ribbon-shortcode/#installation)
 * [Desenvolvimento](https://br.wordpress.org/plugins/cancer-awareness-ribbon-shortcode/#developers)

 [Suporte](https://wordpress.org/support/plugin/cancer-awareness-ribbon-shortcode/)

## Descrição

**Cancer Awareness Ribbon Shortcode** is a lightweight WordPress plugin that adds
a shortcode for displaying a professionally designed awareness ribbon anywhere on
your website.

[Live Demo](https://www.parallelmedia.co.za/cancer-awareness-ribbon-demo/)

The ribbon automatically adapts to the current awareness month and supports a wide
range of awareness types including Cancer, Medical, Social, and Global causes.

The ribbon:
 – Automatically changes color based on the current awareness month –
Supports single-color and multi-color (gradient) ribbons – Uses a clean, scalable
SVG with no background – Works seamlessly with Elementor, Divi, WPBakery, Beaver
Builder, Gutenberg, headers, footers, and widgets – Includes a built-in admin shortcode
builder with live preview – Includes a friendly admin review prompt card – Scales
crisply at any size – Improves visibility on light/dark backgrounds automatically–
Does not rely on external libraries or image files – Includes accessibility-friendly
ARIA labels

This plugin is ideal for:
 – Awareness campaigns – Non-profits and charities – Medical
practices – Schools and community organizations – Corporate social responsibility
initiatives – Site-wide awareness displays

Version 1.5.0 introduces:
 – Admin settings page with live shortcode preview – Default
ribbon settings (size, type, month, category, label, list mode) – Internal data 
structure refactor from cancer-only to awareness types – Developer filter hook for
registering custom awareness ribbons – Improved builder integrations (Elementor,
Divi, WPBakery, Beaver Builder) – Foundation for future Pro features

### Features

 * Automatic ribbon selection based on the current month
 * Supports Cancer, Medical, Social, and Global awareness types
 * Multi-color gradient support for applicable ribbons
 * Fully responsive SVG (no images required)
 * Admin shortcode builder with live preview
 * Friendly admin review card with direct link to WordPress.org reviews
 * Save default ribbon display settings
 * Compatible with major page builders
 * Lightweight and fast (no external libraries)
 * Accessible SVG with ARIA labels
 * Automatic contrast assist for low-visibility color/background combinations
 * Customizable size, label, type, month, category filtering, and month listing 
   via shortcode attributes
 * Developer hook to extend awareness ribbon library

### Usage

Insert the ribbon anywhere using the shortcode:

[cancer_ribbon]

### Optional Shortcode Attributes

[cancer_ribbon size=”64″]
 [cancer_ribbon label=”1″] [cancer_ribbon type=”breast_cancer”][
cancer_ribbon month=”10″]

[cancer_ribbon category=”Medical”]
 [cancer_ribbon list=”1″ month=”11″ label=”1″][
cancer_ribbon list=”1″ month=”10″ category=”Social” label=”1″]

**Available attributes:**

 * `size` – Size in pixels (default: 64)
 * `label` – Show label text (1 or 0)
 * `type` – Force a specific ribbon type key
 * `month` – Force a specific month (1–12)
 * `category` – Filter by category: Cancer, Medical, Social, Global (optional)
 * `list` – If set to 1/true, lists all ribbons for the selected month (optional)

### Admin Shortcode Builder

Version 1.5.0 adds a top-level **Awareness Ribbon** admin page where you can:

 * Select ribbon type
 * Choose month or auto-detect
 * Adjust ribbon size
 * Enable label display
 * Filter by category
 * Enable list mode
 * Add custom CSS class
 * View live preview instantly
 * Access a direct “Leave a Review” button
 * Copy generated shortcode
 * Save global defaults

### Developer Extensibility

Developers can extend the ribbon library using a filter hook:

    ```
    add_filter( 'car_awareness_types', 'my_custom_awareness_ribbon' );
    function my_custom_awareness_ribbon( $types ) {
        $types['my_custom_cause'] = array(
            'label'    => 'My Custom Cause',
            'month'    => 6,
            'colors'   => array( '#123456', '#abcdef' ),
            'category' => 'Global',
        );
        return $types;
    }
    ```

This allows plugins and themes to register custom awareness ribbons without modifying
core plugin files.

### Supported Awareness Types

The plugin includes ribbon colors for many cancer awareness months and additional
awareness types.

Examples include:

 * Breast Cancer (October) – Pink
 * Prostate Cancer (September) – Light Blue
 * Childhood Cancer (September) – Gold
 * Lung Cancer (November) – White
 * Colorectal Cancer (March) – Dark Blue
 * Pancreatic Cancer (November) – Purple
 * Cervical Cancer (January) – Teal & White
 * Thyroid Cancer (September) – Purple, Teal & Pink

Additional awareness ribbons include (among others):

 * HIV / AIDS Awareness
 * Autism Awareness
 * Mental Health Awareness
 * Diabetes Awareness
 * Heart Disease Awareness
 * Domestic Violence Awareness
 * Alzheimer’s Awareness
 * Pride Awareness (multi-color)
 * Anti-Bullying Awareness
 * Organ Donation Awareness
 * Veterans Awareness
 * Child Protection Awareness

### License

This plugin is licensed under the GPLv2 or later.

You are free to modify and redistribute this plugin under the same license.

## Capturas de tela

[⌊Adjust Ribbon Size in WordPress - Customize the cancer awareness ribbon size directly
within the WordPress shortcode to match your website layout and design.⌉⌊Adjust 
Ribbon Size in WordPress - Customize the cancer awareness ribbon size directly within
the WordPress shortcode to match your website layout and design.⌉[

**Adjust Ribbon Size in WordPress** – Customize the cancer awareness ribbon size
directly within the WordPress shortcode to match your website layout and design.

[⌊Select Awareness Type (Cancer, Medical, Social, Global) - Choose from multiple
awareness ribbon types including cancer awareness, medical awareness, social causes,
and global awareness categories.⌉⌊Select Awareness Type (Cancer, Medical, Social,
Global) - Choose from multiple awareness ribbon types including cancer awareness,
medical awareness, social causes, and global awareness categories.⌉[

**Select Awareness Type (Cancer, Medical, Social, Global)** – Choose from multiple
awareness ribbon types including cancer awareness, medical awareness, social causes,
and global awareness categories.

[⌊Manually Override Ribbon Type - Force a specific awareness ribbon type in WordPress
regardless of the automatic awareness month detection.⌉⌊Manually Override Ribbon
Type - Force a specific awareness ribbon type in WordPress regardless of the automatic
awareness month detection.⌉[

**Manually Override Ribbon Type** – Force a specific awareness ribbon type in WordPress
regardless of the automatic awareness month detection.

[⌊Set a Custom Awareness Month - Override the current month and display a specific
cancer or awareness ribbon month using shortcode settings.⌉⌊Set a Custom Awareness
Month - Override the current month and display a specific cancer or awareness ribbon
month using shortcode settings.⌉[

**Set a Custom Awareness Month** – Override the current month and display a specific
cancer or awareness ribbon month using shortcode settings.

[⌊Support for Non-Cancer Awareness Ribbons - Display medical, social, and global
awareness ribbons in addition to traditional cancer awareness ribbons.⌉⌊Support 
for Non-Cancer Awareness Ribbons - Display medical, social, and global awareness
ribbons in addition to traditional cancer awareness ribbons.⌉[

**Support for Non-Cancer Awareness Ribbons** – Display medical, social, and global
awareness ribbons in addition to traditional cancer awareness ribbons.

[⌊Advanced Shortcode Customization Options - Fully customize your WordPress awareness
ribbon using shortcode attributes including size, type, month, category filtering,
label display, and list mode.⌉⌊Advanced Shortcode Customization Options - Fully 
customize your WordPress awareness ribbon using shortcode attributes including size,
type, month, category filtering, label display, and list mode.⌉[

**Advanced Shortcode Customization Options** – Fully customize your WordPress awareness
ribbon using shortcode attributes including size, type, month, category filtering,
label display, and list mode.

[⌊Admin Ribbon Builder with Live Preview (WordPress Dashboard) - Generate and preview
your awareness ribbon inside the WordPress admin panel with real-time updates and
automatic shortcode generation.⌉⌊Admin Ribbon Builder with Live Preview (WordPress
Dashboard) - Generate and preview your awareness ribbon inside the WordPress admin
panel with real-time updates and automatic shortcode generation.⌉[

**Admin Ribbon Builder with Live Preview (WordPress Dashboard)** – Generate and 
preview your awareness ribbon inside the WordPress admin panel with real-time updates
and automatic shortcode generation.

## Instalação

 1. Upload the plugin folder to `/wp-content/plugins/`
 2. Activate **Cancer Awareness Ribbon Shortcode** via the Plugins menu
 3. Add `[cancer_ribbon]` anywhere on your site

Or install directly from the WordPress plugin repository.

## Perguntas frequentes

### Does this work with page builders?

Yes. It works with Elementor, Divi, WPBakery, Beaver Builder, Gutenberg, and any
builder that supports shortcodes.

### Does it add any images or external files?

No. The ribbon is rendered as an inline SVG for maximum performance and quality.

### Can I force a specific ribbon regardless of month?

Yes. Use the `type` attribute in the shortcode.

### Can I filter by category?

Yes. Use `category="Cancer"`, `category="Medical"`, `category="Social"`, or `category
="Global"`.

### Can I list all awareness ribbons for a selected month?

Yes. Use `list="1"` and a month, for example: `[cancer_ribbon list="1" month="11"
label="1"]`.

### Will this affect my site performance?

No. The plugin is extremely lightweight and outputs minimal markup.

### Is the ribbon background transparent?

Yes. The SVG remains transparent. A subtle contrast outline is applied only when
needed for visibility against certain backgrounds.

## Avaliações

Não há avaliações para este plugin.

## Colaboradores e desenvolvedores

“Cancer Awareness Ribbon Shortcode” é um programa de código aberto. As seguintes
pessoas contribuíram para este plugin.

Colaboradores

 *   [ Parallel Media ](https://profiles.wordpress.org/freelancedirectza/)

[Traduzir o “Cancer Awareness Ribbon Shortcode” para seu idioma.](https://translate.wordpress.org/projects/wp-plugins/cancer-awareness-ribbon-shortcode)

### Interessado no desenvolvimento?

[Navegue pelo código](https://plugins.trac.wordpress.org/browser/cancer-awareness-ribbon-shortcode/),
consulte o [repositório SVN](https://plugins.svn.wordpress.org/cancer-awareness-ribbon-shortcode/)
ou assine o [registro de desenvolvimento](https://plugins.trac.wordpress.org/log/cancer-awareness-ribbon-shortcode/)
por [RSS](https://plugins.trac.wordpress.org/log/cancer-awareness-ribbon-shortcode/?limit=100&mode=stop_on_copy&format=rss).

## Registro de alterações

#### 1.5.3

 * Improved SVG sizing/cropping so displayed dimensions better match configured 
   size
 * Added automatic foreground/background contrast assist for better visibility on
   light and dark sections
 * Added small edge spacing around rendered ribbons for cleaner presentation
 * Added admin review card below the live preview with a direct review link

#### 1.5.2

 * Added screenshots
 * Cleaned up some functions

#### 1.5.0

 * Added admin shortcode builder with live preview
 * Added global default ribbon settings
 * Refactored internal data structure from cancer-only to awareness types
 * Added developer filter hook for registering custom awareness ribbons
 * Added full builder integrations (Elementor, Divi, WPBakery, Beaver Builder)
 * Improved internal structure for future Pro version expansion

#### 1.4.0

 * Added awareness categories: Cancer, Medical, Social, Global
 * Added `category` shortcode attribute for filtering
 * Added `list` shortcode attribute to display all ribbons for a selected month
 * Added grouped output by category when using list mode

#### 1.3.0

 * Added Pride awareness ribbon
 * Added Veterans awareness ribbon
 * Added Child Protection awareness ribbon
 * Added Anti-Bullying awareness ribbon
 * Added Organ Donation awareness ribbon

#### 1.2.0

 * Added Domestic Violence awareness ribbon
 * Added Prostate Health awareness ribbon
 * Added Ovarian Health awareness ribbon
 * Added Lung Health awareness ribbon
 * Added Alzheimer’s awareness ribbon

#### 1.1.0

 * Added HIV / AIDS awareness ribbon
 * Added Autism awareness ribbon
 * Added Mental Health awareness ribbon
 * Added Diabetes awareness ribbon
 * Added Heart Disease awareness ribbon

#### 1.0.0

 * Initial release

## Meta

 *  Versão **1.5.4**
 *  Última atualização **5 meses atrás**
 *  Instalações ativas **Menos de 10**
 *  Versão do WordPress ** 5.8 ou superior **
 *  Testado até **7.0.7**
 *  Versão do PHP ** 7.4 ou superior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/cancer-awareness-ribbon-shortcode/)
 * Tags
 * [accessibility](https://br.wordpress.org/plugins/tags/accessibility/)[cancer](https://br.wordpress.org/plugins/tags/cancer/)
   [nonprofit](https://br.wordpress.org/plugins/tags/nonprofit/)[ribbon](https://br.wordpress.org/plugins/tags/ribbon/)
   [shortcode](https://br.wordpress.org/plugins/tags/shortcode/)
 *  [Visualização avançada](https://br.wordpress.org/plugins/cancer-awareness-ribbon-shortcode/advanced/)

## Classificações

Ainda não foi enviada nenhuma avaliação.

[Sua avaliação](https://wordpress.org/support/plugin/cancer-awareness-ribbon-shortcode/reviews/#new-post)

[Ver todas avaliações](https://wordpress.org/support/plugin/cancer-awareness-ribbon-shortcode/reviews/)

## Colaboradores

 *   [ Parallel Media ](https://profiles.wordpress.org/freelancedirectza/)

## Suporte

Tem algo a dizer? Precisa de ajuda?

 [Ver fórum de suporte](https://wordpress.org/support/plugin/cancer-awareness-ribbon-shortcode/)