Använd GitHub-distributioner på WordPress.com

GitHub-distributioner integrerar dina GitHub-filförvar direkt med din WordPress.com-webbplats, vilket ger dig ett versionskontrollerat, automatiserat arbetsflöde för distribution av tillägg, teman eller fullständiga webbplatsändringar. I den här guiden kan du läsa mer om installationsprocessen och hur du hanterar anslutna filförvar.

Den här funktionen är tillgänglig för webbplatser med WordPress.com Business- eller Commerce-paketet. Om du har ett Business-paket, se till att aktivera det. För gratis webbplatser och webbplatser med Personal- eller Premium-paketet kan du uppgradera ditt paket för att få åtkomst till den här funktionen.

Den här videon är på engelska.
YouTube har automatiska översättningsfunktioner så att du kan se videon på ditt eget språk:

För att visa undertexter med automatisk översättning:

1. Spela upp videon.
2. Klicka på ⚙️ Inställningar (längst ner till höger i videon).
3. Välj Undertexter/CC.
4. Välj Automatisk översättning.
5. Välj önskat språk.

För att lyssna med automatisk dubbning (experimentell):

1. Klicka på ⚙️ Inställningar.
2. Välj Ljudspår.
3. Välj språket du vill lyssna på:

ℹ️ Översättningar och dubbning genereras automatiskt av Google, kan innehålla fel och den automatiska dubbningen är fortfarande under test, så den är inte tillgänglig för alla språk.

Innan du kan distribuera ett GitHub-filförvar till din WordPress.com-webbplats måste du först ställa in anslutningen mellan de två med hjälp av följande steg:

1. Gå till webbplatssidan på https://wordpress.com/sites/
2. Klicka på namnet på din webbplats för att visa webbplatsöversikten.
3. Klicka på fliken Distributioner.
4. Klicka på knappen Anslut filförvar. Om du därefter ser en lista över filförvar har du redan anslutit ditt GitHub-konto. Fortsätt till steg 11.
5. Klicka på knappen Installera WordPress.com-appen.
6. Ett nytt fönster öppnas och du uppmanas att logga in på ditt GitHub-konto om du inte redan har gjort det. Därefter visas den här skärmen:

7. Klicka på knappen Auktorisera WordPress.com för utvecklare.
8. Välj den GitHub-organisation eller det konto där ditt filförvar finns.
9. Välj vilket eller vilka filförvar som du vill ansluta:
   • Alla filförvar: Om du väljer det här alternativet får WordPress.com åtkomst till alla aktuella och framtida filförvar som ägs av det valda GitHub-kontot. Detta inkluderar offentliga filförvar som är skrivskyddade.
   • Endast valda filförvar: Om du väljer det här alternativet kan du välja vilka filförvar som WordPress.com kan få åtkomst till på det valda GitHub-kontot. 
10. När du har valt ett alternativ klickar du på knappen Installera.
11. Det nya fönstret stängs och du förs tillbaka till WordPress.com. Ditt eller dina valda filförvar bör listas tillsammans med det Github-konto som är associerat med filförvaret:

12. Klicka på Välj bredvid det filförvar som du vill ansluta.

Nu bör du se WordPress.com för utvecklare under Auktoriserade GitHub-appar och Installerade GitHub-appar.

När du har valt ett filförvar behöver du justera distributionsinställningarna:

• Distributionsgren: Standardinställningen är standardgrenen i filförvaret (vanligtvis huvudgrenen), men detta kan ändras till den gren som du vill använda.
• Målkatalog: Servermappen där du vill distribuera filerna. För tillägg är det /wp-content/plugins/my-plugin-name. För teman är det /wp-content/themes/my-theme-name. För en delvis webbplatsdistribution (dvs. flera tillägg eller teman) kan du använda /wp-content. Innehållet i ett filförvar sammanfogas med det befintliga innehållet på WordPress-webbplatsen i den specificerade katalogen.
• Automatiska distributioner: Det finns två sätt att distribuera till WordPress.com:
  • Automatisk: När koden har checkats in (committed) distribueras den till din WordPress.com-webbplats. Automatisk distribution rekommenderas för utvecklingswebbplatser.
  • Manuell: Koden distribueras när du begär en distribution. Manuell distribution rekommenderas för produktionswebbplatser.
