govuk_publishing_components 35.21.3 → 35.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c928d56fbe68a0a4819b63b6057a80667c24713ecc0bc79dbeaa5980f036125
-  data.tar.gz: e17a211723d9d0100e69120d84dc293980677bae6bf39b0d3cf4901edbcf0b69
+  metadata.gz: b44a8215911c2a260e0b80134c14d3f974a4ee0bb91cdf7eb23dc081e61ee9d9
+  data.tar.gz: 4262f87d3ce863db103a0f24e3936b69e2219b0794ad83d142abb115bf7fe66a
 SHA512:
-  metadata.gz: c2004ec2b34d6559eae86c18224a7f58f6d1e55c80842d6ced8a285f6c5e8db83d2fe1dc1cb87f00b7db8d673a24b5922d2b2afe0f916ad448a36566cd1ec2d2
-  data.tar.gz: 7c1262f1545a1fca6b0c14c5fe7ac2b681f6b506028dfa065319d0ec7902955d820e8ff1261a5f172b8dfcbcf066c4cf18c6263f3f5bc029252efe8881675527
+  metadata.gz: 4deebaa45c7bb16f6acbbc0ae2b916222a6e8b3c9efb05581f3fefbf8e4b87b3ee772025b81399055e3bbedceb6162d1cd9df56b7e22f6ad1f6637523dea307c
+  data.tar.gz: 1fef3fd8a3ab99df0359cfd7d2787ba7d0d62ee50e12e455acb64fad1c51fbb47bc657b4f3ef784767c9c2fb95967678be14d168efb9db789ce28b618118e2bc

data/app/assets/javascripts/govuk_publishing_components/analytics-ga4/ga4-video-tracker.js

