Skip to main content

Customising Umbraco's Default Grid Editors


  1. Create a new directory in App_Plugins called anything you like.  This will be your "package" directory
  2. Copy the web.config file that's inside the main "Views" directory (not your project's main web.config!) into your package directory.  This is needed for MVC to work properly
  3. Create a package.manifest file and put this in it (come back and modify these properties as necessary):

    {
     "gridEditors":
     [{
      "name": "Speaker Portrait",
      "alias": "speakerPortrait",
      "view": "media",
      "render": "/app_plugins/yourpackagedir/MediaMarkup.cshtml",
      "icon": "icon-picture",
      "config":
      {
       "style": "height:270px; width:187px",
       "markup": ""<a class='image featured'>#value#</a>""
      }
     }]
    }
    
  4. Find the .cshtml file for the editor you're modifying in \Views\Partials\Grid\Editors and copy it into your package directory
  5. Edit that to add the functionality you want, I added "markup" to the media editor like so:

    @model dynamic
    @using Umbraco.Web.Templates
    
    @if (Model.value != null)
    {
        var url = Model.value.image;
        if(Model.editor.config != null && Model.editor.config.size != null){
            url += "?width=" + Model.editor.config.size.width;
            url += "&height=" + Model.editor.config.size.height;
    
            if(Model.value.focalPoint != null){
                url += "&center=" + Model.value.focalPoint.top +"," + Model.value.focalPoint.left;
                url += "&mode=crop";
            }
        }
    
        var element = $"<img src=\"{url}\" alt=\"{Model.value.altText}\">";
        string markup = Model.editor.config.markup.ToString();
    
        if (!markup.Contains("#value#"))
        {
            throw new Exception("Error: markup not configured correctly");
        }
    
        markup = markup.Replace("#value#", element);
        @Html.Raw(markup);
    
        if (Model.value.caption != null)
        {
            <p class="caption">@Model.value.caption</p>
        }
    }
    

Comments

Popular posts from this blog

Using Log4Net to use both event log and a rolling log file

Here's the config section, note that the applicationNameproperty in the EventLogAppender needs to be the same as the event source in the windows event log that you want to log to.  If the event source doesn't exist, that appender won't work.  In this particular project I create that during install using WiX (which is covered in another post)

  <log4netdebug="true">
    <appendername="RollingLogFileAppender"type="log4net.Appender.RollingFileAppender">      <filevalue="log.txt" />      <datePatternvalue="dd-MM-yyyy" />      <appendToFilevalue="true" />      <locationinfovalue="false" />      <rollingStylevalue="Size" />      <maximumFileSizevalue="1MB" />      <maxSizeRollBackupsvalue="10" />      <staticLogFileNamevalue="true" />      <layouttype="log4net.Layout.PatternLayout">        <conv…

Using WiX to create an event source during install of a .NET framework project

Edit: so I guess I wasn't the only one confused with this stuff, as it's been my most popular post by far!  If I've helped you out or saved you some time, please let me know in the comments :)

In order for this to work, you have to add references to WixUtilExtension and WixNetFxExtension to your WiX project.  Once that's done, add this inside a <Component> element:

<Util:EventSourcexmlns:Util="http://schemas.microsoft.com/wix/UtilExtension"Name="EVENTSOURCEGOESHERE"Log="Application"EventMessageFile="[NETFRAMEWORK40FULLINSTALLROOTDIR]EventLogMessages.dll" />
Obviously replace EVENTSOURCEGOESHERE with your event source name.  NETFRAMEWORK40FULLINSTALLROOTDIR is a property set by the WixNetFxExtension which stores the path to the .NET framework v4 directory, but you can replace this with the corresponding property for the directory containing the relevant EventLogMessages.dll file.  So if you're using the .NET framewo…

Umbraco Deployment Checklist

This is primarily aimed at deploying from Visual Studio to an Azure Web App + Azure SQL database, feel free to skip bits that aren't relevant if you're doing other things.

Prerequisites for developing locally:
Visual Studio (obviously)
Ensure IIS URL Rewrite module is installed using web platform installer (other downloads from MS documentation don't seem to work)

Set up Azure:
Make a new SQL Database in Azure, take note of the server name, database name, admin login and admin password.  If you already have a server and resource group, automate with Powershell as shown below (you'll need to replace the param values):
New-AzureRmSqlDatabase -DatabaseName "UmbracoDatabase" -ServerName "TheServer" -ResourceGroupName "Whatever" -Edition "Basic"
Add your IP to the Azure SQL db firewall so Umbraco can connect to it later when running locally
Create a new Azure web app, either manually or via Powershell:
New-AzureRmWebApp -ResourceGroupName…