• Distributionsläge: Det finns två typer av distribution:
  • Enkel: I det här läget kopieras alla filer från en gren av filförvaret till webbplatsen och distribueras utan efterbehandling.
  • Avancerad: Med det här läget kan du använda ett arbetsflödesskript och aktivera anpassade byggsteg, t.ex. installera Composer-beroenden, utföra kodtestning före distribution och styra fildistribution. Perfekt för filförvar som behöver Composer- eller Node-programvara. Se Avancerad distribution nedan för mer information.

När alla inställningar har konfigurerats klickar du på knappen Anslut. Ditt filförvar kommer att läggas till:

Observera att du måste utlösa den första distributionen, antingen automatiskt eller manuellt. Du kan sedan ansluta ett annat filförvar när som helst genom att klicka på knappen Anslut filförvar.

Med Avancerad distribution kan du tillhandahålla ett arbetsflödesskript för att bearbeta filer i ditt filförvar före distribution. Detta öppnar upp för många möjligheter, som att kontrollera din kod för att säkerställa att den uppfyller teamets kodningsstandarder, köra enhetstester, exkludera filer från distributionen, installera beroenden och mycket annat. Titta närmare på våra arbetsflödesrecept för att komma igång.

Så här ställer du in avancerad distribution:

1. Ett formulär visas där du kan konfigurera distributionen.
2. Klicka på filförvarets namn för att hantera anslutningen.
3. Välj Avancerat på höger sida under Välj ditt distributionsläge.

4. Om filförvaret redan innehåller en arbetsflödesfil kan du välja den här. Systemet kontrollerar filen för eventuella fel. Om inga fel hittas, fortsätt till steg 7.
5. Du kan också välja alternativet Skapa nytt arbetsflöde för att lägga till en förkonfigurerad arbetsflödesfil. Om du väljer det här alternativet skrivs arbetsflödesfilen wpcom.yml över om den redan finns i ditt filförvar.
6. Klicka på knappen Installera arbetsflöde åt mig för att checka in (commit) arbetsflödesfilen i filförvaret.
7. När ett arbetsflöde har lagts till och verifierats klickar du på Uppdatera. Ditt filförvar kommer nu att använda avancerad distribution.

När du har anslutit ditt GitHub-filförvar till en webbplats är nästa steg att faktiskt distribuera koden. Det finns två distributionsmetoder att välja mellan: Automatisk och Manuell.

Automatisk distribution rekommenderas inte för live produktionswebbplatser, eftersom eventuella kodändringar i filförvaret distribueras automatiskt från GitHub till den live webbplatsen. Överväg istället att konfigurera automatisk distribution till en utvecklingswebbplats och synkronisera den till produktion när du är klar.

Manuell distribution ger dig mer kontroll över när dina kodändringar skickas live, eftersom du måste utlösa varje distribution manuellt. Vi rekommenderar manuell distribution om du inte vill använda en utvecklingswebbplats.

Så här utlöser du en distribution manuellt:

1. Gå till webbplatssidan på https://wordpress.com/sites/
2. Klicka på namnet på din webbplats för att visa webbplatsöversikten.
3. Klicka på fliken Distributioner.
4. Klicka på ellipsmenyn (⋮) för det filförvar som du vill distribuera.
5. Välj Utlös manuell distribution. Du bör se ett bannermeddelande med texten ”Körning av distribution skapad” och distributionsstatusen kommer att ändras till ”Köad”.
6. Vänta tills distributionen har slutförts (statusen ändras till ”Distribuerad”).

7. Klicka på ellipsmenyn (⋮) igen och välj Se distributionskörningar. 
8. I distributionskörningsloggen visas författaren och distribuerad incheckning (commit). Om du klickar på posten för distributionskörning kan du visa mer information.

Så här hanterar du dina befintliga GitHub-filförvaranslutningar:

1. Gå till webbplatssidan på https://wordpress.com/sites/
2. Klicka på namnet på din webbplats för att visa webbplatsöversikten.
3. Klicka på fliken Distributioner.
4. Du bör sedan se anslutningslistan. 

Anslutningslistan visas om det finns minst en anslutning mellan ett GitHub-filförvar och din webbplats. Listan innehåller relevant information för varje anslutning, såsom filförvarets namn och gren, den senaste incheckning (commit) som distribuerades till en webbplats, när det hände, var koden placerades, hur lång tid distributionskörningen tog och dess status.

