{"id": "plugin_hooks:plugin-hook-menu-links", "page": "plugin_hooks", "ref": "plugin-hook-menu-links", "title": "menu_links(datasette, actor, request)", "content": "datasette  -  Datasette class \n                     \n                         You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                     \n                 \n                 \n                     actor  - dictionary or None \n                     \n                         The currently authenticated  actor . \n                     \n                 \n                 \n                     request  -  Request object  or None \n                     \n                         The current HTTP request. This can be  None  if the request object is not available. \n                     \n                 \n             \n             This hook allows additional items to be included in the menu displayed by Datasette's top right menu icon. \n             The hook should return a list of  {\"href\": \"...\", \"label\": \"...\"}  menu items. These will be added to the menu. \n             It can alternatively return an  async def  awaitable function which returns a list of menu items. \n             This example adds a new menu item but only if the signed in user is  \"root\" : \n             from datasette import hookimpl\n\n\n@hookimpl\ndef menu_links(datasette, actor):\n    if actor and actor.get(\"id\") == \"root\":\n        return [\n            {\n                \"href\": datasette.urls.path(\n                    \"/-/edit-schema\"\n                ),\n                \"label\": \"Edit schema\",\n            },\n        ] \n             Using  datasette.urls  here ensures that links in the menu will take the  base_url  setting into account. \n             Examples:  datasette-search-all ,  datasette-graphql", "breadcrumbs": "[\"Plugin hooks\"]", "references": "[{\"href\": \"https://datasette.io/plugins/datasette-search-all\", \"label\": \"datasette-search-all\"}, {\"href\": \"https://datasette.io/plugins/datasette-graphql\", \"label\": \"datasette-graphql\"}]"}