Workflow - content for each task - allows looping through content items using a query or contentype

src/OrchardCore.Modules/OrchardCore.Contents/Views/Items/ContentForEachTask.Fields.Design.cshtml

@@ -0,0 +1,6 @@
+@model OrchardCore.Workflows.ViewModels.ActivityViewModel<ContentForEachTask>
+
+<header>
+    <h4><i class="fa fa-circle-o-notch"></i>@Model.Activity.GetTitleOrDefault(() => T["Content For Each"])</h4>
+</header>
+<em>@Model.Activity.ContentType</em>

src/OrchardCore.Modules/OrchardCore.Contents/Views/Items/ContentForEachTask.Fields.Edit.cshtml

@@ -0,0 +1,8 @@
+@model ContentForEachTaskViewModel
+
+<div class="form-group" asp-validation-class-for="ContentType">
+    <label asp-for="ContentType">@T["Content Type"]</label>
+    <input type="text" asp-for="ContentType" class="form-control" />
+    <span asp-validation-for="ContentType"></span>
+    <span class="hint">@T["The content type to loop over"]</span>
+</div>

src/OrchardCore.Modules/OrchardCore.Contents/Views/Items/ContentForEachTask.Fields.Thumbnail.cshtml

@@ -0,0 +1,2 @@
+<h4 class="card-title"><i class="fa fa-circle-o-notch"></i>@T["Content For Each"]</h4>
+<p>@T["Content for each task"]</p>

src/OrchardCore.Modules/OrchardCore.Contents/Workflows/Activities/ContentForEachTask.cs

@@ -0,0 +1,95 @@
+using Microsoft.Extensions.Localization;
+using OrchardCore.Workflows.Abstractions.Models;
+using OrchardCore.Workflows.Activities;
+using OrchardCore.Workflows.Models;
+using OrchardCore.ContentManagement;
+using OrchardCore.ContentManagement.Records;
+using YesSql;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using OrchardCore.ContentManagement.Workflows;
+
+namespace OrchardCore.Contents.Workflows.Activities
+{
+    public class ContentForEachTask : TaskActivity
+    {
+        readonly IStringLocalizer S;
+        private readonly ISession _session;
+        private readonly IContentManager _contentManager;
+
+        public ContentForEachTask(IContentManager contentManager, IStringLocalizer<RetrieveContentTask> localizer, ISession session)
+        {
+            S = localizer;
+            _session = session;
+            _contentManager = contentManager;
+        }
+        public override string Name => nameof(ContentForEachTask);
+
+        public override LocalizedString DisplayText => S["Content For Each Task"];
+
+        public override LocalizedString Category => S["Content"];
+
+        public override IEnumerable<Outcome> GetPossibleOutcomes(WorkflowExecutionContext workflowContext, ActivityContext activityContext)
+        {
+            return Outcomes(S["Iterate"], S["Done"]);
+        }
+        public override bool CanExecute(WorkflowExecutionContext workflowContext, ActivityContext activityContext)
+        {
+            return true;
+        }
+        public override async Task<ActivityExecutionResult> ExecuteAsync(WorkflowExecutionContext workflowContext, ActivityContext activityContext)
+        {
+            var contentItems = await _session
+                .Query<ContentItem, ContentItemIndex>(index => index.ContentType == ContentType && index.Published == true && index.Latest == true)
+                .ListAsync();
+            List<ContentItem> items = contentItems.ToList();
+            if (contentItems.Count() == 0)
+            {
+                throw new InvalidOperationException($"The '{nameof(ContentForEachTask)}' failed to evaluate the 'ContentType'.");
+            }
+
+            if (Index < contentItems.Count())
+            {
+                var contentItem = await _contentManager.LoadAsync(items[Index]);
+                var current = Current = contentItem;
+                workflowContext.CorrelationId = contentItem.ContentItemId;
+                workflowContext.Properties[ContentEventConstants.ContentItemInputKey] = contentItem;
+                workflowContext.LastResult = current;
+                Index++;
+                return Outcomes("Iterate"); 
+            }
+            else
+            {
+                Index = 0;
+                return Outcomes("Done");
+            }
+        }
+
+        /// <summary>
+        /// The current number of iterations executed.
+        /// </summary>
+        public int Index
+        {
+            get => GetProperty(() => 0);
+            set => SetProperty(value);
+        }
+
+        /// <summary>
+        /// The current iteration value.
+        /// </summary>
+        public object Current
+        {
+            get => GetProperty<object>();
+            set => SetProperty(value);
+        }
+
+        public string ContentType
+        {
+            get => GetProperty(() => string.Empty);
+            set => SetProperty(value);
+        }
+    }
+
+}