Det finns ytterligare åtgärder tillgängliga om du klickar på ellipsmenyn (⋮):

• Utlös manuell distribution: Startar en distributionskörning på den senaste incheckningen (commit) av den konfigurerade grenen.
• Se distributionskörningar: Öppnar vyn för distributionskörningsloggar för det anslutna filförvaret.
• Konfigurera anslutning: Öppnar vyn Hantera anslutning för filförvaret.
• Koppla från filförvar: Tar bort anslutningen mellan filförvaret och webbplatsen.

Distributionskörningsloggar tillhandahåller ett detaljerat steg-för-steg-register för varje distribution, oavsett om den utlöstes automatiskt eller manuellt. Dessa loggar hjälper dig att spåra ändringar, övervaka distributionsstatus och felsöka eventuella problem som uppstår. Med åtkomst till loggar från de senaste 10 körningarna inom 30 dagar kan du enkelt granska vad som har hänt under varje distribution och säkerställa att allt fungerar smidigt.

Så här kontrollerar du loggarna för en distribution:

1. Gå till webbplatssidan på https://wordpress.com/sites/
2. Klicka på namnet på din webbplats för att visa webbplatsöversikten.
3. Klicka på fliken Distributioner.
4. Klicka på ellipsmenyn (⋮) bredvid det filförvar som du vill visa loggar för.
5. Välj Se distributionskörningar.
6. Listvyn Distributionskörningar visar incheckningar (commits) som har distribuerats till webbplatsen, distributionsstatus, datum och varaktighet.
7. Klicka var som helst på en körning för att expandera och visa mer information om distributionen.

Loggarna tillhandahåller ett register över alla utförda kommandon, från att hämta kod från GitHub till att placera den i målkatalogen. Du kan expandera logg-rader för att se mer information genom att klicka på Visa mer.

När du kopplar från ett GitHub-filförvar från din webbplats kommer eventuella framtida ändringar av filförvaret inte längre att påverka webbplatsen. Som standard stannar de distribuerade filerna kvar på din webbplats, men du har möjlighet att ta bort dem under frånkopplingsprocessen.

Så här tar du bort ett filförvar:

1. Gå till webbplatssidan på https://wordpress.com/sites/
2. Klicka på namnet på din webbplats för att visa webbplatsöversikten.
3. Klicka på fliken Distributioner.
4. Klicka på ellipsmenyn (⋮) för filförvaret.
5. Välj Koppla från filförvar.
6. Ett dialogfönster visas. Klicka på reglaget för att ta bort associerade filer från webbplatsen.
7. Klicka på Koppla från filförvar för att stänga dialogrutan och koppla från filförvaret.

Observera att WordPress.com för utvecklare fortfarande fortfarande visas i Installerade GitHub-appar och Auktoriserade GitHub-appar. Det beror på att WordPress.com fortfarande har åtkomst till filförvaret, men anslutningen har tagits bort.

Du kan också välja att återkalla WordPress.coms åtkomst till ditt Github-konto. Du kan göra det när som helst genom att gå till dina applikationsinställningar på GitHub. 

Så här återkallar du auktoriserad appåtkomst till ditt GitHub-konto:

1. Gå till Auktoriserade GitHub-appar.
2. Klicka på Återkalla bredvid WordPress.com för utvecklare.
3. Klicka på knappen Jag förstår, återkalla åtkomst.

Även om du återkallar auktoriserad appåtkomst kan kod fortfarande distribueras eftersom appen WordPress.com för utvecklare fortfarande är installerad på de valda kontona.

Så här återkallar du åtkomst till WordPress.com-installationen och inaktiverar möjligheten att distribuera kod till din WordPress.com-webbplats:

1. Gå till Installerade GitHub-appar.
2. Klicka på Konfigurera bredvid WordPress.com för utvecklare.
3. Klicka på Avinstallera i området Farozon och sedan på OK när du uppmanas till det.

Att ta bort WordPress.com från listan över auktoriserade appar betyder inte att filförvaren tas bort eller slutar att fungera. Dina filförvar kommer fortfarande att finnas på GitHub efter att du har återkallat WordPress.coms åtkomst, men WordPress.com kan inte längre distribuera kod.