Last week, NPR released Pym.js version 1.3.0, and earlier this week released 1.3.1. These feature releases introduced optional scroll tracking, allowing the child iframe to know where the browser is on the parent page. You can read more about how that's implemented, and how it can be used, on the NPR Visuals Team blog post announcing Pym 1.3.0. Pym.js version 1.3.1 added a function getParentPositionInfo
to the Pym child.
Pym Shortcode version 1.3.1 brings you the latest version of Pym.js, as well as the following improvements:
- Adds an
id=""
attribute to allow setting of custom IDs on embeds, for Github issue #21. Theid=""
attribute is useful if you want to load a new embedded page inside the iframe and maintain Pym functionality. - Adds a
class=""
attribute to allow setting custom of classes on embeds, for Github issues #22 and #23. Theclass=""
attribute allows you to, among other things, add layout classes to embeds so they take a different shape on your page. - Adds a default class name
pym
to all embed-containing<div>
elements output by this plugin, and a filterpym_shortcode_default_class
to allow changing the default class or removing it.
You can download the new version of the Pym Shortcode plugin through your WordPress dashboard, on the WordPress.org plugin repository, or on Github.
If you have feedback on the plugin or would like to contribute to development of the Pym Shortcode plugin, check out our contributor guidelines and join the conversation in the plugin's GitHub issues or in our Slack.