Register an entitySign and render an icon.

[engijlr]

📋 Description

This PR explains how to register an entitySign, bind it with forEntityFlags, and render an icon.

📎 Related Issues (if applicable)

Relates to PR: umbraco/Umbraco-CMS#20328

✅ Contributor Checklist

I've followed the Umbraco Documentation Style Guide and can confirm that:

• Code blocks are correctly formatted.
• Sentences are short and clear (preferably under 25 words).
• Passive voice and first-person language (“we”, “I”) are avoided.
• Relevant pages are linked.
• All links work and point to the correct resources.
• Screenshots or diagrams are included if useful.
• Any code examples or instructions have been tested.
• Typos, broken links, and broken images are fixed.

Product & Version (if relevant)

CMS 16.4/17

Deadline (if relevant)

Expect this to be published along with the RC for 16.4 or 17.

[AndyButland]

Looks good to me @engijlr. I suggested a few small updates, partially addressing @nielslyngsoe's point in the copy.

I think it would be nice to present a second example under a heading like "Example: Rendering an Entity Sign with Custom Logic" where you show how to render a backoffice sign without server input. Presumably this won't have a forEntityFlags setting but will have a referenced .ts file where the logic is implemented. That'll handle the rest of Niel's point about showing that this isn't just an extension that depends on the data coming from the management API.

Maybe you can think of a good real-world example, but even an illustrative one adding a sign for any document that has been created in the last week would suffice. The create date for a document I believe is in the tree item response model, so you could read if from there,

[AndyButland]

Nice, all looks good from my perspective @engijlr,

[eshanrnh]

The PR looks great.

@engijlr is there a specific date you would like this PR published or can it be published anytime?

[engijlr]

Hi @eshanrnh,
In my opinion, it can be published anytime. @AndyButland and @nielslyngsoe, what do you think?

[AndyButland]

I agree, it can be published now. And actually @eshanrnh, if you could do as soon as you can please, that would be great (as I linked to this page in the docs expecting the updates to be there in today's blog post 🙈).