Pretty Weather manual

Below you will find the following manuals for "Pretty Weather":

For your information:
  • The manuals are written with Joomla 6.1 and Pretty Weather 1.2.0. Pretty Weather 1.2.0 needs Joomla 5.2 or newer. In Joomla 5 some screens can look slightly different.
  • The red numbers in the images match the numbers between brackets in the steps.
  • Click on an image to enlarge it. It opens in a pop-up window; click next to the window to return to this article.
  • Please note: the module positions depend on your Joomla template and may therefore differ. More information: https://docs.joomla.org/Finding_module_positions_on_any_given_page

Installing Pretty Weather with the download

These steps download Pretty Weather and install it in Joomla by uploading the file.

  1. Download the Pretty Weather module from GitHub (free, no account needed):

    Download Pretty Weather

    Under Assets, click the ZIP file mod_prettyweather-1.2.0.zip (1). A newer version has a higher version number in its name. The file is downloaded. Do not unzip it, and remember where you saved it.

    Download Pretty Weather from GitHub
  2. Open the back-end (administrator) of Joomla, usually at https://<yourdomain>/administrator/. Enter your Username (1) and Password (2) of a Super User account and click Log in (3).

    Joomla 6 administrator login
  3. In the menu on the left, click System (1).

    Joomla 6 Home Dashboard, menu item System
  4. In the block Install, click Extensions (1).

    Joomla 6 System Dashboard, Install, Extensions
  5. The tab Upload Package File (1) is open. Drag the ZIP file into the frame (2), or click the green button Or browse for file (3), select the file and click Open.

    Joomla 6 Upload Package File
  6. The module is installed right away. The message "Installation of the module was successful." appears (1).

    Joomla 6 message: installation of the module was successful
  7. You can now set up the module. See Configuration of Pretty Weather.

Installing Pretty Weather with Install from Web

These steps install Pretty Weather straight from the Joomla Extensions Directory, without downloading a file. The tab Install from Web is provided by the plugin Installer - Install from Web. If you do not see the tab, click System, then Plugins, search for "Install from Web" and enable the plugin.

  1. Log in to the back-end (administrator) of Joomla with a Super User account. You usually find it at https://<yourdomain>/administrator/. Then click System in the menu on the left, as in steps 2 and 3 of the first manual.
  2. In the block Install, click Extensions (1).

    Joomla 6 System Dashboard, Install, Extensions
  3. Click the tab Install from Web (1). Type Pretty Weather in the search field (2) and click the magnifying glass (3).

    Joomla 6 Install from Web, searching for Pretty Weather
  4. Click Pretty Weather in the results (1).

    Joomla 6 Install from Web, Pretty Weather in the results
  5. Click the green button Install (1).

    Joomla 6 Install from Web, the Install button of Pretty Weather
  6. Joomla shows the name of the extension and the address it is installed from. Confirm with the blue button Install (1).

    Joomla 6 Install from Web, confirming the installation
  7. The module is installed. The message "Installation of the module was successful." appears (1).

    Joomla 6 message: installation of the module was successful
  8. The Joomla Extensions Directory can offer an older version than GitHub. When this manual was written, Joomla installed version 1.0.0 this way. Then update the module with the manual Update Pretty Weather.
  9. You can now set up the module. See Configuration of Pretty Weather.

Configuration of Pretty Weather

