[WordPress] 外掛分享： Circle Progress Bar Block

WordPress 外掛 Circle Progress Bar Block 的封面圖片。

前言介紹

  • 這款 WordPress 外掛「Circle Progress Bar Block」是 2025-05-20 上架。
  • 目前有 20 個安裝啟用數。
  • 上一次更新是 2025-05-21，距離現在已有 280 天。
  • 外掛最低要求 WordPress 6.0 以上版本才可以安裝。
  • 外掛要求網站主機運作至少需要 PHP 版本 7.4 以上。
  • 尚未有人給過這款外掛評分。
  • 還沒有人在論壇上發問，可能目前使用數不多，還沒有什麼大問題。

外掛協作開發者

jqsafi |

外掛標籤

circle | progress | gutenberg | block-editor | progress bar |

內容簡介

總結：Circle Progress Bar Block 是一個現代的 Gutenberg 區塊外掛程式，可將美麗的圓形進度指示器加入到您的 WordPress 網站中。非常適合以視覺上吸引人的方式顯示進度、統計或指標。

問題與答案：
1. 這是一個什麼樣的 WordPress 外掛程式？
- 答案：Circle Progress Bar Block 是一個現代的 Gutenberg 區塊外掛程式，可將美麗的圓形進度指示器加入到您的 WordPress 網站中。

2. 這個外掛程式的主要來源碼在哪裡？
- 答案：主要源碼位於 src/index.js，這是用於該區塊的完整 React 源碼。

3. 這個外掛程式如何進行編譯？
- 答案：使用標準 WordPress 工具進行編譯：@wordpress/scripts 用於開發和構建、Webpack 用於模組打包、Babel 用於現代 JavaScript 兼容性。

4. 如何從源代碼進行構建？
- 答案：首先複製 GitHub 倉庫，安裝依賴項，再啟動開發伺服器進行即時重新加載，或建立生產版本。

5. 這個外掛程式提供了哪些自訂功能？
- 答案：提供完全可定制的設計，可以調整圓形大小和筆劃寬度，設置進度槓、背景和文字的顏色，啟用/停用漸變效果，添加自定義文字等。

原文外掛簡介

