Feature #1425: additional params for text webpart

CHANGELOG.md

@@ -26,6 +26,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Added `-Path` option to `Set-PnPList` which allows the url of a list to be changed within the same site [#2381](https://github.com/pnp/powershell/pull/2381)
 - Added `-Force` option to `Set-PnPListem` to force it to update a list item even without changing something. Can be useful in i.e. triggering a webhook. [#2396](https://github.com/pnp/powershell/pull/2396)
 - Added `ImageUrl`, `PageImageAlignment`, `ImageHeight` and `ImageWidth` parameters to `Add-PnPPageTextPart` cmdlet so that users can add an inline image into a text webpart. [#2401](https://github.com/pnp/powershell/pull/2401)
+- Added `TextBeforeImage` and `TextAfterImage` parameters to `Add-PnPPageTextPart` cmdlet so that users can add before and after text for an inline image into a text webpart. [#2401](https://github.com/pnp/powershell/pull/2401)
+
 
 ### Changed
 - Changed to no longer require `https://` to be prefixed when using `Connect-PnPOnline -Url tenant.sharepoint.com` [#2139](https://github.com/pnp/powershell/pull/2139)

documentation/Add-PnPPageTextPart.md

@@ -44,6 +44,14 @@ Add-PnPPageTextPart -Page "MyPage" -Text "Hello World!" -ImageUrl "/sites/contos
 
 Adds the text 'Hello World!' to the Page 'MyPage' with specified image as inline image.
 
+### EXAMPLE 3
+```powershell
+Add-PnPPageTextPart -Page "MyPage" -Text "Hello World!" -ImageUrl "/sites/contoso/SiteAssets/test.png" -TextBeforeImage "Text before" -TextAfterImage "Text after"
+```
+
+Adds the text 'Hello World!' to the Page 'MyPage' with specified image as inline image with text specified before and after the inline image.
+
+
 ## PARAMETERS
 
 ### -Column
@@ -116,6 +124,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -TextBeforeImage
+Specifies the text to display before the inline image.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: 150
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ImageUrl
 Specifies the inline image to be added. Image will be added after the text content.
 
@@ -172,6 +194,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -TextAfterImage
+Specifies the text to display after the inline image.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: 150
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Connection
 Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
 

src/Commands/Pages/AddPageTextPart.cs

@@ -29,6 +29,10 @@ public class AddTextPart : PnPWebCmdlet
         [Parameter(Mandatory = true, ParameterSetName = ParameterSet_POSITIONED)]
         public int Column;
 
+        [Parameter(Mandatory = false, ParameterSetName = ParameterSet_DEFAULT)]
+        [Parameter(Mandatory = false, ParameterSetName = ParameterSet_POSITIONED)]
+        public string TextBeforeImage = string.Empty;
+
         [Parameter(Mandatory = false, ParameterSetName = ParameterSet_DEFAULT)]
         [Parameter(Mandatory = false, ParameterSetName = ParameterSet_POSITIONED)]
         public string ImageUrl;
@@ -45,6 +49,10 @@ public class AddTextPart : PnPWebCmdlet
         [Parameter(Mandatory = false, ParameterSetName = ParameterSet_POSITIONED)]
         public int ImageHeight = 150;
 
+        [Parameter(Mandatory = false, ParameterSetName = ParameterSet_DEFAULT)]
+        [Parameter(Mandatory = false, ParameterSetName = ParameterSet_POSITIONED)]
+        public string TextAfterImage = string.Empty;
+
         protected override void ExecuteCmdlet()
         {
             if (ParameterSpecified(nameof(Section)) && Section == 0)
@@ -77,7 +85,7 @@ protected override void ExecuteCmdlet()
                     Height = ImageHeight
                 });
 
-                textPartText = $"{Text}{inlineImage}";
+                textPartText = $"{Text}{TextBeforeImage}{inlineImage}{TextAfterImage}";
             }
 
             textControl.Text = textPartText;