airano-ir
43fd2201a0
Settings fixes: - MAX_SITES_PER_USER, USER_RATE_LIMIT_PER_MIN/HR now read from DB settings table (DB > ENV > default), so dashboard/settings changes apply without restart. Sync cache refreshed on every save or delete. - /api/me reports the live DB value for max_sites_per_user. Admin improvements: - Admin users bypass per-user rate limiting entirely (role=admin or ADMIN_EMAILS). - Admin Overview now shows platform stats: registered users, new users (7d), total user sites, available tools. Plugin cleanup: - Appwrite and Directus plugins removed from the active registry (8 plugins now: WordPress, WooCommerce, WordPress Specialist, Gitea, n8n, Supabase, OpenPanel, Coolify). Plugin code is retained for future re-enabling. - Settings page plugin visibility list updated to match. Mobile onboarding: - Stepper steps on narrow viewports stack vertically with correct full border and rounded corners on each step. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
627 lines
22 KiB
Python
627 lines
22 KiB
Python
"""Menus Handler - manages WordPress navigation menus"""
|
|
|
|
import json
|
|
from typing import Any
|
|
|
|
from plugins.wordpress.client import WordPressClient
|
|
|
|
|
|
def get_tool_specifications() -> list[dict[str, Any]]:
|
|
"""Return tool specifications for ToolGenerator"""
|
|
return [
|
|
{
|
|
"name": "list_menus",
|
|
"method_name": "list_menus",
|
|
"description": "List all WordPress navigation menus. Returns list of menus with their locations and item counts.",
|
|
"schema": {"type": "object", "properties": {}},
|
|
"scope": "read",
|
|
},
|
|
{
|
|
"name": "get_menu",
|
|
"method_name": "get_menu",
|
|
"description": "Get detailed information about a specific menu including all items. Returns menu details with hierarchical structure of menu items.",
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"menu_id": {
|
|
"type": "integer",
|
|
"description": "Menu ID to retrieve",
|
|
"minimum": 1,
|
|
}
|
|
},
|
|
"required": ["menu_id"],
|
|
},
|
|
"scope": "read",
|
|
},
|
|
{
|
|
"name": "create_menu",
|
|
"method_name": "create_menu",
|
|
"description": "Create a new navigation menu. Can optionally assign to theme locations.",
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"description": "Menu name (displayed in admin)",
|
|
"minLength": 1,
|
|
},
|
|
"slug": {
|
|
"anyOf": [{"type": "string"}, {"type": "null"}],
|
|
"description": "Menu slug (auto-generated from name if not provided)",
|
|
},
|
|
"locations": {
|
|
"anyOf": [{"type": "array", "items": {"type": "string"}}, {"type": "null"}],
|
|
"description": "Theme locations to assign menu to (e.g., ['primary', 'footer'])",
|
|
},
|
|
},
|
|
"required": ["name"],
|
|
},
|
|
"scope": "write",
|
|
},
|
|
{
|
|
"name": "list_menu_items",
|
|
"method_name": "list_menu_items",
|
|
"description": "List all items in a specific menu. Returns hierarchical list of menu items with links and ordering.",
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"menu_id": {
|
|
"type": "integer",
|
|
"description": "Menu ID to get items from",
|
|
"minimum": 1,
|
|
}
|
|
},
|
|
"required": ["menu_id"],
|
|
},
|
|
"scope": "read",
|
|
},
|
|
{
|
|
"name": "create_menu_item",
|
|
"method_name": "create_menu_item",
|
|
"description": "Add a new item to a menu. Supports linking to posts, pages, categories, or custom URLs.",
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"menu_id": {
|
|
"type": "integer",
|
|
"description": "Menu ID to add item to",
|
|
"minimum": 1,
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"description": "Item title/label displayed in menu",
|
|
"minLength": 1,
|
|
},
|
|
"type": {
|
|
"type": "string",
|
|
"description": "Item type: 'post_type' (post/page), 'taxonomy' (category/tag), or 'custom' (URL)",
|
|
"enum": ["post_type", "taxonomy", "custom"],
|
|
},
|
|
"object_id": {
|
|
"anyOf": [{"type": "integer"}, {"type": "null"}],
|
|
"description": "ID of linked post/page/term (required for post_type/taxonomy)",
|
|
},
|
|
"url": {
|
|
"anyOf": [{"type": "string"}, {"type": "null"}],
|
|
"description": "Custom URL (required for type=custom)",
|
|
},
|
|
"parent": {
|
|
"anyOf": [{"type": "integer"}, {"type": "null"}],
|
|
"description": "Parent item ID for creating sub-menu items",
|
|
},
|
|
},
|
|
"required": ["menu_id", "title", "type"],
|
|
},
|
|
"scope": "write",
|
|
},
|
|
{
|
|
"name": "update_menu_item",
|
|
"method_name": "update_menu_item",
|
|
"description": "Update an existing menu item. Can change title, URL, parent, or menu order.",
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"item_id": {
|
|
"type": "integer",
|
|
"description": "Menu item ID to update",
|
|
"minimum": 1,
|
|
},
|
|
"title": {
|
|
"anyOf": [{"type": "string"}, {"type": "null"}],
|
|
"description": "New item title",
|
|
},
|
|
"url": {
|
|
"anyOf": [{"type": "string"}, {"type": "null"}],
|
|
"description": "New URL",
|
|
},
|
|
"parent": {
|
|
"anyOf": [{"type": "integer"}, {"type": "null"}],
|
|
"description": "New parent item ID (0 for top-level)",
|
|
},
|
|
"menu_order": {
|
|
"anyOf": [{"type": "integer"}, {"type": "null"}],
|
|
"description": "Position in menu (lower numbers appear first)",
|
|
},
|
|
},
|
|
"required": ["item_id"],
|
|
},
|
|
"scope": "write",
|
|
},
|
|
{
|
|
"name": "list_navigations",
|
|
"method_name": "list_navigations",
|
|
"description": (
|
|
"List wp_navigation posts (block-theme navigation menus). "
|
|
"These power the <!-- wp:navigation --> block in Site Editor. "
|
|
"Distinct from classic menus (use list_menus for those)."
|
|
),
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"per_page": {
|
|
"type": "integer",
|
|
"description": "Results per page (1-100)",
|
|
"default": 20,
|
|
"minimum": 1,
|
|
"maximum": 100,
|
|
},
|
|
"page": {
|
|
"type": "integer",
|
|
"description": "Page number",
|
|
"default": 1,
|
|
"minimum": 1,
|
|
},
|
|
"status": {
|
|
"type": "string",
|
|
"description": "Status filter",
|
|
"enum": ["publish", "draft", "pending", "private", "any"],
|
|
"default": "any",
|
|
},
|
|
},
|
|
},
|
|
"scope": "read",
|
|
},
|
|
{
|
|
"name": "get_navigation",
|
|
"method_name": "get_navigation",
|
|
"description": (
|
|
"Get a single wp_navigation post by ID, including its raw "
|
|
"block-markup content. Use the returned content to plan an "
|
|
"update_navigation call (e.g. fix href values inside <!-- "
|
|
"wp:navigation-link --> blocks)."
|
|
),
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"navigation_id": {
|
|
"type": "integer",
|
|
"description": "wp_navigation post ID",
|
|
"minimum": 1,
|
|
},
|
|
},
|
|
"required": ["navigation_id"],
|
|
},
|
|
"scope": "read",
|
|
},
|
|
{
|
|
"name": "update_navigation",
|
|
"method_name": "update_navigation",
|
|
"description": (
|
|
"Update a wp_navigation post (block-theme menu). Writes "
|
|
"post_content (block markup) and/or title/status/slug/meta. "
|
|
"Use this to fix navigation-link hrefs that the agent set "
|
|
"up in Site Editor without leaving the MCP loop."
|
|
),
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"navigation_id": {
|
|
"type": "integer",
|
|
"description": "wp_navigation post ID",
|
|
"minimum": 1,
|
|
},
|
|
"title": {
|
|
"anyOf": [{"type": "string"}, {"type": "null"}],
|
|
"description": "Navigation title",
|
|
},
|
|
"content": {
|
|
"anyOf": [{"type": "string"}, {"type": "null"}],
|
|
"description": (
|
|
"Block markup (e.g. <!-- wp:navigation-link "
|
|
'{"label":"About","url":"/about/"} /-->). '
|
|
"Replaces the entire post_content."
|
|
),
|
|
},
|
|
"status": {
|
|
"anyOf": [{"type": "string"}, {"type": "null"}],
|
|
"description": "Publication status",
|
|
"enum": ["publish", "draft", "pending", "private"],
|
|
},
|
|
"slug": {
|
|
"anyOf": [{"type": "string"}, {"type": "null"}],
|
|
"description": "Navigation slug",
|
|
},
|
|
"meta": {
|
|
"anyOf": [{"type": "object"}, {"type": "null"}],
|
|
"description": "Post meta key/value map (registered keys only).",
|
|
},
|
|
},
|
|
"required": ["navigation_id"],
|
|
},
|
|
"scope": "write",
|
|
},
|
|
]
|
|
|
|
|
|
class MenusHandler:
|
|
"""Handle menu-related operations for WordPress"""
|
|
|
|
def __init__(self, client: WordPressClient):
|
|
"""
|
|
Initialize menus handler.
|
|
|
|
Args:
|
|
client: WordPress API client instance
|
|
"""
|
|
self.client = client
|
|
|
|
async def list_menus(self) -> str:
|
|
"""
|
|
List all WordPress navigation menus.
|
|
|
|
Returns list of all menus with their locations and item counts.
|
|
|
|
Returns:
|
|
JSON string with total count and menu list
|
|
|
|
Example response:
|
|
{
|
|
"total": 3,
|
|
"menus": [
|
|
{
|
|
"id": 2,
|
|
"name": "Primary Menu",
|
|
"slug": "primary-menu",
|
|
"locations": ["primary"],
|
|
"count": 8
|
|
}
|
|
]
|
|
}
|
|
"""
|
|
try:
|
|
# WordPress REST API for menus (requires plugin support)
|
|
# Try custom endpoint first, fallback to standard if not available
|
|
try:
|
|
menus = await self.client.get("menus", use_custom_namespace=True)
|
|
except Exception:
|
|
# Fallback: use wp/v2/navigation endpoint (WP 5.9+)
|
|
menus = await self.client.get("navigation")
|
|
|
|
result = {"total": len(menus) if isinstance(menus, list) else 0, "menus": menus}
|
|
|
|
return json.dumps(result, indent=2)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{"error": str(e), "message": f"Failed to list menus: {str(e)}"}, indent=2
|
|
)
|
|
|
|
async def get_menu(self, menu_id: int) -> str:
|
|
"""
|
|
Get detailed information about a specific menu including all items.
|
|
|
|
Args:
|
|
menu_id: Menu ID
|
|
|
|
Returns:
|
|
JSON string with menu details and items
|
|
"""
|
|
try:
|
|
# Get menu details
|
|
try:
|
|
menu = await self.client.get(f"menus/{menu_id}", use_custom_namespace=True)
|
|
except Exception:
|
|
menu = await self.client.get(f"navigation/{menu_id}")
|
|
|
|
# Get menu items
|
|
menu_items = await self.list_menu_items(menu_id)
|
|
|
|
result = {
|
|
"menu": menu,
|
|
"items": json.loads(menu_items) if isinstance(menu_items, str) else menu_items,
|
|
}
|
|
|
|
return json.dumps(result, indent=2)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{"error": str(e), "message": f"Failed to get menu {menu_id}: {str(e)}"}, indent=2
|
|
)
|
|
|
|
async def create_menu(
|
|
self, name: str, slug: str | None = None, locations: list[str] | None = None
|
|
) -> str:
|
|
"""
|
|
Create a new navigation menu.
|
|
|
|
Args:
|
|
name: Menu name
|
|
slug: Menu slug (auto-generated if not provided)
|
|
locations: Theme locations to assign menu to
|
|
|
|
Returns:
|
|
JSON string with created menu details
|
|
"""
|
|
try:
|
|
data = {"name": name}
|
|
if slug:
|
|
data["slug"] = slug
|
|
if locations:
|
|
data["locations"] = locations
|
|
|
|
try:
|
|
menu = await self.client.post("menus", json_data=data, use_custom_namespace=True)
|
|
except Exception:
|
|
# Try navigation endpoint
|
|
menu = await self.client.post("navigation", json_data=data)
|
|
|
|
result = {
|
|
"id": menu.get("id"),
|
|
"name": menu.get("name"),
|
|
"slug": menu.get("slug"),
|
|
"message": f"Menu '{name}' created successfully",
|
|
}
|
|
|
|
return json.dumps(result, indent=2)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{"error": str(e), "message": f"Failed to create menu: {str(e)}"}, indent=2
|
|
)
|
|
|
|
async def list_menu_items(self, menu_id: int) -> str:
|
|
"""
|
|
List all items in a specific menu.
|
|
|
|
Args:
|
|
menu_id: Menu ID
|
|
|
|
Returns:
|
|
JSON string with menu items list
|
|
"""
|
|
try:
|
|
params = {"menus": menu_id, "per_page": 100}
|
|
items = await self.client.get("menu-items", params=params)
|
|
|
|
result = {
|
|
"total": len(items) if isinstance(items, list) else 0,
|
|
"menu_id": menu_id,
|
|
"items": items,
|
|
}
|
|
|
|
return json.dumps(result, indent=2)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{
|
|
"error": str(e),
|
|
"message": f"Failed to list menu items for menu {menu_id}: {str(e)}",
|
|
},
|
|
indent=2,
|
|
)
|
|
|
|
async def create_menu_item(
|
|
self,
|
|
menu_id: int,
|
|
title: str,
|
|
type: str,
|
|
object_id: int | None = None,
|
|
url: str | None = None,
|
|
parent: int | None = None,
|
|
) -> str:
|
|
"""
|
|
Add a new item to a menu.
|
|
|
|
Args:
|
|
menu_id: Menu ID to add item to
|
|
title: Item title/label
|
|
type: Item type (post_type, taxonomy, custom)
|
|
object_id: ID of linked post/term (required for post_type/taxonomy)
|
|
url: Custom URL (required for type=custom)
|
|
parent: Parent item ID for creating sub-menu items
|
|
|
|
Returns:
|
|
JSON string with created menu item
|
|
"""
|
|
try:
|
|
data = {"menus": menu_id, "title": title, "type": type}
|
|
|
|
if object_id:
|
|
data["object_id"] = object_id
|
|
if url:
|
|
data["url"] = url
|
|
if parent:
|
|
data["parent"] = parent
|
|
|
|
item = await self.client.post("menu-items", json_data=data)
|
|
|
|
result = {
|
|
"id": item.get("id"),
|
|
"title": item.get("title", {}).get("rendered", title),
|
|
"type": item.get("type"),
|
|
"url": item.get("url"),
|
|
"message": f"Menu item '{title}' created successfully",
|
|
}
|
|
|
|
return json.dumps(result, indent=2)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{"error": str(e), "message": f"Failed to create menu item: {str(e)}"}, indent=2
|
|
)
|
|
|
|
async def update_menu_item(
|
|
self,
|
|
item_id: int,
|
|
title: str | None = None,
|
|
url: str | None = None,
|
|
parent: int | None = None,
|
|
menu_order: int | None = None,
|
|
) -> str:
|
|
"""
|
|
Update an existing menu item.
|
|
|
|
Args:
|
|
item_id: Menu item ID
|
|
title: New title
|
|
url: New URL
|
|
parent: New parent item ID
|
|
menu_order: Position in menu
|
|
|
|
Returns:
|
|
JSON string with updated menu item
|
|
"""
|
|
try:
|
|
# Build data dict with only provided values
|
|
data = {}
|
|
if title is not None:
|
|
data["title"] = title
|
|
if url is not None:
|
|
data["url"] = url
|
|
if parent is not None:
|
|
data["parent"] = parent
|
|
if menu_order is not None:
|
|
data["menu_order"] = menu_order
|
|
|
|
item = await self.client.put(f"menu-items/{item_id}", json_data=data)
|
|
|
|
result = {
|
|
"id": item.get("id"),
|
|
"title": item.get("title", {}).get("rendered", title),
|
|
"url": item.get("url"),
|
|
"menu_order": item.get("menu_order"),
|
|
"message": f"Menu item {item_id} updated successfully",
|
|
}
|
|
|
|
return json.dumps(result, indent=2)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{"error": str(e), "message": f"Failed to update menu item {item_id}: {str(e)}"},
|
|
indent=2,
|
|
)
|
|
|
|
async def list_navigations(self, per_page: int = 20, page: int = 1, status: str = "any") -> str:
|
|
"""List wp_navigation posts (block-theme menus)."""
|
|
try:
|
|
params = {"per_page": per_page, "page": page, "status": status}
|
|
items = await self.client.get("navigation", params=params)
|
|
|
|
if isinstance(items, list):
|
|
summary = [
|
|
{
|
|
"id": n.get("id"),
|
|
"title": (n.get("title") or {}).get("rendered", ""),
|
|
"slug": n.get("slug"),
|
|
"status": n.get("status"),
|
|
"modified": n.get("modified"),
|
|
}
|
|
for n in items
|
|
]
|
|
else:
|
|
summary = items
|
|
|
|
return json.dumps(
|
|
{"total": len(summary) if isinstance(summary, list) else 0, "navigations": summary},
|
|
indent=2,
|
|
)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{"error": str(e), "message": f"Failed to list navigations: {str(e)}"}, indent=2
|
|
)
|
|
|
|
async def get_navigation(self, navigation_id: int) -> str:
|
|
"""Get a single wp_navigation post (with raw block content)."""
|
|
try:
|
|
# context=edit returns content.raw so the agent can round-trip it
|
|
params = {"context": "edit"}
|
|
nav = await self.client.get(f"navigation/{navigation_id}", params=params)
|
|
|
|
content = nav.get("content") or {}
|
|
raw_content = content.get("raw") if isinstance(content, dict) else None
|
|
rendered = content.get("rendered") if isinstance(content, dict) else None
|
|
|
|
return json.dumps(
|
|
{
|
|
"id": nav.get("id"),
|
|
"title": (nav.get("title") or {}).get("rendered", ""),
|
|
"slug": nav.get("slug"),
|
|
"status": nav.get("status"),
|
|
"content_raw": raw_content,
|
|
"content_rendered": rendered,
|
|
"modified": nav.get("modified"),
|
|
"link": nav.get("link"),
|
|
},
|
|
indent=2,
|
|
)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{
|
|
"error": str(e),
|
|
"message": f"Failed to get navigation {navigation_id}: {str(e)}",
|
|
},
|
|
indent=2,
|
|
)
|
|
|
|
async def update_navigation(
|
|
self,
|
|
navigation_id: int,
|
|
title: str | None = None,
|
|
content: str | None = None,
|
|
status: str | None = None,
|
|
slug: str | None = None,
|
|
meta: dict | None = None,
|
|
) -> str:
|
|
"""Update a wp_navigation post (block-theme menu)."""
|
|
try:
|
|
data: dict[str, Any] = {}
|
|
if title is not None:
|
|
data["title"] = title
|
|
if content is not None:
|
|
data["content"] = content
|
|
if status is not None:
|
|
data["status"] = status
|
|
if slug is not None:
|
|
data["slug"] = slug
|
|
if meta is not None:
|
|
data["meta"] = meta
|
|
|
|
if not data:
|
|
return json.dumps(
|
|
{
|
|
"error": "no_fields",
|
|
"message": (
|
|
"update_navigation requires at least one of "
|
|
"title, content, status, slug, meta."
|
|
),
|
|
},
|
|
indent=2,
|
|
)
|
|
|
|
nav = await self.client.post(f"navigation/{navigation_id}", json_data=data)
|
|
|
|
return json.dumps(
|
|
{
|
|
"id": nav.get("id"),
|
|
"title": (nav.get("title") or {}).get("rendered", ""),
|
|
"slug": nav.get("slug"),
|
|
"status": nav.get("status"),
|
|
"modified": nav.get("modified"),
|
|
"link": nav.get("link"),
|
|
"message": f"Navigation {navigation_id} updated successfully",
|
|
},
|
|
indent=2,
|
|
)
|
|
except Exception as e:
|
|
return json.dumps(
|
|
{
|
|
"error": str(e),
|
|
"message": f"Failed to update navigation {navigation_id}: {str(e)}",
|
|
},
|
|
indent=2,
|
|
)
|