Managing Providers

Adding a New Provider

The preferred method is to import from Doctor.com. 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.

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 title format matters — the provider listing sorts by last name, extracted from the text before the first comma.
3. Set the ACF fields:
   • Photo — Professional headshot. Should be 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 displayed 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). This is how the ratings sync matches providers to their PressGaney 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. Key things to know:

• Photo changes take effect immediately — media is offloaded to S3 automatically
• Specialty/location changes affect where the provider appears in filtered searches
• Bio and profile changes are cached — the provider listing uses transient caching at the API layer, so changes may take a few minutes to appear on the listing page. Individual provider detail pages update immediately.

Removing a Provider

Move the provider post to Trash. This immediately removes them from the listing and their detail page returns a 404. If the provider has left the practice, trashing is preferred over deleting — it preserves the data in case it's needed later.

Provider Photos

• Use consistent framing and backgrounds across all providers
• Upload at approximately 800×1000px (portrait orientation)
• JPG format preferred
• The theme displays photos in cards (smaller) and detail pages (larger) — responsive srcset handles the sizing
• A placeholder image is shown if no photo is uploaded

How the Provider Listing Works

The provider archive at /providers/ does not render server-side. Instead:

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

Users can filter by specialty, location, language, and role. They can also search by name. All filtering happens via AJAX — the page doesn't reload.