wp-comments-notes-api
Installation
SKILL.md
WordPress Comments and Notes API
WordPress editor Notes use the comments table with comment_type = note, but they are private editorial data, not public comments. Always make the type explicit in queries, capabilities, REST requests, counts, notifications, and deletion logic.
Separate public comments from Notes
| Concern | Public comment | Editor Note |
|---|---|---|
comment_type |
usually comment/empty legacy value |
note |
| Anonymous creation | site/filter dependent | never |
| Creation permission | normal comment policy | edit_post for the target post |
| Read permission | approved comment + readable post, or elevated access | note author or user who can edit_comment |
| Comment counts | included | excluded by Core |
| Discussion open/closed | enforced | not used as the Notes gate |
Do not query type => all and expose the result publicly. Use type => comment for public output and type => note, status => all only inside an authorized editorial context.