Description
Pulsegrid Content Connector lets organizations that license the Mayo Clinic Health Information Library display that content on their own WordPress site, styled by their own theme, so visitors never leave the site.
- Search, article and landing views from a single
[pulsegrid]shortcode [pulsegrid_search]search box for headers, sidebars or the home page[pulsegrid_topics]buttons for common topics, each opening a search or a specific article- Server-side API calls — your API key never reaches the browser
- Article images proxied and cached server-side
- Caching capped at 48 hours, as Mayo Clinic’s syndication terms require
- Limits how many uncached API calls a visitor can trigger, protecting your API quota
- Canonical tag pointing at Mayo’s original URL, update date, copyright and Terms of Use link
- Optional sidebar with your own call to action (e.g. “Find a Doctor”) beside search results and articles
- Matches your theme: fonts, text and links come from the theme, and the accent color can be linked to one of the theme’s own palette colors (or switch to layout-only and style everything yourself)
- Every view can be overridden from your theme
- Demo mode with bundled sample articles, so you can try it without credentials
- WP-CLI:
wp pulsegrid status|test|cache clear
You need your own content license and API credentials from Mayo Clinic. This plugin does not include any Mayo Clinic content.
This plugin is an independent project. It is not affiliated with, endorsed by, or sponsored by Mayo Clinic. “Mayo Clinic” is a trademark of Mayo Foundation for Medical Education and Research.
External services
This plugin connects to the Mayo Clinic Content Delivery API (https://cdapi.mayoclinic.org/), operated by Mayo Clinic, to display Health Information Library content. Using it requires a content license and API credentials from Mayo Clinic.
- When: only in Live mode. Demo mode uses the sample content bundled with the plugin and makes no external requests. In Live mode, your server contacts the API when a visitor searches, opens an article, or loads an article image that isn’t already cached, and when an administrator clicks Test API connection.
- What is sent: your API key and trckr value (as request headers), the search terms, the results page number, the requested content or image ID, and the language code. Requests are made by your server; visitors’ IP addresses, cookies and other personal data are not sent.
- Mayo Clinic terms of use: https://www.mayoclinic.org/about-this-site/terms-conditions-use-policy
- Mayo Clinic privacy policy: https://www.mayoclinic.org/about-this-site/privacy-policy
Your use of the content is also governed by your own license agreement with Mayo Clinic.
Installation
- Upload the
pulsegrid-content-connectorfolder to/wp-content/plugins/and activate it. - Go to Settings Pulsegrid and click Create library page (or add
[pulsegrid]to any page). - The plugin starts in demo mode. To show real content, choose Live, enter your API key and trckr value (or define
PGCC_API_KEYandPGCC_TRCKRinwp-config.php), save, and click Test API connection.
FAQ
-
Where do I get an API key?
-
From Mayo Clinic Global Business Solutions as part of a Health Information Library content license.
-
Will it match my theme?
-
Yes. Fonts, text and link colors always come from your theme. Under Settings Pulsegrid you can link the accent color (buttons, badges, the sidebar box) to one of your theme’s palette colors, so it follows the theme if the theme changes, or set a custom color. Choose “Layout only” to turn off the plugin’s cards and buttons entirely and style everything in your theme.
-
Can I change the layout?
-
Copy any file from the plugin’s
templates/folder intoyour-theme/pulsegrid/and edit it there. -
Edit the list under Settings Pulsegrid Topic buttons, then add
[pulsegrid_topics]where you want them, usually next to[pulsegrid_search]. The Shortcodes & help tab lists every option. -
Is there a Pro version?
-
Yes. The optional Pulsegrid Pro add-on changes the sidebar to show links to your own provider and service pages matched to each article’s topic, with a table editor, CSV import/export and an admin-only category inspector. Everything described above works without it. See https://pulsegrid.davidcochran.us/pro/
-
Does it work with Yoast SEO or Rank Math?
-
Yes. On article views the canonical URL and title are passed to those plugins.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Pulsegrid Content Connector” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Pulsegrid Content Connector” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.6.1
- Demo mode: rewrote all sample articles and replaced their category codes with invented ones, so the demo contains no Mayo Clinic text or vocabulary.
- Help text and code examples use placeholder content IDs.
0.6.0
- Topic-matched sidebar links, CSV import/export and the category inspector have moved to the separate Pulsegrid Pro add-on. The call-to-action sidebar stays in this plugin; sites set to “links” show the call to action until Pro is installed. Saved links are kept and picked up by Pro.
- New hooks for add-ons:
pgcc_sidebar_modes,pgcc_sidebar_{mode},pgcc_library_args,pgcc_after_content,pgcc_admin_tabs,pgcc_admin_tab_{slug}.
0.5.0
- Renamed to Pulsegrid Content Connector (slug
pulsegrid-content-connector). Shortcodes are now[pulsegrid],[pulsegrid_search]and[pulsegrid_topics]; settings are under Settings Pulsegrid; wp-config constants arePGCC_API_KEYandPGCC_TRCKR; WP-CLI command iswp pulsegrid.
0.4.1
- Packaging: the plugin now sits at the repository root, so GitHub downloads install directly.
0.4.0
- The accent color can now come from your theme’s color palette and follows the theme when it changes. New “Layout only” option leaves all styling to the theme.
- Buttons carry the theme’s button class (
wp-element-button).
0.3.0
- New
[pulsegrid_topics]shortcode: buttons for common topics, edited under Settings Pulsegrid Topic buttons. - New Shortcodes & help tab documenting every shortcode, link parameter and customization option.
0.2.1
- Fix: “Topic” content (IDs starting with ABT-) that appears in search results now opens instead of showing an error.
0.2.0
- Sidebar links: map Mayo topics to your own provider and service pages, with a table editor and CSV import/export.
- Most-specific topic matching, default row, and an admin-only category inspector on articles.
0.1.0
- First release, converted from the standalone PHP prototype.