{"id":262692,"date":"2025-11-28T10:48:58","date_gmt":"2025-11-28T10:48:58","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/dans-annotator\/"},"modified":"2025-12-07T09:57:50","modified_gmt":"2025-12-07T09:57:50","slug":"dans-annotator","status":"publish","type":"plugin","link":"https:\/\/bal.wordpress.org\/plugins\/dans-annotator\/","author":18349158,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.2.0","stable_tag":"1.2.0","tested":"6.9.4","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"Dan's Annotator","header_author":"DanL","header_description":"Page annotation system \u2014 with threaded comments.","assets_banners_color":"","last_updated":"2025-12-07 09:57:50","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":5,"author_block_rating":0,"active_installs":0,"downloads":225,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation"],"tags":{"1.1.0":{"tag":"1.1.0","author":"lazardanlucian","date":"2025-11-28 10:52:44"},"1.1.1":{"tag":"1.1.1","author":"lazardanlucian","date":"2025-12-03 15:26:19"},"1.2.0":{"tag":"1.2.0","author":"lazardanlucian","date":"2025-12-07 09:57:50"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":2},"assets_icons":{"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3405096,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0","1.1.1","1.2.0"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3405057,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3405057,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"Logged in view of the panel","2":"Settings page"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[15354,6389,107,108,183459],"plugin_category":[42,44],"plugin_contributors":[251329],"plugin_business_model":[],"class_list":["post-262692","plugin","type-plugin","status-publish","hentry","plugin_tags-annotations","plugin_tags-collaboration","plugin_tags-comments","plugin_tags-feedback","plugin_tags-page-notes","plugin_category-contact-forms","plugin_category-discussion-and-community","plugin_contributors-lazardanlucian","plugin_committers-lazardanlucian"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/dans-annotator\/assets\/icon-256x256.jpg?rev=3405096","icon_2x":"https:\/\/ps.w.org\/dans-annotator\/assets\/icon-256x256.jpg?rev=3405096","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/dans-annotator\/assets\/screenshot-1.jpg?rev=3405057","caption":"Logged in view of the panel"},{"src":"https:\/\/ps.w.org\/dans-annotator\/assets\/screenshot-2.jpg?rev=3405057","caption":"Settings page"}],"raw_content":"<!--section=description-->\n<p>Dan's Annotator lets logged-in users (and email based collaborators) highlight elements on any page and discuss them in threaded comments. It adds a floating UI to create, browse, and close annotation threads, plus @-mentions with email notifications.<\/p>\n\n<h3>Features<\/h3>\n\n<p>\u2013 Custom database tables for threads, comments, tags, and collaborators (created on activation).\n\u2013 Admin bar toggle to enable\/disable annotation mode for logged-in users.\n\u2013 Front-end badges showing counts and a side panel UI for reading\/posting comments.\n\u2013 @username tagging with autocomplete and email\/admin-notice notifications.\n\u2013 REST API endpoints used by the front-end JavaScript.\n\u2013 Support for outside collaborators with email-based or link-based access.<\/p>\n\n<h3>Usage<\/h3>\n\n<h3>@ Completion (User Tagging)<\/h3>\n\n<p>To mention a registered WordPress user in an annotation comment:\n1. Type <code>@<\/code> followed by the username or email\n2. An autocomplete dropdown will appear showing matching users\n3. Select the user from the list or continue typing their username\n4. The tagged user will receive a notification (admin notice for logged-in users)<\/p>\n\n<p>Example: <code>@john<\/code> or <code>@admin<\/code><\/p>\n\n<h3>@email Collaborators (Email-Based Access)<\/h3>\n\n<p>To invite external collaborators who don't have WordPress accounts:\n1. In a comment, type <code>@<\/code> followed by their email address\n2. Example: <code>@john@doe.com<\/code>\n3. The collaborator will automatically be created and receive an email with a secure magic link\n4. They can click the link to access and comment on the specific thread without creating an account\n5. Email-based collaborators are scoped to only the threads they're tagged in<\/p>\n\n<p><strong>Note:<\/strong> The magic link is unique and secure, tied to their email address. Enable this feature in Settings \u2192 Annotator \u2192 Outside Collaborators.<\/p>\n\n<h3>!@link Collaborators (Link-Based Access)<\/h3>\n\n<p>For lightweight collaborator access without requiring an email:\n1. In a comment, type <code>!@<\/code> followed by a name\/identifier\n2. Example: <code>!@mike<\/code> or <code>!@designer<\/code>\n3. A token-based collaborator is created with a shareable link\n4. Copy the generated link from the comment and share it directly\n5. Anyone with the link can participate using that collaborator identity\n6. Link-based collaborators are also scoped to the threads they're tagged in<\/p>\n\n<p><strong>Note:<\/strong> Enable token-based collaborators in Settings \u2192 Annotator \u2192 Token-based collaborators. This is useful for quick feedback without email verification.<\/p>\n\n<h3>License<\/h3>\n\n<p>This plugin is licensed under the GNU General Public License v2.0 or later.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>dans-annotator<\/code> directory to your <code>wp-content\/plugins<\/code> folder.<\/li>\n<li>Activate the plugin in WP Admin (tables are created on activation).<\/li>\n<li>While logged in, use the admin bar toggle to enable annotation mode on the front-end.<\/li>\n<\/ol>","raw_excerpt":"Lightweight front-end annotation tool with threads, tagging, and collaborator sessions.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/262692","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=262692"}],"author":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/lazardanlucian"}],"wp:attachment":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=262692"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=262692"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=262692"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=262692"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=262692"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=262692"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}