SchoolDigger Widgets

SchoolDigger Widgets lets you embed interactive, data-rich school and district widgets on any WordPress page or post. Powered by SchoolDigger, 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 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
• Terms of Service: https://widgets.schooldigger.com/terms
• Privacy Policy: 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 (webpack-based) to compile src/index.js and src/edit.js into build/index.js.