CTA Components

⚠️ Important Notice: We are transitioning from <bw-widget> to <nw-blocks> tags. While <bw-widget> is still supported for backward compatibility, all new implementations should use <nw-blocks>. Please update your existing widgets when possible.


Overview

The CTA (Call-to-Action) components provide flexible ways to display links and buttons with tracking capabilities. There are four main component types:

  • ctaLink: Renders a simple styled hyperlink
  • ctaGeoLink: Geo-targeted link based on user location and product
  • ctaButton: Renders a styled button with customizable colors
  • ctaGeoButton: Geo-targeted button based on user location and product

A simple call-to-action link with tracking and styling options.

Basic Usage

Expand me...

dcKey 5ad8ff66ca76b265867d5cf337d632d8

Claim bonus

With Custom Text

Expand me...

dcKey 084383019732cb2ee49df28d8fc6b322

Override translation

Container Specification

You can specify whether the link should be wrapped in a span (inline, default) or div (block).

Expand me...

dcKey 2cbaa4e593e6f1d193438565309e53b3

Container is div
  it is not inlined with text
Expand me...

dcKey bfff816b79ea5bc1bd065a82a1247035

Container is span by default
  it is inlined with text (default is span)

Advanced Configuration

Customize font size, colors, and hover effects using the configuration attribute.

Expand me...

dcKey c5d7800707adf96ef8f10149eaafed24

Claim bonus

Attributes Reference

Attribute Type Default Description
id string required Component identifier (ctaLink)
cloaked-link string - The cloaked tracking link slug
text string - Custom link text (overrides translation)
translation string "cta-claim-bonus" i18n translation key
target string "" Link target attribute (_blank, _self, etc.)
rel string "nofollow" Link rel attribute
container string "span" Container element (span or div)
hover-color string "#0E5DB9" Link color on hover
tracking-target string - Additional tracking target parameter
tracking-data string - Custom tracking data
override-url string - Override the generated URL
referer string - Referer parameter for tracking
configuration JSON {"fontSize": "inherit", "color": "#0F73E6"} Styling configuration object

Blocked brands

Every brand carries an “IP’s excluded” list in Vulcan (Brand details > IP Control). The widget checks that list against the country it resolves for the page: the country attribute when the tag has one, otherwise the visitor’s country. When the country is on the list, the link text stays on the page but there is no link: no href, no redirect, no tracking click. The text is rendered as a plain <span class="cta-link--blocked" aria-disabled="true" data-brand-blocked="true"> in the inherited text color, so it does not look clickable; style it through those hooks if the theme needs a different look. A brand that is switched off in Vulcan (status not active) renders nothing visible, as before.


A geo-targeted call-to-action link that automatically selects brands based on user location, product, and language.

Basic Usage

Expand me...

dcKey b28822a077384ed16cff44dec082b0f9

S'inscrire updated

With Custom Configuration

Expand me...

dcKey 8154fefd47bd0c52b7da4b0e9b0c9536

Claim bonus

With Brand Name Placeholder

Use ##brand_name## in your text to dynamically insert the brand name.

Expand me...

dcKey d6c6652daaf1ae8381420d14adb83ada

Ton bonus chez Royalistplay Casino

With Text Override and Brand Placeholder

Expand me...

dcKey b51a19df5cd957de06cfcd31508b70fd

Youpi trop bien : Legendplay Sports !

Attributes Reference

