Two modules, one for channels and one for categories, were added - channelEmbed and categoryEmbed respectively.
Each module will allow the KMS admin to decide on the default behavior of the Embed tab when an entry is accessed in the context of a channel or category:
- Allow channel/category managers to block embed-grabbing from their channel/category.
- Override the default role permissions set by the main Embed module, allowing finer grain control differentiated between categories and channels.
For the KMS Admin
The modules be found under Modules/category and Modules/channel, respectively:
and once enabled, for channels:
and for categories:
For the Channel/Category Manager
The modules will also add a checkbox to the category/channel settings page.
In a channel:
In a category:
In case allowManagerOverride is set to 'No' in the module’s config, the new “Enable embed grab” checkbox will be shown with the default value, as set in the module’s configuration by the KMS admin, but will be disabled
End-users Trying to Grab an Embed
When an end-user attempts to grab an embed of an entry from a category/channel that prevents embed grabbing, the following message will apear:
1. The modules depend on the Embed module to be enabled. In case the Embed module is disabled, embeds will not be allowed regardless of these modules’ settings and no “Enable embed” checkbox will appear in category/channel settings.
2. Per the module’s logic as described above, should the embedRoles in the Embed module be set differently than the one in the category/channel modules, the latter will take effect.
Related article - Enhanced Settings for Secure Embed in KMS/KAF