Pretty Weather handleiding - TLWebdesign Extensions

Hieronder vind je de volgende handleidingen voor "Pretty Weather":

Installatie Pretty Weather via de download
Installatie Pretty Weather via Installeren vanaf web
Configuratie van Pretty Weather
Toekennen of aanpassen module positie / paginaweergave Pretty Weather
Updaten van Pretty Weather
Verwijderen Pretty Weather

Ter informatie:

De handleidingen zijn geschreven met Joomla 6.1 en Pretty Weather 1.2.0. Pretty Weather 1.2.0 heeft Joomla 5.2 of nieuwer nodig. In Joomla 5 kunnen sommige schermen er iets anders uitzien.
De rode cijfers in de afbeeldingen horen bij de cijfers tussen haakjes in de stappen.
Klik op een afbeelding om deze te vergroten. De afbeelding opent in een pop-upvenster; klik naast het venster om terug te gaan naar dit artikel.
Let op: de moduleposities hangen af van je Joomla-template en kunnen dus anders zijn. Meer informatie: https://docs.joomla.org/Finding_module_positions_on_any_given_page/nl

Installatie Pretty Weather via de download

Met deze stappen download je Pretty Weather en installeer je de module in Joomla door het bestand te uploaden.

Download de module Pretty Weather van GitHub (gratis en zonder account):

Download Pretty Weather

Klik onder Assets op het zipbestand mod_prettyweather-1.2.0.zip (1). Bij een nieuwere versie staat er een hoger versienummer in de naam. Het bestand wordt gedownload. Pak het zipbestand niet uit en onthoud waar je het hebt opgeslagen.
Open de back-end (het beheergedeelte) van Joomla, meestal op https://<jouwdomein>/administrator/. Vul de Gebruikersnaam (1) en het Wachtwoord (2) van een Super User-account in en klik op Inloggen (3).
Klik links in het menu op Systeem (1).
Klik in het blok Installeren op Extensies (1).
Het tabblad Upload pakketbestand (1) staat open. Sleep het zipbestand naar het kader (2), of klik op de groene knop Of blader naar het bestand (3), selecteer het bestand en klik op Openen.
De module wordt direct geïnstalleerd. De melding "Installeren module is geslaagd" verschijnt (1).
Je kunt de module nu instellen. Zie Configuratie van Pretty Weather.

Installatie Pretty Weather via Installeren vanaf web

Met deze stappen installeer je Pretty Weather rechtstreeks vanuit de Joomla Extensions Directory, zonder een bestand te downloaden. Het tabblad Installeren vanaf web komt van de plugin Installer - Install from Web. Zie je het tabblad niet, klik dan op Systeem, daarna op Plugins, zoek op "Install from Web" en schakel de plugin in.

Log in op de back-end (het beheergedeelte) van Joomla met een Super User-account. Meestal vind je die op https://<jouwdomein>/administrator/. Klik daarna links in het menu op Systeem, zoals in stap 2 en 3 van de eerste handleiding.
Klik in het blok Installeren op Extensies (1).
Klik op het tabblad Installeren vanaf web (1). Typ Pretty Weather in het zoekveld (2) en klik op het vergrootglas (3).
Klik in de resultaten op Pretty Weather (1).
Klik op de groene knop Install (1).
Joomla toont de naam van de extensie en het adres waarvan deze wordt geïnstalleerd. Bevestig met de blauwe knop (1).
De module is geïnstalleerd. De melding "Installeren module is geslaagd" verschijnt (1).
De Joomla Extensions Directory kan een oudere versie aanbieden dan GitHub. Toen deze handleiding werd geschreven installeerde Joomla zo versie 1.0.0. Werk de module daarna bij met de handleiding Updaten van Pretty Weather.
Je kunt de module nu instellen. Zie Configuratie van Pretty Weather.

Configuratie van Pretty Weather

