From 1173db4a16bb2938ba62a6cd50372a76a7f9e05f Mon Sep 17 00:00:00 2001 From: Viktor Garske Date: Thu, 23 Jul 2020 16:42:25 +0200 Subject: Fixed #31822 -- Added support for comments URL per feed item. The item_comments hook returns a comments URL which is then used by the feed builder. --- docs/ref/contrib/syndication.txt | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'docs/ref') diff --git a/docs/ref/contrib/syndication.txt b/docs/ref/contrib/syndication.txt index 13aa944e8a..e9063d0629 100644 --- a/docs/ref/contrib/syndication.txt +++ b/docs/ref/contrib/syndication.txt @@ -889,6 +889,27 @@ This example illustrates all possible attributes and methods for a item_copyright = 'Copyright (c) 2007, Sally Smith' # Hard-coded copyright notice. + # ITEM COMMENTS URL -- It's optional to use one of these three. This is + # a hook that specifies how to get the URL of a page for comments for a + # given item. + + def item_comments(self, obj): + """ + Takes an item, as returned by items(), and returns the item's + comments URL as a normal Python string. + """ + + def item_comments(self): + """ + Returns the comments URL for every item in the feed. + """ + + item_comments = 'https://www.example.com/comments' # Hard-coded comments URL + +.. versionchanged:: 3.2 + + Support for a comments URL per feed item was added through the + ``item_comments`` hook. The low-level framework ======================= -- cgit v1.3