Managing Providers

Adding a new provider

Import from Doctor.com whenever you can. In wp-admin, go to Settings → Doctor.com Sync → Providers, find the provider in the Doctor.com listing and click "Sync." This pulls in their profile, bio, education, specialties, locations and photo automatically. After import, review the post and make any WHA-specific adjustments. See Data Sync for how the sync works and how to troubleshoot it.

If the provider isn't in Doctor.com yet, or you need to create one manually:

1. Create the provider post. In wp-admin, go to Providers → Add New.
2. Fill in the profile. Title is the provider's name (e.g. "Jane Smith, MD"). The format matters: the listing sorts by last name, taken as the last word before the first comma (so "Jane Smith, MD" sorts under "Smith").
3. Set the fields:
   • Photo — Professional headshot, consistent with other provider photos (same background, similar framing). The theme generates responsive srcset automatically.
   • Short bio — Appears on provider cards and at the top of the detail page
   • Bio — Full biography for the detail page
   • Quote — Optional personal quote on the detail page
   • Education, certifications, memberships, awards — Structured repeater fields
   • Appointment types — Which appointment types this provider accepts
4. Assign taxonomies:
   • Specialties (wha_providers_specialties) — What the provider specializes in. These map to Services.
   • Locations (wha_providers_locations) — Where they practice. These map to Location posts.
   • Languages (wha_providers_languages) — Languages spoken
   • Roles (wha_providers_roles) — Provider type (physician, midwife, nurse practitioner, etc.)
5. Set the NPI. The National Provider Identifier is stored as post meta (provider_npi). It's how the ratings sync matches providers to their Press Ganey data. Without an NPI, ratings won't sync.
6. Publish. The provider appears on the listing and gets their own detail page at /providers/{slug}/.

Editing a provider

Edit provider posts like any WordPress post. A few things to know:

• Photo changes take effect immediately. Media offloads to S3 automatically.
• Specialty and location changes affect where the provider shows up in filtered searches
• Bio and profile changes are cached. The listing uses transient caching at the API layer, so changes can take a few minutes to appear there. Detail pages update immediately.
• Ratings come from Press Ganey and sync automatically by NPI. Don't edit rating data by hand — it's overwritten on the next sync.

Removing a provider

Move the provider post to Trash. They drop off the listing right away and their detail page returns a 404. If a provider has left WHA, trash rather than delete. It keeps the data around in case you need it later.

Provider photos

• Use consistent framing and backgrounds across all providers
• Upload at roughly 800×1000px (portrait)
• JPG preferred
• The theme shows photos in cards (smaller) and detail pages (larger). Responsive srcset handles the sizing.
• A placeholder shows if no photo is uploaded

How the provider listing works

The provider archive at /providers/ doesn't render server-side. Instead:

1. The page loads with skeleton placeholder cards
2. JavaScript fetches provider data via AJAX
3. Cards populate with provider name, photo, specialties, location and rating

Patients can filter by specialty, location, language and role, and search by name. It all happens via AJAX, so the page never reloads.