In this post we’ll walk through a few of the various options for the module action menus. In this examples, we’ll be forgoing the use of the many constructor overloads in favor of using the various properties which we think make the code more readable.

As most module developers are aware, the first step in using the Module Action Menus is to have your module implement the IActionable interface.  This interface defines a single property which returns a collection of ModuleActions.

Namespace DotNetNuke.Modules.MenuExample

  Partial Class View
    Inherits Entities.Modules.PortalModuleBase
    Implements DotNetNuke.Entities.Modules.Iactionable

    Public ReadOnly Property ModuleActions As ModuleActionCollection
      Implements ModuleActions

      Get
        Dim modActions As New ModuleActionCollection()
        ...
        Return modActions
      End Get
    End Property
  End Class

End Namespace

Inside of this property we’ll add whichever actions are appropriate for the module.  Using the module action menus, it is possible to define a JavaScript method which is called when the associated menu item is selected.  We usually use this in my own modules when we want to popup a form for the user that we have created using jQuery or some other client-side script.  This minimizes postbacks and makes for a much more responsive UI.

' JavaScript Example
Dim jsAction As New ModuleAction (ModuleContext.GetNextActionID()
With jsAction
  .Title = "JavaScript Example"
  .CommandName = ModuleActionType.AddContent
  .ClientScript = "alert('Isn\'t this cool!')"
  .Secure = Security.SecurityAccessLevel.Edit
End With
modActions.Add(jsAction)

There are times when you will want to redirect the user to some specific URL within the current site or even on another site. You might want to provide access to the latest documentation or link the user to the relevant support forum on your website. This behavior is controlled by the URL property.

' URL Example
Dim urlAction As New ModuleAction (ModuleContext.GetNextActionID())
With urlAction
  .Title = "Url Example"
  .CommandName = "redirect"
  .Url = http://www.dotnetnuke.com
  .Secure = Security.SecurityAccessLevel.Edit
End With
modActions.Add(urlAction)

While linking to a URL is good, you will probably want to open the URL in a new window so that the user doesn’t lose their place on the website where they were using your module.  To do this, just set the NewWindow property to true.

' New Window Example
Dim newAction As New ModuleAction (ModuleContext.GetNextActionID())
With newAction
  .Title = "New Window Example"
  .CommandName = "newwindow"
  .Url = "http://www.dotnetnuke.com"
  .NewWindow = True
  .Secure = Security.SecurityAccessLevel.Edit
End With
modActions.Add(newAction)

Occasionally, you will want to do some additional processing on the server-side before taking further action.  Setting the UseActionEvent will override the behavior of the URL setting and force a server side event to be triggered.

' URL Postback Example
Dim urlEventAction As New ModuleAction (ModuleContext.GetNextActionID())
With urlEventAction
  urlEventAction.Title = "Action Event Example"
  urlEventAction.CommandName = "redirect"
  urlEventAction.CommandArgument = "cancel"
  urlEventAction.Url = http://www.dotnetnuke.com
  urlEventAction.UseActionEvent = True
  urlEventAction.Secure = Security.SecurityAccessLevel.Edit
End With
modActions.Add(urlEventAction)

In order to respond to the event you will need to register an event handler in the Init event of your module control

Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Init

  'Add an Action Event Handler to the Skin
  AddActionHandler(AddressOf MyActions_Click)
End Sub

Once you have registered the ActionHandler you are free to process the action using whatever business rules are appropriate for your specific module.

Private Sub MyActions_Click(ByVal sender As Object, ByVal e As Entities.Modules.Actions.ActionEventArgs)
  Skins.Skin.AddModuleMessage(Me, _
    String.Format(Localization.GetString("ClickMessage", LocalResourceFile), e.Action.CommandName), _
    ModuleMessage.ModuleMessageType.BlueInfo)

Select Case e.Action.CommandName.ToLowerInvariant
  Case "redirect"
    If e.Action.CommandArgument.ToLowerInvariant <> "cancel" Then
      Response.Redirect(e.Action.Url
    Else
      Skins.Skin.AddModuleMessage(Me,
        "Canceled the Redirect", _
        ModuleMessage.ModuleMessageType.YellowWarning)
        End If
  End Select
End Sub

This post highlights just a few of the hidden capabilities of the Module Action Menu. The HTML/Text module is a great place to start.

Reasons why you must trust ASPHostPortal.com

Every provider will tell you how they treat their support, uptime, expertise, guarantees, etc., are. Take a close look. What they’re really offering you is nothing close to what ASPHostPortal does. You will be treated with respect and provided the courtesy and service you would expect from a world-class web hosting business.

You’ll have highly trained, skilled professional technical support people ready, willing, and wanting to help you 24 hours a day. Your web hosting account servers are monitored from three monitoring points, with two alert points, every minute, 24 hours a day, 7 days a week, 365 days a year. The followings are the list of other added- benefits you can find when hosting with us:

- DELL Hardware
Dell hardware is engineered to keep critical enterprise applications running around the clock with clustered solutions fully tested and certified by Dell and other leading operating system and application providers.
- Recovery Systems
Recovery becomes easy and seamless with our fully managed backup services. We monitor your server to ensure your data is properly backed up and recoverable so when the time comes, you can easily repair or recover your data.
- Control Panel
We provide one of the most comprehensive customer control panels available. Providing maximum control and ease of use, our Control Panel serves as the central management point for your ASPHostPortal account. You’ll use a flexible, powerful hosting control panel that will give you direct control over your web hosting account. Our control panel and systems configuration is fully automated and this means your settings are configured automatically and instantly.
- Excellent Expertise in Technology
The reason we can provide you with a great amount of power, flexibility, and simplicity at such a discounted price is due to incredible efficiencies within our business. We have not just been providing hosting for many clients for years, we have also been researching, developing, and innovating every aspect of our operations, systems, procedures, strategy, management, and teams. Our operations are based on a continual improvement program where we review thousands of systems, operational and management metrics in real-time, to fine-tune every aspect of our operation and activities. We continually train and retrain all people in our teams. We provide all people in our teams with the time, space, and inspiration to research, understand, and explore the Internet in search of greater knowledge. We do this while providing you with the best hosting services for the lowest possible price.
- Data Center
ASPHostPortal modular Tier-3 data center was specifically designed to be a world-class web hosting facility totally dedicated to uncompromised performance and security
- Monitoring Services
From the moment your server is connected to our network it is monitored for connectivity, disk, memory and CPU utilization – as well as hardware failures. Our engineers are alerted to potential issues before they become critical.
- Network
ASPHostPortal has architected its network like no other hosting company. Every facet of our network infrastructure scales to gigabit speeds with no single point of failure.
- Security
Network security and the security of your server are ASPHostPortal’s top priorities. Our security team is constantly monitoring the entire network for unusual or suspicious behavior so that when it is detected we can address the issue before our network or your server is affected.
- Support Services
Engineers staff our data center 24 hours a day, 7 days a week, 365 days a year to manage the network infrastructure and oversee top-of-the-line servers that host our clients’ critical sites and services.