Du köpte ett premiumtema på ThemeForest, lanserade din sajt, allt fungerar. Sex månader går och en notis dyker upp i adminpanelen: temat är föråldrat, tillsammans med ett par kritiska sårbarheter. Manuell uppdatering genom att ladda ner en ZIP från ThemeForest, ladda upp och ersätta filer är ett scenario som är genuint frustrerande. Särskilt när du har mer än ett tema.

Tidigare fanns Envato WordPress Toolkit för detta ändamål, ett litet plugin som hämtade dina köp från ThemeForest och uppdaterade teman med ett par klick. Men Envato har officiellt ersatt det med pluginet Envato Market, som är modernare och använder OAuth-tokenautentisering istället för föråldrade API-nycklar. Det gamla Toolkit flyttades till GitHub-arkivet och stöds inte längre.

Den här guiden ger en steg-för-steg-installation av Envato Market från grunden: från att skaffa en personlig token till automatiska temauppdateringar, inklusive nyanser för dig som byter från det gamla Toolkit.

💡 Snabb översikt:

• Generera en personlig Envato-token i dina ThemeForest-kontoinställningar
• Ladda ner och installera Envato Market-pluginet från det officiella GitHub-repositoriet
• Ange token och användarnamn, så hämtar pluginet automatiskt alla köpta teman
• Uppdatera teman med ett klick direkt från WordPress adminpanel

Vad hände med det gamla Envato Toolkit

Om du fortfarande använder Envato WordPress Toolkit är det dags att byta. Pluginet har tagits bort från officiell support: dess GitHub-repositorium flyttades till envato-archive, och API-nyckelmekanismen det förlitade sig på har bedömts som osäker. Envato har helt gått över till personliga tokens via OAuth, som är knutna till en specifik uppsättning behörigheter, kan återkallas när som helst och inte "läcker" via serverloggar på det sätt som gamla nycklar gjorde.

Det nya pluginet, Envato Market, finns i ett aktivt repositorium och får regelbundna uppdateringar. Det ser likadant ut: samma integration i adminpanelen, samma inköpslista. Men under huven finns modern autentisering och en mer pålitlig mekanism för uppdateringskontroll.

Generera en personlig Envato-token

En personlig token är den nya autentiseringsstandarden för Envato API som ersatte de gamla 32 tecken långa nycklarna. Du måste skapa den innan du installerar pluginet: Envatos system behandlar inte nya tokens omedelbart, och pluginet kanske inte känner igen den under de första minuterna.

Gå till build.envato.com, logga in med ditt ThemeForest-konto och klicka på Create a token. Ge token ett meningsfullt namn, till exempel "Auto-uppdatera teman på kundsajt", och ställ in behörigheterna:

• View and search Envato sites, krävs
• View your Envato account username, krävs
• View your purchases, krävs
• Verify purchases, valfritt men användbart för teman med licenssystem
• Lämna övriga behörigheter inaktiverade

Efter skapandet, kopiera token. Till skillnad från den gamla API-nyckeln visas token endast en gång. Om du stänger fliken förlorar du åtkomsten till den. Spara den i en lösenordshanterare.

Ladda ner och installera Envato Market-pluginet

Till skillnad från vanliga plugins finns Envato Market inte listat i wordpress.org-katalogen. Det distribueras endast via GitHub. Gå till envato.github.io/wp-envato-market och ladda ner ZIP-filen från mappen docs/.

Viktigt: klicka inte på "Download ZIP" på GitHub-repositoriets huvudsida. Arkivet kommer att heta wp-envato-market-master, och WordPress känner inte igen det som ett plugin. Hämta ZIP-filen specifikt från mappen docs/, som är korrekt paketerad.

Fortsätt sedan med standardinstallation:

• I WordPress adminpanel, gå till Plugins → Lägg till nytt.
• Klicka på Ladda upp plugin och välj den nedladdade ZIP-filen.
• Klicka på Installera nu, sedan Aktivera.

Efter aktivering visas menyalternativet Envato Market i sidofältet i adminpanelen.

Konfiguration: länka token till dina köp

Öppna Envato Market i adminpanelen. Du ser två fält: Envato-användarnamn och personlig token. Klistra in token du kopierade i föregående steg, ange ditt ThemeForest-inloggningsnamn och klicka på Spara ändringar.

Pluginet kommer att fråga Envato API och visa en lista över alla teman och plugins som köpts med detta konto. Om listan är tom, vänta 10-15 minuter och uppdatera sidan. Envato behöver tid för att "bränna in" en färsk token genom sin infrastruktur. Om det inte hjälper, kontrollera att token har behörigheten "View your purchases" aktiverad och att du är inloggad med exakt det konto du använde för att köpa temana.

