Adding share tracking

core/pom.xml

@@ -153,7 +153,7 @@ com.adobe.aem.commons.assetshare.util.impl
                         </goals>
                     </execution>
                 </executions>
-            </plugin>
+            </plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><configuration><source>8</source><target>8</target></configuration></plugin>
             <!-- tests are reused from assetshare.core.cloud, therefore create a dedicated artifact, https://maven.apache.org/plugins/maven-jar-plugin/examples/create-test-jar.html -->
         </plugins>
     </build>

core/src/main/java/com/adobe/aem/commons/assetshare/components/actions/share/impl/EmailShareServiceImpl.java

@@ -67,14 +67,16 @@
 import org.slf4j.LoggerFactory;
 
 import javax.jcr.RepositoryException;
-import javax.jcr.Value;
+import java.net.URISyntaxException;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 
+import org.apache.http.client.utils.URIBuilder;
+
 @Component(service = ShareService.class)
 @Designate(ocd = EmailShareServiceImpl.Cfg.class)
 public class EmailShareServiceImpl implements ShareService {
@@ -90,6 +92,10 @@
     private static final String EMAIL_ADDRESSES = "email";
     private static final String EMAIL_ASSET_LINK_LIST_HTML = "assetLinksHTML";
 
+    /* Share properties */
+    private static final String PN_TRACKING_NAME = "trackingName";
+    private static final String PN_TRACKING_VALUE = "trackingValue";
+
     private transient Cfg cfg;
     private transient BundleContext bundleContext;
 
@@ -206,14 +212,29 @@
 
                 // Unescape the URL since externalizer also escapes, resulting in a breaking, double-escaped URLs
                 // This is required since assetDetailsResolver.getFullUrl(config, asset) performs its own escaping.
-                url =  Text.unescape(url);
+                url = Text.unescape(url);
 
                 if (RequireAem.ServiceType.AUTHOR.equals(requireAem.getServiceType())) {
                     url = externalizer.authorLink(config.getResourceResolver(), url);
                 } else {
                     url = externalizer.externalLink(config.getResourceResolver(), cfg.externalizerDomain(), url);
                 }
 
+                String trackingName = config.getProperties().get(PN_TRACKING_NAME, String.class);
+                String trackingValue = config.getProperties().get(PN_TRACKING_VALUE, String.class);
+
+                try {
+                    if (!StringUtils.isAnyBlank(trackingName, trackingValue)) {
+                        URIBuilder uriBuilder = new URIBuilder(url);
+                        uriBuilder.setParameter(trackingName, trackingValue);
+                        url = uriBuilder.build().toString();
+                    }
+                } catch (URISyntaxException e) {
+                    if (log.isWarnEnabled()) {
+                        log.warn("Unable to part [ {} ] to a valid URL for use in a share e-mail.", url);
+                    }
+                }
+
                 sb.append("<li><a href=\"");
                 sb.append(url);
                 sb.append("\">");

ui.apps/src/main/content/jcr_root/apps/asset-share-commons/components/modals/share/_cq_dialog/.content.xml

@@ -251,6 +251,36 @@
                             </column>
                         </items>
                     </tab-3>
+                    <tab-4
+                            jcr:primaryType="nt:unstructured"
+                            jcr:title="Share tracking"
+                            sling:resourceType="granite/ui/components/coral/foundation/fixedcolumns"
+                            margin="{Boolean}true">
+                        <items jcr:primaryType="nt:unstructured">
+                            <column
+                                    jcr:primaryType="nt:unstructured"
+                                    sling:resourceType="granite/ui/components/coral/foundation/container">
+                                <items jcr:primaryType="nt:unstructured">
+                                    <tracking-name
+                                            jcr:primaryType="nt:unstructured"
+                                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
+                                            fieldDescription="The URL parameter name to set the tracking value to."
+                                            emptyText=""
+                                            fieldLabel="Tracking parameter name"
+                                            name="./data/trackingName"
+                                            required="{Boolean}false"/>
+                                    <tracking-value
+                                            jcr:primaryType="nt:unstructured"
+                                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
+                                            fieldDescription="The tracking URL parameter value. This same value is used on all share URLs."
+                                            emptyText=""
+                                            fieldLabel="Tracking parameter value"
+                                            name="./data/trackingValue"
+                                            required="{Boolean}false"/>
+                                </items>
+                            </column>
+                        </items>
+                    </tab-4>
                 </items>
             </tabs>
         </items>