New Community Website

Ordinarily, you'd be at the right spot, but we've recently launched a brand new community website... For the community, by the community.

Yay... Take Me to the Community!

The Community Blog is a personal opinion of community members and by no means the official standpoint of DNN Corp or DNN Platform. This is a place to express personal thoughts about DNNPlatform, the community and its ecosystem. Do you have useful information that you would like to share with the DNN Community in a featured article or blog? If so, please contact .

The use of the Community Blog is covered by our Community Blog Guidelines - please read before commenting or posting.

Adding Core Taxonomy to Your Module: Part 5 - Terms

As with the other parts of this series, I ask that you please read them prior to reading this blog entry. The majority of this series has touched on Content Items and what they are and how to integrate them into your module. Well, for this portion we will reference Content Items but we will be covering a new topic: Terms. Compared to the previous posts in this series, this one is fairly short!

You can find the previous parts of the series here:

  1. Part 1
  2. Part 2
  3. Part 3
  4. Part 4

Terms, while they depend on Content Items, are actually the first piece we are covering in this blog series that are specific to taxonomy/folksonomy. If you need a refresher on taxonomy/folksonomy or what terms consist of (in relation to DotNetNuke), you may wish to review Charles blog post on the topic. For content editors, terms are assigned to a content item when a user creates a content item (or update an existing content item). When users viewing a content item apply tags, these terms are then associated with the content item as well (and accessible for content editor editing via the editing of the content item).

In Part 4 we touched on where to call content creation and update methods from and where they fit into our Controller class. Now, in combination with other parts of this series, we can focus on the content add and update methods in their full glory.

Sample Create Content Item (Complete):

   1: public ContentItem CreateContentItem(EntryInfo objEntry, int tabId)
   2: {
   3:     var typeController = new ContentTypeController();
   4:     var colContentTypes = (from t in typeController.GetContentTypes() where t.ContentType == ContentTypeName select t);
   5:     var contentTypeID = 0;
   7:     if (colContentTypes.Count() > 0)
   8:     {
   9:         var contentType = colContentTypes.Single();
  10:         contentTypeID = contentType == null ? CreateContentType() : contentType.ContentTypeId;
  11:     }
  12:     else
  13:     {
  14:         contentTypeID = CreateContentType();
  15:     }
  17:     var objContent = new ContentItem
  18:                         {
  19:                             Content = objEntry.MyContent,
  20:                             ContentTypeId = contentTypeID,
  21:                             Indexed = false,
  22:                             ContentKey = "mid=" + objEntry.ModuleId + "&ctl=ViewEntry" + "&EntryID=" + objEntry.EntryId,
  23:                             ModuleID = objEntry.ModuleID,
  24:                             TabID = tabId
  25:                         };
  27:     objContent.ContentItemId = Util.GetContentController().AddContentItem(objContent);
  29:     // Handle Taxonomy Terms
  30:     Util.GetTermController().RemoveTermsFromContent(objContent);
  31:     foreach (var term in objEntry.Terms) {
  32:                 Util.GetTermController().AddTermToContent(term, objContent);
  33:             }
  35:     return objContent;
  36: }

The only items that are new, versus what was covered in Part 2, are lines 30-33. Here is where we call the Core API to first clear any associated terms (in line 30). Next, we loop through each term (which is selected in the user interface and will be covered in Part 6) and then add it to the data store using the Core API’s Util.GetTermController (this is under the DotNetNuke.Entities.Content.Common namespace) passing it the individual term (because we are looping through one by one) and the Content Item we just created. As for the update method, we would just add lines 30-33 at the end of our UpdateContentItem method (also covered in Part 2).

Thus far we have covered everything around taxonomy integration besides integrating it into your user interface, therefore for the final blog entry in this series we will cover the user interface integration and the controls available for you to use.


There are currently no comments, be the first to post one.

Comment Form

Only registered users may post comments.


Aderson Oliveira (22)
Alec Whittington (11)
Alessandra Daniels (3)
Alex Shirley (10)
Andrew Hoefling (3)
Andrew Nurse (30)
Andy Tryba (1)
Anthony Glenwright (5)
Antonio Chagoury (28)
Ash Prasad (37)
Ben Schmidt (1)
Benjamin Hermann (25)
Benoit Sarton (9)
Beth Firebaugh (12)
Bill Walker (36)
Bob Kruger (5)
Bogdan Litescu (1)
Brian Dukes (2)
Brice Snow (1)
Bruce Chapman (20)
Bryan Andrews (1)
cathal connolly (55)
Charles Nurse (163)
Chris Hammond (213)
Chris Paterra (55)
Clint Patterson (108)
Cuong Dang (21)
Daniel Bartholomew (2)
Daniel Mettler (181)
Daniel Valadas (48)
Dave Buckner (2)
David Poindexter (12)
David Rodriguez (3)
Dennis Shiao (1)
Doug Howell (11)
Erik van Ballegoij (30)
Ernst Peter Tamminga (80)
Francisco Perez Andres (17)
Geoff Barlow (12)
George Alatrash (12)
Gifford Watkins (3)
Gilles Le Pigocher (3)
Ian Robinson (7)
Israel Martinez (17)
Jan Blomquist (2)
Jan Jonas (3)
Jaspreet Bhatia (1)
Jenni Merrifield (6)
Joe Brinkman (274)
John Mitchell (1)
Jon Henning (14)
Jonathan Sheely (4)
Jordan Coopersmith (1)
Joseph Craig (2)
Kan Ma (1)
Keivan Beigi (3)
Kelly Ford (4)
Ken Grierson (10)
Kevin Schreiner (6)
Leigh Pointer (31)
Lorraine Young (60)
Malik Khan (1)
Matt Rutledge (2)
Matthias Schlomann (16)
Mauricio Márquez (5)
Michael Doxsey (7)
Michael Tobisch (3)
Michael Washington (202)
Miguel Gatmaytan (3)
Mike Horton (19)
Mitchel Sellers (40)
Nathan Rover (3)
Navin V Nagiah (14)
Néstor Sánchez (31)
Nik Kalyani (14)
Oliver Hine (1)
Patricio F. Salinas (1)
Patrick Ryan (1)
Peter Donker (54)
Philip Beadle (135)
Philipp Becker (4)
Richard Dumas (22)
Robert J Collins (5)
Roger Selwyn (8)
Ruben Lopez (1)
Ryan Martinez (1)
Sacha Trauwaen (1)
Salar Golestanian (4)
Sanjay Mehrotra (9)
Scott McCulloch (1)
Scott Schlesier (11)
Scott Wilkinson (3)
Scott Willhite (97)
Sebastian Leupold (80)
Shaun Walker (237)
Shawn Mehaffie (17)
Stefan Cullmann (12)
Stefan Kamphuis (12)
Steve Fabian (31)
Steven Fisher (1)
Tony Henrich (3)
Torsten Weggen (3)
Tycho de Waard (4)
Vicenç Masanas (27)
Vincent Nguyen (3)
Vitaly Kozadayev (6)
Will Morgenweck (40)
Will Strohl (180)
William Severance (5)
What is Liquid Content?
Find Out
What is Liquid Content?
Find Out
What is Liquid Content?
Find Out