From e7496bf9cd5742479820a116413184a60e5b79bd Mon Sep 17 00:00:00 2001
From: diosmosis <diosmosis@users.noreply.github.com>
Date: Mon, 21 Nov 2022 16:04:20 -0800
Subject: [PATCH 1/2] add tracking methods for tracking crashes w/
 CrashAnalytics

---
 MatomoTracker.php | 81 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)

diff --git a/MatomoTracker.php b/MatomoTracker.php
index 75aca63..328f51c 100644
--- a/MatomoTracker.php
+++ b/MatomoTracker.php
@@ -907,6 +907,47 @@ public function doTrackEcommerceOrder(
         return $this->sendRequest($url);
     }
 
+    /**
+     * Tracks a PHP Throwable a crash (requires CrashAnalytics to be enabled in the target Matomo)
+     *
+     * @param Throwable $ex (required) the throwable to track. The message, stack trace, file location and line number
+     *                      of the crash are deduced from this parameter. The crash type is set to the class name of
+     *                      the Throwable.
+     * @param string|null $category (optional) a category value for this crash. This can be any information you want
+     *                              to attach to the crash.
+     * @return mixed Response or true if using bulk request
+     */
+    public function doTrackPhpThrowable(\Throwable $ex, $category = null)
+    {
+        $message = $ex->getMessage();
+        $stack = $ex->getTraceAsString();
+        $type = get_class($ex);
+        $location = $ex->getFile();
+        $line = $ex->getLine();
+
+        return $this->doTrackCrash($message, $type, $category, $stack, $location, $line);
+    }
+
+    /**
+     * Track a crash (requires CrashAnalytics to be enabled in the target Matomo)
+     *
+     * @param string $message (required) the error message.
+     * @param string|null $type (optional) the error type, such as the class name of an Exception.
+     * @param string|null $category (optional) a category value for this crash. This can be any information you want
+     *                              to attach to the crash.
+     * @param string|null $stack (optional) the stack trace of the crash.
+     * @param string|null $location (optional) the source file URI where the crash originated.
+     * @param int|null $line (optional) the source file line where the crash originated.
+     * @param int|null $column (optional) the source file column where the crash originated.
+     * @return mixed Response or true if using bulk request
+     */
+    public function doTrackCrash($message, $type = null, $category = null, $stack = null, $location = null, $line = null, $column = null)
+    {
+        $url = $this->getUrlTrackCrash($message, $type, $category, $stack, $location, $line, $column);
+
+        return $this->sendRequest($url);
+    }
+
     /**
      * Sends a ping request.
      *
@@ -1248,6 +1289,46 @@ public function getUrlTrackAction($actionUrl, $actionType)
         return $url;
     }
 
+    /**
+     * Builds URL to track a crash.
+     *
+     * @see doTrackCrash()
+     * @param string $message (required) the error message.
+     * @param string|null $type (optional) the error type, such as the class name of an Exception.
+     * @param string|null $category (optional) a category value for this crash. This can be any information you want
+     *                              to attach to the crash.
+     * @param string|null $stack (optional) the stack trace of the crash.
+     * @param string|null $location (optional) the source file URI where the crash originated.
+     * @param int|null $line (optional) the source file line where the crash originated.
+     * @param int|null $column (optional) the source file column where the crash originated.
+     * @return string URL to matomo.php with all parameters set to track an action
+     */
+    public function getUrlTrackCrash($message, $type = null, $category = null, $stack = null, $location = null, $line = null, $column = null)
+    {
+        $url = $this->getRequest($this->idSite);
+        $url .= '&cra=' . urlencode($message);
+        if ($type) {
+            $url .= '&cra_tp=' . urlencode($type);
+        }
+        if ($category) {
+            $url .= '&cra_ct=' . urlencode($category);
+        }
+        if ($stack) {
+            $url .= '&cra_st=' . urlencode($stack);
+        }
+        if ($location) {
+            $url .= '&cra_ru=' . urlencode($location);
+        }
+        if ($line) {
+            $url .= '&cra_rl=' . urlencode($line);
+        }
+        if ($column) {
+            $url .= '&cra_rc=' . urlencode($column);
+        }
+
+        return $url;
+    }
+
     /**
      * Overrides server date and time for the tracking requests.
      * By default Matomo will track requests for the "current datetime" but this function allows you

From 26aebac44fb5fa400c38f8e6c905ec72a6eaac95 Mon Sep 17 00:00:00 2001
From: diosmosis <diosmosis@users.noreply.github.com>
Date: Mon, 21 Nov 2022 16:21:18 -0800
Subject: [PATCH 2/2] forgot ca=1 parameter

---
 MatomoTracker.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MatomoTracker.php b/MatomoTracker.php
index 328f51c..33998c2 100644
--- a/MatomoTracker.php
+++ b/MatomoTracker.php
@@ -1306,7 +1306,7 @@ public function getUrlTrackAction($actionUrl, $actionType)
     public function getUrlTrackCrash($message, $type = null, $category = null, $stack = null, $location = null, $line = null, $column = null)
     {
         $url = $this->getRequest($this->idSite);
-        $url .= '&cra=' . urlencode($message);
+        $url .= '&ca=1&cra=' . urlencode($message);
         if ($type) {
             $url .= '&cra_tp=' . urlencode($type);
         }