@@ -13,7 +13,7 @@ window.GOVUK.analyticsGa4.analyticsModules = window.GOVUK.analyticsGa4.analytics
     configureVideo: function (event) {
       var player = event.target
       var videoId = player.id
-      var duration = player.getDuration()
+      var duration = Math.ceil(player.getDuration())
       var percentages = [25, 50, 75]
 
       for (var i = 0; i < percentages.length; i++) {
@@ -23,6 +23,10 @@ window.GOVUK.analyticsGa4.analyticsModules = window.GOVUK.analyticsGa4.analytics
         // interval is once a second, so end point must be at least one second beyond begin point
         this.handlers['video-' + videoId + '-' + percent + '-percent-end'] = position + 2
       }
+      // store all these values otherwise we have to get them for every event
+      this.handlers['video-' + videoId + '-duration'] = duration // store initially, as number returned from API varies
+      this.handlers['video-' + videoId + '-title'] = player.videoTitle
+      this.handlers['video-' + videoId + '-url'] = this.cleanVideoUrl(player.getVideoUrl())
     },
 
     trackVideo: function (event, state) {
@@ -68,13 +72,13 @@ window.GOVUK.analyticsGa4.analyticsModules = window.GOVUK.analyticsGa4.analytics
 
     sendData: function (player, event, position) {
       var data = {}
+      data.action = event
       data.event_name = 'video_' + event
       data.type = 'video'
-      data.url = this.cleanVideoUrl(player.getVideoUrl())
-      data.text = player.videoTitle
-      data.action = event
+      data.url = this.handlers['video-' + player.id + '-url']
+      data.text = this.handlers['video-' + player.id + '-title']
       data.video_current_time = Math.round(player.getCurrentTime())
-      data.video_duration = Math.ceil(player.getDuration()) // number returned from the API varies, so round up
+      data.video_duration = this.handlers['video-' + player.id + '-duration']
       data.video_percent = position
 
       var schemas = new window.GOVUK.analyticsGa4.Schemas()

data/app/assets/stylesheets/govuk_publishing_components/components/_metadata.scss

@@ -23,7 +23,6 @@
 }
 
 .gem-c-metadata--inverse {
-  background-color: govuk-colour("blue");
   color: govuk-colour("white");
 
   a {

data/app/views/govuk_publishing_components/components/_accordion.html.erb

@@ -10,7 +10,7 @@
   anchor_navigation ||= false
   track_show_all_clicks ||= false
   track_sections ||= false
-  ga4_tracking ||= false
+  disable_ga4 ||= false
   data_attributes_show_all ||= nil
 
   component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
@@ -19,8 +19,8 @@
   component_helper.add_class(shared_helper.get_margin_bottom)
 
   component_helper.add_data_attribute({ module: "govuk-accordion gem-accordion" })
-  component_helper.add_data_attribute({ module: "ga4-event-tracker" }) if ga4_tracking
-  component_helper.add_data_attribute({ ga4_expandable: "" }) if ga4_tracking
+  component_helper.add_data_attribute({ module: "ga4-event-tracker" }) unless disable_ga4
+  component_helper.add_data_attribute({ ga4_expandable: "" }) unless disable_ga4
   component_helper.add_data_attribute({ anchor_navigation: anchor_navigation }) if anchor_navigation
   component_helper.add_data_attribute({ track_show_all_clicks: track_show_all_clicks }) if track_show_all_clicks
   component_helper.add_data_attribute({ track_sections: track_sections }) if track_sections
@@ -39,7 +39,7 @@
         item[:data_attributes] ||= nil
         ga4_link_data_attributes ||= nil
 
-        if ga4_tracking
+        unless disable_ga4
           heading_text = Nokogiri::HTML(item[:heading][:text]).text
           item[:data_attributes] ||= {}
           item[:data_attributes][:ga4_event] = {

data/app/views/govuk_publishing_components/components/_contents_list.html.erb

@@ -12,18 +12,18 @@
   link_classes << brand_helper.color_class
   link_classes << "govuk-link--no-underline" unless underline_links
 
-  ga4_tracking ||= false
+  disable_ga4 ||= false
   ga4_data = {
     event_name: "navigation",
     section: t("components.contents_list.contents", locale: :en) || "",
     type: "contents list",
     index_total: cl_helper.get_index_total,
-  } if ga4_tracking
+  } unless disable_ga4
   local_assigns[:aria] ||= {}
   component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
   component_helper.add_class("gem-c-contents-list #{brand_helper.brand_class}")
   component_helper.add_data_attribute({ module: "gem-track-click" })
-  component_helper.add_data_attribute({ module: "ga4-link-tracker" }) if ga4_tracking
+  component_helper.add_data_attribute({ module: "ga4-link-tracker" }) unless disable_ga4
   component_helper.add_aria_attribute({ label: t("components.contents_list.contents") }) unless local_assigns[:aria][:label]
   component_helper.add_role("navigation")
 -%>
@@ -38,11 +38,11 @@
     <% end %>
 
     <ol class="gem-c-contents-list__list">
-      <% index_link = 1 if ga4_tracking %>
+      <% index_link = 1 unless disable_ga4 %>
       <% contents.each.with_index(1) do |contents_item, position| %>
         <li class="<%= cl_helper.list_item_classes(contents_item, false) %>" <%= "aria-current=true" if contents_item[:active] %>>
           <% link_text = format_numbers ? cl_helper.wrap_numbers_with_spans(contents_item[:text]) : contents_item[:text]
-            if ga4_tracking
+            unless disable_ga4
               ga4_data[:event_name] = cl_helper.get_ga4_event_name(contents_item[:href]) if contents_item[:href]
               ga4_data[:index_link] = index_link
             end
@@ -56,16 +56,16 @@
               track_options: {
                 dimension29: contents_item[:text]
               },
-              ga4_link: (ga4_tracking ? ga4_data.to_json : nil)
+              ga4_link: (!disable_ga4 ? ga4_data.to_json : nil)
             }
           %>
-          <% index_link += 1 if ga4_tracking %>
+          <% index_link += 1 unless disable_ga4 %>
           <% if contents_item[:items] && contents_item[:items].any? %>
             <ol class="gem-c-contents-list__nested-list">
               <% contents_item[:items].each.with_index(1) do |nested_contents_item, nested_position| %>
                 <li class="<%= cl_helper.list_item_classes(nested_contents_item, true) %>" <%= "aria-current=true" if nested_contents_item[:active] %>>
                   <%
-                    if ga4_tracking
+                    unless disable_ga4
                       ga4_data[:event_name] = cl_helper.get_ga4_event_name(nested_contents_item[:href]) if nested_contents_item[:href]
                       ga4_data[:index_link] = index_link
                     end
@@ -79,11 +79,11 @@
                       track_options: {
                         dimension29: nested_contents_item[:text]
                       },
-                      ga4_link: (ga4_tracking ? ga4_data.to_json : nil)
+                      ga4_link: (!disable_ga4 ? ga4_data.to_json : nil)
                     }
                   %>
                 </li>
-                <% index_link += 1 if ga4_tracking %>
+                <% index_link += 1 unless disable_ga4 %>
               <% end %>
             </ol>
           <% end %>

data/app/views/govuk_publishing_components/components/_contextual_breadcrumbs.html.erb

@@ -1,9 +1,9 @@
-<% 
-  ga4_tracking ||= false
+<%
+  disable_ga4 ||= false
   prioritise_taxon_breadcrumbs ||= false
-  breadcrumb_selector = GovukPublishingComponents::Presenters::BreadcrumbSelector.new(content_item, request, prioritise_taxon_breadcrumbs, ga4_tracking)
+  breadcrumb_selector = GovukPublishingComponents::Presenters::BreadcrumbSelector.new(content_item, request, prioritise_taxon_breadcrumbs, disable_ga4)
   inverse ||= false
-  collapse_on_mobile ||= true unless local_assigns[:collapse_on_mobile].eql?(false) 
+  collapse_on_mobile ||= true unless local_assigns[:collapse_on_mobile].eql?(false)
 %>
 
 <div class="gem-c-contextual-breadcrumbs">

data/app/views/govuk_publishing_components/components/_contextual_footer.html.erb

@@ -1,12 +1,12 @@
 <% navigation = GovukPublishingComponents::Presenters::ContextualNavigation.new(content_item, request) %>
-<% ga4_tracking ||= false %>
+<% disable_ga4 ||= false %>
 
 <% unless navigation.content_tagged_to_current_step_by_step? %>
   <div class="gem-c-contextual-footer">
     <%# Rendering related navigation because no step by step list %>
     <%= render 'govuk_publishing_components/components/related_navigation',
                content_item: content_item,
-               ga4_tracking: ga4_tracking,
+               disable_ga4: disable_ga4,
                context: :footer %>
   </div>
 <% end %>

data/app/views/govuk_publishing_components/components/_contextual_sidebar.html.erb

@@ -1,8 +1,8 @@
 <%
   add_gem_component_stylesheet("contextual-sidebar")
 
-  ga4_tracking ||= false
-  request.query_parameters[:ga4_tracking] = ga4_tracking
+  disable_ga4 ||= false
+  request.query_parameters[:disable_ga4] = disable_ga4
   navigation = GovukPublishingComponents::Presenters::ContextualNavigation.new(content_item, request)
   shared_helper = GovukPublishingComponents::Presenters::SharedHelper.new(local_assigns)
   show_ukraine_cta = navigation.show_ukraine_cta?
@@ -13,7 +13,7 @@
 <div class="gem-c-contextual-sidebar">
   <% if navigation.content_tagged_to_a_reasonable_number_of_step_by_steps? %>
     <%# Rendering step by step related items because there are a few but not too many of them %>
-    <%= render 'govuk_publishing_components/components/step_by_step_nav_related', links: navigation.step_nav_helper.related_links, ga4_tracking: ga4_tracking %>
+    <%= render 'govuk_publishing_components/components/step_by_step_nav_related', links: navigation.step_nav_helper.related_links, disable_ga4: disable_ga4 %>
   <% end %>
 
   <% if navigation.content_tagged_to_current_step_by_step? %>
@@ -21,7 +21,7 @@
     <%= render 'govuk_publishing_components/components/step_by_step_nav', navigation.step_nav_helper.sidebar %>
   <% else %>
     <%# Rendering related navigation sidebar because no step by step list %>
-    <%= render 'govuk_publishing_components/components/related_navigation', content_item: content_item, context: :sidebar, ga4_tracking: ga4_tracking, ga4_tracking_counts: ga4_tracking_counts %>
+    <%= render 'govuk_publishing_components/components/related_navigation', content_item: content_item, context: :sidebar, disable_ga4: disable_ga4, ga4_tracking_counts: ga4_tracking_counts %>
   <% end %>
 
   <% if navigation.content_tagged_to_other_step_by_steps? %>
@@ -30,11 +30,11 @@
       pretitle: t("components.contextual_sidebar.pretitle"),
       links: navigation.step_nav_helper.also_part_of_step_nav,
       always_display_as_list: true,
-      ga4_tracking: ga4_tracking
+      disable_ga4: disable_ga4
     } %>
   <% end %>
 
   <% if show_ukraine_cta %>
