feat(core-cms): redirect blog posts without new plugin

[wesleyboar]

Overview

Redirect certain blog posts without using a plugin.

Changes since 2023-06-02 Feedback

• Redirection on News Articles does not require manual URL.
• Core CMS provides static tag classes on markup.
• TUP CMS JavaScript relies on static tag classes.
• TUP CMS re-uses code to find external article URL.
• Knowledge that Google could send user to article URL.

Related

• replaces feat(tup-cms): redirect plugin app #121
• requires feat: support blog article redirect via cms setting & html class Core-CMS#594
• later added to Core-CMS via feat: tup-706 news on other sites Core-CMS#868

Changes

• change core-cms image tag
• add cms setting to identify redirect articles
• add redirect snippet template
• add blog list external url snippet

Testing

Remote

• News Listing: News > Latest News
• Article (A) (View): Towers in the Storm
• Article (A) (Edit): Towers in the Storm (with ?edit at end of URL)
• Article (B) (View): Storm Wave Sentinels
• Article (B) (Edit): Storm Wave Sentinels (with ?edit at end of URL)

Open External Article in New Tab

Add Redirect Feature to News

1. On news listing, in "Footer-Content", create a new snippet.
2. Set "HTML:" to external.
3. Set "TEMPLATE:" to snippets/news/open-external-post.html
4. Save snippet.

Redirect Article in List to New Tab

5. Create article that has:
   1. external link in its abstract
      ^{To make the link invisible, you may add hidden attribute on the link.}
   2. tag external (add within "Info" section)
6. In news listing, in edit mode, verify article heading text link opens external URL in new tab.
7. In news listing, in view mode, verify article box (whole thing is a link) opens external URL in new tab.
8. In news listing mode, verify article that is not tagged external, opens article.

Verify New Core-CMS Features

9. feat(settings): TACC_BLOG_SHOW_ABSTRACT_TAG Core-CMS#592
   Verify the article page, for the external-tagged article, show its abstract beneath the header and visual.
10. feat(djangocms_blog): article 'has-blog-tag-...' class names Core-CMS#593/feat(djangocms_blog): drop scripts in favor of template overwrites Core-CMS#596
    Verify the external-tagged article, in the news listing, has the class has-blog-tag-external.

Redirect an Article Page to New Tab

Why
In case user reaches article page (via Google or "Open External Article in New Tab" fails).

12. On article page, in "Post-Content", create a new snippet.
13. Set "HTML:" to https://www.designsafe-ci.org/community/news/2022/december/towers-storm/. ¹
    Leave "HTML:" blank ¹
14. Set "TEMPLATE:" to snippets/redirect.html
15. Save snippet.
16. Reload article page.
17. Verify page redirects to https://www.designsafe-ci.org/community/news/2022/december/towers-storm/ in same window.
18. Open local article page with ?edit at the end of the URL (e.g. https://dev.tup[…]towers-storm?edit.
19. Verify page does not redirect.

UI

Notice
Screenshots may show me locally having used redirect tag instead of external tag.

Open External Article in New Tab

heading URL	abstract URL	footer URL	category url

target="_blank"	regular post

has redirect tag, has link change	no redirect tag, no link change

New Core-CMS Features

TACC/Core-CMS#592	TACC/Core-CMS#593/TACC/Core-CMS#596

Redirect Snippet

create snippet1	add snippet	edit post (no redirect)

redirect.snippet.active.mov

Footnotes

1. The "HTML:" URL is not required since 14298c9, which tells redirect JavaScript how to auto-find an article's external URL. But, it will still work, and take precedence. ↩ ↩² ↩³

[jarosenb]

LGTM and works in dev.