Testimonials module: Create the module

After you Testimonials module: Create the frontend and backend views of the Testimonials module, you can create the module itself.

The module registers all necessary components to work with testimonials and creates the backend pages that provide an overview of submitted testimonials.

To implement the module class, perform the following:

1. In Visual Studio, in Solution Explorer, open the context menu of the Testimonials folder and click Add » Class...
   

2. In the Name input field, enter TestimonialsModule.
   

3. Open the file TestimonialsModule.cs and add the following namespaces:
   

   
   

   using Telerik.Sitefinity.Abstractions;

   using Telerik.Sitefinity.Configuration;

   using Telerik.Sitefinity.GenericContent.Model;

   using Telerik.Sitefinity.Modules.Pages;

   using Telerik.Sitefinity.Modules.Pages.Configuration;

   using Telerik.Sitefinity.Pages.Model;

   using Telerik.Sitefinity.Services;

   
   

4. Change the class definition to:
   

   
   

   public class TestimonialsModule : ModuleBase

   {

   }

   
   

5. Add the following properties:
   

   
   

   public static string ModuleName = "Testimonials";

   public static string UrlName = "Testimonials";

    

   public override Guid LandingPageId

   {

       get { return new Guid("D7CC19E4-BCE6-4D0F-97D0-C2B667DBBAA8"); }

   }

    

   public Guid CreatePageId

   {

       get { return new Guid("A58078E4-9CCA-43C4-BAC7-EAE0EFE0489A"); }

   }

    

   public Guid EditPageId

   {

       get { return new Guid("C1725944-EC74-4F05-8BA2-3DA5B57CE325"); }

   }

    

   public override Type[] Managers

   {

       get { return null; }

   }

   
   

6. Define the following helper method:
   

   
   

   private void CreatePage(PageManager pageManager, Guid pageID, Guid parentPageID, string UrlName, bool ShowInNavigation, string Title, PageControl control)

   {

       // get backend node

       var parentPage = pageManager.GetPageNode(parentPageID);

    

       // Create a node in the SiteMap for that page.

       var node = pageManager.CreatePageNode(pageID);

       pageManager.ChangeParent(node, parentPage);

       parentPage.Nodes.Add(node);

    

       // set page properties

       node.RenderAsLink = true;

       node.Title = Title;

       node.ShowInNavigation = ShowInNavigation;

       node.UrlName = UrlName;

    

       // Create a PageData object to hold the actual page contents

       var pageData = pageManager.CreatePageData();

       pageData.Template = pageManager.GetTemplate(SiteInitializer.DefaultBackendTemplateId);

       pageData.HtmlTitle = Title;

       pageData.Title = Title;

       pageData.Status = ContentLifecycleStatus.Live;

       pageData.Visible = true;

       pageData.Version = 1;

    

       // associate the node with the PageData object

       node.Page = pageData;

    

       // add admin control to the page

       if (control != null) pageData.Controls.Add(control);

   }

   
   

7. Implement the ModuleBase by pasting the following code:
   

   
   

   public override void Upgrade(SiteInitializer initializer, Version upgradeFrom) { }

    

   protected override ConfigSection GetModuleConfig() { return null; }

   
   

