Content shape alternate targeting a specific item with ContentItemId (#15572)

[dmourtzoukos]

This pull request enhances the templating system for content items by adding support for templates based on ContentItemId and updating the documentation to reflect these changes. The most important changes include the addition of new template alternates in the Shapes.cs file and the corresponding updates in the documentation.

Enhancements to templating system:

• src/OrchardCore.Modules/OrchardCore.Contents/Shapes.cs: Added new template alternates for ContentItemId and DisplayType combined with ContentItemId. This allows for more granular control over content item templates.

Documentation updates:

• src/docs/reference/modules/Templates/README.md: Updated the documentation to include examples and descriptions for the new template alternates based on ContentItemId and DisplayType combined with ContentItemId.

Fixes #15572.

[github-actions]

Thank you for submitting your first pull request, awesome! 🚀 If you haven't already, please take a moment to review our contribution guide. This guide provides helpful information to ensure your contribution aligns with our standards. A core team member will review your pull request.

[dmourtzoukos]

Fixes following issue:
#15572

[Piedone]

I'm out until Harvest and won't be able to review, trust your judgement @hishamco.

[Piedone]

I didn't review the PR, but am only adding the release notes note.

[Piedone]

Please add a note about this to https://github.com/OrchardCMS/OrchardCore/blob/main/src/docs/releases/2.1.0.md. See https://docs.orchardcore.net/en/latest/guides/contributing/contributing-documentation/.

[github-actions]

This pull request has merge conflicts. Please resolve those before requesting a review.

[hishamco]

Please resolve the conflict

[dmourtzoukos]

Please resolve the conflict

Conflicts have been resolved.

[Piedone]

I'm not reviewing but @hishamco please finish yours.

[MikeAlhayek]

@dmourtzoukos If you please add notes about this change in https://github.com/OrchardCMS/OrchardCore/blob/main/src/docs/releases/3.0.0.md I will merge it for you. Please add the note and request my review so I can merge it.

[sebastienros]

Do we really need this since we have alias and route shapes? I am thinking this would just create extraneous alternates for every single content item that would probably be unnecessary.

[MikeAlhayek]

@sebastienros same feeling here. However, others seems to want it. If it is not really needed, I rather not add it

[sebastienros]

others seems to want it

The issues were created before we had alias/route alternates, maybe we should ask again.

[MichaelPetrinolis]

You are right, now that we have alternates by alias this PR has no added value.
Do you agree to modify the alternate based on the localization set, so that a simple template can be applied to a specific content item on any locale? This cannot be achieved by alias or autoroute alternates, as they are unique

[sebastienros]

@MichaelPetrinolis can you file an issue? Also here is a previous mention of this, check the whole thread there are other alternatives. #5033 (comment)

It's not that easy though, perf implications (even more that this PR)

[Piedone]

Yeah, this is not really needed anymore, but thank you @dmourtzoukos! Sorry that things shifted around in the meantime, but we'd welcome any further improvements/issue fixes from you in the future.

Closed #15572.