Announcement Winter 2022 (Sales Features)

The primary purpose of the winter “sales” build is to provide Catapult sales staff features that they can use to help sell our products in the upcoming (in this case 2023) season. Based on a combination of customer feedback and sales staff intuition the following features are the ones our clients want the most.

• Edit Homepage Blurb

• Edit Post - Support Header Tags.

• Redirect (URL)

• Embed Post (Global Content)

Edit Homepage Blurb

Current Behavior: the system only stores one copy of “Post Content” this is stored as a string in the announcement API: PostInfo: string:Description We currently use javascript to strip the HTML down to plaintext and serve the frst couple of lines for the truncated description that appears on the homepage, we show the full version when the post is opened.

Desired Behavior: Add a secondary string which is automatically generated when the description is changed, but allow users to manually alter this to be a customized string of their choice (with a limited character count of 200 characters and no line breaks)

User Warning: If “Post Content” is edited and a custom blurb is present ask Ask the user on save if they would like to replace the custom blurb with a truncated version of their post content.

UI Reference: Replace Post Content with Tabs (default to Post Content)

Open

UI Reference: Homepage Blurb. (200 character maximum, no formatting options)

Open

I found a script that was built by adobe which offers a running update of how many characters are left (including a reference for if you go over)

Script Reference: https://developer.adobe.com/commerce/frontend-core/javascript/jquery-widgets/remaining-characters/

If possible it would be nice to avoid “force truncating” the content until after the user hits save, at which point a note “your homepage blurb is over the maximum of 200 characeters, saving will truncate any additional text”

Edit Post - Support Header Tags

We want to add header tags to the list of supported HTML for the Edit Post (description) this will increase the compatability of our announcement descriptions with google docs, with minimal affect on the total HTML we’re adding. Currently the description strips all HTML that isn’t on a pre-approved whitelist of tags that are supported. Add the following tags to the allowed list for paste processing<h1>,<h2>,<h3>,<h4>,<h5> additionally please add the toolbar option to include headers in the selection.

UI Reference:

Redirect URL

Overview: With the advent of the “Branded Newsletter” feature in Connect we’ve introduced content that cannot be easily displayed inside of an announcement post. We’d like to add an additional string to PostInfo which will store the URL of “rich html” content i.e. posts that need a full website instead of a simple post content. This will allow us to add logic to certain front end options to link directly to the rich content instead of showing the link in the description (reducing the number of clicks required from the viewer to get to that content.)

Reference UI:

Embed Post

The “Embed Post” button will provide an embed code which outputs the content of a single post. This embed code will be similar to the content provided in the “Share URL” unlike the share URL this content is intended to be added by developers to other catapult pages.

Example: https://www.egusd.net/announcements/?capostid=58750

The embed code provided by “share post” should be a stand alone HTML snippet which can be added to any catapult page via unrestricted code card (like a youtube embed)

This additional Button will be accessible from the “Share Post” screen.

Reference UI

Unlike other embed types which prompt users to select feeds, share URL etc, the embed post embed relates to a single post ID so shouldn’t need much additional info the next screen is the embed code: