Skip to content

MagicMirror2 module for tracking parcels handled by Czech Post

License

Notifications You must be signed in to change notification settings

richardfous/MMM-CzechPost

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MMM-CzechPost

MagicMirror2 module for tracking parcels handled by Czech Post

module MMM-CzechPost

Installation

Navigate into MagicMirror's Module folder using termial:

cd ~/MagicMirror/modules

Clone this repository using following command:

git clone https://github.com/RichieCZ/MMM-CzechPost.git

Add the following text to MagicMirror/config/config.js to activate the module.

{
    module: "MMM-CzechPost",
    position: "top_left", // You can change this to your desired position.
    config: {
        //Here you can insert options listed below.
        }
},

Configuration Options

Option Description
packagesUrl Url of a shared Google Docs document. This document is used to insert tracking numbers into this module. For more info see dependencies below.
Type:string
Default:""
This option is NOT REQUIRED
postCode Postcode of desired Czech post office. This option works only when no packagesUrl is set.
Type:string
Default:"76001"
This option is REQUIRED only when option packagesUrl is not set.
showPostInfo Select how much information about post offices you want to see.
Type:string
Default:all
Possible values: all,today,none(if this option is selected without any url in packagesUrl the module will not display any information).
This option is NOT REQUIRED.
showPackageInfo Select how much information about inserted packages you want to see.
Type:string
Default:all
Possible values: all,latest
This option is NOT REQUIRED.
maxNumOfShownPackages If showPackageInfo option is set to all, you can choose how many packages will be shown on the screen with this option. If the number of packages is higher, the module will only show latest information about each package.
Type:integer
Default:1
This option is NOT REQUIRED.
tableClass Set the size of tables rendered on screen.
Type:string
Default:small
Possible values: xsmall,small,medium,large,xlarge.
This option is NOT REQUIRED.
initialLoadDelay Delay before loading the module. The value is in milliseconds.
Type:integer
Default:3000(3 seconds)
Possible values: 1000-5000.
This option is NOT REQUIRED.
retryDelay The delay before retrying after failed request.
Type:integer
Default:5000(5 seconds)
Possible values: 1000-60000.
This option is NOT REQUIRED.
updateInterval Interval after which new content is fetched. This value is in milliseconds.
Type:integer
Default:5*60*1000(5 minutes)
Possible values: 1000-86400000.
This option is NOT REQUIRED

Multiple Instances of the Module

You can run multiple instances of this module. You can do this by adding another entry of this module into MagicMirror/config/config.js.

Dependencies

For inserting and changing the tracking numbers in this module, you need to create a new Google Docs document, that is set to public. You can do this by going onto the google docs website and creating new document. After your document is created, you have to click the Share button and then select the "Everyone can see this" option in the pop-up menu, after that you can copy the generated Url and place it into the config file.

You can find API used in this module here.

There is a CORS problem with this API, so in order to make this module work a proxy server is used. The proxy server is available on this website. There is a limitation of 100000 characters per request and a limitation of 10 requests/second.

Issues

If you find any issues with this module, feel free to open a GitHub issue in this repository.

About

MagicMirror2 module for tracking parcels handled by Czech Post

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published