We have moved!

You are currently looking at documentation for Umbraco 8 and older versions.
An automated guess is that docs.umbraco.com/umbraco-cms/tutorials/creating-a-property-editor/part-3 could be the link to the new documentation for Umbraco 9 and newer versions.

    Integrating services with a property editor

    Overview

    This is step 3 in the property editor tutorial. In this part, we will integrate one of the built-in Umbraco services. For this sample, we will use the editorService to hook into a Media picker and return image data to the markdown editor.

    Injecting the service

    First up, we need to get access to the service. This is done in the constructor of the controller, where we add it as a parameter:

    angular.module("umbraco")
    .controller("My.MarkdownEditorController",
    // inject Umbraco's assetsService and editor service
    function ($scope, assetsService, $timeout, editorService) { ... }

    This works the same way as with the assetsService we added in step 1.

    Hooking into pagedown

    The markdown editor we are using has a nice event system in place, so we can hook into the events triggered by the media chooser, by adding a hook, after the editor has started:

    // Start the editor
var converter2 = new Markdown.Converter();
var editor2 = new Markdown.Editor(converter2, "-" + $scope.model.alias);
editor2.run();

// subscribe to the image dialog clicks
editor2.hooks.set("insertImageDialog", function (callback) {
        // here we can intercept our own dialog handling

        return true; // tell the editor that we'll take care of getting the image url
    });
});

    Notice the callback, this callback is used to return whatever data we want to the editor.

    So now that we have access to the editor events, we will trigger a media picker dialog, by using the editorService. We can inject whatever HTML we want with this service, but it also has a number of shorthands for things like a media picker. So at this point your controller should look like this:

    angular.module("umbraco")
    .controller("My.MarkdownEditorController",
        // inject umbracos assetsService
        function ($scope, assetsService, $timeout, editorService) {

            if ($scope.model.value === null || $scope.model.value === "") {
                $scope.model.value = $scope.model.config.defaultValue;
            }

            // tell the assetsService to load the markdown.editor libs from the markdown editors
            // plugin folder
            assetsService
                .load([
                    "~/App_Plugins/MarkDownEditor/lib/markdown.converter.js",
                    "~/App_Plugins/MarkDownEditor/lib/markdown.sanitizer.js",
                    "~/App_Plugins/MarkDownEditor/lib/markdown.editor.js"
                ])
                .then(function () {
                    // this function will execute when all dependencies have loaded
                    $timeout(function () {
                        var converter2 = new Markdown.Converter();
                        var editor2 = new Markdown.Editor(converter2, "-" + $scope.model.alias);
                        editor2.run();

                        // subscribe to the image dialog clicks
                        editor2.hooks.set("insertImageDialog", function (callback) {
                            // here we can intercept our own dialog handling
                            var mediaPicker = {
                                disableFolderSelect: true,
                                submit: function (model) {
                                    var selectedImagePath = model.selection[0].image;
                                    callback(selectedImagePath);
                                    editorService.close();
                                },
                                close: function () {
                                    editorService.close();
                                }
                            };
                            editorService.mediaPicker(mediaPicker);

                            return true; // tell the editor that we'll take care of getting the image url
                        });
                    });
                });

            // load the separate css for the editor to avoid it blocking our JavaScript loading
            assetsService.loadCss("~/App_Plugins/MarkDownEditor/lib/markdown.editor.less");
        });

    Now when we run the markdown editor and click the image button, we are presented with a native Umbraco dialog, listing the standard media archive.

    Clicking an image and choosing select returns the image to the editor which then renders it as:

    ![Koala picture][1]

[1]: /media/1005/Koala.jpg

    The above is correct markdown code, representing the image, and if preview is turned on, you will see the image below the editor. If you wish to render your markdown in a view, you first need to convert you markdown to html format:

    @using HeyRed.MarkdownSharp
@inherits Umbraco.Web.Mvc.UmbracoViewPage<IPublishedContent>
@{
    var value = Model.Value<string>("myMarkdownPropertyAlias");
    var html = new Markdown().Transform(value);
}
@Html.Raw(html)

    Umbraco's built-in Markdown editor will be interpreted by Models Builder, in which case you won't need to do the convertion mentioned above.

    Wrap up

    So over the 3 previous steps, we've:

    • Created a plugin
    • Defined an editor
    • Injected our own JavaScript libraries and 3rd party ones
    • Made the editor configurable
    • Connected the editor with native dialogs and services
    • Looked at koala pictures
    • Converted and rendered our markdown as html format

    Next - Adding server-side data to a property editor