Add new text block for Pingbacks

[gwwar]

Folks have been requesting an API data change for Pingbacks (a special type of comment to note when blogs are linking between each other p7jreA-TT-p2), to add an additional text block to link back to the original source post. This will help folks moderate if they want the pingback. For notes this may look like the images below.

If folks have alternative ideas on how to do the same, please discuss in the comments. If we come up with a different agreement, please remember to update this summary with the outcome and new proposed changes. cc @Automattic/lannister @dmsnell

If we do not bump API versions, please coordinate heavily with Mobile, as they currently have a hack in place to do just this.

Patch in D15862-code

Before:

After:

Diff:

69a70,90
>       "text": "Read the source post",
>       "ranges": [
>         {
>           "type": "noticon",
>           "indices": [
>             0,
>             0
>           ],
>           "value": "\uf442"
>         },
>         {
>           "type": "",
>           "indices": [
>             0,
>             20
>           ],
>           "url": "https:\/\/link-to-the-source.blog\/sarasonia.html"
>         }
>       ]
>     },
>     {

Original

{
  "id": 3407238481,
  "type": "comment",
  "read": 1,
  "noticon": "\uf107",
  "timestamp": "2018-06-04T21:02:39+00:00",
  "icon": "https:\/\/www.gravatar.com\/avatar\/ad516503a11cd5ca435acc9bb6523536?s=128",
  "url": "https:\/\/lanteanar.wordpress.com\/2018\/05\/09\/post-post-2\/",
  "subject": [
    {
      "text": "Pingback? \u2013 Lalala linked to your post Post Post.",
      "ranges": [
        {
          "type": "site",
          "indices": [
            0,
            18
          ],
          "url": "https:\/\/lalalantean.wordpress.com\/2018\/06\/04\/pingback-2\/"
        },
        {
          "type": "post",
          "indices": [
            39,
            48
          ],
          "url": "https:\/\/lanteanar.wordpress.com\/2018\/05\/09\/post-post-2\/",
          "site_id": 56127862,
          "id": 236
        }
      ]
    }
  ],
  "body": [
    {
      "text": "https:\/\/lalalantean.wordpress.com\/2018\/06\/04\/pingback-2\/",
      "ranges": [
        {
          "type": "post",
          "indices": [
            0,
            56
          ],
          "url": "https:\/\/lalalantean.wordpress.com\/2018\/06\/04\/pingback-2\/"
        }
      ],
      "media": [
        {
          "type": "image",
          "indices": [
            0,
            0
          ],
          "height": "256",
          "width": "256",
          "url": "https:\/\/www.gravatar.com\/avatar\/ad516503a11cd5ca435acc9bb6523536?s=128"
        }
      ],
      "meta": {
        "links": {
          "home": "https:\/\/lalalantean.wordpress.com\/2018\/06\/04\/pingback-2\/"
        },
        "titles": {
          "home": ""
        }
      },
      "type": "user"
    },
    {
      "text": "[\u2026] Linked article here [\u2026]",
      "actions": {
        "spam-comment": false,
        "trash-comment": false,
        "approve-comment": false,
        "edit-comment": true,
        "replyto-comment": true,
        "like-comment": false
      },
      "meta": {
        "ids": {
          "comment": 55,
          "post": 236,
          "site": 56127862
        },
        "links": {
          "comment": "https:\/\/public-api.wordpress.com\/rest\/v1\/comments\/55",
          "post": "https:\/\/public-api.wordpress.com\/rest\/v1\/posts\/236",
          "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/56127862"
        }
      },
      "type": "comment",
      "nest_level": 0,
      "edit_comment_link": "https:\/\/wordpress.com\/comment\/lanteanar.wordpress.com\/55?action=edit"
    }
  ],
  "meta": {
    "ids": {
      "site": 56127862,
      "post": 236,
      "comment": 55
    },
    "links": {
      "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/56127862",
      "post": "https:\/\/public-api.wordpress.com\/rest\/v1\/posts\/236",
      "comment": "https:\/\/public-api.wordpress.com\/rest\/v1\/comments\/55"
    }
  },
  "title": "Link",
  "header": [
    {
      "text": "Jorge",
      "ranges": [
        {
          "type": "user",
          "indices": [
            0,
            5
          ],
          "url": "http:\/\/www.lantean.co",
          "email": "jorge@lantean.com.ar",
          "id": 45413599
        }
      ],
      "media": [
        {
          "type": "image",
          "indices": [
            0,
            0
          ],
          "height": "256",
          "width": "256",
          "url": "https:\/\/2.gravatar.com\/avatar\/e44d9c00c3af8037f203ca42207a99d7?s=256&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2Fad516503a11cd5ca435acc9bb6523536%3Fs%3D256&r=G"
        }
      ]
    },
    {
      "text": "Post Post"
    }
  ]
}

Proposed Update

{
  "id": 3407238481,
  "type": "comment",
  "read": 1,
  "noticon": "\uf107",
  "timestamp": "2018-06-04T21:02:39+00:00",
  "icon": "https:\/\/www.gravatar.com\/avatar\/ad516503a11cd5ca435acc9bb6523536?s=128",
  "url": "https:\/\/lanteanar.wordpress.com\/2018\/05\/09\/post-post-2\/",
  "subject": [
    {
      "text": "Pingback? \u2013 Lalala linked to your post Post Post.",
      "ranges": [
        {
          "type": "site",
          "indices": [
            0,
            18
          ],
          "url": "https:\/\/lalalantean.wordpress.com\/2018\/06\/04\/pingback-2\/"
        },
        {
          "type": "post",
          "indices": [
            39,
            48
          ],
          "url": "https:\/\/lanteanar.wordpress.com\/2018\/05\/09\/post-post-2\/",
          "site_id": 56127862,
          "id": 236
        }
      ]
    }
  ],
  "body": [
    {
      "text": "https:\/\/lalalantean.wordpress.com\/2018\/06\/04\/pingback-2\/",
      "ranges": [
        {
          "type": "post",
          "indices": [
            0,
            56
          ],
          "url": "https:\/\/lalalantean.wordpress.com\/2018\/06\/04\/pingback-2\/"
        }
      ],
      "media": [
        {
          "type": "image",
          "indices": [
            0,
            0
          ],
          "height": "256",
          "width": "256",
          "url": "https:\/\/www.gravatar.com\/avatar\/ad516503a11cd5ca435acc9bb6523536?s=128"
        }
      ],
      "meta": {
        "links": {
          "home": "https:\/\/lalalantean.wordpress.com\/2018\/06\/04\/pingback-2\/"
        },
        "titles": {
          "home": ""
        }
      },
      "type": "user"
    },
    {
      "text": "Read the source post",
      "ranges": [
        {
          "type": "noticon",
          "indices": [
            0,
            0
          ],
          "value": "\uf442"
        },
        {
          "type": "",
          "indices": [
            0,
            20
          ],
          "url": "https:\/\/link-to-the-source.blog\/sarasonia.html"
        }
      ]
    },
    {
      "text": "[\u2026] Linked article here [\u2026]",
      "actions": {
        "spam-comment": false,
        "trash-comment": false,
        "approve-comment": false,
        "edit-comment": true,
        "replyto-comment": true,
        "like-comment": false
      },
      "meta": {
        "ids": {
          "comment": 55,
          "post": 236,
          "site": 56127862
        },
        "links": {
          "comment": "https:\/\/public-api.wordpress.com\/rest\/v1\/comments\/55",
          "post": "https:\/\/public-api.wordpress.com\/rest\/v1\/posts\/236",
          "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/56127862"
        }
      },
      "type": "comment",
      "nest_level": 0,
      "edit_comment_link": "https:\/\/wordpress.com\/comment\/lanteanar.wordpress.com\/55?action=edit"
    }
  ],
  "meta": {
    "ids": {
      "site": 56127862,
      "post": 236,
      "comment": 55
    },
    "links": {
      "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/56127862",
      "post": "https:\/\/public-api.wordpress.com\/rest\/v1\/posts\/236",
      "comment": "https:\/\/public-api.wordpress.com\/rest\/v1\/comments\/55"
    }
  },
  "title": "Link",
  "header": [
    {
      "text": "Jorge",
      "ranges": [
        {
          "type": "user",
          "indices": [
            0,
            5
          ],
          "url": "http:\/\/www.lantean.co",
          "email": "jorge@lantean.com.ar",
          "id": 45413599
        }
      ],
      "media": [
        {
          "type": "image",
          "indices": [
            0,
            0
          ],
          "height": "256",
          "width": "256",
          "url": "https:\/\/2.gravatar.com\/avatar\/e44d9c00c3af8037f203ca42207a99d7?s=256&d=https%3A%2F%2Fsecure.gravatar.com%2Favatar%2Fad516503a11cd5ca435acc9bb6523536%3Fs%3D256&r=G"
        }
      ]
    },
    {
      "text": "Post Post"
    }
  ]
}