src/OrchardCore.Modules/OrchardCore.Contents/Workflows/Drivers/ContentForEachTaskDisplayDriver.cs

@@ -0,0 +1,22 @@
+using OrchardCore.Workflows.Display;
+using OrchardCore.Contents.Workflows.ViewModels;
+using OrchardCore.Contents.Workflows.Activities;
+
+namespace OrchardCore.Contents.Workflows.Drivers
+{
+
+
+    public class ContentForEachTaskDisplayDriver: ActivityDisplayDriver<ContentForEachTask, ContentForEachTaskViewModel>
+    {
+        protected override void EditActivity(ContentForEachTask activity, ContentForEachTaskViewModel model)
+        {
+            model.ContentType = activity.ContentType;
+        }
+
+        protected override void UpdateActivity(ContentForEachTaskViewModel model, ContentForEachTask activity)
+        {
+            activity.ContentType = model.ContentType;
+        }
+    }
+
+}

src/OrchardCore.Modules/OrchardCore.Contents/Workflows/Startup.cs

@@ -27,7 +27,7 @@ public override void ConfigureServices(IServiceCollection services)
             services.AddActivity<CreateContentTask, CreateContentTaskDisplayDriver>();
             services.AddActivity<RetrieveContentTask, RetrieveContentTaskDisplayDriver>();
             services.AddActivity<UpdateContentTask, UpdateContentTaskDisplayDriver>();
-
+            services.AddActivity<ContentForEachTask, ContentForEachTaskDisplayDriver>();
             services.AddScoped<IContentHandler, ContentsHandler>();
             services.AddScoped<IWorkflowValueSerializer, ContentItemSerializer>();
         }

src/OrchardCore.Modules/OrchardCore.Contents/Workflows/ViewModels/ContentForEachTaskViewModel.cs

@@ -0,0 +1,30 @@
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.StaticFiles;
+using Microsoft.Extensions.Localization;
+using Microsoft.Extensions.Options;
+using OrchardCore.Environment.Shell;
+using OrchardCore.Workflows.Abstractions.Models;
+using OrchardCore.Workflows.Activities;
+using OrchardCore.Workflows.Services;
+using OrchardCore.Workflows.Display;
+using OrchardCore.Workflows.Models;
+using OrchardCore.ContentManagement;
+using OrchardCore.ContentManagement.Workflows;
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Threading.Tasks;
+using OrchardCore.Contents.Workflows.Activities;
+using System.ComponentModel.DataAnnotations;
+
+namespace OrchardCore.Contents.Workflows.ViewModels
+{
+
+    public class ContentForEachTaskViewModel
+    {
+        [Required]
+        public string ContentType { get; set; }
+    }
+
+}

src/docs/reference/modules/Workflows/README.md

@@ -85,6 +85,11 @@ Although many activities support multiple outcomes, they typically return only o
 For example, the _Send Email_ activity has two possible outcomes: "Done" and "Failed".  
 When the email was sent successfully, it yields "Done" as the outcome, and "Failed" otherwise.
 
+For activities that have an iterator outcome e.g _Content For Each_, return the outcome of the next activity back to the irrerate task for the irritation to continue either through the done outcome or via a fork.
+If forking make sure that the loop output is after the action output. 
+
+![Sample content for each ](docs/sample-content-for-each.png)
+
 ### Transition
 
 A transition is the connection between the outcome of one activity to another activity. Transitions are created using drag & drop operations in the workflow editor.
@@ -241,6 +246,7 @@ The following activities are available with any default Orchard installation:
 | Create Content | Task | Create a content item. |
 | Delete Content | Task | Delete a content item. |
 | Publish Content | Task | Publish a content item. |
+| For Content Type | Task | Loop through a content type. |
 **User** | * | * | * |
 | ValidateUser | Task | Used to check if the user is logged in and has the specified role(s). |