1. Overview

This Documentation describes the installation and configuration steps of phpMeteo.

2. Requirements

Please ensure that your server meets the following minimum requirements:

Software Modules
PHP 7, or higher MySQLi, cURL, OpenSSL, mbstring
Apache 2, or higher mod_rewrite
MySQL 5, or higher

The following services are also required:

Service Information
OpenWeatherMap API Key

3. Installation

After you've downloaded the product and extracted the contents from the ZIP package, you can start the installation process.

3.1. Importing the database

  1. Create a new MySQL database (optional).
  2. Create a new MySQL username and password (optional).
  3. Import the Database.sql file from the MySQL folder into your MySQL database.

3.2. Setting-up and uploading the files

  1. With a text editor open the Script/app/includes/config.php file and update the values YOURDBUSER, YOURDBNAME, YOURDBPASS, https://example.com with your own information.
  2. Upload the contents of the Script folder on the location where you want the product to be installed at.
  3. Set the CHMOD to 755, 775 or 777 (depending on the server configuration) to the /public/uploads folder and its subfolders.

3.3. Finishing the installation

You're almost done, the last step is to access your Admin Panel (via https://example.com/admin) using the default credentials:

Username admin
Password password
Don't forget to change your Admin Panel password once you've logged-in.

4. Configuration

Most of the phpMeteo's settings are pretty straight forward and self explanatory, but some of them require more advanced steps to get them working, which are covered in the next chapter.

4.1. OpenWeatherMap API

  1. Register an account at OpenWeatherMap.
  2. Once registered, go to your API Keys and copy the key.
  3. Add the API Key in the Admin Panel > Weather section.

5. FAQ

5.1. General

  1. I have a support inquiry, a question or a problem, how can I contact you?
    You can contact us here.
  2. What hosting do you recommend?
    We recommend using DigitalOcean (free $10 on signup), as they offer great performance and flexibility at an affordable price.
  3. Is installation included in the price?
    No, installation is not included. We offer installation services for an extra fee. Contact Us.
  4. How does Searches / IP work?
    Searches / IP limits the number of searches a user is allowed to make per day.

5.2. Installation

  1. Why Permalinks are not working on my site?
    Make sure you've uploaded the .htaccess files that comes with the software and that you have mod_rewrite enabled on your server.
  2. I can't find the .htaccess files, why?
    You're probably using MacOS, which by default is hiding the .htaccess files, enable the option to see hidden files.
  3. How can I add a new site language?
    You can add a new site language by copying your new language file in the /app/languages folder.
  4. My website returns a blank page, why?
    This generally happens when one of the server requirements is not met, you can check your current server configuration by accessing https://example.com/i.php.

5.3. Configuration

  1. How can I change my website's logo?
    You can change the Logo or the Site title from the Admin Panel > General.
  2. How can I change my website's favicon?
    You can change the favicon from Admin Panel > General.
  3. How can I remove the Powered by tag?
    You can remove the Powered by from the /public/themes/search/views/shared/footer.php file.
  4. How can I change a text string on my website?
    You can change any text from the language files located in the /app/languages folder.