feat: update analytics so to meet IABv2 requirements

- https://iabtechlab.com/wp-content/uploads/2017/12/Podcast_Measurement_v2-Dec-20-2017.pdf
  - no IP address is ever stored on the server. Only aggregate data is stored in the dababase.
  - rolling 24-hour window
  - castopod does not do pre-load
  - IP Blacklisting https://github.com/client9/ipcat
  - user-agent Filtering https://github.com/opawg/user-agents
  - ignores 2 bytes range "Range: 0-1" (performed by official Apple iOS Podcast app)
  - in case of partial content, adds up all requests to check >1mn was downloaded
  - identifying Uniques is done with a combination of IP Address and User Agent
- add AMcharts
- add some graphs
- add regions to analytics
- add ipcat blacklist
- enhance useragents performances
- add filesize and header size in order to calculate 1mn downloads
- update publisher ID3 field
- update castopod icon
- add disclaimer and warning import form translation
- update docs/setup-development.md

closes #10

app/Models/AnalyticsPodcastsByPlayerModel.php

@@ -15,7 +15,6 @@ use CodeIgniter\Model;
 class AnalyticsPodcastsByPlayerModel extends Model
 {
     protected $table = 'analytics_podcasts_by_player';
-    protected $primaryKey = 'id';
 
     protected $allowedFields = [];
 
@@ -23,4 +22,120 @@ class AnalyticsPodcastsByPlayerModel extends Model
     protected $useSoftDeletes = false;
 
     protected $useTimestamps = false;
+
+    /**
+     * Gets all data for a podcast
+     *
+     * @param int $podcastId
+     *
+     * @return array
+     */
+    public function getDataByApp(int $podcastId): array
+    {
+        if (
+            !($found = cache(
+                "{$podcastId}_analytics_podcasts_by_player_by_app"
+            ))
+        ) {
+            $found = $this->select('`app` as `labels`')
+                ->selectSum('`hits`', '`values`')
+                ->where([
+                    '`podcast_id`' => $podcastId,
+                    '`app` !=' => null,
+                    '`bot`' => 0,
+                    '`date` >' => date('Y-m-d', strtotime('-1 week')),
+                ])
+                ->groupBy('`labels`')
+                ->orderBy('`values``', 'DESC')
+                ->findAll(10);
+
+            cache()->save(
+                "{$podcastId}_analytics_podcasts_by_player_by_app",
+                $found,
+                14400
+            );
+        }
+
+        return $found;
+    }
+
+    /**
+     * Gets all data for a podcast
+     *
+     * @param int $podcastId
+     *
+     * @return array
+     */
+    public function getDataByDevice(int $podcastId): array
+    {
+        if (
+            !($found = cache(
+                "{$podcastId}_analytics_podcasts_by_player_by_device"
+            ))
+        ) {
+            $foundApp = $this->select(
+                'CONCAT_WS("/", `device`, `os`, `app`) as `ids`, `app` as `labels`, CONCAT_WS("/", `device`, `os`) as `parents`'
+            )
+                ->selectSum('`hits`', '`values`')
+                ->where([
+                    '`podcast_id`' => $podcastId,
+                    '`app` !=' => null,
+                    '`bot`' => 0,
+                    '`date` >' => date('Y-m-d', strtotime('-1 week')),
+                ])
+                ->groupBy('`ids`')
+                ->orderBy('`values``', 'DESC')
+                ->findAll();
+
+            $foundOs = $this->select(
+                'CONCAT_WS("/", `device`, `os`) as `ids`, `os` as `labels`, `device` as `parents`'
+            )
+                ->selectSum('`hits`', '`values`')
+                ->where([
+                    '`podcast_id`' => $podcastId,
+                    '`os` !=' => null,
+                    '`bot`' => 0,
+                    '`date` >' => date('Y-m-d', strtotime('-1 week')),
+                ])
+                ->groupBy('`ids`')
+                ->orderBy('`values``', 'DESC')
+                ->findAll();
+
+            $foundDevice = $this->select(
+                '`device` as `ids`, `device` as `labels`, "" as `parents`'
+            )
+                ->selectSum('`hits`', '`values`')
+                ->where([
+                    '`podcast_id`' => $podcastId,
+                    '`device` !=' => null,
+                    '`bot`' => 0,
+                    '`date` >' => date('Y-m-d', strtotime('-1 week')),
+                ])
+                ->groupBy('`ids`')
+                ->orderBy('`values``', 'DESC')
+                ->findAll();
+
+            $foundBot = $this->select(
+                '"bots" as `ids`, "Bots" as `labels`, "" as `parents`'
+            )
+                ->selectSum('`hits`', '`values`')
+                ->where([
+                    '`podcast_id`' => $podcastId,
+                    '`bot`' => 1,
+                    '`date` >' => date('Y-m-d', strtotime('-1 week')),
+                ])
+                ->groupBy('`ids`')
+                ->orderBy('`values``', 'DESC')
+                ->findAll();
+
+            $found = array_merge($foundApp, $foundOs, $foundDevice, $foundBot);
+            cache()->save(
+                "{$podcastId}_analytics_podcasts_by_player_by_device",
+                $found,
+                14400
+            );
+        }
+
+        return $found;
+    }
 }