GitHub-implementaties gebruiken op WordPress.com

GitHub-implementaties integreert je GitHub-repository’s rechtstreeks met je WordPress.com-site, waardoor je een versiegestuurde, geautomatiseerde workflow krijgt voor het implementeren van plugins, thema’s of volledige sitewijzigingen. Deze handleiding beschrijft het configuratieproces en hoe je je gekoppelde repository’s beheert.

Deze functie is beschikbaar op sites met een Business- en Commerce-abonnement van WordPress.com. Als je een Business-abonnement hebt, moet je deze activeren. Voor gratis sites of sites met Personal- en Premium-abonnementen moet je je abonnement upgraden om toegang te krijgen tot deze functie.

Deze video is in het Engels.
YouTube biedt automatische vertaalfuncties zodat je de video in je eigen taal kunt bekijken:

Automatisch vertaalde ondertitels inschakelen:

1. Speel de video af.
2. Klik op het ⚙️ Instellingen-pictogram (rechtsonder in het videoscherm).
3. Selecteer Ondertiteling/CC.
4. Kies Automatisch vertalen.
5. Selecteer je voorkeurstaal.

Automatische nasynchronisatie (experimenteel) gebruiken:

1. Klik op ⚙️ Instellingen.
2. Selecteer Audiotrack.
3. Kies de taal waarin je wilt luisteren.

ℹ️ Vertalingen en nasynchronisaties worden automatisch gegenereerd door Google, kunnen onjuistheden bevatten en de automatische nasynchronisatie is nog in testfase, dus niet in alle talen beschikbaar.

Voordat je een GitHub-repository kan implementeren op je WordPress.com-site, moet je eerst de verbinding tussen de twee instellen met behulp van de volgende stappen:

1. Bezoek de pagina Sites: https://wordpress.com/sites/
2. Klik op de naam van je site om het siteoverzicht te bekijken.
3. Klik op het tabblad Implementaties.
4. Klik op de knop ‘Repository koppelen‘. Als je vervolgens repository’s ziet vermeld, heb je al je GitHub-account gekoppeld. Ga door aan naar stap 11.
5. Klik op de knop ‘De WordPress.com-app installeren‘.
6. Er wordt een nieuw venster geopend en je wordt gevraagd in te loggen op je GitHub-account als je dit nog niet hebt gedaan. Dan zie je dit scherm:

7. Klik op de knop ‘WordPress.com autoriseren voor ontwikkelaars‘.
8. Selecteer de GitHub-organisatie of het account waar je repository zich bevindt.
9. Selecteer welke repository/repository’s je wilt koppelen:
   • Alle repository’s: als je deze optie selecteert, krijgt WordPress.com toegang tot alle huidige en toekomstige repository’s die eigendom zijn van het geselecteerde GitHub-account. Dit is inclusief openbare repository’s die alleen-lezen zijn.
   • Alleen repository’s selecteren: als je deze optie selecteert, kun je kiezen welke repository’s WordPress.com kan openen op het geselecteerde GitHub-account. 
10. Zodra je een optie hebt geselecteerd, klik je op de knop Installeren.
11. Het nieuwe venster wordt gesloten en je wordt teruggeleid naar WordPress.com. Je geselecteerde repository/repository’s moeten worden vermeld samen met het GitHub-account dat aan die repository is gekoppeld:

12. Klik op Selecteren naast de repository die je wilt koppelen.

Op dit punt zou je WordPress.com voor ontwikkelaars moeten zien onder je geautoriseerde GitHub-apps en geïnstalleerde GitHub-apps.

Zodra je een repository selecteert, moet je de implementatie-instellingen aanpassen:

• Implementatie-branch: wordt standaard ingesteld op de standaard-branch van de repository (meestal main), maar kan worden gewijzigd naar de branch die je wilt gebruiken.
• Doelmap: de servermap waar je de bestanden wilt implementeren. Voor plugins is het /wp-content/plugins/my-plugin-name. Voor thema’s is het /wp-content/themes/my-theme-name. Voor een gedeeltelijke site-implementatie (d.w.z. meerdere plugins of thema’s), kan je /wp-content gebruiken. De inhoud van een repository wordt samengevoegd met de bestaande inhoud van de WordPress-site in de gespecificeerde map.
• Automatische implementaties: er zijn twee manieren waarop je kan implementeren op WordPress.com:
  • Automatisch: zodra de code is vastgelegd, wordt deze geïmplementeerd op je WordPress.com-site. Automatische implementaties worden aanbevolen voor testsites.
  • Handmatig: de code wordt geïmplementeerd zodra je een implementatie aanvraagt. Handmatige implementaties worden aanbevolen voor productiesites.
