KOZ Copy Actions
| 开发者 | ramirkz |
|---|---|
| 更新时间 | 2026年9月3日 23:39 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
KOZ Copy Actions lets you turn selected text, values, buttons, links or other frontend elements into copy-to-clipboard targets.
You choose what can be copied by adding simple CSS selectors in the plugin settings. The plugin then handles mouse clicks and keyboard activation, shows optional feedback, and copies the value directly in the visitor's browser.
No copied content is sent to the developer or to an external service.
Part of the KOZ Suite
KOZ Copy Actions is one focused module of the KOZ Suite, a family of independent WordPress plugins with a shared KOZ administration experience and visual identity.
Each KOZ plugin can be installed independently or combined with other KOZ Suite modules.
Current public KOZ plugins:
- KOZ SEO Core — technical SEO, schema, sitemaps, AI discovery and OpenAI Vision image ALT.
- KOZ Copy Actions — accessible copy-to-clipboard actions for selected WordPress content.
- KOZ URL-Only Comment Spam — privacy-first local moderation for URL-only comment spam.
- KOZ Static Translate — AI-powered multilingual translation with Microsoft Azure Translator and static language routes.
- KOZ Translate Diagnostics — read-only diagnostics and privacy-safe reports for KOZ Static Translate.
- Copy coupon codes, reference numbers, wallet addresses or contact details.
- Add a copy action to code snippets, IDs or short text values.
- Copy the current value of an input, textarea or select field.
- Copy a value stored in a data attribute.
- Copy text or a form value from another element on the same page.
- Limit copy actions to selected paths or sections of the site.
- Use the same configuration on multilingual WordPress sites.
- Install and activate KOZ Copy Actions.
- Open KOZ Suite -> Copy Actions in the WordPress admin.
- Enable Copy actions.
- In CSS selectors, add one selector per line for the elements visitors should be able to copy.
- Save the settings.
- Open a public page and click or keyboard-activate a matching element.
.copy-me
If your page contains:
<span class="copy-me">PROMO-2026</span>
the visitor can copy PROMO-2026 by activating that element.
Choosing what gets copied
The plugin uses the first applicable source below.
1. Explicit value with data-copy-value
Use this when the visible label is different from the value that should be copied.
<button class="copy-me" data-copy-value="PROMO-2026">Copy promo code</button>
Copied value: PROMO-2026
2. Another element with data-copy-target
Use a local ID reference beginning with #.
<input id="account-number" value="UA123456789">
<button class="copy-me" data-copy-target="#account-number">Copy account number</button>
Copied value: the current value of #account-number.
3. Form controls
If a matching element is an input, textarea or select field, the plugin copies its current value.
4. Normal page content
For other matching elements, the plugin copies the element's visible text content.
Supported selectors
For safety and predictable behaviour, settings accept simple selectors only:
- A class selector such as
.copy-me - An ID selector such as
#copy-code - Supported data-attribute selectors such as
[data-copy-value],[data-copy-target],[data-copy-key]and[data-uafree-copy]
/contact/
/donate/
/products/*
An ending * matches all paths beginning with that prefix.
For multilingual sites with language-specific URLs, add each required language path, for example:
/en/contact/
/uk/kontakty/
Accessibility and feedback
KOZ Copy Actions can:
- Add keyboard focus to matching non-interactive elements.
- Add button semantics and an accessible label where appropriate.
- Support activation with Enter or Space.
- Show an optional copy icon.
- Show localized success or error messages.
- Position feedback at the bottom centre, bottom left or bottom right.
- Preserve formatting or collapse repeated whitespace.
- Prevent navigation when a matching link is used as a copy action.
koz-copy-actions text domain.
Admin labels and frontend messages such as Copied, Could not copy and Copy to clipboard use WordPress translation functions and remain compatible with the standard WordPress.org translation system.
Version 1.1.13 also includes the KOZ Suite runtime language baseline: Ukrainian, Chinese, Spanish, Arabic, Indonesian, Portuguese, French, Japanese, German and Hindi, with English fallback. The WordPress user locale controls the administration interface. On the frontend, supported language-prefixed routes use the matching bundled copy feedback language.
The copy logic itself is language-independent: it works with the rendered content of the current page, so the same selector configuration can be used with multilingual plugins and translated pages.
If your multilingual setup uses different URL paths for each language and you use Allowed paths, add the corresponding path for each language.
KOZ Copy Actions does not translate the content being copied. It copies the value or text that is already rendered on the current page.
Privacy
Clipboard operations happen in the visitor's browser.
The plugin does not:
- Store copied values.
- Store IP addresses or visitor identifiers.
- Set tracking cookies.
- Send analytics or telemetry.
- Make external requests for copy functionality.
安装:
- Install KOZ Copy Actions from the WordPress Plugin Directory or upload the plugin ZIP through Plugins -> Add New Plugin -> Upload Plugin.
- Activate the plugin.
- Open KOZ Suite -> Copy Actions.
- Enable copy actions.
- Add one or more CSS selectors for the elements that should be copyable.
- Optionally restrict the feature to selected paths.
- Configure the copy icon, feedback message, whitespace and accessibility options.
- Click Save settings.
- Test the selected elements on a public page with both mouse and keyboard.
常见问题:
Do I need to edit theme PHP files?
No. If your page builder, block editor or theme lets you add a CSS class or supported data attribute to an element, you can normally configure the copy action without editing PHP.
What happens if I use .copy-me as a selector?
Every public element with the class copy-me becomes a copy target on allowed pages. Normal text elements copy their rendered text. Form controls copy their current value.
Can the copied value be different from the visible text?
Yes. Add data-copy-value to the matching element.
Can one button copy text from another element?
Yes. Use data-copy-target="#element-id" and make sure the referenced element has that ID.
Does it work with WPML, Polylang or other multilingual setups?
The plugin does not require a specific multilingual integration. It operates on the rendered frontend content and simple selectors, so it can work on translated pages. If you restrict copy actions by URL path, configure the required path for each language.
Does the plugin translate copied content?
No. It copies the content already displayed on the current page.
Are the plugin interface and copy messages translatable?
Yes. User-facing strings are internationalized with the koz-copy-actions text domain and are compatible with the WordPress.org translation system.
Does the plugin send copied values anywhere?
No. Clipboard operations are performed locally in the browser and copied values are not sent to the developer or an external service.
Can I disable navigation on links used for copying?
Yes. Enable Prevent navigation when a matching link is clicked in the plugin settings.
更新日志:
1.1.14
- Updated KOZ Suite documentation to include KOZ Static Translate as the fourth public plugin.
- Updated WordPress compatibility metadata for WordPress 7.1.
- No changes to clipboard, selector, path, privacy or multilingual runtime behavior.
- Added bundled runtime interface translations for Ukrainian, Chinese, Spanish, Arabic, Indonesian, Portuguese, French, Japanese, German and Hindi, with English fallback.
- Frontend copy feedback follows supported language-prefixed routes while WordPress user locale controls the administration interface.
- Preserved all clipboard, selector, path, privacy and compatibility behaviour from 1.1.12.
- Expanded the WordPress.org documentation with a complete quick-start guide and copy examples.
- Added clear documentation for multilingual WordPress sites and translation support.
- Added FAQ entries explaining selectors, data attributes, path restrictions and privacy.
- Moved historical UA FREE migration information out of the main feature list.
- No frontend or settings behaviour changed in this release.
- Added the required translators comment for the diagnostics placeholder.
- Removed the Domain Path header because this package does not ship a local translations directory.
- Restored the real admin settings page to the stable plugin-specific slug koz-copy-actions.
- Removed the hidden compatibility redirect that could leave the WordPress admin content area blank.
- Kept all plugin-owned PHP symbols, options, hooks, handles and JavaScript globals under the unique kozcoac / KOZCOAC prefix and ramirkz\kozcopyactions namespace.
- Added a backward-compatible admin-page alias so existing links using page=koz-copy-actions open the current KOZ Copy Actions settings page instead of showing an access error.
- Primary internal page slug remains uniquely prefixed as kozcoac-copy-actions.
- Standardized every plugin-owned PHP symbol, option, hook, script handle, page slug and JavaScript global under the unique kozcoac prefix or ramirkz\kozcopyactions namespace.
- Replaced generic KOZ Suite identifiers inside this plugin with plugin-specific identifiers.
- Preserved migration from previous UA FREE Copy settings.
- Preserved frontend compatibility with existing UA FREE data attributes and copy-success event listeners.
- Updated the developer support block and LinkedIn contact.