8. To install the backend pages and register the widgets in the toolbox, add the following method:
   

   public override void Install(SiteInitializer initializer)

   {

       #region Install Pages

        

       // get page manager

       var pageManager = initializer.PageManager;

    

       // create Module Landing Page if doesn't exist

       var landingPage = pageManager.GetPageNodes().SingleOrDefault(p => p.Id == this.LandingPageId);

       if (landingPage == null)

       {

           // create admin list view control and add to new landing page

           var ctrl = pageManager.CreateControl<PageControl>("~/Modules/Testimonials/Admin/TestimonialsAdminView.ascx", "Content");

           CreatePage(pageManager, LandingPageId, SiteInitializer.ModulesNodeId, TestimonialsModule.ModuleName, true, TestimonialsModule.ModuleName, ctrl);

       }

    

       // create testimonials "Create" Page if doesn't exist

       var createPage = pageManager.GetPageNodes().SingleOrDefault(p => p.Id == this.CreatePageId);

       if (createPage == null)

       {

           // create admin control, set properties

           var ctrl = pageManager.CreateControl<PageControl>("~/Modules/Testimonials/Admin/TestimonialsAddEditView.ascx", "Content");

           var prop = ctrl.Properties.FirstOrDefault(p => p.Name == "Mode");

           if (prop == null)

           {

               prop = new ControlProperty();

               prop.Id = Guid.NewGuid();

               prop.Name = "Mode";

               ctrl.Properties.Add(prop);

           }

    

           // set control to "Create" mode

           prop.Value = SitefinityWebApp.Modules.Testimonials.Admin.TestimonialsAddEditView.AdminControlMode.Create.ToString();

    

           // create backend page and add control

           CreatePage(pageManager, CreatePageId, LandingPageId, "Create", false, "Create Testimonial", ctrl);

       }

    

       // create testimonials "Edit" Page if doesn't exist

       var editPage = pageManager.GetPageNodes().SingleOrDefault(p => p.Id == this.EditPageId);

       if (editPage == null)

       {

           // create admin control, set properties

           var ctrl = pageManager.CreateControl<PageControl>("~/Modules/Testimonials/Admin/TestimonialsAddEditView.ascx", "Content");

           var prop = ctrl.Properties.FirstOrDefault(p => p.Name == "Mode");

           if (prop == null)

           {

               prop = new ControlProperty();

               prop.Id = Guid.NewGuid();

               prop.Name = "Mode";

               ctrl.Properties.Add(prop);

           }

    

           // set control to "Create" mode

           prop.Value = SitefinityWebApp.Modules.Testimonials.Admin.TestimonialsAddEditView.AdminControlMode.Edit.ToString();

    

           // create backend page and add control

           CreatePage(pageManager, EditPageId, LandingPageId, "Edit", false, "Edit Testimonial", ctrl);

       }

    

       #endregion

    

       #region Register Toolbox Widget

    

       string toolboxName = "PageControls";

       string sectionName = "Samples";

       var config = initializer.Context.GetConfig<ToolboxesConfig>();

    

       var controls = config.Toolboxes[toolboxName];

       var section = controls.Sections.Where<ToolboxSection>(e => e.Name == sectionName).FirstOrDefault();

    

       if (section == null)

       {

           section = new ToolboxSection(controls.Sections)

           {

               Name = sectionName,

               Title = sectionName,

               Description = sectionName,

               ResourceClassId = typeof(PageResources).Name

           };

           controls.Sections.Add(section);

       }

    

       // Add TestimonialsView Widget if doesn't exist

       if (!section.Tools.Any<ToolboxItem>(e => e.Name == TestimonialsView.ViewName))

       {

           var tool = new ToolboxItem(section.Tools)

           {

               Name = TestimonialsView.ViewName,

               Title = "TestimonialsView",

               Description = "Public control for the Testimonials module",

               ControlType = "~/Modules/Testimonials/TestimonialsView.ascx",

               CssClass = "sfTestimonialsWidget"

           };

           section.Tools.Add(tool);

       }

    

       // Add SubmitTestimonial Widget if doesn't exist

       if (!section.Tools.Any<ToolboxItem>(e => e.Name == SubmitTestimonial.ViewName))

       {

           var tool = new ToolboxItem(section.Tools)

           {

               Name = SubmitTestimonial.ViewName,

               Title = "SubmitTestimonial",

               Description = "Public control for submitting Testimonial",

               ControlType = "~/Modules/Testimonials/SubmitTestimonial.ascx",

               CssClass = "sfTestimonialsWidget"

           };

           section.Tools.Add(tool);

       }

        

       #endregion

   }

   
   

In the code above, the TestimonialsModule class inherits from the ModuleBase class. The Install method creates data tables, installs pages, and registers the widgets in the toolbox.