|A - Introduction|
|B - Download|
|C - Configuration|
|D - Data Import|
|E - Updates Setup|
|F - Control Panel and Homepage|
|G - Customization|
|H - Glossary|
|I - About|
|J - Videos|
|K - API|
Meteotemplate is a website template to display data from a weather station. It uses a MySQL database to store all the data and therefore allows extensive possibilities of viewing and analyzing your data. This includes interactive sortable tables, graphs, interesting visualizations, maps etc.
Meteotemplate is also characteristic by its extreme customizability and ease of use. You can choose from over 25 languages, hundreds of possible color combinations, fonts and other design features. You can, however, also customize the content. The homepage is highly modular, built from small widgets referred to as blocks. It is up to you to decide how you want your homepage to look like and in addition there are almost a hundred different plugins, add-ons to further extend your website functionality and features, new ones added frequently.
You are now about to go through the wiki, which will guide you through the process of installation. If, however, you feel lost, do not hesitate to contact me, everything is described in this tutorial, but it could be that some parts are unclear to you or the default setting does not work in your particular case. Also, please make sure you read before you do. People often "assume" rather than read and it will save time to you and me if you follow the instructions and do not run into any problems that result from ignoring or skipping parts of this wiki.
Last part of this tutorial is a Glossary. In this glossary you will find definitions of some terms used in this tutorial and their particular meaning in the context of this template. It is therefore a good idea to also look there.
I have also created videos to help you installing the template, however you should be able to install it just using the wiki, and the wiki is always the most up=to-date source of information that should be used as primary help. To access the videos click the link on the left "Videos" and make sure you read the comments before viewing them.
I also recommend you read the About section. I try to do my best, but being a relative newbie and only having this as a night-time hobby, since I have absolutely no formal IT education, it is possible that you can find bugs or problems, which I will try to fix, but it is important that in such case you also let me know.
You will need a basic understanding and familiarity with the following terms in order to use this DIY (do-it-yourself) installation. Each word has a link attached that provides a basic definition. Further information can be found by a web search on the given subject. These are general terms from IT. However, one section of this Wiki is a Glossary. This glossary contains terminology particularly for this template and can be useful if you ever don't quite understand what some term means.
It is a good idea for you know at least the basics of how FTP works and have the ability to use an FTP client. I recommend the freeware Filezilla for manipulating files on the server. However, if you feel completely lost, then this is always something I can help you with.
The documentation is in English and it is also easiest for me to communicate in English if you need support. I also know French and German, but I am not very confident in these languages (and of course Czech, but I don't assume many of you will know this extremely difficult language ;) However, I want to emphasize that this is not a must and I have already installed and set up the template for people who did not know a single word in any of the languages I am able to speak - there is always a way of getting your point across.
If you decide you want to make changes in some of the scripts, please DO NOT use the default Windows Notepad because it inserts additional invisible characters into files, which can cause problems that are particularly difficult to spot. I highly recommend for example Atom, Visual Studio Code or Notepad++. Other options include PsPad or some more sophisticated software (IDE) such as PHP Storm or NetBeans.
If you are using a Mac computer, the supplied Text Editor works perfectly for editing, but you must change the settings for the quotes so that they are straight quotes and not the default smart quotes. Straight quotes are required for editing the scripts.
1) Open the TextEdit application and select Preferences from the pull-down menu. Uncheck the 'Smart quotes' box and also uncheck the 'Smart dashes' box to avoid problems with dashes.
2) Go to System Preferences, click the Keyboard icon, uncheck the box next to ‘Use smart quotes and dashes.’ Straight quotes will now be the default setting in the Text Editor.
The below points cover things that are absolutely essential. If you satisfy those requirements, yet know absolutely nothing about web development etc., I can do the rest for you. Once you know/have the prerequisites, we can begin the tutorial. Even if you don’t have everything in place yet, reading the tutorial first is a good idea.
A weather station that is capable of being connected to a PC or to a device such as Meteobridge, which I use myself, to send data to the internet.
You can use special PC software to download data from your weather station and upload it to the server. I personally think the best is Weather Display, but another very good one is Cumulus or WeatherView.
You can also use a device that directly connects to your station and sends data to the internet. The best example of this is the Meteobridge, which I use myself. It is also possible to get data from a weather network such as Weather Underground, but the template also supports the WeatherLink website if your station has a built-in function to send data there and there is a possibility to use data from the NetAtmo API.
You could use your own server. If this is not an option, you can use external webhosting for your page. People often ask if it is possible to use a free webhosting. The answer is yes, but... make sure the freehosting provider includes all the other necessary things. Also, keep in mind the fact that freehosting tends to be very slow, unreliable, and is more or less intended for very simple sites such as a some blogs or simple personal sites.
Your server must support PHP. The lowest supported version by Meteotemplate is (theoretically) 5.4. Version 5.4 has been around for several years, is well tested, and most importantly, it has some useful new features which are used in the template.
This is the core part of the template. It is necessary that your server has MySQL available to store your weather data. The template only uses one table in the database (if you do not install any other plugins), so it is not very large. For example, 4 yrs of data in 5 minute intervals, would take up approximately 40 MB. Nevertheless, Meteotemplate will not work correctly at all without the MySQL database.
Meteotemplate is offered as a donationware download. However, there are certain things that can and cannot be done. Please read the section below very carefully!
In this tutorial, you will be guided through the process of installing the template and its addons that are called blocks and plugins. During this process, you will also learn the basics of how the whole template functions.
This Wiki should be regarded as a brief installation tutorial. It is not intended to be an all-inclusive document for learning about servers, ftp, directories, etc. (See above for links to help with these topics). Your comfort level with installing and configuring the template is somewhat dependent on the level of your PC skills, and your general knowledge of web pages, web providers, and server configuration. But don't let this intimidate you - knowledge based links are provided above and throughout this tutorial, and my contact preferences are provided below if you need help.
If you encounter problems or have questions during the installation and setup of the template, here are some helpful resources:
The template is offered as donationware 100% ad free. Not only is the download package free, but support is also free (which I am more than happy to provide if needed). If you decide later that you like the template, want to keep on using it and find it useful, you may want to help offset the costs associated with running the website – hosting and domain. A PayPal Donate button is located in the footer, and on several other pages throughout the site. All donations will be applied to operational costs, remember that this is really all developed just by me, not a company, and there are no ads on this page meaning donations are the only source of income allowing me to spend the hours that go into this every day :-).