These steps set up the module after you installed it with one of the manuals above. The example shows the temperature in Sittard with the weather provider Open-Meteo, which needs no API key, and an extra text when it is warmer than 25 degrees.

  1. Log in to the back-end (administrator) of Joomla with a Super User account. You usually find it at https://<yourdomain>/administrator/. Then click System in the menu on the left, as in steps 2 and 3 of the first manual.
  2. In the block Manage, click Site Modules (1).

    Joomla 6 System Dashboard, Manage, Site Modules
  3. The installation has added a module called Pretty Weather. It is not published yet and has no position. Click its title (1).

    Joomla 6 Site Modules with the new module Pretty Weather
  4. On the tab Module:
    • Change the Title (1), for example to The weather.
    • With Title on the right (2) you choose whether the title is shown on the website: Show or Hide.
    • Choose the Position (3) of your template where the module should appear. In this example with the Cassiopeia template: Sidebar-right [sidebar-right].
    • Set Status (4) to Published. A new module is always unpublished.


    Module Pretty Weather: title, position and status
  5. Click the tab Settings (1) and set where the weather data comes from:
    • Weather Information Provider (2): choose Open-Meteo.com if you do not want to request an API key. With OpenWeatherMap.org and OpenWeatherMap One Call API 4.0 the field Provider API Key appears, where you enter the key of your OpenWeatherMap account. The blue text above the field explains what each provider needs.
    • Units (3): Metric (Celsius), Imperial (Fahrenheit) or Standard (Kelvin).
    • Latitude (4) and Longitude (5): the coordinates of the location, for example 50.99833 and 5.86944 for Sittard. You find them by looking up the place in a map service.
    • Location name (optional) (6): the name for the placeholder {name}. Open-Meteo does not return a location name itself, so fill this in if you want to show the name.
    • Time between API calls (7): the minimum number of minutes before the module fetches the weather data again.
    • Debug (8): choose Yes to show the stored weather data and any error messages of the provider on the website. That output is only visible to users who may manage modules.


    Module Pretty Weather: tab Settings
  6. Click the tab Content (1). At the top you see the placeholders (2) you can use in your text: {temp} for the temperature, {feels_like} for the feels like temperature, {temp_min} and {temp_max} for the minimum and maximum temperature and {name} for the location name. At Default content (3), type the text that is always shown, for example: It is now {temp} °C in {name}. With the green plus button (4) at Conditional content you add a text that is only shown in certain weather.

    Module Pretty Weather: tab Content with the default content
  7. Fill in the conditional content:
    • Content (1): the text that is shown when the rules are met. You can use the placeholders here as well.
    • Type (2): the value the rule looks at: Temperature, Feels like, Minimum temperature or Maximum temperature.
    • Operator (3): the comparison, for example Greater than (>) or Less than or equal (<=).
    • Value (4): the number to compare with. Temperatures are rounded to whole degrees first.
    • With the green plus button (5) you add another rule. With more rules the text is only shown when all rules are met, for example greater than 15 and less than or equal to 25.
    To the right of the rules are the buttons to add another conditional content or to remove this one. In the example the text is shown when it is warmer than 25 degrees.

    Module Pretty Weather: conditional content with a rule
  8. Click the tab Menu Assignment (1) and choose at Module Assignment (2) on which pages the module is shown:
    • On all pages: on every page of the website.
    • No pages: on no page at all.
    • Only on the pages selected: only on the menu items you tick in the list (3).
    • On all pages except those selected: on every page, except the menu items you tick.


    Module Pretty Weather: tab Menu Assignment
  9. Click Save (1) to save and keep the module open, so you can check the result on your website and adjust it. Click Save & Close (2) when you are done.

    Module Pretty Weather: Save and Save & Close
  10. The result on the website (1). When this image was made it was cooler than 25 degrees, so the module only shows the default content.

    Pretty Weather on the website with the Cassiopeia template

You can find examples here: https://extensions.tlwebdesign.nl/en/pretty-weather

Assign or adjust module position / page view Pretty Weather

These steps move Pretty Weather to another module position or change the pages it is shown on.

  1. Log in to the back-end (administrator) of Joomla with a Super User account. You usually find it at https://<yourdomain>/administrator/. Then click System in the menu on the left, as in steps 2 and 3 of the first manual.
  2. In the block Manage, click Site Modules and then click the title of your Pretty Weather module. The column Type shows which modules are of the type Pretty Weather.

    Joomla 6 Site Modules with the module Pretty Weather
  3. On the tab Module, choose the new Position (3) on the right.

    Module Pretty Weather: title, position and status
  4. Click the tab Menu Assignment (1) and choose at Module Assignment (2) on which pages the module is shown. With "Only on the pages selected" and "On all pages except those selected" you tick the menu items in the list (3).

    Module Pretty Weather: tab Menu Assignment
  5. Click Save & Close and check on your website that the module is shown on the right pages.

Update Pretty Weather

When a new version is available, Joomla shows it in the back-end, just like updates of other extensions. Important: always make a backup of your website before updating!

  1. Log in to the back-end (administrator) of Joomla with a Super User account.
  2. On the Home Dashboard, in the block Notifications, click Updates are available! (1). You can also click System and then, in the block Update, Extensions.

    Joomla 6 Home Dashboard: updates are available
  3. Tick the box in front of Pretty Weather (1) and click Update (2). In this example the module goes from version 1.0.2 to 1.2.0.

    Joomla 6 Extensions: Update with Pretty Weather ticked
  4. The message "Updating module was successful." appears (1).

    Joomla 6 message: updating module was successful
  5. Check on your website that Pretty Weather still works properly.

Uninstall Pretty Weather

If you no longer want to use Pretty Weather, you can uninstall it. All Pretty Weather modules you made are removed as well.

  1. Log in to the back-end (administrator) of Joomla with a Super User account. You usually find it at https://<yourdomain>/administrator/. Then click System in the menu on the left, as in steps 2 and 3 of the first manual.
  2. In the block Manage, click Extensions (1).

    Joomla 6 System Dashboard, Manage, Extensions
  3. Type Pretty Weather in the search field (1) and click the magnifying glass (2).

    Joomla 6 Extensions: Manage, searching for Pretty Weather
  4. Tick the box in front of Pretty Weather (1), click Actions (2) and then Uninstall (3).

    Joomla 6 Extensions: Manage, Actions, Uninstall
  5. Joomla asks whether you are sure. Click Yes (1).

    Joomla 6 warning: are you sure you want to uninstall
  6. The extension is removed. A message confirms that uninstalling the module was successful (1).

    Joomla 6 message: uninstalling the module was successful


If you run into a problem, let us know with the button below. This is the only way we can improve this extension.

Report problem

If you are satisfied, please leave a review on the Joomla Extensions Directory: https://extensions.joomla.org/extension/pretty-weather/

Thanks in advance!