Wrapped Editible Content Block Control? - Front- & Back-End Development - Front- & Back-End Development - Progress Community
 Front- & Back-End Development

Wrapped Editible Content Block Control?

  • Wrapped Editible Content Block Control?
  • We have a number of controls we've developed for our 3.7 site which are wrapped generic content controls. I can't figure out how to do this with Sitefinity 4.0. I had thought that I would put a ContentBlock control in the usercontrol's ascx page, but I don't know what to do with the code behind. In 3.7, we implemented the IGenericContent interface, and decorated the following property:

    /// <summary>
    /// The Wizzy-based content in the body of the pod.
    /// </summary>
    [WebEditor("Telerik.Cms.Engine.WebControls.HtmlContentEditor, Telerik.Cms.Engine")]
    public object Content
            return bodyContent.Content;
            bodyContent.Content = value.ToString();

    How would I do this with Sitefinity 4.0? Id there a completely different way?


    Michael Snyder
  • Hi ,

    The implementation you have now is not correct if we are talking for Sitefinity 3.7 edition. The way that the control should be wrapped there is shown here . The easiest way to achieve your goal in SF 4.0 is adding
    HtmlField control inside the control template. The HtmlField wraps the RadEditor that you see when you open ContentBlock control

    <%@ Control Language="C#" %>
    <%@ Register Assembly="Telerik.Sitefinity" Namespace="Telerik.Sitefinity.Web.UI" TagPrefix="sf" %>
    <%@ Register Assembly="Telerik.Sitefinity" Namespace="Telerik.Sitefinity.Web.UI.Fields" TagPrefix="sf" %>
    <sf:ResourceLinks id="resourcesLinks" runat="server">
        <sf:ResourceFile Name="Styles/Window.css" />
    <sf:FormManager ID="formManager" runat="server" />
    <div style="width: 660px; overflow: hidden;">
    <script type="text/javascript">

    Note that this solution requires to create custom control and designer for it. Please take a look at How to create a widget

    Best wishes,
    Ivan Dimitrov
    the Telerik team
  • Does anyone out there have a custom widget example that wraps a content block with a designer template?  I've tried following the news widget example but really get nowhere.

    Thanks in advance for any help!

  • You mean front-end wrapper to style it like this?

    Shouldn't be needed in 4.0 as it's wrapped in .sfContentBlock by default

    <div class="sfContentBlock">

    ...assuming thats what you meant anyway
  • Hey Steve,

    Thanks for the reply.  Let me try & explain it this way....

    In Sitefinity 3.7, sometimes our design would call for some copy content that for instance had some border wrapped around it.  From a code stand point, I would never know where that border was needed, so I would create a control that wrapped around a generic content control, which made it easier for the end user to just drop the control in & start entering content.

    If I remember correctly, in 4.0 I can assign a custom class around the content block, but that would require end users to remember to do that everytime they needed this custom border or whatever the design calls for.  It also would require them to remember what the custom class name is.

    So, I simply thought if I could wrap a content block in one of my custom controls, it would make life easier on the end user.  Ultimately, I would like to learn how to wrap a image control & a content block control in my own custom control, but I just struggled trying to get the designer template working on the backend, & understanding what is needed to get the content to show up on the frontend.

    Thanks again Steve for your time!

  • If I read this right....IMO in 4.0 ....your "wrapper" is a custom layout control :)

    So user drops in the layout control which contains your styling...then they can put GC widgets into there

    More flexible, less code :)
  • 255669_ScreenShot.JPG
    Yeah, your totally right with using the layout, that has saved me a ton of time. 

    Maybe I'm missing something here.  If you take a look at the screenshot below, there is a PDF icon with some text to the right of it.  Wrapped around that is some border.  If the user simply drops a content block in the layout, I don't see a way how I would know to apply border & when not to apply border. 

    With a custom widget, everytime they dropped that on the page, I would know to apply border to that content block, without the user having to take extra steps to apply a custom class to the content block.

    Maybe there is a different way of going about it that I'm not seeing?
  • You want to make a Custom Layout control as the wrapper, so it'd just be a single 100% layout (which could contain more if the user so chooses right).  So there'd be a new layout control in the list called (I dont know) SitePDFBox, and they use that...this means you never have to hard code "areas" into your masterpage (more flexible)

    And in the markup for THAT custom layout you wrap it in your class so you know that's your special callout box :)

    Looks like they re-did or are re-doing the documentation so for the life of me I can't find the code on creating custom layouts, however I did make a bunch so if you're not sure I'll post the code here directly (let me know)
  • Yeah, after I replied to your last post, it clicked that maybe creating a custom layout control was the way to go.  I started looking for some documentation on that too, haven't found any yet.

    I you could post an example, that would be great.

    Thanks again for your time today Steve.

  • Here ya go...

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;
    using Telerik.Sitefinity.Web.UI;
    using Telerik.Web.UI;
    using System.Web.UI;
    using System.Diagnostics;
    using System.Web.UI.WebControls;
    using System.Configuration;
    using System.ComponentModel;
    using Telerik.Sitefinity.Configuration;
    using Telerik.Sitefinity.Modules.Pages.Configuration;
    using Telerik.Sitefinity.Web.UI;
    namespace RandomSiteControls.Layouts
        public class SimpleWrapperLayout : LayoutControl
            protected override void CreateChildControls()
            public override string AssemblyInfo
                    return GetType().ToString();
                    base.AssemblyInfo = value;
            #region TEMPLATE
            public override string Layout
                    return this.CustomTempalate;
            public string CustomTempalate = "RandomSiteControls.Layouts.Views.SimpleWrapperLayout.ascx";

    <%@ Control Language="C#" %>
    <%@ Register TagPrefix="telerik" Namespace="Telerik.Web.UI" Assembly="Telerik.Web.UI" %>
    <%@ Register Assembly="Telerik.Sitefinity" Namespace="Telerik.Sitefinity.Web.UI" TagPrefix="sitefinity" %>
    <div class="layoutWrapper">
        <div id="Div1" runat="server" class="sf_cols">
            <div id="Div2" runat="server" class="sf_colsOut sf_1cols_1_100">
                <div id="Div3" runat="server" class="sf_colsIn sf_1cols_1in_100">

    So "layoutWrapper" is where you put in your custom class, and you can put any number of divs\wrappers on this dude...I LOVE LAYOUTS :)
  • Sweet!  Thanks for the example Steve.  I'll give this a try.
  • Hi Brian,

    I wrapped the content block to put some extra divs and markup, to always put a rounded border around a content block. I achieved this by creating a control that inherits the content block and creating a new template putting my divs around <asp:Literal ID="contentHtml" runat="server"></asp:Literal>

    using System.Text;
    using Telerik.Sitefinity.Modules.GenericContent.Web.UI;
    using Telerik.Sitefinity.Web.UI.ControlDesign;
    using Telerik.Sitefinity.Web.UI.Fields;
    namespace Widgets
        /// <summary>
        /// Rounded version of the ContentBlock
        /// </summary>
        class ContentBlockRounded : ContentBlock
            /// <summary>
            /// Gets the name of the embedded layout template.
            /// </summary>
            /// <value></value>
            /// <remarks>
            /// Override this property to change the embedded template to be used with the dialog
            /// </remarks>
            protected override string LayoutTemplateName
                    return layoutTemplateName;
            private const string layoutTemplateName = "Widgets.Resources.Views.ContentBlockRounded.ascx";


    <%@ Control Language="C#" %>
    <%@ Register TagPrefix="sf" Namespace="Telerik.Sitefinity.Web.UI.PublicControls.BrowseAndEdit" Assembly="Telerik.Sitefinity" %>
    <%@ Register Assembly="Telerik.Sitefinity" Namespace="Telerik.Sitefinity.Web.UI.PublicControls" TagPrefix="sitefinity" %>
    <div class="rounded_colhead">
      <div class="tl"></div><div class="tr"></div>
    <asp:Literal ID="contentHtml" runat="server"></asp:Literal>
     <div class="bl"></div><div class="br"></div>
    <sf:BrowseAndEditToolbar ID="browseAndEditToolbar" runat="server" Mode="Edit"></sf:BrowseAndEditToolbar>
    <sitefinity:JavaScriptEmbedControl runat="server" ID="jQyeryLink" ScriptEmbedPosition="Head" ScriptType="jQuery"></sitefinity:JavaScriptEmbedControl>

  • 258842_3-24-2011-3-46-58-PM.png
    This is getting way too complicated...  following the instructions here: www.sitefinity.com/.../how-to-create-a-widget.aspx  for which is even more complicated than I need...

    I can do a simple control with an input text box for say a Title.  But I need input for the content. Like Brian, I have a simple 'template" that has a title and then content.  See attached image. It is the getting the content like a Rad Editor that is the problem.  I was able to do this the very old way using  IGenericContent.    Now I have to do the same thing for a new client in 4.0..  I don't have VS 10 and we don't have the Sitefinity Project Manager.  I tried to follow the How to Create a Widget and I got it to work with a title only, as a User Control.  When I went on to creating it as a Custom Control and then had to write the JQuery I got lost and frustrated.     how can I take the basic user control from the 4.0 KB and add it so that the user can input text, graphics, etc.?

    Thank you for any guidance.
  • 258851_Register-Screenshot.JPG


    Here is what you will need to do to get this working:

    Create a directory in the root of the site named controls.  Inside that new controls directory, create a directory named JoinEditor.  Inside the Join Editor folder should be two files seen below.


    01.using System;
    02.using System.Collections.Generic;
    03.using System.Linq;
    04.using System.Web;
    05.using Telerik.Sitefinity.Modules.GenericContent.Web.UI;
    06.using Telerik.Sitefinity.Web.UI.ControlDesign;
    07.using Telerik.Sitefinity.Web.UI.Fields;
    09.namespace SitefinityWebApp.controls.JoinEditor
    11.    public class JoinEditor : ContentBlock
    13.        protected override string LayoutTemplateName
    15.            get
    17.                return layoutTemplateName;
    21.        private const string layoutTemplateName = "SitefinityWebApp.controls.JoinEditor.JoinEditor.ascx";

    01.<%@ Control Language="C#" %>
    02.<%@ Register TagPrefix="sf" Namespace="Telerik.Sitefinity.Web.UI.PublicControls.BrowseAndEdit" Assembly="Telerik.Sitefinity" %>
    03.<%@ Register Assembly="Telerik.Sitefinity" Namespace="Telerik.Sitefinity.Web.UI.PublicControls" TagPrefix="sitefinity" %>
    05.<div id="ContentWrapper">
    06.    <asp:Literal ID="contentHtml" runat="server"></asp:Literal>
    09.<sf:BrowseAndEditToolbar ID="browseAndEditToolbar" runat="server" Mode="Edit"></sf:BrowseAndEditToolbar>
    10.<sitefinity:JavaScriptEmbedControl runat="server" ID="jQyeryLink" ScriptEmbedPosition="Head" ScriptType="jQuery"></sitefinity:JavaScriptEmbedControl>

    You will then need to rebuild the project which I'm sure you need VS 2010 for (might be other ways, I'm not 100% sure).

    After that, register the control in Sitefinity under Admin -> Advanced -> Toolboxes -> Toolboxes -> PageControls -> Sections.

    Attached is how it should be registered..