KlyDexa Link Actions for ACF
| 开发者 | klydexa |
|---|---|
| 更新时间 | 2026年10月27日 23:04 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Standard link – an ordinary link to a page on your site, another site, an email address or a phone number, optionally opening in a new tab.
- Image gallery popup – images picked, removed and reordered in the WordPress Media Library, shown in an accessible popup with Previous and Next buttons, an image counter, keyboard and swipe navigation.
- Video popup – a video from the Media Library (MP4, WebM or Ogg) or a YouTube or Vimeo video, played in a popup and stopped when the popup closes.
- Shortcode popup – the output of a shortcode, for example a contact or newsletter form, in a popup. Only shortcodes an administrator has explicitly allowed can be used.
- Uses the browser's native
<dialog>element. No jQuery, slider library or popup library on the front end. - One small script (under 5 KB gzipped) serves every Link Action on the page and is loaded only on pages that show a popup. Standard links load no JavaScript.
- Keyboard support: Enter or Space opens a popup, Escape closes it, arrow keys, Home and End move through a gallery. Focus returns to the link when the popup closes.
- Every popup has a labelled, always-visible close button. Animations are skipped for visitors who prefer reduced motion.
- Without JavaScript, a popup link jumps to the popup content shown inline on the page instead of doing nothing.
安装:
- Install and activate Advanced Custom Fields (free) or ACF PRO, version 6.0 or later.
- Install and activate KlyDexa Link Actions for ACF.
- In ACF, edit a field group and add a field of type KlyDexa Link Actions (in the Relational category).
- Optional: if editors should be able to show shortcodes in popups, go to Settings > Link Actions for ACF and select the allowed shortcodes.
- Display the field in your theme:
<?php echo klydexa_link_actions_for_acf_render( get_field( 'my_link_action' ) ); ?>
Or set the field's Return format to "Rendered HTML" and use the_field( 'my_link_action' ).屏幕截图:
常见问题:
Does this plugin work without ACF?
The field type needs Advanced Custom Fields 6.0 or later, free or PRO. Without it, the plugin shows a notice to administrators and does nothing else.
Which shortcodes can editors use?
None, until an administrator allows them under Settings > Link Actions for ACF. Every user who can edit a Link Action field can then use the allowed shortcodes with any attributes, so allow only shortcodes that are safe for those users. Developers can also allow shortcodes with the klydexa_link_actions_for_acf_allowed_shortcodes filter.
Will every shortcode work in a popup?
No plugin can promise that. The shortcode is rendered on the server when the page loads and stays in place on the page, so ordinary forms keep working. However, some plugins load their scripts only on certain pages, measure their content when the page loads (which fails while the popup is hidden) or expect to appear only once per page. Test each shortcode you allow. See the developer documentation for the kdlaa:open event, which can be used to re-initialize such content.
Which video services are supported?
YouTube and Vimeo page addresses, for example https://www.youtube.com/watch?v=…, https://youtu.be/… or https://vimeo.com/…. Embed codes and other services are not accepted.
Does the video start automatically?
When "Start video when the popup opens" is on (the default), playback starts after the visitor clicks the link, which counts as their request to play. Some browsers still require a second click, for example on mobile data-saving modes.
Can I style the popup?
Yes. All classes start with kdlaa-, and colors, radius and widths are CSS custom properties on .kdlaa-dialog. You can also pass extra CSS classes to the link with the class argument of the render function.
Does it work with caching and optimization plugins?
Yes. The markup does not depend on the visitor, and the script is a standard deferred footer script with no inline configuration. Excluding it from combining is not required.
What happens when I uninstall the plugin?
The shortcode allowlist setting is deleted. Link Action field values are your content and are kept in the database.
更新日志:
- Initial release.