Desk9 AI Content Disclosure
| 开发者 | desk9 |
|---|---|
| 更新时间 | 2026年8月22日 21:33 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Desk9 AI Content Disclosure helps you document AI-assisted work in a calm, readable way. Choose tools (like OpenAI or Gemini), add a short or long disclaimer, pick a layout that fits your theme, and optionally expose a compact “tools used” line or badge-style hints.
Everything runs on your server—settings and post options are stored in your WordPress database. This plugin is a practical transparency aid; statutes and obligations depend on your context, so treat the copy as informational, not a legal guarantee.
安装:
From the WordPress.org plugin directory (recommended)
- In your admin dashboard, go to Plugins → Add New.
- Search for Desk9 AI Content Disclosure.
- Click Install Now, then Activate.
- Download the plugin ZIP (from WordPress.org or your maintainer).
- Go to Plugins → Add New → Upload Plugin, choose the ZIP, and click Install Now.
- Click Activate Plugin.
- Unzip the package on your computer if needed. You should have a folder named
desk9-ai-content-disclosure. - Upload that folder to
wp-content/plugins/on your site. - In the dashboard, open Plugins and activate Desk9 AI Content Disclosure.
屏幕截图:
常见问题:
Do I need Node.js or NPM?
No. Pre-built scripts and styles ship in the build/ folder. Developers who want to rebuild from source can use Node—see Development below.
Does this plugin guarantee legal compliance (for example EU AI Act or Article 50)?
No. It helps you disclose AI use visibly, but laws and interpretations differ by region and use case. Consult qualified counsel for compliance questions.
What does “experimental JSON-LD” mean?
When enabled, the plugin can emit a non-standard JSON-LD script plus related data-* attributes once per page load. Treat it as beta: it is not a guaranteed schema.org pattern and may evolve.
Does the plugin send data to external services?
No dedicated telemetry or analytics endpoints are bundled. Settings and per-post data stay in your WordPress database. Output is rendered on your pages like other theme and plugin content.
Does it work with WPML, Polylang, or other multilingual plugins?
Yes. A wpml-config.xml ships with the plugin so WPML can register admin strings, translate the custom disclaimer meta field, and translate the text attribute on the shortcode (HTML allowed) while keeping structural fields consistent across languages. Other multilingual setups can use similar approaches or WordPress filters—see the FAQ entry on hooks in older documentation if you customize output.
更新日志:
1.4.1
- Repairs the 1.4.0 package, which reached WordPress.org incomplete: several files — including
includes/class-deskaico-image-badge.php, which the plugin loads on every request — were never committed to the release tag. Installing or updating to 1.4.0 therefore ended in a fatal error. Nothing else changed; 1.4.1 is 1.4.0 with all of its files.
- New: design directions for the notice. The existing look is now named Classic and remains the default, joined by Accent bar (clear and official, with a small heading and the same sparkle the image pill uses), Minimal (reads like a footnote), Editorial (serif, masthead tone), Technical (monospace marker) and Soft (frameless, rounded, warm).
- New: six color schemes — neutral grey, blue, warm grey/sand, green, violet and black-and-white — each setting background, border and text together at a verified contrast ratio of at least 4.5:1. Every scheme also carries a dark variant that can follow the visitor's system preference.
- New: Custom colors as the seventh option. Choosing it reveals the individual color fields — background, border and now text as well — each as a WordPress color picker: a swatch that opens the picker, with the hex value still editable as text. Picking a ready-made scheme hides those fields and shows that scheme's palette as read-only swatches instead, including its dark variant.
- The text color is new and defaults to empty, meaning the notice keeps inheriting the color from your theme exactly as before.
- Existing sites are untouched: Classic plus Custom colors is what an update selects, so the notice keeps looking exactly as before until you change it.
- Per-block color overrides still win over a scheme, so a single placement can deviate deliberately.
- New providers: Mistral AI, xAI / Grok, DeepSeek, Perplexity, Adobe Firefly, Black Forest Labs (FLUX) and Leonardo.ai — fifteen entries in total, still with “Other” for anything not listed.
- Icons now ship only where the provider's actual logo is bundled, with no generic stand-in artwork at all — the “Other” gear and the generic sparkle went too, so an unbranded chip is now always plain text. Invented motifs for Midjourney and Stability AI were removed, and so was the Copilot icon, which was in fact the GitHub Copilot mark — a different product. Those providers fall back to their abbreviation badge, which the renderer already did on its own. A made-up logo tells a reader nothing about which tool was used, and one drawn close enough to be recognised would be a knock-off.
- While Icons is the selected display style, the provider list only offers the ones a real logo exists for. Anything you already ticked stays visible and keeps working, so no stored selection can go missing.
- The provider list is now handed to the block editor from PHP instead of being repeated in three JavaScript bundles, where it had already fallen out of step.
- Fix:
other.svg, the icon for the “Other” provider, contained two raw control characters in a comment and was therefore not well-formed XML. Browsers refused to render it, so the chip stayed blank whenever “Other” was shown in icon mode. Present since the first release. - New: a Restore bundled wording button under each disclaimer preset. Once you have edited a preset there was previously no way back to the shipped text; the button rebuilds it from the plugin's own wording plus the lead sentence of the selected usage scope.
- All directions render from one shared markup tree and rearrange through CSS, so the editor preview and the front end cannot drift apart.
- New: mark individual images as AI generated or AI edited. The marking is stored on the image itself, so it follows the picture everywhere it is used — featured image, archive listings and images placed in post content, including inside galleries.
- Mark images from wherever you happen to be: a pair of fields in the media library next to the alt text, or an AI disclosure panel on the selected image block, so a picture you just inserted can be flagged without opening the media library at all.
- Record the tool that made the image and let the pill name it, for example “AI generated · Midjourney”.
- New: an optional overlay pill on marked images — choose the corner, the size, icon-only or icon plus wording, and your own text. Icon-only keeps the wording available to screen readers rather than dropping it.
- Marked images carry the pill in the block editor too, so you see the marking while writing rather than only after publishing.
- The pill is drawn over the picture with CSS and never alters the image file, so it disappears when the picture is downloaded or screenshotted — the settings screen says so plainly rather than implying a permanent watermark.
- Styled entirely through CSS custom properties, so its look can be retuned from a child theme without touching plugin markup.
- Off by default; enabling the pill under Settings → Image marking is what makes marked images show it.
- The block editor preview is now produced by the block's own PHP renderer through the block-renderer REST route, so the canvas shows the exact markup and styling the front end outputs. It replaces a separate JavaScript approximation that had drifted apart from the real output: it showed placeholder badges (“OAI ⋯”) instead of your configured tools, truncated the disclaimer at 220 characters, dropped the AI usage lead sentence, and — because the front-end stylesheet was only ever enqueued during rendering — displayed no card, border, background or badge styling at all.
- The front-end stylesheet is now loaded into the editor canvas as well, so preview and front end are styled by one and the same file.
- Fix: alignment and margin set on the block applied in the editor but were dropped on the front end, because the renderer builds its own element and never called
get_block_wrapper_attributes(). Both are now carried through to the published markup. - Fix: per-post overrides were resolved against no post at all when rendering outside a singular view; the renderer now falls back to the post the REST request sets up.
- Removed roughly 400 lines of duplicated preview logic in JavaScript along with the
deskaicoEditorConfigpayload that only fed it.
- Breaking (CSS only): every CSS class, HTML
idand CSS custom property now uses thedeskaico-prefix instead of the legacyacd-shorthand (.acd-disclosure→.deskaico-disclosure,--acd-bg→--deskaico-bg, and so on). The old three-letter prefix predates the plugin’s rename and no longer matched anything else in the codebase. Custom CSS targeting the old names needs updating; settings, content and stored data are untouched. - Translations now ship exclusively as WordPress.org language packs instead of files bundled in
/languages/, so a corrected translation reaches sites without a plugin release. Help translate at https://translate.wordpress.org/projects/wp-plugins/desk9-ai-content-disclosure/ - Fix: the block’s front-end stylesheet targeted
.wp-block-ai-content-disclosure-disclosure, a class generated by the block namespace used before the plugin was renamed. The rule never matched anything; it now targets.wp-block-deskaico-disclosure. - Compatibility: all runtime registrations (block, shortcode, post meta, auto-append, JSON-LD collector) now boot on
initinstead ofplugins_loaded. This removes the WordPress 6.7+ debug notices about_load_textdomain_just_in_timeand aboutwp_register_script/wp_register_stylerunning before the enqueue hooks. - Fix: an empty or invalid border color fell back to the background default, so the card border became invisible. Background, border and accent colors now each fall back to their own default.
- New:
uninstall.phpremoves the plugin option and all_deskaico_*post meta when the plugin is deleted (multisite-aware). - Housekeeping: declared Tested up to 7.1; removed a stray temporary file from the plugin folder.
- Settings/runtime: fix global long / short presets accidentally saved as only the informational usage-scope lead (no preset body)—options are rebuilt from the bundled texts plus your selected scope whenever that pattern is detected, so Settings and the front end stay consistent until you intentionally edit the presets.
- Settings: fixing how AI usage scope merges its introductory paragraph into long and short disclaimer presets in the browser—strip legacy leads whether they appear as plaintext or wrapped in a leading
<p>…</p>, refresh both textareas once on page load, and clarify the helper text beneath the dropdown (German strings updated).
- Block: when AI usage extent is Inherit site setting and the block uses global site disclaimer text, the front end now outputs the wording stored under Settings as-is (the admin screens already merge the usage-scope sentence into those textareas when you save). Applying the programmatic prefix twice no longer hides or duplicates the canonical Settings copy compared with choosing None.
- Frontend: prevent duplicated AI usage-scope lead sentences. Saved disclaimer HTML from Settings often wraps the introductory sentence inside
<p>…</p>; stripping only matched raw prefixes at the beginning of the string, so WordPress appended the same lead again—now trimmed whether it is plaintext or first matching paragraph (deskaico_strip_leading_usage_scope_prefixes).
- Frontend: fixing disclaimer resolution so Settings → Disclaimer text is honored whenever a disclosure block or shortcode explicitly uses global site defaults, even if the document sidebar uses “Custom message & tools” for auto-append/overrides on the same entry.
- Front-end ignores “empty-looking” markup (such as stray empty paragraphs): only real visible text satisfies custom disclaimer fields, preventing the notice from collapsing to nothing.
- Document sidebar help text clarified for how per-post customs interact with globally defaulted blocks.
- Block editor preview: the canvas now reflects Settings → Default disclaimer length (long vs short) and the saved long/short disclaimer texts, including the block inserter preview—no more “blank” or always-long English placeholder when the short template is selected.
- Developer note:
deskaicoEditorConfignow passesdefaultDisclaimerVariant,disclaimerPlainLong, anddisclaimerPlainShortfor editor preview only (front-end markup is unchanged).
- First public release on WordPress.org: settings UI, disclosure renderer, dynamic block (inspector presets for disclaimer length, AI usage extent, per-block tools, multiple blocks per post) and shortcode
[deskaico_disclosure], document sidebar (post overrides and optional auto-append layout), Beta JSON-LD collector, German translation starter pack. - Distinctive listing title Desk9 AI Content Disclosure, slug
desk9-ai-content-disclosure, Text Domain aligned with the slug; all PHP identifiers use thedeskaico/DESKAICO/Deskaicoprefix for Plugin Check compliance. - Toolbar buttons load from
@wordpress/componentsfor current WordPress block editor compatibility; block namespacedeskaico/disclosure. - Show selected tools as: abbreviations, bundled SVG icons, or plain full names (comma-separated).
- Front-end compact layout uses neutral “Tools used:” wording (no automatic plugin credits or outbound promotional links on the public site).
- Source transparency: human-readable JavaScript and Sass under
src/withpackage.jsonandwebpack.config.js; Development section in this readme documentsnpm install/npm run build; compiled assets ship inbuild/. - Defense-in-depth output escaping:
Deskaico_Renderer::render()runs final HTML throughwp_kses()with allow-listdeskaico_kses_allowed_disclosure. - Beta JSON-LD emitted via
wp_print_inline_script_tag()with safe JSON encoding flags. - Bundled PHP translations via Text Domain + Domain Path with WordPress JIT loading (per Plugin Check). Ship
languages/desk9-ai-content-disclosure-{locale}.mo; duplicatemsgidremoved inde_DE.po. - Verified with WordPress Plugin Check “plugin-review” PHPCS ruleset and relevant security/naming sniffs.