Adds the option to enable the banner via Google Tag Manager.

How to test this pull request

To enable the banner, follow these steps to configure the tag via Google Tag Manager:

1. Log in to Google Tag Manager at https://tagmanager.google.com/.

2. Open the account assigned to this project: GTM-T8P2JP.

3. Select Tags from the left sidebar.

   

4. Click New and configure the tag with the following settings:

   

   • Type: Custom HTML

   • Body:

     <meta name="scylladb-docs-hide_banner" content="false" />
     <meta name="scylladb-docs-banner_title_text" content="Title text" />
     <meta name="scylladb-docs-banner_button_text" content="Button text" />
     <meta name="scylladb-docs-banner_button_url" content="https://docs.scylladb.com" />
     

   • Trigger: On initialization on all pages.

5. Click Save.

6. Click Submit and fill in the information to release a new version of the tag.

   

7. Click Publish.

8. Clone this pull request, navigate to the docs folder, and run make preview. Open http://127.0.0.1:5500/ in incognito mode to ensure that your browser does not keep any cookies from previous browsing sessions.

You should now see the announcement banner on the website 🎉

IMPORTANT: Once you've done the test, remember to delete the tag so that a banner with a sample text appears on all sites once we release a new version of the theme.

Editing the banner content

You can customize the banner's title, button text, and URL by editing the content attribute of the corresponding meta key. For example:

<meta name="scylladb-docs-hide_banner" content="false" />
<meta name="scylladb-docs-banner_title_text" content="Title text" />
<meta name="scylladb-docs-banner_button_text" content="Button text" />
<meta name="scylladb-docs-banner_button_url" content="https://docs.scylladb.com" />

To change a property, edit the tag's body accordingly. Once you've made the changes, remember to publish a new version of the tag.

Disabling the banner

To disable the banner, you have two options:

a. Delete the tag on Google Tag Manager.

b. Set the meta attribute scylladb-docs-hide_banner to true.

   <meta name="scylladb-docs-hide_banner" content="false" />

In both cases, remember to publish a new version.