https://api.openpanel.dev — "
+ "Self-hosted: your API service URL (e.g., https://analytics.example.com).",
+ "Client must have root mode for full access (tracking + export + manage). "
+ "Use read mode for analytics only, or write mode for tracking only.",
+ "If you have WordPress, install the OpenPanel WordPress plugin "
+ "to automatically send analytics data to your OpenPanel instance.",
+ ],
+ "notes_fa": [
+ "آدرس سایت باید آدرس API باشد، نه داشبورد. "
+ "نسخه Cloud: https://api.openpanel.dev — "
+ "خودمیزبان: آدرس سرویس API شما (مثلاً https://analytics.example.com).",
+ "برای دسترسی کامل، کلاینت باید حالت root داشته باشد. "
+ "از حالت read برای آنالیتیکس و write برای ردیابی استفاده کنید.",
+ "اگر وردپرس دارید، افزونه OpenPanel WordPress "
+ "را نصب کنید تا دادههای آنالیتیکس بهصورت خودکار به OpenPanel ارسال شود.",
+ ],
+ },
+ }
+
+ desc_data = service_descriptions.get(plugin_type, {})
+
return {
"plugin_type": plugin_type,
"display_name": display_name,
@@ -3299,6 +3336,7 @@ async def get_service_page_data(plugin_type: str) -> dict | None:
"tools_count": len(tools),
"credential_fields": credential_fields,
"is_public": is_plugin_public(plugin_type),
+ "description": desc_data,
}
diff --git a/core/endpoints/config.py b/core/endpoints/config.py
index b22db17..c479206 100644
--- a/core/endpoints/config.py
+++ b/core/endpoints/config.py
@@ -249,16 +249,15 @@ ENDPOINT_CONFIGS = {
},
max_tools=80,
),
- # OpenPanel endpoint - Product Analytics (73 tools) - Phase H
+ # OpenPanel endpoint - Product Analytics (42 tools) - Phase H
EndpointType.OPENPANEL: EndpointConfig(
path="/openpanel",
name="OpenPanel Analytics",
- description="OpenPanel product analytics management (events, export, funnels, dashboards)",
+ description="OpenPanel self-hosted product analytics (events, export, insights, project/client management)",
endpoint_type=EndpointType.OPENPANEL,
plugin_types=["openpanel"],
require_master_key=False,
allowed_scopes={"read", "write", "admin"},
- # Blacklist system and admin tools
tool_blacklist={
"manage_api_keys_create",
"manage_api_keys_delete",
@@ -266,7 +265,7 @@ ENDPOINT_CONFIGS = {
"oauth_register_client",
"oauth_revoke_client",
},
- max_tools=80,
+ max_tools=50,
),
# Appwrite endpoint - Backend-as-a-Service (100 tools) - Phase I
EndpointType.APPWRITE: EndpointConfig(
diff --git a/core/plugin_visibility.py b/core/plugin_visibility.py
index e79add5..0287a06 100644
--- a/core/plugin_visibility.py
+++ b/core/plugin_visibility.py
@@ -15,7 +15,7 @@ Usage:
import os
# Default plugins available to public (OAuth) users
-DEFAULT_PUBLIC_PLUGINS = {"wordpress", "woocommerce", "supabase"}
+DEFAULT_PUBLIC_PLUGINS = {"wordpress", "woocommerce", "supabase", "openpanel"}
def _parse_plugins(val: str) -> set[str]:
diff --git a/core/settings.py b/core/settings.py
index 03ab3fc..160cea8 100644
--- a/core/settings.py
+++ b/core/settings.py
@@ -3,7 +3,7 @@
Usage:
from core.settings import get_setting
- enabled = await get_setting("ENABLED_PLUGINS", "wordpress,woocommerce,supabase")
+ enabled = await get_setting("ENABLED_PLUGINS", "wordpress,woocommerce,supabase,openpanel")
max_sites = int(await get_setting("MAX_SITES_PER_USER", "10"))
"""
@@ -17,7 +17,7 @@ _cached_plugins: set[str] | None = None
# Default values for all managed settings
SETTING_DEFAULTS: dict[str, str] = {
- "ENABLED_PLUGINS": "wordpress,woocommerce,supabase",
+ "ENABLED_PLUGINS": "wordpress,woocommerce,supabase,openpanel",
"MAX_SITES_PER_USER": "10",
"USER_RATE_LIMIT_PER_MIN": "30",
"USER_RATE_LIMIT_PER_HR": "500",
diff --git a/core/site_api.py b/core/site_api.py
index 6447025..a4b5586 100644
--- a/core/site_api.py
+++ b/core/site_api.py
@@ -157,7 +157,7 @@ PLUGIN_CREDENTIAL_FIELDS: dict[str, list[dict[str, Any]]] = {
"label": "Client ID",
"type": "text",
"required": True,
- "hint": "OpenPanel admin panel → API section",
+ "hint": "OpenPanel Dashboard → Settings → Clients → Create client with 'root' mode for full access",
},
{
"name": "client_secret",
@@ -166,6 +166,21 @@ PLUGIN_CREDENTIAL_FIELDS: dict[str, list[dict[str, Any]]] = {
"required": True,
"hint": "Generated with your Client ID",
},
+ {
+ "name": "project_id",
+ "label": "Project ID",
+ "type": "text",
+ "required": False,
+ "hint": "From dashboard URL: dashboard.openpanel.dev/{org}/{project-id}/ — sets default for Export & Insights tools",
+ },
+ {
+ "name": "organization_id",
+ "label": "Organization ID",
+ "type": "text",
+ "required": False,
+ "hint": "From dashboard URL: dashboard.openpanel.dev/{org}/{project-id}/",
+ "advanced": True,
+ },
],
"appwrite": [
{
@@ -215,7 +230,7 @@ _HEALTH_ENDPOINTS: dict[str, dict[str, Any]] = {
"gitea": {"path": "/api/v1/user", "method": "GET"},
"n8n": {"path": "/healthz", "method": "GET"},
"supabase": {"path": "/rest/v1/", "method": "GET"},
- "openpanel": {"path": "/api/v1/oauth/token", "method": "POST"},
+ "openpanel": {"path": "/healthcheck", "method": "GET"},
"appwrite": {"path": "/v1/health", "method": "GET"},
"directus": {"path": "/server/health", "method": "GET"},
}
@@ -342,23 +357,13 @@ async def validate_site_connection(
elif plugin_type == "directus":
headers["Authorization"] = f"Bearer {credentials.get('token', '')}"
elif plugin_type == "openpanel":
- # OpenPanel uses token exchange — just check that the URL is reachable
- pass
+ headers["openpanel-client-id"] = credentials.get("client_id", "")
+ headers["openpanel-client-secret"] = credentials.get("client_secret", "")
try:
timeout = aiohttp.ClientTimeout(total=15)
async with aiohttp.ClientSession(timeout=timeout) as session:
- if method == "POST" and plugin_type == "openpanel":
- async with session.post(
- check_url,
- json={
- "clientId": credentials.get("client_id", ""),
- "clientSecret": credentials.get("client_secret", ""),
- },
- ) as resp:
- status_code = resp.status
- resp_text = await resp.text()
- elif method == "POST":
+ if method == "POST":
async with session.post(check_url, headers=headers) as resp:
status_code = resp.status
resp_text = await resp.text()
diff --git a/core/templates/dashboard/service.html b/core/templates/dashboard/service.html
index 6c85a75..b241e41 100644
--- a/core/templates/dashboard/service.html
+++ b/core/templates/dashboard/service.html
@@ -31,6 +31,31 @@
+
+ {% if service.description %}
+ {{ service.description.fa }}
+ {% elif service.description.en %} +{{ service.description.en }}
+ {% endif %} + + {% set notes_key = 'notes_fa' if lang == 'fa' else 'notes_en' %} + {% if service.description[notes_key] %} +