-    <%= render 'govuk_publishing_components/components/contextual_sidebar/ukraine_cta', content_item: content_item, ga4_tracking: ga4_tracking, ga4_tracking_counts: ga4_tracking_counts %>
+    <%= render 'govuk_publishing_components/components/contextual_sidebar/ukraine_cta', content_item: content_item, disable_ga4: disable_ga4, ga4_tracking_counts: ga4_tracking_counts %>
   <% end %>
 </div>

data/app/views/govuk_publishing_components/components/_cookie_banner.html.erb

@@ -31,7 +31,7 @@
   css_classes = %w(gem-c-cookie-banner govuk-clearfix govuk-cookie-banner js-banner-wrapper)
   css_classes << "gem-c-cookie-banner--services" if services_cookies
 
-  ga4_tracking ||= false
+  disable_ga4 ||= false
 %>
 
 <div id="<%= id %>" class="<%= css_classes.join(' ') %>" data-module="cookie-banner" data-nosnippet role="region" aria-label="<%= title %>">
@@ -42,7 +42,7 @@
         <div tabindex="-1" class="govuk-cookie-banner__content gem-c-cookie-banner__confirmation">
           <span class="gem-c-cookie-banner__content"><%= text %></span>
           <p class="gem-c-cookie-banner__confirmation-message--accepted govuk-body" hidden
-          <% if ga4_tracking %>
+          <% unless disable_ga4 %>
             data-ga4-cookie-banner <%# GA4 pageview JS looks for data-ga4-cookie-banner %>
             data-module="ga4-link-tracker"
             data-ga4-track-links-only
@@ -96,14 +96,14 @@
     <div hidden class="js-hide-button govuk-button-group">
       <%
         button_data_module = "gem-track-click"
-        button_data_module << " ga4-event-tracker" if ga4_tracking
+        button_data_module << " ga4-event-tracker" unless disable_ga4
 
         ga4_event = {
           event_name: "select_content",
           type: "cookie banner",
           action: "closed",
           section: t("components.cookie_banner.confirmation_message.accepted", locale: :en)
-        }.to_json if ga4_tracking
+        }.to_json unless disable_ga4
       %>
       <button
         class="gem-c-cookie-banner__hide-button govuk-button"
@@ -111,7 +111,7 @@
         data-module="<%= button_data_module %>"
         data-track-category="cookieBanner"
         data-track-action="Hide cookie banner"
-        <% if ga4_tracking %> data-ga4-event="<%= ga4_event %>" <% end %>>
+        <% unless disable_ga4 %> data-ga4-event="<%= ga4_event %>" <% end %>>
           <%= t("components.cookie_banner.hide") %>
         </button>
     </div>

data/app/views/govuk_publishing_components/components/_devolved_nations.html.erb

@@ -6,10 +6,10 @@
 
   applies_to ||= t("components.devolved_nations.applies_to")
   heading_level ||= 2
-  ga4_tracking ||= false
+  disable_ga4 ||= false
   data_attributes = {}
 
-  if ga4_tracking
+  unless disable_ga4
     data_attributes[:ga4_devolved_nations_banner] = devolved_nations_helper.ga4_applicable_nations_title_text(true)
     data_attributes[:module] = "ga4-link-tracker"
     data_attributes[:ga4_track_links_only] = ""

data/app/views/govuk_publishing_components/components/_emergency_banner.html.erb

@@ -7,7 +7,7 @@
   link_text ||= "More information"
   campaign_class ||= nil
   homepage ||= false
-  ga4_tracking ||= false
+  disable_ga4 ||= false
 
   emergency_banner_helper = GovukPublishingComponents::Presenters::EmergencyBannerHelper.new()
 
@@ -29,12 +29,11 @@
   description_classes = %w[gem-c-emergency-banner__description]
   description_classes << "gem-c-emergency-banner__description--homepage" if homepage
 
-
   data_attributes = {
     "nosnippet": true,
   }
 
-  if ga4_tracking
+  unless disable_ga4
     data_attributes[:ga4_emergency_banner] = ""
     data_attributes[:module] = "ga4-link-tracker"
     data_attributes[:ga4_track_links_only] = ""
@@ -46,7 +45,6 @@
     }.to_json
   end
 %>
-
 <%= content_tag('section', class: banner_classes, "aria-labelledby": "emergency-banner-heading", data: data_attributes) do %>
   <div class="govuk-width-container">
     <div class="govuk-grid-row">

data/app/views/govuk_publishing_components/components/_intervention.html.erb

@@ -32,10 +32,10 @@
   intervention_helper = GovukPublishingComponents::Presenters::InterventionHelper.new(options)
   dismiss_href = intervention_helper.dismiss_link
 
-  ga4_tracking ||= false
-  suggestion_data_attributes[:module] = "#{suggestion_data_attributes[:module]} ga4-link-tracker".strip if ga4_tracking
-  suggestion_data_attributes[:ga4_link] = { event_name: "navigation", type: "intervention", section: suggestion_text, index_link: 1, index_total: 1 }.to_json if ga4_tracking
-  data_attributes[:ga4_intervention_banner] = "" if ga4_tracking # Added to the parent element for the GA4 pageview object to use
+  disable_ga4 ||= false
+  suggestion_data_attributes[:module] = "#{suggestion_data_attributes[:module]} ga4-link-tracker".strip unless disable_ga4
+  suggestion_data_attributes[:ga4_link] = { event_name: "navigation", type: "intervention", section: suggestion_text, index_link: 1, index_total: 1 }.to_json unless disable_ga4
+  data_attributes[:ga4_intervention_banner] = "" unless disable_ga4 # Added to the parent element for the GA4 pageview object to use
 
   suggestion_tag_options = {
     class: "govuk-link",
@@ -59,8 +59,8 @@
   }
   section_options.merge!({ hidden: true }) if hide
 
-  dismiss_link_data_attributes[:module] = "#{dismiss_link_data_attributes[:module]} ga4-event-tracker".strip if ga4_tracking
-  dismiss_link_data_attributes[:ga4_event] = { event_name: "select_content", type: "intervention", section: suggestion_text, action: 'closed' }.to_json if ga4_tracking
+  dismiss_link_data_attributes[:module] = "#{dismiss_link_data_attributes[:module]} ga4-event-tracker".strip unless disable_ga4
+  dismiss_link_data_attributes[:ga4_event] = { event_name: "select_content", type: "intervention", section: suggestion_text, action: 'closed' }.to_json unless disable_ga4
 %>
 <% if intervention_helper.show? %>
   <%= tag.section **section_options do %>

