doc: Update README

Author: jcdcdev

.github/README.md

@@ -1,22 +1,23 @@
-# Umbraco.Community.SimpleTrees
-
-[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/Umbraco.Community.SimpleTrees)
-[![License](https://img.shields.io/github/license/jcdcdev/Umbraco.Community.SimpleTrees?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees?tab=MIT-1-ov-file)
-[![NuGet Downloads](https://img.shields.io/nuget/dt/Umbraco.Community.SimpleTrees?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/Umbraco.Community.SimpleTrees)
-[![Project Website](https://img.shields.io/badge/Project%20Website-jcdc.dev-jcdcdev?style=flat&color=3c4834&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIGNsYXNzPSJiaSBiaS1wYy1kaXNwbGF5IiB2aWV3Qm94PSIwIDAgMTYgMTYiPgogIDxwYXRoIGQ9Ik04IDFhMSAxIDAgMCAxIDEtMWg2YTEgMSAwIDAgMSAxIDF2MTRhMSAxIDAgMCAxLTEgMUg5YTEgMSAwIDAgMS0xLTF6bTEgMTMuNWEuNS41IDAgMSAwIDEgMCAuNS41IDAgMCAwLTEgMG0yIDBhLjUuNSAwIDEgMCAxIDAgLjUuNSAwIDAgMC0xIDBNOS41IDFhLjUuNSAwIDAgMCAwIDFoNWEuNS41IDAgMCAwIDAtMXpNOSAzLjVhLjUuNSAwIDAgMCAuNS41aDVhLjUuNSAwIDAgMCAwLTFoLTVhLjUuNSAwIDAgMC0uNS41TTEuNSAyQTEuNSAxLjUgMCAwIDAgMCAzLjV2N0ExLjUgMS41IDAgMCAwIDEuNSAxMkg2djJoLS41YS41LjUgMCAwIDAgMCAxSDd2LTRIMS41YS41LjUgMCAwIDEtLjUtLjV2LTdhLjUuNSAwIDAgMSAuNS0uNUg3VjJ6Ii8+Cjwvc3ZnPg==)](https://jcdc.dev/umbraco-packages/simple-trees)
-
-
+# Umbraco.Community.SimpleTrees
+
+[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/Umbraco.Community.SimpleTrees)
+[![License](https://img.shields.io/github/license/jcdcdev/Umbraco.Community.SimpleTrees?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees?tab=MIT-1-ov-file)
+[![NuGet Downloads](https://img.shields.io/nuget/dt/Umbraco.Community.SimpleTrees?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/Umbraco.Community.SimpleTrees)
+[![Project Website](https://img.shields.io/badge/Project%20Website-jcdc.dev-jcdcdev?style=flat&color=3c4834&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIGNsYXNzPSJiaSBiaS1wYy1kaXNwbGF5IiB2aWV3Qm94PSIwIDAgMTYgMTYiPgogIDxwYXRoIGQ9Ik04IDFhMSAxIDAgMCAxIDEtMWg2YTEgMSAwIDAgMSAxIDF2MTRhMSAxIDAgMCAxLTEgMUg5YTEgMSAwIDAgMS0xLTF6bTEgMTMuNWEuNS41IDAgMSAwIDEgMCAuNS41IDAgMCAwLTEgMG0yIDBhLjUuNSAwIDEgMCAxIDAgLjUuNSAwIDAgMC0xIDBNOS41IDFhLjUuNSAwIDAgMCAwIDFoNWEuNS41IDAgMCAwIDAtMXpNOSAzLjVhLjUuNSAwIDAgMCAuNS41aDVhLjUuNSAwIDAgMCAwLTFoLTVhLjUuNSAwIDAgMC0uNS41TTEuNSAyQTEuNSAxLjUgMCAwIDAgMCAzLjV2N0ExLjUgMS41IDAgMCAwIDEuNSAxMkg2djJoLS41YS41LjUgMCAwIDAgMCAxSDd2LTRIMS41YS41LjUgMCAwIDEtLjUtLjV2LTdhLjUuNSAwIDAgMSAuNS0uNUg3VjJ6Ii8+Cjwvc3ZnPg==)](https://jcdc.dev/umbraco-packages/simple-trees)
+
+
 This packages aims to help developers quickly put together Umbraco Trees using C#.
 
 ## Features
 
 - C# custom tree creation
 - No javascript or umbraco-package.json files required
 - Supports both Views & View Components
-- Easy to define section permissions
-
-## Quick Start
-
+- Easy to define section permissions
+- ✨ Custom Entity Actions!
+
+## Quick Start
+
 ### Install Package
 
 ```csharp
@@ -29,7 +30,7 @@ By default, this will display in the content section.
 
 ```csharp title="ExampleTree.cs"
 using Umbraco.Cms.Core.Models;
-using Umbraco.Community.SimpleTrees.Models;
+using Umbraco.Community.SimpleTrees.Core.Models;
 
 namespace Umbraco.Community.SimpleTrees.TestSite.Trees;
 
@@ -78,17 +79,101 @@ public class MyTree : SimpleTree
 		</table>
 	</div>
 </uui-box>
-```
-
-
-
-## Contributing
-
-Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/contribute) page.
-
-## Acknowledgements (Thanks)
-
-- LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
-
-
+```
+
+
+## Extending
+
+### Entity Actions
+
+It is possible to implement two Entity Actions
+
+#### Url Actions
+
+When clicked, the user will be taken to the specific URL.
+
+```csharp title="NuGetPackageItemEntityUrlAction.cs"
+using Umbraco.Community.SimpleTrees.Core.Models;
+
+namespace Umbraco.Community.SimpleTrees.TestSite.Trees;
+
+public class NuGetPackageItemEntityUrlAction : SimpleEntityUrlAction
+{
+    public override string Icon => "icon-link";
+    public override string Name => "Go to Package";
+    public override Type[] ForTreeItems => [typeof(NuGetPackageTree)];
+    public override Type[] ForSimpleEntityTypes => [typeof(NuGetPackageVersionEntityType)];
+
+    public override Task<Uri> GetUrlAsync(string unique, string entityType)
+    {
+        var uri = new Uri("https://www.nuget.org/packages/" + unique);
+        return Task.FromResult(uri);
+    }
+}
+```
+
+#### Execute Actions
+
+When clicked, you custom logic will be executed. You can also return a helpful response to the user.
+
+```csharp title="NuGetPackageItemEntityExecuteAction"
+using System.Net.Http.Headers;
+using Umbraco.Community.SimpleTrees.Core.Models;
+using Umbraco.Community.SimpleTrees.Web.Models;
+
+namespace Umbraco.Community.SimpleTrees.TestSite.Trees;
+
+public class NuGetPackageItemEntityExecuteAction : SimpleEntityExecuteAction
+{
+    private readonly HttpClient _client;
+
+    public NuGetPackageItemEntityExecuteAction(HttpClient client)
+    {
+        var url = "https://functions.marketplace.umbraco.com/api/";
+        client.BaseAddress = new Uri(url);
+        client.DefaultRequestHeaders.UserAgent.Add(new ProductInfoHeaderValue("Umbraco.Community.SimpleTrees.TestSite", "1.0"));
+        _client = client;
+    }
+
+    public override string Icon => "icon-refresh";
+    public override string Name => "Sync Package";
+    public override Type[] ForTreeItems => [typeof(NuGetPackageTree)];
+
+    public override async Task<SimpleEntityActionExecuteResponse> ExecuteAsync(string unique, string entityType)
+    {
+        try
+        {
+            var split = unique.Split('_');
+            var packageId = split[0];
+            var model = new MarketplaceRequest
+            {
+                PackageId = packageId,
+            };
+
+            var result = await _client.PostAsJsonAsync("InitiateSinglePackageSyncFunction", model);
+            if (!result.IsSuccessStatusCode)
+            {
+                return SimpleEntityActionExecuteResponse.Error("Failed to initiate package update", $"Status Code: {result.StatusCode}, Reason: {result.ReasonPhrase}");
+            }
+
+            var message = $"Package {packageId} update has been initiated. You can check the progress in the Umbraco Marketplace.";
+            return SimpleEntityActionExecuteResponse.Success("Package update initiated successfully", message);
+        }
+        catch (Exception ex)
+        {
+            return SimpleEntityActionExecuteResponse.Error("An error occurred while initiating the package update", ex.Message);
+        }
+    }
+}
+```
+
+## Contributing
+
+Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/contribute) page.
+
+## Acknowledgements (Thanks)
+
+- LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
+
+