MagicMirror/modules/README.md

22 lines
1.2 KiB
Markdown
Raw Permalink Normal View History

MagicMirror
===========
##Modules
A module has to contain four files: `main.js`, `style.css`, `elements.html` and `include.php`.
Other files can be loaded from within those.
### include.php
If you happen to need any other css or js file from remote host or a local file you can add it in `include.php`.
2016-01-28 11:42:43 +01:00
It will be loaded before the module's main javascript, the module's css and the module's elements.
Local files starting without `http` or `https` will be loaded from the `root` of the module folder.
If you have a file called `test.js` in your module just add `test.js` if you have the same file but in a folder called `js` inside your module folder add `js/test.js`. Same is valid for css files. Remote files will be loaded normally from the remote host, no need to specify anything.
### elements.html
2016-01-28 11:42:43 +01:00
Put your custom divs and other html elements in this file (don't include any body or header tags). Any refrence of `[module]` will be replaced with the path to the module's root. `[module]/img/test.png` for example becomes `modules/name_of_module/img/test.png`.
### main.js
2016-01-28 11:42:43 +01:00
Your plugin's JavaScript.
### style.css
2016-01-28 11:42:43 +01:00
CSS for your HTML elements. All module elements get loaded into a `div`. The `id` is the name of the module's folder, which acts as the module's name.