Met deze stappen stel je de module in nadat je deze met een van de handleidingen hierboven hebt geïnstalleerd. In het voorbeeld tonen we de temperatuur in Sittard met de weerprovider Open-Meteo, waarvoor geen API-sleutel nodig is, en een extra tekst als het warmer is dan 25 graden.

Log in op de back-end (het beheergedeelte) van Joomla met een Super User-account. Meestal vind je die op https://<jouwdomein>/administrator/. Klik daarna links in het menu op Systeem, zoals in stap 2 en 3 van de eerste handleiding.
Klik in het blok Beheren op Website modules (1).
Bij de installatie is een module met de naam Pretty Weather toegevoegd. Deze is nog niet gepubliceerd en heeft nog geen positie. Klik op de titel (1).
Op het tabblad Module:
- Pas de Titel (1) aan, bijvoorbeeld naar Het weer.
- Met Titel aan de rechterkant (2) kies je of de titel op de website wordt getoond: Toon of Verberg.
- Kies de Positie (3) van je template waar de module moet komen. In dit voorbeeld met het template Cassiopeia: Sidebar-rechts [sidebar-right].
- Zet Status (4) op Gepubliceerd. Een nieuwe module is altijd gedepubliceerd.
Klik op het tabblad Instellingen (1) en stel in waar de weergegevens vandaan komen:
- Weerinformatie Provider (2): kies Open-Meteo.com als je geen API-sleutel wilt aanvragen. Bij OpenWeatherMap.org en OpenWeatherMap One Call API 4.0 verschijnt het veld Provider API Key, waarin je de sleutel van je OpenWeatherMap-account invult. De blauwe tekst boven het veld legt per provider uit wat je nodig hebt.
- Eenheden (3): Metrisch (Celsius), Imperiaal (Fahrenheit) of Standaard (Kelvin).
- Breedtegraad (4) en Lengtegraad (5): de coördinaten van de locatie, bijvoorbeeld 50.99833 en 5.86944 voor Sittard. Je vindt ze door de plaats op te zoeken in een kaartendienst.
- Locatienaam (optioneel) (6): de naam voor de plaatshouder {name}. Open-Meteo geeft zelf geen locatienaam terug, dus vul dit veld in als je de naam wilt tonen.
- Tijd tussen API calls (7): het minimale aantal minuten voordat de module de weergegevens opnieuw ophaalt.
- Debug (8): kies Ja om op de website de opgeslagen weergegevens en eventuele foutmeldingen van de provider te tonen. Die uitvoer is alleen zichtbaar voor gebruikers die modules mogen beheren.
Klik op het tabblad Inhoud (1). Bovenaan staan de plaatshouders (2) die je in je tekst kunt gebruiken: {temp} voor de temperatuur, {feels_like} voor de gevoelstemperatuur, {temp_min} en {temp_max} voor de minimum- en maximumtemperatuur en {name} voor de locatienaam. Typ bij Standaardinhoud (3) de tekst die altijd wordt getoond, bijvoorbeeld: Het is nu {temp} °C in {name}. Met de groene plusknop (4) bij Voorwaardelijke inhoud voeg je een tekst toe die alleen bij bepaald weer wordt getoond.
Vul de voorwaardelijke inhoud in:
- Inhoud (1): de tekst die wordt getoond als aan de regels is voldaan. Ook hier kun je de plaatshouders gebruiken.
- Type (2): de waarde waar de regel naar kijkt: Temperatuur, Gevoelstemperatuur, Minimale temperatuur of Maximale temperatuur.
- Operator (3): de vergelijking, bijvoorbeeld Groter dan (>) of Kleiner dan of gelijk (<=).
- Waarde (4): het getal waarmee wordt vergeleken. Temperaturen worden eerst afgerond op hele graden.
- Met de groene plusknop (5) voeg je nog een regel toe. Bij meer regels wordt de tekst alleen getoond als aan alle regels is voldaan, bijvoorbeeld groter dan 15 en kleiner dan of gelijk aan 25.
Rechts naast de regels staan de knoppen om nog een voorwaardelijke inhoud toe te voegen of deze te verwijderen. In het voorbeeld wordt de tekst getoond als het warmer is dan 25 graden.
Klik op het tabblad Menutoewijzing (1) en kies bij Moduletoewijzing (2) op welke pagina's de module wordt getoond:
- Op alle pagina's: op elke pagina van de website.
- Geen pagina's: op geen enkele pagina.
- Alleen op de geselecteerde pagina's: alleen op de menu-items die je in de lijst (3) aanvinkt.
- Op alle pagina's behalve de geselecteerde: op elke pagina, behalve op de menu-items die je aanvinkt.
Klik op Opslaan (1) om op te slaan en de module open te houden, zodat je het resultaat op je website kunt bekijken en nog kunt aanpassen. Klik op Opslaan & sluiten (2) als je klaar bent.
Het resultaat op de website (1). Toen deze afbeelding werd gemaakt was het kouder dan 25 graden, dus de module toont alleen de standaardinhoud.