En notering för ägare av flera sajter: du kan skapa en separat token för varje domän eller en global token. En global är bekvämare: klistra in den på alla sajter, så ser varje tema sin licens. Men om du överlämnar sajten till en kund är det bättre att återkalla den globala token och utfärda en smal för den specifika domänen.

Automatiska temauppdateringar

Efter att ha länkat token kommer fliken Teman att visa en lista över köpta teman med deras aktuella versioner. Om en uppdatering är tillgänglig för ett tema visas en Uppdatering tillgänglig-knapp bredvid det.

Klicka på den, så kör WordPress standarduppdateringsmekanismen: ladda ner den färska ZIP-filen från Envatos servrar, packa upp den och ersätt temafilerna.

Före uppdatering finns det en viktig punkt gällande anpassning. Om du redigerade temafiler direkt (stilmallar, mallar, functions.php) kommer uppdateringen att skriva över dem, och alla ändringar går förlorade. Detta gäller inte inställningar gjorda via WordPress-anpassaren eller temats alternativpanel: de lagras i databasen och kommer att bevaras.

Rätt tillvägagångssätt är ett barntema. Flytta alla kodändringar dit och rör aldrig föräldratemat. Då blir "Uppdatering tillgänglig"-knappen säker, och du kan klicka på den utan rädsla för att förlora anpassningar.

Pluginet lägger också till automatisk uppdateringskontroll: WordPress kommer regelbundet att fråga Envato API och visa notiser om nya versioner direkt i den vanliga uppdateringssektionen.

⁉️🤔 Vanliga frågor

Hur skiljer sig en personlig token från den gamla API-nyckeln?

En personlig token fungerar via OAuth. Du anger specifika behörigheter, kan återkalla token när som helst, och den visas inte i URL-förfrågningar. Den gamla API-nyckeln var en enda permanent sträng utan detaljerade rättigheter. Envato har slutat generera nya nycklar, och alla nya integrationer fungerar endast via tokens.

Kan jag fortsätta använda det gamla Envato Toolkit?

Tekniskt sett ja, om du redan har det installerat och fungerande. Men pluginet har inte uppdaterats sedan 2021, dess repositorium är arkiverat, och Envatos infrastruktur fasar gradvis ut stödet för gamla API-nycklar. Förr eller senare kommer Toolkit att sluta hämta köp. Det är bättre att byta nu medan det fortfarande fungerar än att behöva panikåtgärda när ett tema slutar uppdateras.

Envato Market-pluginet ser inte mina köp. Vad ska jag göra?

Den vanligaste orsaken är att token skapades under ett annat Envato-konto (många har flera konton för olika marknadsplatser). Kontrollera att du är inloggad på exakt det konto du använde för att köpa temana. Den andra orsaken är att en färsk token inte har behandlats än: vänta 15-30 minuter. Den tredje är att token inte har behörigheten "View your purchases" aktiverad.

Behöver jag installera Envato Market på varje sajt separat?

Ja, pluginet fungerar per sajt, och varje sajt behöver sin egen aktivering. Du kan använda samma token på alla sajter (den är knuten till kontot, inte domänen), men pluginet installeras och konfigureras på varje sajt oberoende.

Vad händer med temaanpassningar efter automatisk uppdatering?

Föräldratemats filer skrivs över helt. Inställningar från anpassaren och temats alternativpanel bevaras eftersom de finns i databasen. Kodändringar gjorda direkt i temafiler kommer att gå förlorade. Använd ett barntema för alla kodändringar. Detta är en bästa praxis, inte bara en rekommendation.

Bör du byta från Envato Toolkit just nu

Om du fortfarande använder det gamla Toolkit, byt idag. Processen tar 10 minuter: avaktivera Toolkit, installera Envato Market, klistra in token. Att skapa en token tar en minut, att installera pluginet tar ytterligare ett par minuter, och allt fungerar.

Den främsta fördelen är inte att "den gamla fortfarande fungerar". Fördelen är att det nya pluginet använder infrastruktur som Envato utvecklar och stödjer. Det gamla Toolkit är en återvändsgränd, och frågan är inte "kommer det att sluta fungera" utan "när". Detta händer vanligtvis vid sämsta möjliga tillfälle, när en temauppdatering släpps som åtgärdar en sårbarhet, och du inte kan uppdatera.

Ta 10 minuter, installera Envato Market och glöm manuella temauppdateringar för alltid.