{"id": "plugin_hooks:plugin-register-permissions", "page": "plugin_hooks", "ref": "plugin-register-permissions", "title": "register_permissions(datasette)", "content": "If your plugin needs to register additional permissions unique to that plugin -  upload-csvs  for example - you can return a list of those permissions from this hook. \n             from datasette import hookimpl, Permission\n\n\n@hookimpl\ndef register_permissions(datasette):\n    return [\n        Permission(\n            name=\"upload-csvs\",\n            abbr=None,\n            description=\"Upload CSV files\",\n            takes_database=True,\n            takes_resource=False,\n            default=False,\n        )\n    ] \n             The fields of the  Permission  class are as follows: \n             \n                 \n                     name  - string \n                     \n                         The name of the permission, e.g.  upload-csvs . This should be unique across all plugins that the user might have installed, so choose carefully. \n                     \n                 \n                 \n                     abbr  - string or None \n                     \n                         An abbreviation of the permission, e.g.  uc . This is optional - you can set it to  None  if you do not want to pick an abbreviation. Since this needs to be unique across all installed plugins it's best not to specify an abbreviation at all. If an abbreviation is provided it will be used when creating restricted signed API tokens. \n                     \n                 \n                 \n                     description  - string or None \n                     \n                         A human-readable description of what the permission lets you do. Should make sense as the second part of a sentence that starts \"A user with this permission can ...\". \n                     \n                 \n                 \n                     takes_database  - boolean \n                     \n                         True  if this permission can be granted on a per-database basis,  False  if it is only valid at the overall Datasette instance level. \n                     \n                 \n                 \n                     takes_resource  - boolean \n                     \n                         True  if this permission can be granted on a per-resource basis. A resource is a database table, SQL view or  canned query . \n                     \n                 \n                 \n                     default  - boolean \n                     \n                         The default value for this permission if it is not explicitly granted to a user.  True  means the permission is granted by default,  False  means it is not. \n                         This should only be  True  if you want anonymous users to be able to take this action.", "breadcrumbs": "[\"Plugin hooks\"]", "references": "[]"}