Title: SchoolDigger Widgets
Author: schooldigger
Published: <strong>2026 年 3 月 11 日</strong>
Last modified: 2026 年 3 月 11 日

---

搜尋外掛

![](https://ps.w.org/schooldigger-widgets/assets/icon-256x256.png?rev=3480276)

# SchoolDigger Widgets

 由 [schooldigger](https://profiles.wordpress.org/schooldigger/) 開發

[下載](https://downloads.wordpress.org/plugin/schooldigger-widgets.1.0.5.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/schooldigger-widgets/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/schooldigger-widgets/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/schooldigger-widgets/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/schooldigger-widgets/#developers)

 [技術支援](https://wordpress.org/support/plugin/schooldigger-widgets/)

## 外掛說明

**SchoolDigger Widgets** lets you embed interactive, data-rich school and district
widgets on any WordPress page or post. Powered by [SchoolDigger](https://www.schooldigger.com),
the widgets display up-to-date school information, rankings, test scores, and more.

**Available Widgets:**

 * **School Information Card** (Free) — School name, address, contact, grade levels,
   and ranking
 * **District Information Card** (Free) — District summary with school counts and
   rankings
 * **Ranking Badge** (Basic+) — Visual star rating and percentile indicator
 * **School Finder** (Basic+) — Search schools by ZIP code, city, or address with
   filters
 * **Top Schools List** (Basic+) — Ranked list of top schools by state and level
 * **School Autocomplete** (Basic+) — Type-ahead search for schools
 * **District Autocomplete** (Basic+) — Type-ahead search for districts
 * **Test Score Chart** (Pro+) — Interactive bar/line charts for test score data
 * **Nearby Schools Map** (Pro+) — Interactive map with school markers and popups

**Two ways to embed:**

 1. **Gutenberg Block** — Visual widget configurator in the block editor
 2. **Shortcode** — `[sd_widgets widget="school-info-card" school-id="340576000472"]`

**External Service:**

This plugin relies on the [SchoolDigger Widgets](https://widgets.schooldigger.com)
service to load and render widgets. When a page containing a widget is viewed, a
JavaScript file is loaded from `https://widgets.schooldigger.com` and widget data
is fetched from the SchoolDigger API. No personal visitor data is collected or transmitted—
only the widget parameters (school ID, widget type, etc.) are sent to retrieve public
school data.

 * Service URL: [https://widgets.schooldigger.com](https://widgets.schooldigger.com)
 * Terms of Service: [https://widgets.schooldigger.com/terms](https://widgets.schooldigger.com/terms)
 * Privacy Policy: [https://widgets.schooldigger.com/privacy](https://widgets.schooldigger.com/privacy)

### Shortcode Reference

**School Info Card:**
 [sd_widgets widget=”school-info-card” school-id=”340576000472″
show-address=”true” show-ranking=”true”]

**District Info Card:**
 [sd_widgets widget=”district-info-card” district-id=”0600001″
show-school-counts=”true”]

**Ranking Badge:**
 [sd_widgets widget=”ranking-badge” school-id=”340576000472″ 
style=”badge”]

**School Finder:**
 [sd_widgets widget=”school-finder” search-mode=”simple” initial-
state=”CA” default-level=”Elementary”]

**Top Schools List:**
 [sd_widgets widget=”top-schools-list” state=”NY” level=”High”
count=”10″]

**Nearby Schools Map:**
 [sd_widgets widget=”nearby-schools-map” center-mode=”school”
school-id=”340576000472″ radius-miles=”5″]

**Test Score Chart:**
 [sd_widgets widget=”test-score-chart” school-id=”340576000472″
chart-type=”bar” x-axis=”subject”]

### Build Instructions

The Gutenberg block JavaScript in `blocks/schooldigger-widget/build/` is compiled
from the human-readable source files included in `blocks/schooldigger-widget/src/`.

To rebuild from source:

 1. Navigate to `blocks/schooldigger-widget/`
 2. Run `npm install`
 3. Run `npx wp-scripts build`

This uses [@wordpress/scripts](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-scripts/)(
webpack-based) to compile `src/index.js` and `src/edit.js` into `build/index.js`.

## 適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

 *   SchoolDigger Widget Embed an interactive SchoolDigger school data widget.

## 安裝方式

 1. Upload the `schooldigger-widgets` folder to `/wp-content/plugins/`
 2. Activate the plugin through the **Plugins** screen in WordPress
 3. Go to **Settings > SchoolDigger Widgets**
 4. Enter your App ID (create a free account at [widgets.schooldigger.com](https://widgets.schooldigger.com/signup)
    if you don’t have one)
 5. Add your WordPress domain to the domain whitelist in your [SchoolDigger dashboard](https://widgets.schooldigger.com/dashboard/domains)

## 常見問題集

### Where do I get an App ID?

Sign up for a free account at [widgets.schooldigger.com](https://widgets.schooldigger.com/signup).
Your App ID can be found on the [WordPress integration guide](https://widgets.schooldigger.com/wordpress).

### How do I find a School ID or District ID?

Use the ID lookup tool on the [WordPress integration guide](https://widgets.schooldigger.com/wordpress).
Search by school or district name and copy the ID directly.

### My widget shows an error or doesn’t load

Make sure your WordPress domain is added to your domain whitelist in the SchoolDigger
dashboard (Settings > Domains). The domain must match exactly.

### Which widgets are available on the Free plan?

The Free plan includes School Information Card and District Information Card. Upgrade
to Basic for search and ranking widgets, or Pro for charts and maps. See [pricing](https://widgets.schooldigger.com/#pricing).

### Can I use multiple widgets on the same page?

Yes. Each widget operates independently. The loader script is automatically included
only once regardless of how many widgets are on the page.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈SchoolDigger Widgets〉的開發相關工作。

參與者

 *   [ schooldigger ](https://profiles.wordpress.org/schooldigger/)

[將〈SchoolDigger Widgets〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/schooldigger-widgets)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/schooldigger-widgets/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/schooldigger-widgets/)，或透過
[RSS](https://plugins.trac.wordpress.org/log/schooldigger-widgets/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/schooldigger-widgets/)。

## 變更記錄

#### 1.0.5

 * Renamed shortcode from [schooldigger] to [sd_widgets] for unique prefixing per
   WordPress.org guidelines
 * Added Build Instructions section to readme with source code location and build
   steps for compiled JS

#### 1.0.0

 * Initial release
 * Support for all 9 SchoolDigger widget types
 * Gutenberg block with visual configuration
 * Shortcode support with full parameter passthrough
 * Settings page with App ID configuration and account management links

## 中繼資料

 *  版本 **1.0.5**
 *  最後更新 **1 個月前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 6.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.9.4**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/schooldigger-widgets/)
 * 標籤
 * [education](https://tw.wordpress.org/plugins/tags/education/)[k-12](https://tw.wordpress.org/plugins/tags/k-12/)
   [ranking](https://tw.wordpress.org/plugins/tags/ranking/)[school](https://tw.wordpress.org/plugins/tags/school/)
   [widgets](https://tw.wordpress.org/plugins/tags/widgets/)
 *  [進階檢視](https://tw.wordpress.org/plugins/schooldigger-widgets/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/schooldigger-widgets/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/schooldigger-widgets/reviews/)

## 參與者

 *   [ schooldigger ](https://profiles.wordpress.org/schooldigger/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/schooldigger-widgets/)