Create custom tree/workspace in setting - lack of ...
# help-with-umbraco
l
I'm updating my Umbraco 13 package(s) to Umbraco 15 and I'm really struggling with the lack of documentation (or I don't know where to look). I want to achieve this; a custom tree in the settings section: In Umbraco 13 I simply had a TreeController and that worked. I assume I need this documentation: https://docs.umbraco.com/umbraco-cms/customizing/extending-overview/extension-types/tree, but this raises so many questions: * How do I get the tree to appear in the settings section * What are tree 'kinds' and whats the difference between entity and fileSystem? * What are entityTypes? * What do I supply to forEntityTypes? * How do I wire my elements to the tree items? * So what's the relation with trees compared to menu's? (https://docs.umbraco.com/umbraco-cms/customizing/extending-overview/extension-types/menu) * Are there any conditions? And if so, what are they? * How would I set the icons? So do I need a tree or a menu (or both?) https://cdn.discordapp.com/attachments/1342478017930334250/1342478018123399219/image.png?ex=67b9c795&is=67b87615&hm=468614cb49ae9e6050ee791c3edf0c85a9434b012bc21ecc97684eef7c8f4320&
d
I had these same questions, and, funny enough, came to the same conclusion: look at uSync's Github!
k
uSync tree is actually a little over complicated, because we've written it.to allow for other things (uSync.Complete) to expand and have their own custom bits underneath it, so typically you don't need to have the custom menu element to add a single icon to the side, (e.g the manifest will do it all)
l
Good to know. I was about to strip it (a lot). Currently I only have one menu item, so that might be easier. It's just so hard to get the syntax right and to know what is needed and isn't needed.
h
This is my manifest that adds an item to the settings
Copy code
{
  "$schema": "../umbraco-package-schema.json",
  "name": "SettingsApp",
  "id": "SettingsApp",
  "version": "0.1.0",
  "allowTelemetry": true,
  "extensions": [
    {
      "type": "menu",
      "alias": "Polls.Menu",
      "name": "Polls Menu"
    },
    {
      "type": "menuItem",
      "alias": "Polls.MenuItem",
      "name": "Polls Menu Item",
      "meta": {
        "label": "All Polls",
        "entityType": "polls-workspace",
        "menus": [
          "Polls.Menu"
        ]
      }
    }
  ]
}
polls-workspace in my workspace that opens when you select the meu-item
l
Seriously, the documentation on how to extend Umbraco is an utter mess. I'm now creating a workspace, but this is the only documentation on a workspace: https://docs.umbraco.com/umbraco-cms/customizing/workspaces. No way this is even remotely enough for understanding how to use it. If it wasn't for the blogs of Kevin Jump, I would have never figured it out. Even though some things are already outdated, I've learned more from Kevin's blogs than the documentation of Umbraco. Seriously, am I missing documentation on another locations or is this it? I haven't been as critical of Umbraco 15 as some of you, because I have at least the feeling the changes were tought through (even though some features are still missing). But the lack of documentation on such a complex backoffice is just ridiculous.
28 Views