• Implementatiemodus: er zijn twee soorten implementaties:
  • Simpel: deze modus kopieert alle bestanden van een tak van de repository naar de site en implementeert ze zonder nabewerking.
  • Geavanceerd: in deze modus kun je een workflowscript gebruiken dat aangepaste bouwstappen inschakelt, zoals het installeren van Opstel-afhankelijkhede, het uitvoeren van codetests voorafgaand aan de implementatie en het beheren van bestandsimplementatie. Ideaal voor repository’s die Opstel- of Node-software nodig hebben. Zie Geavanceerde implementatie hieronder voor meer informatie.

Klik op de knop Koppelen zodra alle instellingen zijn geconfigureerd. Je repository wordt toegevoegd:

Let op: je moet de eerste implementatie activeren, automatisch of handmatig. Je kan dan op elk moment koppelen aan een andere repository door op de knop ‘Repository koppelen‘ te klikken.

Met Geavanceerde implementatie kan je een workflowscript leveren om bestanden in je repository te verwerken voordat je ze implementeert. Dit opent vele mogelijkheden, zoals het controleren van je code om er zeker van te zijn dat deze voldoet aan de coderingsnormen van je team, het uitvoeren van unit-tests, het uitsluiten van bestanden van de implementatie, het installeren van afhankelijkheden en nog veel meer. Bekijk onze workflowrecepten om aan de slag te gaan.

Geavanceerde implementatie instellen:

1. Er verschijnt een formulier waarop je de implementatie kunt configureren.
2. Klik op de naam van de repository om de verbinding te beheren.
3. Aan de rechterkant, onder ‘Je implementatiemodus kiezen‘, kies je Geavanceerd.

4. Als de repository al een workflowbestand bevat, kan je dat hier selecteren. Het systeem controleert het bestand op eventuele fouten. Als er geen fouten worden gevonden, ga dan verder naar stap 7.
5. Je kunt ook de optie ‘Nieuwe workflow maken‘ selecteren om een vooraf geconfigureerd workflowbestand toe te voegen. Als je voor deze optie kiest, wordt het workflowbestand wpcom.yml overschreven als het al in je repository bestaat.
6. Klik op de knop ‘Installeer workflow voor mij‘ om het workflowbestand toe te voegen aan de repository.
7. Zodra een workflow is toegevoegd en geverifieerd, klik op Bijwerken. Je repository maakt nu gebruik van geavanceerde implementatie.

Nadat je je GitHub-repository hebt gekoppeld aan een site, is de volgende stap eigenlijk het implementeren van je code. Er zijn twee implementatiemethoden beschikbaar: automatisch en handmatig.

Automatische implementaties worden niet aanbevolen voor live productiesites, omdat alle codewijzigingen in de repository automatisch worden geïmplementeerd van GitHub naar de live site. Overweeg in plaats daarvan om een automatische implementatie in te stellen voor een testsite en deze te synchroniseren met de productie zodra je er klaar voor bent.

Handmatige implementaties geven je meer controle over wanneer je codewijzigingen live worden gepusht, omdat je elke implementatie handmatig moet activeren. We raden handmatige implementaties aan als je geen testsite wilt gebruiken.

Handmatig een implementatie activeren:

1. Bezoek de pagina Sites: https://wordpress.com/sites/
2. Klik op de naam van je site om het siteoverzicht te bekijken.
3. Klik op het tabblad Implementaties.
4. Klik op het menu met drie punten (⋮) in de repository die je wilt implementeren.
5. Kies ‘Handmatige implementatie activeren‘. Je zou een bannermelding moeten zien met de tekst ‘Implementatie-uitvoering gemaakt’, en de implementatiestatus zal veranderen naar ‘In wachtrij geplaatst’.
6. Wacht tot de implementatie is voltooid (de status wordt gewijzigd naar ‘Geïmplementeerd’).

7. Klik nogmaals op het menu met drie punten (⋮) en kies ‘Implementatie-uitvoeringen bekijken‘. 
8. Het logboeken met uitgevoerde implementaties geeft de auteur en de geïmplementeerde commit weer. Als je op het item Implementatie uitvoeren klikt, kan je meer informatie bekijken.

Je bestaande koppelingen van GitHub-repository’s beheren:

1. Bezoek de pagina Sites: https://wordpress.com/sites/
2. Klik op de naam van je site om het siteoverzicht te bekijken.
3. Klik op het tabblad Implementaties.
4. Je zou dan de lijst met koppelingen moeten zien. 

De lijst met verbindingen wordt weergegeven als er ten minste één koppeling is tussen een GitHub-repository en je site. De lijst bevat relevante informatie voor elke koppeling, zoals de naam en branch van de repository, de laatste commit die is geïmplementeerd op een site, wanneer deze is uitgevoerd, waar de code is geplaatst, hoelang de implementatie heeft geduurd en de status ervan.