Attribute Type Default Description
id string required Component identifier (ctaGeoLink)
brandposition number 0 Brand position in the geo-targeted list (0-indexed internally, use 1 for first)
product string - Product type (e.g., “SB” for Sports Betting, “CA” for Casino)
language string - Language code (e.g., “fr”, “en”)
country string - Country code (e.g., “FR”, “US”)
country-state string - State code for US/CA (e.g., “NY”, “ON”)
selling-point-type string "general" Type of selling point to display
text string - Custom link text (supports ##brand_name## placeholder)
translation string "cta-claim-bonus" i18n translation key
target string "" Link target attribute
rel string "nofollow" Link rel attribute
container string "span" Container element (span or div)
hover-color string "#0E5DB9" Link color on hover
tracking-target string - Additional tracking target parameter
configuration JSON {"fontSize": "inherit", "color": "#0F73E6"} Styling configuration object

Blocked brands: a brand excluded for the resolved country never enters the geo-targeted list, so brandposition counts only the brands available in that country and the link always points to an available brand.


ctaButton

A styled button component with customizable colors, gradients, and hover effects.

Basic Usage

Expand me...

dcKey 9dcc2f0599d39c5bb7df2ba31013b2b8

With Custom Text

Expand me...

dcKey 5f76a167e466b769b9f3d34949363246

With Advanced Configuration

Customize button appearance with gradient colors, hover effects, size, and more.

Expand me...

dcKey c8726f2f8c04511e7e06a5ed804b06a3

With Right Arrow Icon

Control the display of the right arrow icon.

Expand me...

dcKey fdffa5236405c965cbb8d09828c06df0

Attributes Reference

Attribute Type Default Description
id string required Component identifier (ctaButton)
cloaked-link string - The cloaked tracking link slug
text string - Custom button text (overrides translation)
translation string "cta-claim-bonus" i18n translation key
target string "_blank" Link target attribute
rel string "nofollow" Link rel attribute
show-right-arrow boolean true Show/hide the right arrow icon
tracking-target string - Additional tracking target parameter
tracking-data string - Custom tracking data
override-url string - Override the generated URL
referer string - Referer parameter for tracking
configuration JSON See below Styling configuration object

Configuration Object:

{
  "fontSize": "14px",
  "buttonColors": ["#05842A", "#05842A"],  // [gradient-start, gradient-end]
  "buttonHover": "#096725",
  "width": "300px"
}

Blocked brands: a button exists to be clicked, so when the brand is excluded for the resolved country (Vulcan “IP’s excluded”) the button is not rendered, exactly like an inactive brand. Only ctaLink keeps its text in that case.


ctaGeoButton

A geo-targeted button that automatically selects brands based on user location, product, and language.

Basic Usage

Expand me...

dcKey 6bbae01b388bcc98482d82f4551be6cc

With Brand Name in Text

Expand me...

dcKey 71ddacf98226305f9116c436a83b78a0

With Custom Text and Brand Placeholder

Expand me...

dcKey e6740685124d871ad5206301f93638ff

Attributes Reference

Attribute Type Default Description
id string required Component identifier (ctaGeoButton)
brandposition number 0 Brand position in the geo-targeted list (0-indexed internally, use 1 for first)
product string - Product type (e.g., “SB” for Sports Betting, “CA” for Casino)
language string - Language code (e.g., “fr”, “en”)
country string - Country code (e.g., “FR”, “US”)
country-state string - State code for US/CA (e.g., “NY”, “ON”)
selling-point-type string "general" Type of selling point to display
text string - Custom button text (supports ##brand_name## placeholder)
translation string "cta-claim-bonus" i18n translation key
target string "_blank" Link target attribute
rel string "nofollow" Link rel attribute
show-right-arrow boolean true Show/hide the right arrow icon
tracking-target string - Additional tracking target parameter
configuration JSON See ctaButton config Styling configuration object (same as ctaButton)

Backward Compatibility

All examples above use the new <nw-blocks> tag. If you need to use the legacy <bw-widget> tag for backward compatibility, simply replace <nw-blocks> with <bw-widget> in any example:

<!-- New way (recommended) -->
<nw-blocks id="ctaButton" cloaked-link="greatwin-casino" >
</nw-blocks>

<!-- Old way (still supported) -->
<bw-widget id="ctaButton" cloaked-link="greatwin-casino">
</bw-widget>

Both tags work identically and support all the same attributes and functionality.


Common Use Cases

<nw-blocks id="ctaLink" cloaked-link="your-casino" text="Play Now" ></nw-blocks>

2. Geo-Targeted Button for Multiple Markets

<nw-blocks id="ctaGeoButton" 
    product="CA" 
    language="en" 
    text="Join ##brand_name## Today!" >
</nw-blocks>

3. Custom Styled Button with Tracking

<nw-blocks id="ctaButton" 
    cloaked-link="your-casino"
    tracking-target="homepage"
    tracking-data="promo-2024"
    configuration='{"buttonColors": ["#FF6B35", "#F7931E"], "width": "200px"}' >
</nw-blocks>
Check out <nw-blocks id="ctaLink" 
    cloaked-link="your-casino" 
    text="this amazing offer"
    container="span"
    configuration='{"color": "#e74c3c", "fontSize": "inherit"}' ></nw-blocks> today!