Walter vl: /* Installation */

2023-09-07T14:16:48Z

Installation

New page

[[File:Settings Active menu.png|right|frameless]]
In the tab Custom you can place your own Domoticz menu or info pages.

The Custom menu has to be enabled in the menu [[User Management|Setup - Users]] for each user able to see this menu

It will only show the menu if there is a custom page or multiple custom pages installed.

'''Warning:''' The non Domoticz data shown in these custom pages are not protected by the domoticz authorisation mechanisms!!

[[File:Custom menu.png]]

<br />
===Installation===
Place your custom page .html files in the folder <code>domoticz/www/templates</code>.

When using Docker you have to make an extra mount to <code>domoticz/www/templates</code>

for example:

<code>./config/domoticz/templates:/opt/domoticz/www/templates</code>

====Custom dashboard example====
For example rename the existing file <code>custom.example</code> to <code>custom.html</code>

When you start/refresh Domoticz, you should now see a 'Custom' dropdown menu linking to a dashboard page.

For an explanation of this custom.html file see page [[CustomStatusPage]]

So every .html file in domoticz/www/templates will create a menu entry in the Custom tab.

====Grafana external====
To show your Grafana dashboard from this menu in a new browser window create a <code>grafana.html</code> file with the following contents:

<code><script type="text/javascript"></code>

<code>window.open('<nowiki>http://IPAddress:Port/?orgId=1'</nowiki>);</code>

<code></script></code>

With the window.open statement every website can be opened.

====Grafana embedded====
To open the external website in the context of the Domoticz website (embedded) make an .html file containing:

<IFRAME SRC="<code><nowiki>http://IPAddress:Port/?orgId=1</nowiki></code>" height="800" width="100%"></IFRAME>

NOTE: Not all websites allow embedding in another webpage. You will see an error.

<br />

====Another example====
Example of Zigate UI plugin embedded in Domoticz:

[[File:Custom menu page.png]]

====Custom menu by Python plugins====
Also Python Plugins can create custom menu pages, see page [[Developing a Python plugin#Setup custom page within plugin]]

<br />

Custom menu - Revision history

Walter vl: /* Installation */