Compare commits

...

4 commits

Author SHA1 Message Date
Kristjan ESPERANTO
1622872867
Adapt examples to new timings option 2025-03-25 08:32:13 +01:00
Kristjan ESPERANTO
03fde2a4a6
Fix typo 2025-03-25 08:03:50 +01:00
Kristjan ESPERANTO
571e023539
Update doc about rotationTime 2025-03-25 08:03:09 +01:00
Kristjan ESPERANTO
de2ddfb806
Fix deprecation message
Co-authored-by: Edward Shen <code@eddie.sh>
2025-03-25 08:02:17 +01:00
2 changed files with 26 additions and 20 deletions

View file

@ -49,12 +49,12 @@ Module.register('MMM-pages', {
}
if (this.config.rotationFirstPage) {
Log.warn('[MMM-pages] The config option "rotationFirstPage" is deprecated. Please used "rotationHomePage" instead.');
Log.warn('[MMM-pages] The config option "rotationFirstPage" is deprecated. Please use "rotationHomePage" instead.');
this.config.rotationHomePage = this.config.rotationFirstPage;
}
if (this.config.rotationTime) {
Log.warn('[MMM-pages] The config option "rotationTime" is deprecated. Please used "rotationHomePage" instead.');
Log.warn('[MMM-pages] The config option "rotationTime" is deprecated. Please use "timings" instead.');
this.config.timings.default = this.config.rotationTime;
}

View file

@ -71,10 +71,13 @@ The first element of the array is the first page, the second element is the seco
{
module: "MMM-pages",
config: {
rotationTime: 1000 * 20, // rotate every 20 seconds
timings: {
default: 5000, // rotate every 5 seconds
0: 20000 // page 0 rotates every 20 seconds
},
modules: [
["newsfeed"], // page 1
["calendar", "compliments"], // page 2
["newsfeed"], // page 0
["calendar", "compliments"], // page 1
],
fixed: [ // modules that are always shown
"clock",
@ -103,11 +106,14 @@ Instead of using the module name, you can also use a class name for each page. T
{
module: "MMM-pages",
config: {
rotationTime: 1000 * 20, // rotate every 20 seconds
timings: {
default: 20000, // rotate every 20 seconds
2: 30000 // page 2 rotates every 30 seconds
},
modules: [
["page0"], // class name for page 0
["page1"], // class name for page 1
["page2"], // class name for page 2
["page3"], // class name for page 3
],
fixed: ["fixed_page"],
hiddenPages: {
@ -121,15 +127,23 @@ Instead of using the module name, you can also use a class name for each page. T
You have to add the class name to the config of the module you want to show on a specific page. You can even add more than one class name to show a module instance on multiple pages.
```js
{ // newsfeed on page 1
{ // newsfeed on page 0
module: "newsfeed",
classes: "page0",
position: "...",
config: {
...
}
},
{ // first calendar instance on page 1
module: "calendar",
classes: "page1",
position: "...",
config: {
...
}
},
{ // first calendar instance on page 2
{ // second calendar instance on page 2
module: "calendar",
classes: "page2",
position: "...",
@ -137,17 +151,9 @@ You have to add the class name to the config of the module you want to show on a
...
}
},
{ // second calendar instance on page 3
module: "calendar",
classes: "page3",
position: "...",
config: {
...
}
},
{ // this compliments instance appears on page 1 and 3
{ // this compliments instance appears on page 0 and 2
module: "compliments",
classes: "page1 page3",
classes: "page0 page2",
position: "...",
config: {
...
@ -165,7 +171,7 @@ You have to add the class name to the config of the module you want to show on a
| `excludes` | *NA* | *NA* | **Deprecated**. Use `fixed` instead. |
| `hiddenPages` | `{String: [String...]...}` | `{}` | An Object defining special `hiddenPages` which are not available on the normal page rotation and only accessible via a notification. Modules defined in `fixed` are ignored and need to be also added if you wish to have them on any hidden page. |
| `animationTime` | `int` | `1000` | Fading animation time. Set to `0` for instant change. Value is in milliseconds (1 second = 1000 milliseconds). |
| `rotationTime` | `int` | `0` | **Deprecated**. Use `timings` instead. |
| `rotationTime` | *NA* | *NA* | **Deprecated**. Use `timings` instead. |
| `timings` | `object` | `{ default: 0 }` | An object whose keys define the rotation time of the pages in milliseconds. <br>Example, where each page is 3 seconds, except page 3 which is 20 seconds:<br>`{ default: 3000, 2: 20000 }`<br>If a page is not defined, it will use the `default` value. <br> *Note:* Remember that the numbering starts at 0, so the first page is `0`, the second page is `1`, and so forth. |
| `rotationDelay` | `int` | `10000` | Time, in milliseconds, of how long should a manual page change linger before returning to automatic page changing. In other words, how long should the timer wait for after you manually change a page. This does include the animation time, so you may wish to increase it by a few seconds or so to account for the animation time. |
| `rotationHomePage` | `int` | `0` | Time, in milliseconds, before automatically returning to the home page. If a home page is not set, this returns to the leftmost page instead. |