Description
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:
- Gutenberg Block — Visual widget configurator in the block editor
- 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:
- Navigate to
blocks/schooldigger-widget/ - Run
npm install - Run
npx wp-scripts build
This uses @wordpress/scripts (webpack-based) to compile src/index.js and src/edit.js into build/index.js.
Blocs
Cette extension fournit 1 bloc.
- SchoolDigger Widget Embed an interactive SchoolDigger school data widget.
Installation
- Upload the
schooldigger-widgetsfolder to/wp-content/plugins/ - Activate the plugin through the Plugins screen in WordPress
- Go to Settings > SchoolDigger Widgets
- Enter your App ID (create a free account at widgets.schooldigger.com if you don’t have one)
- Add your WordPress domain to the domain whitelist in your SchoolDigger dashboard
FAQ
-
Where do I get an App ID?
-
Sign up for a free account at widgets.schooldigger.com. Your App ID can be found on the WordPress integration guide.
-
How do I find a School ID or District ID?
-
Use the ID lookup tool on the WordPress integration guide. 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.
-
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.
Avis
Il n’y a aucun avis pour cette extension.
Contributeurs/contributrices & développeurs/développeuses
« SchoolDigger Widgets » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
Contributeurs
Traduisez « SchoolDigger Widgets » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal des modifications
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