Skip to content

Open source, privacy-first web analytics. Lightweight, cookie-free Google Analytics alternative. Self-hosted or cloud.

Implement wildcard filters for the API

Uku Taht0a5f6c5886bd
diff --git a/lib/plausible/stats/query.ex b/lib/plausible/stats/query.ex
index 909742d41d..1342fd3970 100644
--- a/lib/plausible/stats/query.ex
+++ b/lib/plausible/stats/query.ex
@@ -233,9 +233,12 @@ defmodule Plausible.Stats.Query do
is_negated = String.contains?(str, "!=")
is_list = String.contains?(val, "|")
+ is_wildcard = String.contains?(val, "*")
cond do
key == "event:goal" -> {key, parse_goal_filter(val)}
+ is_wildcard && is_negated -> {key, {:does_not_match, val}}
+ is_wildcard -> {key, {:matches, val}}
is_list -> {key, {:member, String.split(val, "|")}}
is_negated -> {key, {:is_not, val}}
true -> {key, {:is, val}}
diff --git a/test/plausible_web/controllers/api/external_stats_controller/aggregate_test.exs b/test/plausible_web/controllers/api/external_stats_controller/aggregate_test.exs
index d62586711b..984eada41f 100644
--- a/test/plausible_web/controllers/api/external_stats_controller/aggregate_test.exs
+++ b/test/plausible_web/controllers/api/external_stats_controller/aggregate_test.exs
@@ -729,5 +729,57 @@ defmodule PlausibleWeb.Api.ExternalStatsController.AggregateTest do
"visit_duration" => %{"value" => 1500}
}
end
+
+ test "wildcard page filter", %{conn: conn, site: site} do
+ populate_stats(site, [
+ build(:pageview, pathname: "/en/page1"),
+ build(:pageview, pathname: "/en/page2"),
+ build(:pageview, pathname: "/pl/page1")
+ ])
+
+ conn =
+ get(conn, "/api/v1/stats/aggregate", %{
+ "site_id" => site.domain,
+ "metrics" => "visitors",
+ "filters" => "event:page==/en/**"
+ })
+
+ assert json_response(conn, 200)["results"] == %{"visitors" => %{"value" => 2}}
+ end
+
+ test "negated wildcard page filter", %{conn: conn, site: site} do
+ populate_stats(site, [
+ build(:pageview, pathname: "/en/page1"),
+ build(:pageview, pathname: "/en/page2"),
+ build(:pageview, pathname: "/pl/page1")
+ ])
+
+ conn =
+ get(conn, "/api/v1/stats/aggregate", %{
+ "site_id" => site.domain,
+ "metrics" => "visitors",
+ "filters" => "event:page!=/en/**"
+ })
+
+ assert json_response(conn, 200)["results"] == %{"visitors" => %{"value" => 1}}
+ end
+
+ test "wildcard and member filter combined", %{conn: conn, site: site} do
+ populate_stats(site, [
+ build(:pageview, pathname: "/en/page1"),
+ build(:pageview, pathname: "/en/page2"),
+ build(:pageview, pathname: "/pl/page1"),
+ build(:pageview, pathname: "/ee/page1")
+ ])
+
+ conn =
+ get(conn, "/api/v1/stats/aggregate", %{
+ "site_id" => site.domain,
+ "metrics" => "visitors",
+ "filters" => "event:page==/en/**|/pl/**"
+ })
+
+ assert json_response(conn, 200)["results"] == %{"visitors" => %{"value" => 3}}
+ end
end
end
diff --git a/test/plausible_web/controllers/api/external_stats_controller/breakdown_test.exs b/test/plausible_web/controllers/api/external_stats_controller/breakdown_test.exs
index 59e681f507..bdaa39b4bc 100644
--- a/test/plausible_web/controllers/api/external_stats_controller/breakdown_test.exs
+++ b/test/plausible_web/controllers/api/external_stats_controller/breakdown_test.exs
@@ -830,6 +830,33 @@ defmodule PlausibleWeb.Api.ExternalStatsController.BreakdownTest do
}
end
+ test "can filter event:page with a wildcard", %{
+ conn: conn,
+ site: site
+ } do
+ populate_stats(site, [
+ build(:pageview, pathname: "/en/page1"),
+ build(:pageview, pathname: "/en/page2"),
+ build(:pageview, pathname: "/en/page2"),
+ build(:pageview, pathname: "/pl/page1")
+ ])
+
+ conn =
+ get(conn, "/api/v1/stats/breakdown", %{
+ "site_id" => site.domain,
+ "period" => "day",
+ "property" => "event:page",
+ "filters" => "event:page==/en/**"
+ })
+
+ assert json_response(conn, 200) == %{
+ "results" => [
+ %{"page" => "/en/page2", "visitors" => 2},
+ %{"page" => "/en/page1", "visitors" => 1}
+ ]
+ }
+ end
+
test "breakdown by custom event property", %{conn: conn, site: site} do
populate_stats([
build(:event,