Er zijn aanvullende acties beschikbaar nadat je op het menu met drie punten (⋮) hebt geklikt:

• Handmatige implementatie activeren: start een implementatie op de laatste commit van de geconfigureerde branch.
• Implementatie-uitvoeringen bekijken: opent de weergave van het logboeken met uitgevoerde implementaties voor de gekoppelde repository.
• Koppeling configureren: opent de weergave Verbinding beheren voor de repository.
• Repository loskoppelen: verwijdert de verbinding tussen de repository en de site.

Logboeken met uitgevoerde implementaties bieden een gedetailleerd, stapsgewijs overzicht van elke implementatie, ongeacht of deze automatisch of handmatig wordt geactiveerd. Deze logboeken helpen je wijzigingen bij te houden, de implementatiestatus te bewaken en eventuele problemen op te lossen. Met toegang tot logboeken van de laatste 10 uitvoeringen binnen 30 dagen, kan je eenvoudig bekijken wat er tijdens elke implementatie is gebeurd en ervoor zorgen dat alles soepel verloopt.

Logboeken van een implementatie controleren:

1. Bezoek de pagina Sites: https://wordpress.com/sites/
2. Klik op de naam van je site om het siteoverzicht te bekijken.
3. Klik op het tabblad Implementaties.
4. Klik op het menu met drie punten (⋮) naast de repository waarvoor je de logboeken wilt bekijken.
5. Selecteer ‘Implementatie-uitvoeringen bekijken‘.
6. In de lijstweergave Implementatie-uitvoeringen worden afspraken weergegeven die zijn geïmplementeerd op de site, de implementatiestatus, de datum en de duur.
7. Klik waar je ook bent tijdens een uitvoering om de weergave uit te klappen en meer informatie over de implementatie te bekijken.

De logboeken bieden een record van alle uitgevoerde opdrachten, van het ophalen van code van GitHub tot het plaatsen in de doelmap. Je kunt de logregels uitvouwen om meer informatie te zien door op ‘Meer weergeven‘ te klikken.

Wanneer je een GitHub-repository loskoppelt van je site, hebben toekomstige wijzigingen aan de repository niet langer invloed op je site. De geïmplementeerde bestanden blijven standaard op je site staan, maar je hebt de optie om ze te verwijderen tijdens het loskoppelingsproces.

Een repository verwijderen:

1. Bezoek de pagina Sites: https://wordpress.com/sites/
2. Klik op de naam van je site om het siteoverzicht te bekijken.
3. Klik op het tabblad Implementaties.
4. Klik op het menu met drie punten (⋮) in de repository.
5. Selecteer ‘Repository loskoppelen‘.
6. Er verschijnt een dialoogvenster. Klik op de schakelaar om gekoppelde bestanden van de site te verwijderen.
7. Klik op ‘Repository loskoppelen‘ om het dialoogvenster te sluiten en de repository los te koppelen.

Merk op dat WordPress.com voor ontwikkelaars nog steeds zal verschijnen in je geïnstalleerde GitHub-apps en je geautoriseerde GitHub-apps. Dit komt omdat WordPress.com nog steeds toegang heeft tot de repository, maar de koppeling is verwijderd.

Je kunt er ook voor kiezen om de toegang van WordPress.com tot je GitHub-account in te trekken. Je kan dit op elk moment doen door naar je applicatie-instellingen op GitHub te gaan. 

Geautoriseerde toegang tot je GitHub-account intrekken:

1. Ga naar Geautoriseerde GitHub-apps.
2. Klik op Intrekken naast WordPress.com voor ontwikkelaars.
3. Klik op de knop ‘Ik begrijp het, toegang intrekken‘.

Zelfs als je geautoriseerde toegang tot de app intrekt, kan er nog steeds code worden geïmplementeerd omdat de WordPress.com voor ontwikkelaars-app op de geselecteerde accounts blijft geïnstalleerd.

De toegang tot de installatie van WordPress.com intrekken en de mogelijkheid om code te implementeren op je WordPress.com-site uitschakelen:

1. Ga naar Geïnstalleerde GitHub-apps.
2. Klik op Configureren naast WordPress.com voor ontwikkelaars.
3. Klik in het gebied Gevarenzone op Verwijderen en klik vervolgens op OK wanneer dit wordt gevraagd.

Het verwijderen van WordPress.com van de lijst met geautoriseerde apps betekent niet dat de repository’s worden verwijderd of niet meer werken; je repositories blijven bestaan op GitHub nadat je de toegang van WordPress.com hebt ingetrokken, maar WordPress.com kan geen code meer implementeren.