data/app/views/govuk_publishing_components/components/_metadata.html.erb

@@ -26,13 +26,13 @@
 
   classes << shared_helper.get_margin_bottom if local_assigns[:margin_bottom]
 
-  ga4_tracking ||= false
+  disable_ga4 ||= false
   ga4_object = {
     event_name: "navigation",
     type: "content history",
     section: "Top",
     action: "opened"
-  }.to_json
+  }.to_json unless disable_ga4
 %>
 <%= content_tag :div, class: classes, data: { module: "gem-toggle metadata" } do %>
   <dl class="gem-c-metadata__list" data-module="gem-track-click">
@@ -66,7 +66,7 @@
                     data-track-category="content-history"
                     data-track-action="see-all-updates-link-clicked"
                     data-track-label="history"
-                    <% if ga4_tracking %>
+                    <% unless disable_ga4 %>
                       data-module="ga4-link-tracker"
                       data-ga4-link="<%= ga4_object %>"
                     <% end%>>
@@ -84,7 +84,7 @@
         <% if definition.any? %>
           <dt class="gem-c-metadata__term"><%= title %>:</dt>
           <dd class="gem-c-metadata__definition"
-              <% if ga4_tracking %>
+              <% unless disable_ga4 %>
                 data-module="ga4-link-tracker"
                 data-ga4-track-links-only
                 data-ga4-link="<%= ga4_object %>"

data/app/views/govuk_publishing_components/components/_phase_banner.html.erb

@@ -5,7 +5,7 @@ app_name ||= nil
 phase ||= nil
 message ||= nil
 inverse ||= false
-ga4_tracking ||= false
+disable_ga4 ||= false
 
 unless message.present?
   if phase == "beta"
@@ -20,7 +20,7 @@ container_css_classes << "gem-c-phase-banner--inverse" if inverse
 
 data_attributes = {}
 
-if ga4_tracking
+unless disable_ga4
   data_attributes[:ga4_phase_banner] = phase
   data_attributes[:module] = "ga4-link-tracker"
   data_attributes[:ga4_track_links_only] = ""

data/app/views/govuk_publishing_components/components/_previous_and_next_navigation.html.erb

@@ -1,6 +1,6 @@
 <%
   add_gem_component_stylesheet("previous-and-next-navigation")
-  ga4_tracking ||= false
+  disable_ga4 ||= false
 
   if local_assigns.include?(:next_page) || local_assigns.include?(:previous_page)
 %>
@@ -8,7 +8,7 @@
     class="govuk-pagination govuk-pagination--block"
     role="navigation"
     aria-label="<%= t("components.previous_and_next_navigation.pagination") %>"
-    <% if ga4_tracking %>
+    <% unless disable_ga4 %>
       data-module="ga4-link-tracker"
     <% end %>
   >
@@ -27,7 +27,7 @@
           data-track-label="<%= previous_page[:url] %>"
           data-track-dimension="previous"
           data-track-dimension-index="29"
-          <% if ga4_tracking %>
+          <% unless disable_ga4 %>
             data-ga4-link = "<%= {
               event_name: "navigation",
               type: "previous and next",
@@ -63,7 +63,7 @@
           data-track-label="<%= next_page[:url] %>"
           data-track-dimension="next"
           data-track-dimension-index="29"
-          <% if ga4_tracking %>
+          <% unless disable_ga4 %>
             data-ga4-link = "<%= {
               event_name: "navigation",
               type: "previous and next",

data/app/views/govuk_publishing_components/components/_related_navigation.html.erb

@@ -1,11 +1,11 @@
 <%
   related_nav_helper = GovukPublishingComponents::Presenters::RelatedNavigationHelper.new(local_assigns)
   shared_helper = GovukPublishingComponents::Presenters::SharedHelper.new(local_assigns)
-  ga4_tracking ||= false
+  disable_ga4 ||= false
   ga4_type = local_assigns[:context] == :footer ? "contextual footer" : "related content"
   data = {}
   data[:module] = "gem-track-click"
-  data[:module] << " ga4-link-tracker" if ga4_tracking
+  data[:module] << " ga4-link-tracker" unless disable_ga4
   ga4_tracking_counts ||= OpenStruct.new(index_section_count: 0)
   ga4_tracking_counts.index_section_count += related_nav_helper.index_section_count
 
@@ -43,7 +43,7 @@
         section_index: section_index,
         section_count: ga4_tracking_counts.index_section_count,
         random: random,
-        ga4_tracking: ga4_tracking,
+        disable_ga4: disable_ga4,
         ga4_type: ga4_type %>
     <% end %>
   <% end %>

data/app/views/govuk_publishing_components/components/_step_by_step_nav.html.erb

@@ -18,12 +18,12 @@
 
   step_nav_helper = GovukPublishingComponents::Presenters::StepByStepNavHelper.new
 
-  ga4_tracking ||= false
+  disable_ga4 ||= false
 %>
 <% if steps %>
   <div
-    data-module="gemstepnav<% if ga4_tracking %> ga4-event-tracker<% end %>"
-    <%= "data-ga4-expandable" if ga4_tracking %>
+    data-module="gemstepnav<% unless disable_ga4 %> ga4-event-tracker<% end %>"
+    <%= "data-ga4-expandable" unless disable_ga4 %>
     class="gem-c-step-nav js-hidden <% if small %>govuk-!-display-none-print<% end %> <% unless small %>gem-c-step-nav--large<% end %>"
     <%= "data-remember" if remember_last_step %>
     <%= "data-id=#{tracking_id}" if tracking_id %>
@@ -76,7 +76,7 @@
           <%
             ga4_link_data = {}
 
