External Links Widget

The External Links Widget allows you to clearly show all of the external links in your page, by visually telling your website visitors using an image. This is very similar to the external links that you would see in a wiki website, such as Wikipedia.

Widget Suite Version:  01.01.00 and up

Object Tag

<object id="ANY-UNIQUE-ID-YOU-WANT" codetype="dotnetnuke/client" codebase="WillStrohl.Widgets.ExternalLinks" declare="declare">


</object>

This is the simplest method of implementing this widget. The ID attribute is required, but can be any unique value that you want to assign to it. The rest of the values must be in place how you see them above.

Parameters

The following parameters are optional, but allow you to customize how this widget will work and affect your page.

altText

Allows you to customize the text that is used in the alt attribute of the rendered img tag. 

Default - External Link
Notes - None
Usage

<param name="altText" value="Link Opens to New Site" />

image

Allows you to customize the image that is shown to your website visitors to visually identify a link as being for an external website. 

Default - /Resources/Widgets/User/WillStrohl/images/external-link.png
Notes - None
Usage

<param name="image" value="/images/edit.gif" />

class

Allows you to specify a CSS class that will be applied to links.

Default - not specified/empty string
Notes - None
Usage

<param name="class" value="myClass" />

newWindow

Allows you to specify that all external links should be opened in a new windows. 

Default - false
Notes - None
Usage

<param name="newWindow" value="true" />

selector

Allows you to specify a CSS selector for elements whose links will be processed. 

Default - body
Notes - None
Usage

<param name="selector" value="#section1,UL" />

gaCategory

Allows you to specify the name of a category of Google Analytics event to register when a link is clicked. 

Default - Empty String/Not Specified
Notes - None
Usage

<param name="gaCategory" value="Outbound" />

gaAction

If gaCategory is specified, this is the name of the Google Analytics event action to register.

Default - None
Notes - If this is specified, a GA event with the specified category and action will be registered with a value equal to the destination URL. If not, the action itself will be the URL.
Usage

<param name="gaAction" value="Click" />

Example Usage

<object id="ANY-UNIQUE-ID-YOU-WANT" codetype="dotnetnuke/client" codebase="WillStrohl.Widgets.ExternalLinks" declare="declare">

     <param name="altText" value="Link Opens to New Site" />

     <param name="newWindow" value="true" />

</object>
Create the Widget HTML Mark-Up
  1. Enter or select the appropriate values in the form below to generate the skin widget mark-up to use in your site. Copy and paste it into your site.
  10. >> Generate Widget Code