Hur man publicerar till WordPress Plugin Repository

En av de överväganden som alla WordPress-pluginutvecklare måste göra är hur man faktiskt publicerar sitt arbete. Många premium plugins väljer att köra sin egen webbplats, dokumentation och inköp gateway, men om du vill publicera en gratis plugin eller kanske en liten variant av ett premium plugin, så är det ett bra alternativ att använda WordPress plugin repository..

WordPress.org erbjuder källkontroll, statistikspårning och meddelar automatiskt användare av uppdateringar gratis. Det gör ingen skada att webbplatsen har en solid ranking med sökmotorer, antingen särskilt eftersom din plugin kan gynna!

I den här artikeln tittar vi på hur du installerar ett WordPress-plugin-arkiv och underhåller ditt projekt genom dess livscykel. Observera att den här artikeln förutsätter att du har grundläggande förtrogenhet med Subversion.


Steg 1 Begär tillgång

Innan du begär tillgång till ditt projekt måste du ha ett konto med WordPress.org. De är gratis och lätta att installera.

Först navigera till den här sidan och ge den begärda informationen. När ditt konto är inställt och bekräftat kan du konfigurera förvaret. Navigera till WordPress Developer Center. Från WordPress.org hemsida klickar du på Utöka och pluggar. Klicka sedan på "Lägg till ditt plugin:"

På nästa skärm uppmanas du att ange ditt plugin namn, en kort beskrivning och URL-adressen till projektets hemsida. Detta behöver inte vara fördjupat, men här är några tips som kommer att tjäna du kommer att begära åtkomst:

  • Se till att plugin-namnet är slutligt. När du har fått tillgång till förvaret kan du inte ändra namnet. Tänk strategiskt om vad du vill namnge plugin också. För bästa resultat är det ofta bäst att namnge plugin någonting som är relaterat till vad användarna ska söka på i en sökmotor.
  • Spendera inte mycket tid på att skriva en beskrivning av ditt plugin vid denna tidpunkt. En kortfattad beskrivning med en mening är bra. README-filen för plugin kommer att ge mer detaljer när du har lanserat projektet.
  • Webbadressen till pluginets hemsida behöver inte nödvändigtvis vara giltig men se till att den webbadress du anger är där pluginens hemsida faktiskt kommer att leva.

När du har lämnat informationen skickar du begäran. Du kommer att få i ett e-postmeddelande med referensuppgifterna för ditt förråd normalt inom 24 till 48 timmar, varefter du kan göra ditt första engagemang.


Steg 2 Ställa in förvaret

När du har mottagit förvarets webbadress kan du göra din första utbetalning. Använd din favorit subversionsklient (jag använder TortoiseSVN i den här handledningen) genom att göra en kassa med hjälp av depotets URL:

Detta skapar en katalog med det pluginnamn som du angav i det första steget i denna handledning. Det kommer också att initiera grenar, taggar och stamkataloger:

En snabb anteckning på katalogstrukturen:

  • Bagageförvaret i förvaret är din arbetsregister. Det här är katalogen där du gör all din huvudsakliga utveckling.
  • Taggar är versioner eller snapshots av bagaget på specifika punkter i sin utvecklingscykel. Ofta kan du märka stammen varje gång du vill utföra en frisättning.
  • Grenkatalogen är en kopia av stammen vid en viss tidpunkt som används för tung utveckling. Om du ska göra tung utveckling, är det bäst att filialera - på så sätt bevarar du stamkvaliteten.

Du kan läsa mycket mer om subversion katalogstrukturen här.


Steg 4 förbinder ändringar

Vid denna tidpunkt kan du börja arbeta ut ur förvaret. Om det här är första gången du arbetar med det, ska din stamkatalog vara tom. Om du har arbetat med ditt plugin innan du initierar katalogen, fortsätt sedan och kopiera filerna till bagaget nu. annars kan du börja arbeta med ditt plugin.

När du väl har kopierat eller börjat arbeta med plugin måste du lägga till filerna i källkontrollen. För att göra detta, exekvera add-kommandot:

Detta kommer att instruera subversion för att börja spåra dessa filer. Nästa upp, kör kommandot kommandot:

Detta steg kommer faktiskt att skicka in pluginens kodbas till WordPress-plugin-arkivet.

Självklart har du ännu inte publicerat ditt plugin tills du taggar det. Innan du gör det, se till att du har rätt inställning av pluginens rubrik och det är README-filen. Du kan också läsa mer om detta i Writing Maintainable WordPress Widgets-serien.


Steg 3 Märkning och frigöring

Om du antar att du har slutfört en fungerande version av ditt plugin och installerat rubriken och README, är det dags att släppa en version av pluginprogrammet. För att göra så, kör kommandot Branch / Tag [TODO] på stamkatalogen.

Innan du gör det, se till att du uppdaterar versionskoden i pluginens rubrik:

Och uppdatera även den stabila taggen av README:

Därefter begå ändringarna till bagageutrymmet.

Därefter är du redo att tagga:

Under det att Subversion kommer att fråga dig vilken katalog du vill tagga versionen. Det är väldigt viktigt att du uppdaterar sökvägen till plugin till taggbanan - de flesta Subversion-klienter kommer att fylla i destinationen med bagageriktningen. Detta är felaktigt - istället vill du ändra sökvägen till /tags/1.0 (men om du markerar 1,5 eller 2,0 så ändrar du numret):

Vid denna punkt har du pluginkontrollen kontrollerats i källkontroll och taggats som en specifik version. Inom 20 minuter ska din plugin dyka upp i WordPress Plugin-förvaret på den URL som du angav när du begärde förvaret.

Kontroll i framtida versioner av plugin fungerar på samma sätt som i föregående steg. Med tiden kan du fortsätta utveckla plugin och spåra nedladdningsstatistik från projektsidan.


Slutsats

Det är allt! Förhoppningsvis har du nu en bra förståelse för vad som krävs för att formellt publicera ditt plugin via WordPress-pluginförvaret. Vi tittade nyligen på hur man faktiskt börjar skapa plugins? så du borde ha en solid grund för att komma dit och börja skapa egna anpassade plugins! Det fantastiska med allt detta är att det bidrar till att bidra till den redan utestående plattformen som är WordPress. De mest begåvade utvecklarna och konstruktörerna som vi kan komma ut där skapar användbara plugins, desto bättre blir plattformen!

Extra resurser

Om du är intresserad av att lära dig mer om WordPress Plugin Development, kan du checka ut våra WordPress Plugin Services i Envato Studio för ytterligare resurser och utbildning om ämnet!