Circle Progress Bar Block is a modern Gutenberg block plugin that adds beautiful circular progress indicators to your WordPress site. Perfect for displaying progress, statistics, or metrics in a visually appealing way.
Source Code
All uncompiled source code is included in this plugin. The production code in build/index.js is compiled from:
Main Source File
Located at src/index.js, this is the complete React source code for the block:
`javascript

import { registerBlockType } from ‘@wordpress/blocks’;
import { InspectorControls } from ‘@wordpress/block-editor’;
import {
PanelBody,
RangeControl,
ColorPicker,
TextControl,
SelectControl,
} from ‘@wordpress/components’;
registerBlockType(‘circle-progress-bar/progress’, {
title: ‘Circle Progress Bar’,
icon: ‘chart-pie’,
category: ‘widgets’,
description: ‘A customizable circle progress bar.’,
keywords: [‘progress’, ‘circle’, ‘chart’],
supports: { html: false },
attributes: {
percentage: { type: ‘number’, default: 75 },
size: { type: ‘number’, default: 100 },
strokeColor: { type: ‘string’, default: ‘#00aaff’ },
bgColor: { type: ‘string’, default: ‘#e6e6e6’ },
text: { type: ‘string’, default: ‘Progress’ },
useShadow: { type: ‘boolean’, default: false },
useGradient: { type: ‘boolean’, default: false },
strokeWidth: { type: ‘number’, default: 10 },
fontSize: { type: ‘number’, default: 20 },
fontColor: { type: ‘string’, default: ‘#333’ }
},
// Full source code available in src/index.js
// See GitHub repository for complete implementation

});

Build Tools
The production code is generated using standard WordPress tools:
* @wordpress/scripts – For development and build
* Webpack – For module bundling
* Babel – For modern JavaScript compatibility
Building from Source

The source is in src/index.js
Build tools are configured in package.json
To compile:
bash
npm install
npm run build
Output goes to build/index.js

Directory Structure
To work with the source code:
1. Clone the GitHub repository: https://github.com/jqsafi/circle-progress-bar
2. Install dependencies: npm install
3. Start development server: npm start
4. Build production version: npm run build
Features

Fully Customizable Design

Adjustable circle size and stroke width
Custom colors for progress bar, background, and text
Optional gradient effects
Configurable font size and text
Shadow effects available

Block Editor Integration

Easy to use block controls
Live preview in editor
Works with Full Site Editing (FSE)
Multiple instances support

Performance Optimized

Lightweight SVG-based rendering
No external dependencies
Optimized for modern browsers

Usage
Basic Configuration

After adding the block, set your desired percentage (0-100) in the block settings panel
Customize the appearance:

Change circle size using the “Size” slider
Adjust stroke width using the “Thickness” slider
Set colors for the progress bar, background, and text
Enable/disable gradient effect
Add custom text above or below the percentage

Advanced Features

Shadow Effects: Enable and customize shadow effects in the “Effects” panel
Text Options: Configure font size, weight, and position

Development
The Circle Progress Bar Block is developed using modern JavaScript and follows WordPress coding standards. The source code is available on GitHub:

GitHub Repository: https://github.com/jqsafi/circle-progress-bar

Building from Source

Clone the repository
Install dependencies:
npm install
For development with live reload:
npm start
For production build:
npm run build

The plugin uses the following build tools:
* @wordpress/scripts for development and build processes
* webpack for bundling
* Babel for JavaScript transpilation
* ESLint and Prettier for code formatting
Source files are located in:
* src/ – Uncompiled JavaScript source code
* build/ – Compiled and minified production code

各版本下載點

  • 方法一：點下方版本號的連結下載 ZIP 檔案後，登入網站後台左側選單「外掛」的「安裝外掛」，然後選擇上方的「上傳外掛」，把下載回去的 ZIP 外掛打包檔案上傳上去安裝與啟用。
  • 方法二：透過「安裝外掛」的畫面右方搜尋功能，搜尋外掛名稱「Circle Progress Bar Block」來進行安裝。

（建議使用方法二，確保安裝的版本符合當前運作的 WordPress 環境。

1.0.0 | trunk |

延伸相關外掛（你可能也想知道）

  • Reading progressbar 》使用進度條作為閱讀位置指示器，將其顯示在頂部、底部或自定義位置的不同樣板或文章類型中。, 非常輕量級，它使用 <progress> HTML5 元素和幾行javascr...。
  • Worth The Read 》一個非常低調且輕量級的閱讀進度條插件，可向使用者顯示他們在當前文章或頁面中滾動到哪個部分。您可以控制進度條的位置和顏色，並可以選擇是否包括主要內容...。
  • WP Reading Progress 》阅读进度条是长篇文章中非常棒的用户体验。特别是当它准确地反映了文章文本的阅读进度，而没有其他内容。这在单个博客文章上是标准的，并且默认情况下启用。,...。
  • Image Slider Block 》Image Slider 是在 WordPress 網站上展示多個圖像的好方法，它會讓你的網站更具互動性，也有助於減少頁面滾動。, , 使用這個圖片輪播外掛程式以區塊編輯器來...。
  • Ultimeter 》Ultimeter 可以透過簡單的短碼、小工具或區塊來顯示不同的計量器（Lite 版提供了一個溫度計和一個進度條，Pro 版提供了三個以上的計量器選擇），您可以選擇百...。
  • Progress Bar 》此外掛只做一件事：建立一個簡單（但看起來不錯）的 CSS3 進度條，您可以使用自己的 CSS 进行樣式設計，並使用一個簡單的 shortcode 在任何地方使用。現在支...。
  • Parallax Slider Block 》「Parallax Slider」是一種讓網站訪客獲得引人入勝視覺體驗的絕佳方式。透過這種方式，您可以使用視差捲動效果（parallax scrolling）在幻燈片中增加沉浸感，...。
  • Progress Bars 》使用這個進度條區塊，你可以輕鬆地讓你的網站互動並吸引你的觀眾的注意力。你可以在 WordPress 區塊編輯器中使用它，並展示你重要的統計數據、資料和成就，並...。
  • Tiles Progress Block 》一個快速簡單的方法，將進度條添加到您的網站。。
  • Responsive Progress Bar 》一個輕量級的響應式進度條，可與您喜愛的 HTML5 主題配合使用。, 它與主要瀏覽器兼容，可進行配置，唯一的依賴是 jQuery，這是 WordPress 主題廣泛使用的。, ...。
  • Social Share Block 》Share all your posts and content on popular social platforms seamlessly with one click using Social Share Gutenberg block., With this stunning plug...。
  • Juno – Progress Bar Block 》總結: Juno 是 WordPress 進度條外掛，提供完全可自訂的圓形、正方形和半圓形進度條，讓您可以根據網站設計和品牌需求自由調整內容、顏色等。同時享受各種動...。
  • Progress Tracker 》讓你的使用者/學生可以追蹤在你的網站上的進度。當追蹤已啟用的頁面上，他們可以按一個「已完成」的按鈕，這樣當他們重返該網站時，便會有一個視覺化的指引，...。
  • Kenzap Timeline 》一款美觀且簡單易定制的 Gutenberg 區塊套件，可用於創建時間軸部分的新編輯器。輕鬆調整以下參數：, , 更改大小, 將時間軸列為輪播, 設置背景顏色或圖像, 支...。
  • Progress Bar 》總結文案: WBD進度條區塊是在WordPress網站上用於顯示進度、統計數據、技能或任何基於百分比的資料的簡單而強大的工具。採用現代網站標準構建，該區塊提供流...。

文章
Filter
Apply Filters
Close
Mastodon