[TIP] Instructions for using Edit Config for adding Widgets

[poke0]

I struggled with adding the SABnzbd last night but finally figured it out and thought I would document my process in case you wanted to share it with the community. I'm sure you developer types have easier ways to manage your configs but us mere mortals have to do it the hard way (I'm not complaining, I'm actually really grateful I was able to do this at all). I hope you find this contribution helpful.
-David

Instructions for using Edit Config for adding Widgets

1. Go to Config -> Update Configuration -> Edit Config
   
   

2. Expand the section you want to add the widget(s) to ("Testing Widgets" in this case); if you want to use a new section add that via the GUI first
   

3. Click on the Edit button for the section’s name and select Insert -> Array; You will see 2 new rows were added: “field” in a box with “[0]” next to it and “(empty array)”
   

4. Type “widgets” into the newly created field
   

5. Click on the Edit button for the newly created “empty object” and select Append -> Object; You will see 1 new row added with "(empty array)".
   

6. Click on the Edit button for the newly created “empty object” and select Append -> Auto; See new row with field box and value box.
   

7. Enter “type” into the field box and enter the name of the widget into the value box.
   

8. Click on the Edit button for the “type” row and select either Append -> Object (for value fields required by the widget) or Append -> Auto (for boolean fields required by the widget)

9. Don't forget to hit the Save Changes button and then the Save to Disk button (or whatever save mechanism you prefer) so you don't lose your work.

• You can add additional widgets by repeating steps 5-8.

• You can add an additional widget block by repeating steps 3-8.

• 
You can drag the widget and items (buttons) around into water order you want.

• You can drag the name row above the widget row for neatness
  

[Lissy93]

Thanks @poke0 for the nice guide :)
I'm gonna transfer it to the discussions section....

Just to add, a much easier way of editing config, is to work with your config file directly.
Using a tool like Code-Server, makes this even easier.

---

Or, using the UI JSON editor, you can also switch to code mode, and quickly copy/pasta stuff in.
YAML and JSON follow the same structure, if you're not so familiar you can just use this tool to convert between the two.

[poke0]

I considered Code-Server but it looked too much like a project that I had to figure out before I could play with the widget. I did try directly editing in code view but I failed miserably. The only challenge with the Edit Config view was understanding the required relationships between the Autos, Arrays, Objects, and Strings. Once I got that to work once it was easy sailing, but getting that to work the first time was very frustrating. Thanks to the pointer to YAML <--> JSON, if I knew about that previously it probably would have changed my approach. :)