Fixed wording and added extra links for Google Analytics report

modules/analyze_google_analytics/src/Plugin/Analyze/GoogleAnalytics.php

@@ -182,4 +182,16 @@ private function getSummaryResults(EntityInterface $entity): ?array {
     return $return;
   }
 
+  /**
+   * {@inheritdoc}
+   */
+  public function extraSummaryLinks(EntityInterface $entity): array {
+    return [
+      [
+        'title' => $this->t('View sitewide Google Analytics report'),
+        'url' => Url::fromRoute('view.google_analytics_summary.page_1'),
+      ],
+    ];
+  }
+
 }

modules/analyze_plugin_example/src/Plugin/Analyze/Example.php

@@ -231,4 +231,21 @@ private function getData(EntityInterface $entity): array {
     ];
   }
 
+  /**
+   * {@inheritdoc}
+   *
+   * This method exists to be able to add extra links to the summary page. For
+   * instance, if you have a plugin that provides a full global report, you can
+   * add a link to that report here or if there is some external tool being
+   * used.
+   */
+  public function extraSummaryLinks(EntityInterface $entity): array {
+    return [
+      'global_report' => [
+        'title' => $this->t('Global Report'),
+        'url' => Url::fromUri('https://example.com/global-report'),
+      ],
+    ];
+  }
+
 }

src/AnalyzeInterface.php

@@ -96,4 +96,15 @@ public function access(EntityInterface $entity): bool;
    */
   public function fullReportUrlOverridden(EntityInterface $entity): bool;
 
+  /**
+   * If the plugin wants to expose extra summary links, it can do so here.
+   *
+   * @param \Drupal\Core\Entity\EntityInterface $entity
+   *   An entity to create links against.
+   *
+   * @return array<mixed>
+   *   An array of title and url pairs.
+   */
+  public function extraSummaryLinks(EntityInterface $entity): array;
+
 }

src/AnalyzePluginBase.php

@@ -128,4 +128,11 @@ public function access(EntityInterface $entity): bool {
     return TRUE;
   }
 
+  /**
+   * {@inheritdoc}
+   */
+  public function extraSummaryLinks(EntityInterface $entity): array {
+    return [];
+  }
+
 }

src/Controller/AnalyzeController.php

@@ -82,7 +82,7 @@ public function analyze(?string $plugin = NULL, ?string $entity_type = NULL, boo
           if (!$full_report && $url = $plugin->getFullReportUrl($entity)) {
             $build[$id . '-link'] = [
               '#type' => 'link',
-              '#title' => $this->t('View the full report'),
+              '#title' => $this->t('View full report of this page'),
               '#url' => $url,
               '#attributes' => [
                 'class' => [
@@ -114,6 +114,25 @@ public function analyze(?string $plugin = NULL, ?string $entity_type = NULL, boo
 
             $weight++;
           }
+          // If there are extra links for the summary, add them.
+          if (!$full_report && $links = $plugin->extraSummaryLinks($entity)) {
+            foreach ($links as $key => $link) {
+              $build[$id . '-extra-link-' . $key] = [
+                '#type' => 'link',
+                '#title' => $link['title'],
+                '#url' => $link['url'],
+                '#attributes' => [
+                  'class' => [
+                    'action-link',
+                    Html::cleanCssIdentifier('view-' . $id . '-report'),
+                  ],
+                ],
+                '#weight' => $weight,
+              ];
+
+              $weight++;
+            }
+          }
         }
         elseif (!$full_report) {