Merge pull request plone#1208 from plone/controlpanels

add contropanels section

Author: MrTango

docs/backend/control-panels.md

@@ -0,0 +1,44 @@
+---
+html_meta:
+  "description": "How to add a Control Panel"
+  "property=og:description": "How to add a Control Panel"
+  "property=og:title": "Control panels"
+  "keywords": "Plone, Add, Control Panel"
+---
+
+(backend-controlpanels-label)=
+
+# Control panels
+
+## Adding a control panel
+To add a control panel to your add-on, you can use [`plonecli`](https://pypi.org/project/plonecli/) as follows:
+
+```shell
+plonecli add controlpanel
+```
+
+This will create the control panel Python file in the control panel's folder where you can define your control panel schema fields. 
+
+## Registering a Control panel
+To manually register a view as a control panel, add the following registration to your `/profiles/default/controlpanel.xml`.
+
+```xml
+  <?xml version="1.0"?>
+  <object
+      name="portal_control-panel"
+      xmlns:i18n="http://xml.zope.org/namespaces/i18n"
+      i18n:domain="lmu.behavior">
+    <configlet
+      title="Some Control Panel"
+      action_id="collective.example.some_control-panel"
+      appId="collective.example"
+      category="Products"
+      condition_expr=""
+      url_expr="string:${portal_url}/@@some_view"
+      icon_expr=""
+      visible="True"
+      i18n:attributes="title">
+          <permission>Manage portal</permission>
+    </configlet>
+  </object>
+```

docs/backend/index.md

@@ -12,7 +12,7 @@ html_meta:
 
 ```{toctree}
 :maxdepth: 2
-
+control-panels
 content-types
 behaviors
 annotations