Topic page enhancements

[zerolab]

What is the context of this PR?

This PR adds:

• the ability to feature an article series and always display the latest article in the series)
  • the feature item will display the listing image, if set
• the ability to highlight articles and/or methodologies (CMS-294)
  • the chosen items take priority and will display first in the chosen order. the rest up to 3 is backfilled from other relevant statistical articles (or methodologies, for its section)
• an explore more StreamField block with internal and external links
• wires everything in the template
• misc enhancements
  • adds a label attribute to all relevant pages.
  • adds an utility function to prep a page queryset to be displayed in an onsDocumentList component

Screencast: https://www.loom.com/share/bff403cd0e8e46a3a769a1530349ffef

To-Do:

• limit the featured series chooser to relevant series (created under the given topic)
• limit the highlights chooser to relevant pages (created under the topic)
• tests

How to review

• Check the branch out locally.
• npm run build
• Run migrations.
• Create or edit a topic page and sequantially fill in the various fields (features, highlighted articles, highlighted methodologies, explore more). Also create several series / articles in the series, and methodologies, under the given topic page

Follow-up Actions

• enhance with related articles/methodologies by taxonomy, when the feature is merged.

[nehakerung]

LGTM - looks good, just have a small question.

[zerolab]

@AdamHawtin can you run npm run build, that should sort out the featured block. (I missed that from the instructions, now updated in the ticket description)

[AdamHawtin]

Looks good to me, the functionality works as expected.

I have some questions about the behaviour with highlighting/featuring draft pages. The way it's handled makes sense technically, with editors able to select to feature/highlight draft pages, but those draft pages then not appearing on the published topic page until they are published, but this isn't communicated in the editor. I wonder if it will be understood by users? Perhaps draft pages need to be highlighted in the editor with a warning that they will not show until they are published.

[sanjeevz3009]

Looks good to me, the functionality works as expected.

I have some questions about the behaviour with highlighting/featuring draft pages. The way it's handled makes sense technically, with editors able to select to feature/highlight draft pages, but those draft pages then not appearing on the published topic page until they are published, but this isn't communicated in the editor. I wonder if it will be understood by users? Perhaps draft pages need to be highlighted in the editor with a warning that they will not show until they are published.

@AdamHawtin Echoing what Adam said. This is the same behaviour on the Generic Index page.
@kacperpONS

[zerolab]

@AdamHawtin @sanjeevz3009 I hear you both. We have a backlog item that looks specifically at previews in a holistic manner (CMS-356) and one that looks at release preview in particular (CMS-350)

[kacperpONS]

LGTM, two quick questions:

• in your walkthrough it seems that the article titles are displayed without the article series title prefix, but when running this branch it shows both. Just wanted to clarify whether that has changed since you recorded the screencast?
• why is the label field defined as a method? wouldn't it be sufficient if it was defined as a class variable?

[zerolab]

@kacperpONS

1. I noticed the same while doing the screencast, so followed it up in c45deb1
2. Old habits. class var works just as well, so updated in 586f1c2. Cheers!

[sanjeevz3009]

Everything looks good to me! Works as expected! One minor comment =)

[sanjeevz3009]

LGTM!