Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/edward-shen/MMM-page-indicator
MagicMirror² module to display what page you're on.
https://github.com/edward-shen/MMM-page-indicator
indicator magicmirror pagination
Last synced: 4 months ago
JSON representation
MagicMirror² module to display what page you're on.
- Host: GitHub
- URL: https://github.com/edward-shen/MMM-page-indicator
- Owner: edward-shen
- License: mit
- Created: 2017-06-14T20:10:41.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-11-28T09:24:08.000Z (over 1 year ago)
- Last Synced: 2024-01-15T19:44:48.033Z (5 months ago)
- Topics: indicator, magicmirror, pagination
- Language: JavaScript
- Size: 31.3 KB
- Stars: 38
- Watchers: 5
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Lists
- awesome-mmm - **MMM-Page-Indicator**
README
## Maintainer needed
Hello, it's been 5 years since I've written this! While I'm happy to see it
thriving, it's also about time I step away. I haven't had a magic mirror up
in years, and to be frank, I'm hoping someone else will be willing to take
up maintainership of the project.That being said, this is a very mature project in that it does not need
frequent updates. It does what it needs to do, and there's really no need for
it to have new features. I would still recommend using it today, if not because
people rarely seem to have problems with it.It's a very small project (with the intent to keep it this way), so if you're
interested, please don't hesitate to reach out.---
# MMM-page-indicator
![Example of MMM-page-indicator](./example_picture.png)
This [MagicMirror²][mm] Module is designed to indicate what "page" you are looking at. This module is designed to be an indicator only. By itself, it only offers a basic way to change the page, by clicking on the circle indicative of the page you wish to change to.
## Installation
In your terminal, go to your MagicMirror's Module folder:
```bash
cd ~/MagicMirror/modules
```
Clone this repository:
```bash
git clone https://github.com/edward-shen/MMM-page-indicator.git
```
Configure the module in your config.js file.## Sending notifications to the module
This module responds to the notification `PAGE_CHANGED`. The payload should be an `integer`. Note that this has strict error checking, so `"3"` will not work, while `3` will. Also do note that to switch to page 1, you need to send `0` to the module. **This uses a zero-based numbering system.**
Let's say that you want to change the indicator to page 3. In your code, you would write:
```js
this.sendNotification("PAGE_CHANGED", 2);
```
This would cause the module to change show that you are on page 3.If you wish to change the number of pages, you need to send a `MAX_PAGES_CHANGED` notification with your payload as an integer.
```js
this.sendNotification("MAX_PAGES_CHANGED", 4);
```This would now show that there are now 4 pages to display.
You can also just send `PAGE_INCREMENT` or `PAGE_DECREMENT` without any payloads to have the module change the displayed page by one. If you are using [MMM-pages](https://github.com/edward-shen/MMM-pages.git) with this module, sending an integer as a payload for a `PAGE_INCREMENT` or `PAGE_DECREMENT` notification will perform as described in [the MMM-pages documentation](https://github.com/edward-shen/MMM-pages#notifications). If you are not using MMM-pages, the indicator will ignore the payload and just change the displayed page by one.
## Using the module
To use this module, add it to the modules array in the `config/config.js` file:
```js
modules: [
{
module: 'MMM-page-indicator',
position: 'bottom_bar',
config: {
pages: 3,
}
}
]
```## Configuration options
Option|Description
------|-----------
`pages`|Number of pages that you have.
**Expected Value type:** `int`.
`activeBright`|Should the active circle be bright.
**Expected Value type:** `boolean`.
`inactiveDimmed`|Should the inactive circles be dimmed?
**Expected Value type:** `boolean`.
`inactiveHollow`|Should the inactive circles be hollow?
**Expected Value type:** `boolean`.## FAQ
- Help! My module is (above/below) another module in the same region but I want it to be somewhere else!
The order of your `config.js` determines your module location. If you have two modules, both with `position:bottom_bar`, the one that is first listed will appear on top. The rest will appear in the same order you defined them in. If you want this module to be at the very bottom, define this module as the last module in your `config.js` file. If you want it to be on top in that region, make sure no other module is defined before it that has the same region.
- Can I make a pull request?Please do! I'd love for this to be integrated in many modules!
- I want more config options!Please make an issue. Thanks!
[mm]: https://github.com/MichMich/MagicMirror