Voorbeelden vind je hier: https://extensions.tlwebdesign.nl/pretty-weather

Toekennen of aanpassen module positie / paginaweergave Pretty Weather

Met deze stappen zet je Pretty Weather op een andere modulepositie of verander je op welke pagina's de module wordt getoond.

Log in op de back-end (het beheergedeelte) van Joomla met een Super User-account. Meestal vind je die op https://<jouwdomein>/administrator/. Klik daarna links in het menu op Systeem, zoals in stap 2 en 3 van de eerste handleiding.
Klik in het blok Beheren op Website modules en klik daarna op de titel van je Pretty Weather-module. In de kolom Type zie je welke modules van het type Pretty Weather zijn.
Kies op het tabblad Module aan de rechterkant de nieuwe Positie (3).
Klik op het tabblad Menutoewijzing (1) en kies bij Moduletoewijzing (2) op welke pagina's de module wordt getoond. Bij "Alleen op de geselecteerde pagina's" en "Op alle pagina's behalve de geselecteerde" vink je de menu-items aan in de lijst (3).
Klik op Opslaan & sluiten en controleer op je website of de module op de juiste pagina's staat.

Updaten van Pretty Weather

Als er een nieuwe versie is, toont Joomla dat in de back-end, net als bij updates van andere extensies. Belangrijk: maak altijd een back-up van je website voordat je gaat updaten!

Log in op de back-end (het beheergedeelte) van Joomla met een Super User-account.
Klik op het controlepaneel in het blok Notifications op Er zijn updates beschikbaar! (1). Je kunt ook op Systeem klikken en daarna in het blok Update op Extensies.
Vink het vakje voor Pretty Weather aan (1) en klik op Update (2). In dit voorbeeld gaat de module van versie 1.0.2 naar 1.2.0.
De melding "Updaten module is geslaagd" verschijnt (1).
Controleer op je website of Pretty Weather nog goed werkt.

Verwijderen Pretty Weather

Als je Pretty Weather niet meer wilt gebruiken, kun je de extensie de-installeren. Alle Pretty Weather-modules die je hebt gemaakt worden dan ook verwijderd.

Log in op de back-end (het beheergedeelte) van Joomla met een Super User-account. Meestal vind je die op https://<jouwdomein>/administrator/. Klik daarna links in het menu op Systeem, zoals in stap 2 en 3 van de eerste handleiding.
Klik in het blok Beheren op Extensies (1).
Typ Pretty Weather in het zoekveld (1) en klik op het vergrootglas (2).
Vink het vakje voor Pretty Weather aan (1), klik op Acties (2) en daarna op Deïnstalleren (3).
Joomla vraagt of je het zeker weet. Klik op Ja (1).
De extensie is verwijderd. Een melding bevestigt dat het de-installeren van de module is gelukt (1).