內容簡介
<h3>外掛總結：</h3>
<p>Cancer Awareness Ribbon Shortcode 是一個輕量級的 WordPress 外掛，可以在您的網站任何地方顯示專業設計的意識絲帶。</p>
<h3>問題與答案：</h3>
<ul>
<li>
<h4>這個外掛的特色有哪些？</h4>
<p>
- 根據當前的意識月份自動改變顏色<br>
- 支援單色和多色 (漸層) 絲帶<br>
- 使用乾淨、可擴展的 SVG 圖像，無背景<br>
- 與 Elementor、Divi、WPBakery、Beaver Builder、Gutenberg 等完美結合<br>
- 包括內置管理員短碼構建器，具有實時預覽<br>
- 在任何大小下都可以清晰顯示<br>
- 不依賴外部庫或圖像文件<br>
- 包含無障礙友好的 ARIA 標籤
</p>
</li>
<li>
<h4>哪些情況下適合使用這個外掛？</h4>
<p>
- 意識活動<br>
- 非營利組織和慈善機構<br>
- 醫療機構<br>
- 學校和社區組織<br>
- 企業社會責任倡議<br>
- 網站範圍的意識展示
</p>
</li>
<li>
<h4>版本 1.5.0 新增了哪些功能？</h4>
<p>
- 具有實時短碼預覽的管理員設置頁面<br>
- 默認絲帶設置 (大小、類型、月份、類別、標籤、列表模式)<br>
- 從只有癌症到意識類型的內部數據結構重構<br>
- 開發者過濾器鈎子，用於註冊自定義意識絲帶<br>
- 改進的構建器集成 (Elementor、Divi、WPBakery、Beaver Builder)<br>
- 未來 Pro 功能的基礎
</p>
</li>
</ul>
外掛標籤
開發者團隊
② 後台搜尋「Cancer Awareness Ribbon Shortcode」→ 直接安裝（推薦）
原文外掛簡介
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
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.
