When possible, it is best to add code via your website Github repository. However, there are certain use cases where this is not feasible. If you attempt to add the code via the WYSIWYG editor, our Content Delivery Network (CDN) provider Cloudflare will block the request for security reasons. In these cases, developers can use the UMN Embed Code Token Manager module to generate a token through their website UI. Content Editors can then insert the token via the WYSIWYG editor. After the content is saved, the embedded content will render.
Note: This article is for developers with websites on the OIT Drupal platform. If you are a content editor and an embed token has been created for you, see Drupal: Insert a Token to Embed Code on Your Website.
Setting Up the Module
- Under the Extend menu, enable the UMN Embed Token Insert module.
- This will also enable the UMN Embed Code Token Manager parent module
- Optional: Adjust permissions, if appropriate, for your website. By default, the Administer UMN embed code tokens permission is granted to the Administrator role. Only trained developers should have this permission.
- Set up Text Format(s) to use tokens:
- Navigate to Configuration, Content Authoring, then Text formats and editors in the admin toolbar.
- Select Configure for the desired text format.
- In the list of filters, check the box to enable the UMN Token Filter.
- Select Save Configuration at the bottom of the page.
- If you get an error message when attempting to enable the filter for the Folwell CKEditor, please email [email protected] for assistance
- Repeat step 3 for any additional text formats if needed.
Generating a Token
- Navigate to Configuration and then UMN Embed Code Tokens in the admin toolbar.
- Select the +Add embed code token button to generate a new token.
- Enter a token name and add the embed code.
- Note: The Prohibited Code tab contains the functions and patterns that are not allowed and, if present, will prevent the token from being saved.
- Check the Security Attestation box to confirm that you have reviewed this code for security vulnerabilities and determined that it is safe to use.
- Select Save Token.
Your content contributors will now be able to use this token to add the embed code via the WYSIWYG editor text formats where the UMN Token Filter has been enabled. See Drupal: Insert a Token to Embed Code on Your Website for the steps to use the token.