-            if ga4_tracking
+            unless disable_ga4
               ga4_link_data = {
                 "module": "ga4-link-tracker",
                 "ga4-track-links-only": "",
@@ -99,7 +99,7 @@
               options[:step_title] = step[:title]
               options[:step_index] = step_index
               options[:link_index] = 0
-              options[:ga4_tracking] = ga4_tracking
+              options[:disable_ga4] = disable_ga4
             %>
             <% step[:contents].each do |element| %>
               <%= step_nav_helper.render_step_nav_element(element, options) %>

data/app/views/govuk_publishing_components/components/_step_by_step_nav_header.html.erb

@@ -3,7 +3,7 @@
 
   title ||= false
   path ||= false
-  ga4_tracking ||= false
+  disable_ga4 ||= false
   breadcrumbs = [
     { title: "Home", url: "/" },
     { title: title, url: path }
@@ -12,7 +12,7 @@
 
   data = {}
   data[:module] = "gem-track-click"
-  data[:module] << " ga4-link-tracker" if ga4_tracking
+  data[:module] << " ga4-link-tracker" unless disable_ga4
 
   tracking_id ||= false
   tracking_category ||= "stepNavHeaderClicked"
@@ -26,7 +26,7 @@
     tracking_options ||= ({ dimension96: tracking_id }).to_json
   end
 
-  if ga4_tracking
+  unless disable_ga4
     ga4_data = {
       event_name: "navigation",
       type: "super breadcrumb",
@@ -52,7 +52,7 @@
         data-track-category="<%= tracking_category %>"
         data-track-action="<%= tracking_action %>"
         data-track-label="<%= tracking_label %>"
-        <% if ga4_tracking %>
+        <% unless disable_ga4 %>
           data-ga4-link='<%= ga4_data %>'
         <% end %>
         <% if tracking_dimension_enabled %>

data/app/views/govuk_publishing_components/components/_step_by_step_nav_related.html.erb

@@ -1,6 +1,6 @@
 <%
   add_gem_component_stylesheet("step-by-step-nav-related")
-  ga4_tracking ||= false
+  disable_ga4 ||= false
   links ||= []
   pretitle ||= t("components.step_by_step_nav_related.part_of")
   always_display_as_list ||= false
@@ -8,7 +8,7 @@
   classes << "gem-c-step-nav-related--singular" if links.length == 1
   data = {}
   data[:module] = "gem-track-click"
-  data[:module] << " ga4-link-tracker" if ga4_tracking
+  data[:module] << " ga4-link-tracker" unless disable_ga4
 %>
 <% if links.any? %>
   <%= tag.div(class: classes, data: data) do %>
@@ -23,7 +23,7 @@
             data-track-dimension="<%= links[0][:text] %>"
             data-track-dimension-index="29"
             data-track-options='{"dimension96" : "<%= links[0][:tracking_id] %>" }'
-            <% if ga4_tracking
+            <% unless disable_ga4
               ga4_attributes = {
                 event_name: "navigation",
                 type: "part of",
@@ -51,7 +51,7 @@
                 data-track-dimension="<%= link[:text] %>"
                 data-track-dimension-index="29"
                 data-track-options='{"dimension96" : "<%= link[:tracking_id] %>" }'
-                <% if ga4_tracking
+                <% unless disable_ga4
                   ga4_attributes = {
                     event_name: "navigation",
                     type: "part of",

data/app/views/govuk_publishing_components/components/_tabs.html.erb

@@ -8,13 +8,13 @@
   panel_css_classes = panel_css_classes.join(" ")
 
   as_links ||= false
-  ga4_tracking ||= false
+  disable_ga4 ||= false
 
   component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
   component_helper.add_class("govuk-tabs gem-c-tabs")
   component_helper.add_data_attribute({ module: "govuk-tabs" }) unless as_links
 
-  if ga4_tracking
+  unless disable_ga4
     component_helper.add_data_attribute({ module: "ga4-event-tracker" }) unless as_links
     component_helper.add_data_attribute({ module: "ga4-link-tracker" }) if as_links
   end
@@ -29,7 +29,7 @@
       <li class="govuk-tabs__list-item <%= "govuk-tabs__list-item--selected" if tab[:active] %>">
         <%
           tab[:tab_data_attributes] ||= {}
-          if ga4_tracking
+          unless disable_ga4
             ga4_attributes = {
               event_name: "select_content",
               type: "tabs",
@@ -65,10 +65,10 @@
   <% end %>
 <% end %>
 <% if tabs.count == 1 %>
-    <section id="<%= tabs[0][:id] %>">
-      <% if tabs[0][:title] %>
-        <h2 class="govuk-heading-l"><%= tabs[0][:title] %></h2>
-      <% end %>
-      <%= tabs[0][:content] %>
-    </section>
+  <section id="<%= tabs[0][:id] %>">
+    <% if tabs[0][:title] %>
+      <h2 class="govuk-heading-l"><%= tabs[0][:title] %></h2>
+    <% end %>
+    <%= tabs[0][:content] %>
+  </section>
 <% end %>

data/app/views/govuk_publishing_components/components/contextual_sidebar/_ukraine_cta.html.erb

@@ -3,7 +3,7 @@
   title = t("components.related_navigation.ukraine.title")
   lang = shared_helper.t_locale("components.related_navigation.ukraine.title")
   data_module = "gem-track-click"
-  data_module << " ga4-link-tracker" if ga4_tracking
+  data_module << " ga4-link-tracker" unless disable_ga4
 %>
 <%= tag.div class: "gem-c-contextual-sidebar__cta gem-c-contextual-sidebar__cta--ukraine", data: { module: data_module } do %>
   <%= tag.h2 title, class: "gem-c-contextual-sidebar__heading govuk-heading-s" %>
@@ -20,7 +20,7 @@
             index_section_count: "#{ga4_tracking_counts.index_section_count}",
             index_total: "#{index_total}",
             section: title,
-          } if ga4_tracking
+          } unless disable_ga4
         %>
         <%= link_to link[:label],
           link[:href],

data/app/views/govuk_publishing_components/components/docs/accordion.yml

@@ -34,7 +34,7 @@ accessibility_criteria: |
 
   * be fully expanded
   * not be marked as expandable
-uses_component_wrapper_helper: true  
+uses_component_wrapper_helper: true
 shared_accessibility_criteria:
   - link
 examples:
@@ -182,11 +182,11 @@ examples:
                     <a class="govuk-link" href="#">Retiring your service</a>
                   </li>
               </ul>'
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Allows you to add GA4 tracking to an accordion. This will add a data module and data-attributes with JSONs to the accordion. See the [ga4-event-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) for more information.
+      Disables GA4 tracking on the accordion. Tracking is enabled by default. This adds a data module and data-attributes with JSONs to the accordion. See the [ga4-event-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) for more information.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       items:
         - heading:
             text: Writing well for the web

data/app/views/govuk_publishing_components/components/docs/contents_list.yml

@@ -192,10 +192,10 @@ examples:
             text: 2. Numbers not parsed
           - href: "#third-thing"
             text: 3. Numbers are just text
-  with_ga4_tracking:
-    description: Enables the GA4 link tracker on the list.
+  without_ga4_tracking:
+    description: Disables GA4 link tracking on the list. Tracking is enabled by default.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       contents:
         - href: "https://www.gov.uk"
           text: 1. First thing

data/app/views/govuk_publishing_components/components/docs/contextual_breadcrumbs.yml

@@ -32,13 +32,12 @@ examples:
       inverse: true
     context:
       dark_background: true
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Adds GA4 tracking to the step by step nav header component when it is rendered as a breadcrumb. See the 
+      Disables GA4 tracking. Tracking is enabled by default. This includes GA4 tracking on the step by step nav header component when it is rendered as a breadcrumb. See the
       [ga4-link-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
-      Note: tracking on regular breadcrumbs is enabled by default and does not require activating.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         title: "A content item"
         links:

data/app/views/govuk_publishing_components/components/docs/contextual_footer.yml

@@ -69,10 +69,10 @@ examples:
           ordered_related_items:
             - title: "Find an apprenticeship"
               base_path: "/apply-apprenticeship"
-  with_ga4_tracking:
-    description: Adds Google Analytics 4 tracking to the Related Navigation component, if it is visible.
+  without_ga4_tracking:
+    description: Disables GA4 tracking on the component. Tracking is enabled by default.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         title: "A content item"
         links:

data/app/views/govuk_publishing_components/components/docs/contextual_sidebar.yml

@@ -103,10 +103,10 @@ examples:
               title: "Russian invasion of Ukraine: UK government response"
               base_path: "/government/topical-events/russian-invasion-of-ukraine-uk-government-response"
               locale: "en"
-  with_ga4_tracking_on_related_navigation:
-    description: Adds Google Analytics 4 tracking to components within the sidebar. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
+  without_ga4_tracking_on_related_navigation:
+    description: Disables GA4 tracking on components within the sidebar. Tracking is enabled by default. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA have tracking.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         title: "UK forces arrive to reinforce NATO’s eastern flank"
         content_id: "a342fd46-d801-4c1e-9d8f-f41fba6da563"
@@ -129,10 +129,10 @@ examples:
               title: "Russian invasion of Ukraine: UK government response"
               base_path: "/government/topical-events/russian-invasion-of-ukraine-uk-government-response"
               locale: "en"
-  with_ga4_tracking_on_step_by_step:
-    description: Adds Google Analytics 4 tracking to components within the sidebar. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
+  without_ga4_tracking_on_step_by_step:
+    description: Disables GA4 tracking on components within the sidebar. Tracking is enabled by default. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         title: "A content item"
         links:
@@ -157,10 +157,10 @@ examples:
                       - text: Arrange the funeral
                         href: "/after-a-death/arrange-the-funeral"
                     optional: false
-  with_ga4_tracking_on_part_of_step_by_step_heading(s):
-    description: Adds Google Analytics 4 tracking to the "Part of" step by step heading(s) in the sidebar. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
+  without_ga4_tracking_on_part_of_step_by_step_heading(s):
+    description: Disables GA4 tracking on the "Part of" step by step heading(s) in the sidebar. Tracking is enabled by default. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         links:
           part_of_step_navs:

data/app/views/govuk_publishing_components/components/docs/cookie_banner.yml

@@ -49,8 +49,8 @@ examples:
         cookie_preferences:
           text: How we use cookies
           href: "/cookies"
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the "You have accepted cookies" section, and allows the pageview event that is sent when GA4 initialises to record the presence of the cookie acceptance message.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the "You have accepted cookies" section, and allows the pageview event that is sent when GA4 initialises to record the presence of the cookie acceptance message.
     data:
-      ga4_tracking: true
+      disable_ga4: true

data/app/views/govuk_publishing_components/components/docs/devolved_nations.yml

@@ -19,14 +19,14 @@ examples:
       national_applicability:
         england:
           applicable: true
-  applies_to_two_nations:  
+  applies_to_two_nations:
     data:
       national_applicability:
         england:
           applicable: true
         wales:
           applicable: true
-  applies_to_three_nations:  
+  applies_to_three_nations:
     data:
       national_applicability:
         england:
@@ -89,9 +89,9 @@ examples:
       national_applicability:
         england:
           applicable: true
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
     data:
       national_applicability:
         england:

data/app/views/govuk_publishing_components/components/docs/emergency_banner.yml

@@ -45,13 +45,13 @@ examples:
       short_description: "1491 to 1547"
       link: "https://www.gov.uk/"
       homepage: true
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
     data:
       campaign_class: "notable-death"
       heading: "His Royal Highness Henry VIII"
       short_description: "1491 to 1547"
       link: "https://www.gov.uk/"
       homepage: true
-      ga4_tracking: true
+      disable_ga4: true

data/app/views/govuk_publishing_components/components/docs/intervention.yml

@@ -6,9 +6,9 @@ body: |
   that would be useful to them. This component would be used to add this personalised content and would
   indicate to the user that this is not normally part of the page, but has been added for them specifically.
 
-  The dismiss link works without Javascript by pointing to the current URL with the "hide-intervention" 
-  query string parameter set to "true". It's progressively enhanced and sets a cookie to remember that 
-  the user has dismissed the banner before. The cookie requires a "name" parameter, the value of which 
+  The dismiss link works without Javascript by pointing to the current URL with the "hide-intervention"
+  query string parameter set to "true". It's progressively enhanced and sets a cookie to remember that
+  the user has dismissed the banner before. The cookie requires a "name" parameter, the value of which
   is stored in the cookie to distinguish which campaign banner the user has dismissed.
 
 accessibility_criteria: |
@@ -33,8 +33,8 @@ examples:
       suggestion_link_url: /travel-abroad
 
   with_dismiss_link:
-    description: | 
-      Name is required in order to set a cookie. The name value should be distinct to the campaign for the banner, 
+    description: |
+      Name is required in order to set a cookie. The name value should be distinct to the campaign for the banner,
       so that other banners using this component are not hidden by accident.
     data:
       suggestion_text: You should renew your permit every 6 months.
@@ -89,11 +89,11 @@ examples:
         track-label: hide the intervention
       dismiss_link_data_attributes:
         track-category: example
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the component itself, event tracking on the 'Hide' link, and allows pageviews to record the presence of the banner on page load.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, event tracking on the 'Hide' link, and allows pageviews to record the presence of the banner on page load.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       suggestion_text: Based on your browsing you might be interested in
       suggestion_link_text: "Travel abroad: step by step"
       suggestion_link_url: /travel-abroad

data/app/views/govuk_publishing_components/components/docs/metadata.yml

@@ -355,6 +355,8 @@ examples:
       see_updates_link: true
       other:
         Applies to: England, Scotland, and Wales (see detailed guidance for <a href="http://www.dardni.gov.uk/news-dard-pa022-a-13-new-procedure-for" rel="external">Northern Ireland</a>)
+    context:
+      dark_background: true
   on_a_dark_background_without_padding:
     description: By default the inverse option includes extra spacing around the component. This option removes this padding. Note that both the `inverse` and `inverse_compress` options must be supplied.
     data:
@@ -375,6 +377,8 @@ examples:
       see_updates_link: true
       other:
         Applies to: England, Scotland, and Wales (see detailed guidance for <a href="http://www.dardni.gov.uk/news-dard-pa022-a-13-new-procedure-for" rel="external">Northern Ireland</a>)
+    context:
+      dark_background: true
   with_custom_margin_bottom:
     description: |
       The component accepts a number for margin bottom from `0` to `9` (`0px` to `60px`) using the [GOV.UK Frontend spacing scale](https://design-system.service.gov.uk/styles/spacing/#the-responsive-spacing-scale). It defaults to the `margin-bottom` values defined in the [responsive-bottom-margin mixin](https://github.com/alphagov/govuk_publishing_components/blob/main/app/assets/stylesheets/govuk_publishing_components/components/mixins/_margins.scss#L1)
@@ -382,10 +386,10 @@ examples:
       first_published: 14 June 2014
       last_updated: 10 September 2015
       margin_bottom: 2
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables the GA4 link tracker on the 'See all updates' link.
+      Disables the GA4 link tracker on the 'See all updates' link. Tracking is enabled by default.
     data:
       last_updated: 10 September 2015
       see_updates_link: true
-      ga4_tracking: true
+      disable_ga4: true

data/app/views/govuk_publishing_components/components/docs/phase_banner.yml

@@ -32,11 +32,11 @@ examples:
       app_name: Skittles Maker
       phase: beta
       inverse: true
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
     data:
       app_name: Skittles Maker
       phase: beta
       inverse: true
-      ga4_tracking: true
+      disable_ga4: true

data/app/views/govuk_publishing_components/components/docs/previous_and_next_navigation.yml

@@ -64,10 +64,10 @@ examples:
         url: next-page
         title: Next
         label: 'Driver CPC part 1 test: theory'
-  with_ga4_tracking:
-    description: Enables the GA4 link tracker on the links.
+  without_ga4_tracking:
+    description: Disables the GA4 link tracker on the links. Tracking is enabled by default.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       previous_page:
         url: previous-page
         title: Previous

data/app/views/govuk_publishing_components/components/docs/related_navigation.yml

@@ -306,10 +306,10 @@ examples:
               title: "Student loans: terms and conditions 2017 to 2018 (PDF, 136KB)"
             - title: The Student Room repaying your student loan
               url: https://www.thestudentroom.co.uk/content.php?r=5967-Repaying-your-student-loan
-  with_ga4_tracking:
-    description: Adds Google Analytics 4 tracking to the component, using the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md).
+  without_ga4_tracking:
+    description: Disables GA4 tracking on the banner. Tracking is enabled by default and uses the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md).
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         links:
           ordered_related_items:
@@ -352,4 +352,3 @@ examples:
               base_path: /world/chile/news
             - title: China
               base_path: /world/China/news
- 

data/app/views/govuk_publishing_components/components/docs/step_by_step_nav.yml

@@ -72,17 +72,13 @@ examples:
           ]
         }
       ]
-  with_google_analytics_4_tracking:
+  without_google_analytics_4_tracking:
     description: |
-      The ga4_tracking boolean allows you to add Google Analytics 4 (GA4) tracking to your component.
-      Setting this to true will add the `ga4-event-tracker` module to your component. The JavaScript will then add a `data-ga4-event` attribute and `data-ga4-expandable` attribute to the "Show all steps" button, and each clickable Step heading.
-      GA4 will then track these elements when they are expanded or collapsed.
-      `data-ga4-event` contains a JSON with event data relevant to our tracking. `data-ga4-expandable` enables the value of `aria-expanded` to be captured.
-      See the [ga4-event-tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) docs for more information.
-      Links are also tracked with the [ga4-link-tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md).
-      Therefore the `ga4-link-tracker` data module also exists on these step by step components. Any links will contain a data attribute of `ga4-link`, which contains the relevant tracking data as a JSON.
+      Disables GA4 tracking on the component. Tracking is enabled by default. This includes the [ga4-event-tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) module as well as `data-ga4-event` and `data-ga4-expandable` attributes on the "Show all steps" button, and each clickable Step heading. `data-ga4-event` contains JSON with event data relevant to tracking. `data-ga4-expandable` enables the value of `aria-expanded` to be captured.
+
+      Links within steps are tracked with the [ga4-link-tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md). Links are given a data attribute of `ga4-link`, which contains the relevant tracking data as JSON.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       steps: [
         {
           title: "Do something",
@@ -128,7 +124,7 @@ examples:
       ]
   with_unique_tracking:
     description: |
-      In order to identify the step by step navigation the component is part of, we need to track a unique ID of the navigation in Google Analytics. This ID should be the same across all pages that are linked from and are part of that navigation. Its value is included in any tracking events, specifically in dimension96. It refers to the ID of the step nav page.
+      In order to identify the step by step navigation the component is part of, we need to track a unique ID of the navigation in Universal Analytics. This ID should be the same across all pages that are linked from and are part of that navigation. Its value is included in any tracking events, specifically in dimension96. It refers to the ID of the step nav page.
 
       This includes show/hide all, show/hide step and any link clicks.
     data:
@@ -531,7 +527,7 @@ examples:
 
           No change. Active step by step will be expanded.
 
-      4. Content item is part of multiple primary step by steps and a single secondary step by step 
+      4. Content item is part of multiple primary step by steps and a single secondary step by step
 
           No change. Show "Part of" step by steps list. Secondary step by step won't be shown.
 

data/app/views/govuk_publishing_components/components/docs/step_by_step_nav_header.yml

@@ -51,9 +51,9 @@ examples:
       tracking_action: "customTrackingAction"
       tracking_label: "customTrackingLabel"
       tracking_dimension_enabled: false
-  with_ga4_tracking:
-    description: The ga4_tracking boolean allows you to add Google Analytics 4 (GA4) tracking to your component. Setting this to true will add the `ga4-link-tracker` module to your component. The JavaScript will then add a `data-ga4-link` attribute which contains a JSON object with data relevant to our tracking. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
+  without_ga4_tracking:
+    description: Disables GA4 tracking on the header. Tracking is enabled by default. This includes the `ga4-link-tracker` module and `data-ga4-link` attributes. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       title: 'Learn to drive a motorbike: step by step'
       path: /learn-to-drive-a-motorbike

data/app/views/govuk_publishing_components/components/docs/step_by_step_nav_related.yml

@@ -64,7 +64,7 @@ examples:
       ]
   always_display_as_a_list:
     description: |
-      when this component is rendered alongside an expanded step by step, we want it to render as a heading. 
+      when this component is rendered alongside an expanded step by step, we want it to render as a heading.
       However, in some cases the component will not be followed by a step by step, for example [Book Driving Test](https://www.gov.uk/book-driving-test).
       In these cases, the heading is not followed by any content, so it should be rendered as a list instead.
     data:
@@ -76,10 +76,10 @@ examples:
           text: 'Learn to drive a motorbike: step by step'
         }
       ]
