DotNetNuke Tutorials and Articles

The FatGeorge Tag Cloud control is an XMod Add-on developed by XMod MVP, Tony Harrison. Using this Xmod add-on creates a very easy way to show category listings for your XMod application.

In this walk through I will describe how to configure Business Directory to prepare for the Tag Cloud installation and then describe the set up procedure for Tag Cloud.

Step 1

Follow the installation instructions that came with your FatGeorge Tag Cloud purchase and install Tag Cloud.

Step 2

Once you have set up your XMod application, go to the module action menu and click Configure XMod Module.

While you are in the Xmod configure mode pay attention to the URL of the page.

In our example, the end of the URL looks like this (yours will be unique to your installation):

/tabid/64/ctl/Configure/mid/401/Default.aspx

Note the values of the tabid (64) and the value for mid (401). You will need these later in step 2.

Under the Data Setting tab go to Filtering >> Filter Using URL Parameter

and select the XMod field cboCategory and give it a parameter name of cat and save your changes.

This will allow us to configure the Tag Cloud control to pass the URL querystring parameter for our categories.

Step 3. Create the Tag Cloud form

Return to the XMod module action menu and select Manage Forms.

We will now create the XMod form that will be used with Tag Cloud.

Next we will create a new Form using the Plain Text editor and Custom HTML-Based Layout.

In the screenshot above, you will notice that I have already created my form and named it BD Tag Cloud with No Local Video.

You can name it what ever you prefer.

In the settings area you can configure settings as shown below. I use Auto-Approve All Records since it is the database adding the categories and not a human.

Next you will add your form code.

In the above screenshot notice the highlighted areas of code.

formname = the name of the main form you are using. In our example we are using one of the Business Directory forms named BD6 Multiple Categories No Local Video Form.

tagfield = cboCategory This is the XMod formfield that we set up in step 1.

tagurl = the full URL location of your main XMod form. Pay close attention to the tabid and the xmid value in the example above.

Use the values from the URL in step one and create the URL that matches your DNN page.

When completed save your form and click Done.

Step 4 Add a XMod FormView Module

Next we will add a FormView module to our page and assign the Tag Cloud form to it.

In the modules action menu select Configure XMod Module.

Select the Tag Cloud form that you created in Step 2 and save your changes.

Now, when you add a new listing to your application, it will automatically be added to the Tag Cloud module.

Great Job!

For more information on the FatGeorge Tag Cloud Control click here.