[wp-trac] [WordPress Trac] #51156: Create developer documentation for disclosures.json

[WordPress Trac]

#51156: Create developer documentation for disclosures.json
-------------------------------------+----------------------------------
 Reporter:  carike                   |      Owner:  (none)
     Type:  enhancement              |     Status:  new
 Priority:  normal                   |  Milestone:  5.6
Component:  Privacy                  |    Version:  trunk
 Severity:  normal                   |   Keywords:  needs-privacy-review
  Focuses:  docs, template, privacy  |
-------------------------------------+----------------------------------
 **Background:**

 The Disclosures Tab is an initiative that is underway in the Core Privacy
 Team.
 The aim is to help site owners / admins better understand what information
 their site (plugins, themes and Core) collects, where the information is
 stored and where it is sent - and in particular, who it is shared with.
 We hope to help site owners / admins make more informed privacy choices
 (e.g. when choosing which plugin to install) and to better understand
 their risk profile when it comes to privacy.
 For the most part, the actual "controlling" is planned for a sibling
 plugin, the Permissions Tab, which is not currently intended to be merged
 into Core, as this will contain more advanced settings.
 You can read more about the various privacy initiatives here:
 https://make.wordpress.org/core/2020/08/19/minutes-core-privacy-
 meeting-19-august-2020/

 **The Challenge:**

 To make #51092 understandable for plugin, theme and core developers, by
 providing a template and illustrative examples.

 **Scope:**

 The following tickets represent milestones for the Disclosures Tab:

 #51092 proposes the schema.
 [] will be created for the validation of the schema by Core.
 [] will be created for internationalization.
 This ticket only deals with developer documentation.
 #51144 proposes a UI for site-level privacy disclosures and related
 settings.

 **The Solution:**

 Illustrative example: Monetization

 In this example, a theme author would like to disclose their monetization
 practices.
 The theme author would include the following in a file named
 disclosures.json in the theme's main folder to indicate that:
 - The code contains or generates promotion for other products or services
 from the same author(s);
 - The code does not contain or generate requests for, or a mechanism to
 donate to the author(s);
 - The code contains or requests a backlink, in the form of a footer
 credit;
 - The code does not contain or generate affiliate links;
 - The code does not contain or generate paid promotion for products or
 services from others who are not the author(s).

 {{{#!php
 <?php
 {
    "monetization": {
       "upsells": [
          TRUE, "https://example.com/ToS/devsite/"
       ],
       "donations": [
          FALSE
       ],
       "backlinks": [
          TRUE, "https://example.com/ToS/devsite/"
       ],
       "affiliates": [
          FALSE
       ],
       "advertising": [
          FALSE
       ]
    }
 }
 }}}

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/51156>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform