Joomla CMS Installeren en Configureren in de ServBay-omgeving op macOS

Overzicht

In deze handleiding leer je stap voor stap hoe je het Joomla Content Management System (CMS) installeert en configureert binnen ServBay, een krachtig lokaal webontwikkelplatform. ServBay biedt een geïntegreerde en gebruiksvriendelijke omgeving voor technologieën als PHP en MySQL, ideaal voor het bouwen en testen van Joomla-websites. Met ServBay beheer je eenvoudig verschillende PHP-versies, databases en webservers (Caddy of Nginx), en leg je een flexibele en efficiënte basis voor Joomla-ontwikkeling.

Wat is Joomla?

Joomla is een veelgebruikt, open-source content management systeem (CMS) dat is geschreven in PHP en doorgaans gebruikmaakt van een MySQL-database. Het biedt een uitgebreide functionaliteit en is zeer uitbreidbaar, geschikt voor zowel persoonlijke blogs, kleine zakelijke sites als grote ondernemingsportalen en e-commerceplatformen. Dankzij de grote community en het grote aanbod aan extensies en sjablonen, kunnen websites efficiënt worden ontwikkeld, beheerd en onderhouden.

Toepassingsscenario’s

• Joomla-websites lokaal ontwikkelen, testen en debuggen binnen ServBay.
• Leren en ontdekken van Joomla-functionaliteiten en het bouwen van extensies.
• Offline Joomla-projecten uitvoeren.
• Joomla-configuraties voorbereiden voor toekomstige productieomgevingen.

Vereisten

Zorg ervoor dat je aan de volgende voorwaarden voldoet voordat je met de installatie van Joomla begint:

1. ServBay geïnstalleerd en actief: Zorg dat ServBay met succes is geïnstalleerd en gestart op je macOS-systeem. ServBay voorziet in alle benodigde componenten zoals PHP, een webserver (Caddy of Nginx) en een database (MySQL of MariaDB).
2. Basiskennis van het werken met de commandoregel: Tijdens het installatieproces zul je enkele eenvoudige commando’s in de terminal moeten uitvoeren.
3. Internetverbinding: Een actieve verbinding is nodig om het Joomla-installatiepakket te downloaden.

Stappen voor het installeren van Joomla

Volg onderstaande stappen om Joomla te installeren en te configureren in je ServBay-omgeving.

Stap 1: Download Joomla

Ga eerst naar de door ServBay aanbevolen webrootmap: /Applications/ServBay/www. Dit is de centrale locatie voor al je lokale webprojecten. Maak in deze map een nieuwe projectdirectory aan voor je Joomla-site en download het Joomla-installatiepakket.

# Navigeer naar de webrootmap van ServBay
cd /Applications/ServBay/www

# Maak een nieuwe projectdirectory, bijvoorbeeld servbay-joomla-app
mkdir servbay-joomla-app

# Ga naar de zojuist aangemaakte directory
cd servbay-joomla-app

# Download het Joomla-installatiepakket
# Let op: de onderstaande link verwijst mogelijk naar een oudere Joomla 3-versie.
# Bezoek bij voorkeur de Joomla-website (https://downloads.joomla.org/) voor de nieuwste stabiele downloadlink.
curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip

Let op: curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip kan verwijzen naar de laatste stabiele versie van Joomla 3. Joomla brengt regelmatig nieuwe versies uit (zoals Joomla 4 of 5). Voor de nieuwste functies en beveiligingsupdates raadpleeg altijd de officiële Joomla downloadpagina, kopieer de nieuwste stabiele link en vervang de URL in het bovenstaande commando.

Stap 2: Pak Joomla uit

Pak het zojuist gedownloade Joomla-archief uit in de huidige servbay-joomla-app map en verwijder daarna het zipbestand voor een opgeruimde projectmap.

# Pak het Joomla-archief uit
unzip joomla.zip

# Verwijder het zipbestand
rm joomla.zip

Na het uitpakken vind je alle installatiebestanden van Joomla in de directory servbay-joomla-app.

Stap 3: Maak database en gebruiker aan

Joomla heeft een database nodig om content, instellingen en gebruikersgegevens op te slaan. We gebruiken phpMyAdmin, dat standaard via ServBay wordt geleverd, om de database en gebruiker aan te maken.

1. Open het ServBay Controlepaneel

   Open je browser en ga naar het lokale controlepaneel van ServBay via: https://servbay.host/. Dit is het handige toegangspunt van ServBay om onder andere phpMyAdmin en phpinfo te bereiken.

2. Log in op phpMyAdmin

   Klik op de link "phpMyAdmin" op de beginpagina van het ServBay controlepaneel om naar de databasebeheer-interface te gaan.

3. Databasegebruiker aanmaken

   Het is veilig om voor elke applicatie een aparte databasegebruiker te maken.

   1. Navigeer naar gebruikersaccounts

      Klik in de menubalk bovenaan phpMyAdmin op "Gebruikersaccounts".

   2. Nieuwe gebruikersaccount toevoegen

      Klik op "Voeg gebruikersaccount toe" en vul het volgende in:

      • Gebruikersnaam: Geef een gewenste gebruikersnaam op, bijvoorbeeld servbay_joomla_user.
      • Hostnaam: Kies localhost. Dit betekent dat de gebruiker alleen lokaal verbinding mag maken, wat veiliger is.
      • Wachtwoord: Voer een sterk wachtwoord in. Zorg dat je dit wachtwoord veilig bewaart. Bijvoorbeeld password123 (vervang dit in de praktijk door een sterker wachtwoord).
      • Herhaal wachtwoord: Voer het wachtwoord ter bevestiging opnieuw in.
      • Database voor gebruiker aanmaken: Vink "Maak een database met dezelfde naam en verleen alle rechten" aan. Hiermee maak je automatisch een database aan met dezelfde naam als de gebruiker (bijvoorbeeld servbay_joomla_user) waartoe deze gebruiker alle rechten krijgt.
      • Globale rechten: Vink deze niet aan. De gebruiker hoeft uitsluitend deze nieuwe database te beheren.

   3. Creëer de gebruiker

      Controleer je gegevens en klik onderaan op "Start" om de gebruiker en database aan te maken.

Stap 4: Configureer de webserver (voeg website toe)

Nu kun je ServBay vertellen welke domeinnaam naar de Joomla-bestanden moet verwijzen. Dat doe je door in ServBay een nieuwe "website" aan te maken.

1. Open de ServBay-applicatie

   Start of gebruik het hoofdvenster van de ServBay-app.

2. Ga naar websitebeheer

   Klik in de linkerzijbalk van de ServBay-app op "Websites".

3. Voeg een nieuwe website toe

   Klik rechtsboven op de knop "Toevoegen".

   • Naam (Name): Geef de website een naam om deze makkelijk te herkennen, bijvoorbeeld My ServBay Joomla Site.
   • Domein (Domain): Vul het gewenste lokale domein in, zoals servbay-joomla.local. ServBay regelt automatisch de lokale DNS-instelling, zodat dit domein verwijst naar je lokale omgeving.
   • Websitetype (Site Type): Kies PHP.
   • PHP-versie (PHP Version): Selecteer een bij Joomla compatibele PHP-versie. Controleer op de Joomla-site welke PHP-versie jouw versie van Joomla vereist en aanbevolen wordt.
   • Website root (Site Root): Klik op het mapicoon en selecteer de directory die je eerder hebt aangemaakt, bijvoorbeeld /Applications/ServBay/www/servbay-joomla-app.

4. Configuratie opslaan

   Vul alle gegevens in en klik onderaan op "Opslaan". ServBay past de nieuwe websiteconfiguratie toe, wat kan betekenen dat bepaalde services (zoals Caddy of Nginx) kort worden herstart.

Stap 5: Start de Joomla-installatie

Je kunt Joomla nu via je gekochte lokale domeinnaam in de browser openen en installeren.

1. Bezoek de installatiewizard

   Open je webbrowser en ga naar het eerder ingestelde domein, bijvoorbeeld https://servbay-joomla.local/. De ServBay-webserver verwijst deze aanvraag automatisch naar de door jou gekozen projectmap. Joomla herkent meestal automatisch een eerste bezoeker en leidt je om naar de installatiewizard (gewoonlijk op /installation/index.php). Gebeurt dat niet automatisch, ga dan handmatig naar https://servbay-joomla.local/installation/index.php.

2. Volg de installatiewizard

   Je ziet nu de grafische installatiewizard van Joomla. Volg de aanwijzingen op het scherm:

   • Configuratie: Vul de basisinformatie in, zoals sitenaam, beschrijving en adminaccount (gebruikersnaam, wachtwoord, e-mailadres). Kies altijd een veilig wachtwoord en gebruikersnaam.
   • Database: Vul de gegevens in van de database die je in stap 3 hebt aangemaakt:
     • Database Type: Meestal kies je MySQLi.
     • Host Name: Gebruik localhost.
     • Username: Je databasegebruikersnaam, bijvoorbeeld servbay_joomla_user.
     • Password: Het wachtwoord van deze gebruiker, bijvoorbeeld password123.
     • Database Name: De naam van de database, bijvoorbeeld servbay_joomla_user.
     • Table Prefix: Laat staan wat automatisch wordt ingevuld of kies een eigen prefix, bijvoorbeeld jos_.
     • Actie voor bestaande database: Bij een schone installatie maakt het niet uit of je "Backup" of "Verwijder" kiest; bij een lege database maakt deze keuze geen verschil.
   • Afronding (Finalisatie): Controleer alle gegevens. Joomla checkt automatisch of je ServBay-omgeving voldoet. Klik op "Installeren" als alles goedstaat.

3. Installatie afronden en installatiemap verwijderen

   Het installatieproces kan enkele minuten duren. Na succesvolle installatie krijg je een melding dat Joomla geïnstalleerd is. Het is heel belangrijk om vervolgens de map installation te verwijderen om te voorkomen dat de installatiewizard nogmaals kan worden uitgevoerd. Vaak biedt Joomla een knop om deze map direct te verwijderen.

   Je kunt het ook handmatig via de terminal doen:

   # Ga naar je Joomla-projectmap
   cd /Applications/ServBay/www/servbay-joomla-app
   
   # Verwijder de installation-directory
   rm -rf installation

   Na het verwijderen van de installation-directory kun je je Joomla-site normaal bezoeken. Je kunt ervoor kiezen om de ‘site’ (voorkant) of ‘administrator’ (backend) te openen.

Stap 6: Ontdek het Joomla-beheer

Bezoek je domein gevolgd door /administrator, bijvoorbeeld https://servbay-joomla.local/administrator, en log in met de admin-inloggegevens die je tijdens de installatie hebt ingesteld. Vanaf hier kun je de site verder configureren, extensies en sjablonen installeren en content aanmaken.

Basisstappen voor het bouwen van een website met Joomla

Na een geslaagde installatie kun je direct gebruik maken van Joomla's uitgebreide mogelijkheden voor het bouwen van een site. Enkele eerste stappen:

• Artikelen en categorieën aanmaken: Beheer artikelen en categorieën onder het menu 'Inhoud' (Content).
• Menu’s beheren: Maak en bewerk navigatiemenu’s onder het menu 'Menu’s'.
• Modules configureren: Beheer functionele blokken als sidebars en footers via 'Extensies' -> 'Modules'.
• Sjablonen kiezen en aanpassen: Pas de uitstraling van je site aan via 'Extensies' -> 'Sjablonen'.
• Extensies installeren: Breid Joomla uit via 'Extensies' -> 'Beheren', waar je extra componenten, modules, plugins en sjablonen kunt installeren.

Belangrijke aandachtspunten

• Beveiliging: Gebruik altijd sterke wachtwoorden voor je Joomla-beheerder en databasegebruikers. Verwijder meteen na installatie de installation-map.
• Compatibiliteit PHP-versie: Zorg dat de gekozen PHP-versie binnen ServBay past bij jouw Joomla-versie. Raadpleeg de documentatie van Joomla voor compatibiliteit.
• Databaseconnectie: Vul tijdens de installatie nauwkeurig de databasegegevens (hostnaam localhost, gebruikersnaam, wachtwoord en databasenaam) in.
• ServBay-updates: Houd ServBay up-to-date voor de nieuwste functies, patches en verbeteringen.
• Back-ups: ServBay ondersteunt zowel handmatige als automatische back-ups van je websitebestanden, databases, SSL-certificaten en instellingen. Maak regelmatig back-ups voordat je grote aanpassingen doet, dit voorkomt dataverlies. Je vindt deze opties in de back-upinstellingen van de ServBay-app.

Veelgestelde Vragen (FAQ)

• Vraag: Krijg je een “Site niet bereikbaar” of 404-fout als je het lokale domein bezoekt?Antwoord: Controleer het volgende:

  1. ServBay draait op je systeem.
  2. In de website-lijst van ServBay staat je Joomla-site ingeschakeld.
  3. De website root verwijst correct naar /Applications/ServBay/www/servbay-joomla-app.
  4. Het domein dat je bezoekt (servbay-joomla.local) komt overeen met het domein dat in ServBay geconfigureerd is.

• Vraag: Krijg je een databasefout tijdens de Joomla-installatie?Antwoord: Dit duidt meestal op foutieve databasegegevens. Controleer:

  1. Dat je als hostnaam localhost hebt ingevuld in het installatieformulier.
  2. Of de gebruikersnaam (servbay_joomla_user) en het wachtwoord (password123) exact overeenkomen met wat je in phpMyAdmin hebt aangemaakt.
  3. Dat de opgegeven databasenaam (servbay_joomla_user) klopt.
  4. Of de databaseservice (MySQL/MariaDB) binnen ServBay actief is.

• Vraag: Ben je het MySQL root-wachtwoord van ServBay vergeten?Antwoord: In ServBay kun je eenvoudig het root-wachtwoord van MySQL of MariaDB resetten via de beheertools in de app.

• Vraag: Krijg je na installatie foutmeldingen of een blanco pagina?Antwoord: Verzeker je ervan dat je de installation-directory hebt verwijderd. Controleer de Joomla- of PHP-foutlogboeken (te raadplegen of in te stellen via ServBay onder ‘error_reporting’ en ‘display_errors’) voor meer details. Controleer ook of de PHP-versie voldoet aan de eisen van Joomla.

Samenvatting

Het installeren en configureren van Joomla CMS op macOS met ServBay is eenvoudig en efficiënt. Door het voorgeconfigureerde lokale ontwikkelplatform van ServBay met geïntegreerde webserver, database en PHP wordt Joomla-installatie en -beheer sterk vereenvoudigd. Volg de stappen uit deze handleiding om snel een lokale Joomla-ontwikkelomgeving op te zetten en begin direct aan je volgende webproject. Vergeet niet ServBay en Joomla actueel te houden en pas de beste beveiligingspraktijken toe.