Adding How-to Videos and Guidelines for content editors in Umbraco

Adding How-to Videos and Guidelines for content editors in Umbraco

While doing some work for a Charity in Australia, the client made a request to have some how-to videos displayed within the CMS.
The client had some advanced editors who were willing to record the videos and write down the guidelines.
Now they needed a way it could be displayed on the Umbraco back-office and updated by those advanced editors in the future.

This is the solution I came up with.

  • Create a Google Slides presentation with the guidelines and how-to videos. This Google Slides presentation can be later edited by anyone who has access to it.
    (PS: I tried Google Docs, but it didn't support video embedding)
  • Use File » Publish to the web » Embed option and copy the Embed code from there.

For a tab on the dashboard of the content section

  1. Create a new "Editor Help" tab within the Content Area using the instructions from here: https://our.umbraco.org/documentation/extending/dashboards/
  2. Here's my code sample for adding into ~/config/Dashboard.config:
    <section alias="StartupHelpSection">
    <areas>
        <area>content</area>
        <area>default</area>
    </areas>
    <tab caption="Editor Help">
        <control>
            ~/App_Plugins/Spire.Custom/views/helpdashboardintro.html
        </control>
    </tab>
    </section>
    
  3. Create a view with the Embed code in it.
    Code sample:

    <div class="umb-dashboard-grid">
    <div style="max-width: 1200px">
        <h3><strong>How-to videos & Guidelines</strong></h3>
        <p style="font-size: 16px; line-height: 1.5; margin-bottom: 30px; max-width: 760px;">
            <span>Here's some information to get you started.</span>
        </p>
    
        <div class="row">
            <iframe src="https://docs.google.com/presentation/d/13hdjSb-LNJBwcSqXY-NUZgKgexS4ZcfHsu6F9Gguqcs/embed?start=false&loop=false&delayms=3000" frameborder="0" width="960" height="569" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe>
        </div>
    </div> 
    </div>
    

For a tab on given document types:

  1. Install the "Inline Html Help Label" (ProWorksInlineHtmlHelpLabel) package from here: https://our.umbraco.org/projects/backoffice-extensions/inline-html-help-label
  2. Add another tab to the document type and name it as "Editor Help"
  3. Add a property named Help with an "HTML Inline Help Label" editors
  4. In the HTML to display, add some HTML with the Embed code in it:
    See my code snippet below:
    <h3><strong>How-to videos & Guidelines</strong></h3>
    <p><span>Here's some information to get you started.</span></p>
    <iframe src="https://docs.google.com/presentation/d/1R-PTnDRf0mzsSbAyQVbkDrYRP9cjmW4Z6nhxe3Grl2I/embed?start=false&loop=false&delayms=3000" frameborder="0" width="960" height="569" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe>
    

That's all there is for the setup from a developer's perspective. Now an editor who has access to the Google Slides presentation could update it anytime and it will appear within the CMS back-office with no further intervention from the developer.

See a walkthrough video of how it was all put together.

This concept could be used with other CMS back-offices as well. Give it a try and leave me a comment.


This article was originally written on Google's Blogger platform and ported to Hashnode on 17 Sep 2022.