-  with_ga4_tracking:
-    description: The ga4_tracking boolean allows you to add Google Analytics 4 (GA4) tracking to your component. Setting this to true will add the `ga4-link-tracker` module to your component. The JavaScript will then add a `data-ga4-link` attribute which contains a JSON object with data relevant to our tracking. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
+  without_ga4_tracking:
+    description: Disables GA4 tracking on the component. Tracking is enabled by default. This includes the `ga4-link-tracker` module and `data-ga4-link` attributes. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       pretitle: 'Example pretitle'
       links: [
         {

data/app/views/govuk_publishing_components/components/docs/tabs.yml

@@ -95,10 +95,10 @@ examples:
             tracking: GTM-123AB
           content: |
             <p class="govuk-body-m">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam congue elementum commodo. Vestibulum elit turpis, efficitur quis posuere vitae, commodo vitae augue. Donec ut pharetra ligula. Phasellus ac mauris eu felis bibendum dapibus rutrum sed quam. Pellentesque posuere ante id consequat pretium.</p>
-  with_ga4_tracking_on_tabs:
-    description: Enables GA4 tracking by adding the event tracker and required data attributes to the tabs. See the [ga4-event-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) for more information.
+  without_ga4_tracking_on_tabs:
+    description: Disables GA4 tracking on tabs. Tracking is enabled by default. This includes the event tracker and required data attributes. See the [ga4-event-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) for more information.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       tabs:
         - id: "tab-with-ga4-tracking-1"
           label: "First section"
@@ -110,8 +110,8 @@ examples:
           title: "Second section"
           content: |
             <p class="govuk-body-m">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam congue elementum commodo. Vestibulum elit turpis, efficitur quis posuere vitae, commodo vitae augue. Donec ut pharetra ligula. Phasellus ac mauris eu felis bibendum dapibus rutrum sed quam. Pellentesque posuere ante id consequat pretium.</p>
-  with_ga4_tracking_on_tabs_as_links:
-    description: Enables GA4 tracking by adding the link tracker and required data attributes to the tabs. See the [ga4-link-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
+  without_ga4_tracking_on_tabs_as_links:
+    description: Disables GA4 tracking on tabs as links. Tracking is enabled by default.
     data:
       as_links: true
       ga4_tracking: true

data/app/views/govuk_publishing_components/components/related_navigation/_section.html.erb

@@ -40,7 +40,7 @@
           index_section_count: "#{section_count}",
           index_total: "#{index_total}",
           section: ga4_heading_text,
-        } if ga4_tracking
+        } unless disable_ga4
         link_element = link_to(
           link[:text],
           link[:path],
@@ -69,13 +69,13 @@
     <% if links.length > section_link_limit %>
       <%
         classes = "gem-c-related-navigation__link toggle-wrap"
-        data_attributes_li = { module: "ga4-event-tracker" } if ga4_tracking
+        data_attributes_li = { module: "ga4-event-tracker" } unless disable_ga4
         data_attributes_link = {
           controls: "toggle_#{section_title}",
           expanded: "false",
           toggled_text: t("common.toggle_less")
         }
-        data_attributes_link[:ga4_event] = { "event_name": "select_content", "type": "related content" } if ga4_tracking
+        data_attributes_link[:ga4_event] = { "event_name": "select_content", "type": "related content" } unless disable_ga4
       %>
       <%= tag.li(class: classes, data: data_attributes_li) do %>
         <%= link_to("#", class: "gem-c-related-navigation__toggle", data: data_attributes_link) do %>

data/lib/govuk_publishing_components/presenters/breadcrumb_selector.rb

@@ -3,11 +3,11 @@ module GovukPublishingComponents
     class BreadcrumbSelector
       attr_reader :content_item, :request, :prioritise_taxon_breadcrumbs
 
-      def initialize(content_item, request, prioritise_taxon_breadcrumbs, ga4_tracking)
+      def initialize(content_item, request, prioritise_taxon_breadcrumbs, disable_ga4)
         @content_item = content_item
         @request = request
         @prioritise_taxon_breadcrumbs = prioritise_taxon_breadcrumbs
-        @ga4_tracking = ga4_tracking
+        @disable_ga4 = disable_ga4
       end
 
       def breadcrumbs
@@ -38,7 +38,7 @@ module GovukPublishingComponents
         elsif navigation.content_tagged_to_current_step_by_step?
           {
             step_by_step: true,
-            breadcrumbs: navigation.step_nav_helper.header(@ga4_tracking),
+            breadcrumbs: navigation.step_nav_helper.header(@disable_ga4),
           }
         elsif navigation.content_is_tagged_to_a_live_taxon? && prioritise_taxon_breadcrumbs
           {

data/lib/govuk_publishing_components/version.rb

@@ -1,3 +1,3 @@
 module GovukPublishingComponents
-  VERSION = "35.21.3".freeze
+  VERSION = "35.22.0".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govuk_publishing_components
 version: !ruby/object:Gem::Version
-  version: 35.21.3
+  version: 35.22.0
 platform: ruby
 authors:
 - GOV.UK Dev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-08 00:00:00.000000000 Z
+date: 2023-11-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: govuk_app_config
@@ -1478,7 +1478,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.21
+rubygems_version: 3.4.22
 signing_key: 
 specification_version: 4
 summary: A gem to document components in GOV.UK frontend applications