Create entity-create-option-action.md

Author: madsrasmussen

14/umbraco-cms/customizing/extending-overview/extension-types/entity-create-option-action.md

@@ -0,0 +1,67 @@
+# Entity Create Option Action
+
+An "Entity Create Option Action" is an additional option that can be added when creating an entity. For example, options like "Create Document Type" or "Create Document Type with Template" can be available when a Document Type is being created.
+
+These options will be displayed in a create options dialog when the "Create"-entity action is selected. The dialog will show the available options and allow the user to select one of them.
+
+To enable a "Create"-entity action to show the options dialog, use the 'create'-kind in the manifest when setting up the "Create"-entity action. This will display the options dialog if multiple options are available, or it will automatically execute the first option if only one is available.
+
+By using the "create"-kind for your create entity actions, even though you only have one option available, you can ensure that your options are extendable by other developers.
+
+Register a "Create"-entity action that can display a dialog with options:
+
+```typescript
+const manifest = {
+    type: "entityAction",
+    kind: "create",
+    alias: "My.EntityAction",
+    name: "My Create Entity Action",
+    forEntityTypes: ["my-entity"],
+};
+```
+
+Registering an Entity Create Option Action. If the option is the only one available, it will be executed right away.
+
+```typescript
+const manifest = {
+    type: "entityCreateOptionAction",
+    alias: "My.EntityCreateOptionAction",
+    name: "My Create Option Action",
+    weight: 100,
+    api: () => import("./path-to-file.js"),
+    forEntityTypes: ["my-entity"],
+    meta: {
+        icon: "icon-unplug",
+        label: "My Create Option Action",
+        additionalOptions: false,
+    },
+};
+```
+
+Implementing the Create Action Option.
+
+```typescript
+import {
+    UmbEntityCreateOptionActionBase,
+    type MetaEntityCreateOptionAction,
+    type UmbEntityCreateOptionActionArgs,
+} from "@umbraco-cms/backoffice/entity-create-option-action";
+import type { UmbControllerHostElement } from "@umbraco-cms/backoffice/controller-api";
+
+export class MyEntityCreateActionOption extends UmbEntityCreateOptionActionBase {
+    constructor(
+        host: UmbControllerHostElement,
+        args: UmbEntityCreateOptionActionArgs<MetaEntityCreateOptionAction>
+    ) {
+        super(host, args);
+    }
+
+    override async execute() {
+        alert("My Create Option Action executed!");
+    }
+}
+```
+
+We currently support Create Options for the following entity types:
+
+-   user