Ostit premium-teeman ThemeForestista, julkaisit sivustosi, kaikki toimii. Kuluu puoli vuotta, ja hallintapaneeliin ilmestyy ilmoitus: teema on vanhentunut, ja mukana on pari kriittistä haavoittuvuutta. Manuaalinen päivitys lataamalla ZIP ThemeForestista, siirtämällä se palvelimelle ja korvaamalla tiedostot on aidosti turhauttava skenaario. Varsinkin, kun teemoja on useampi kuin yksi.

Aiemmin tähän tarkoitukseen oli olemassa Envato WordPress Toolkit, pieni lisäosa, joka haki ostoksesi ThemeForestista ja päivitti teemat parilla klikkauksella. Envato kuitenkin korvasi sen virallisesti Envato Market -lisäosalla, joka on modernimpi ja käyttää OAuth-token-todennusta vanhentuneiden API-avainten sijaan. Vanha Toolkit siirtyi GitHub-arkistoon, eikä sitä enää tueta.

Tämä opas käy läpi Envato Marketin vaiheittaisen käyttöönoton alusta alkaen: henkilökohtaisen tokenin hankkimisesta automaattisiin teemapäivityksiin, mukaan lukien vivahteet niille, jotka siirtyvät vanhasta Toolkitista.

💡 Pikaopas:

• Luo henkilökohtainen Envato-token ThemeForest-tilisi asetuksissa
• Lataa ja asenna Envato Market -lisäosa virallisesta GitHub-varastosta
• Syötä token ja käyttäjätunnus, niin lisäosa hakee automaattisesti kaikki ostetut teemat
• Päivitä teemat yhdellä klikkauksella suoraan WordPressin hallintapaneelista

Mitä vanhalle Envato Toolkitille tapahtui

Jos käytät edelleen Envato WordPress Toolkitiä, on aika vaihtaa. Lisäosa on poistettu virallisesta tuesta: sen GitHub-varasto on siirretty envato-archive-arkistoon, ja sen käyttämä API-avainmekanismi on todettu turvattomaksi. Envato on siirtynyt kokonaan OAuth-pohjaisiin henkilökohtaisiin tokeneihin, jotka on sidottu tiettyihin käyttöoikeuksiin, voidaan mitätöidä milloin tahansa eivätkä "vuoda" palvelinlokien kautta kuten vanhat avaimet tekivät.

Uusi lisäosa, Envato Market, sijaitsee aktiivisessa varastossa ja saa säännöllisesti päivityksiä. Se näyttää samankaltaiselta: sama hallintapaneeli-integraatio, sama ostoslista. Mutta konepellin alla on moderni todennus ja luotettavampi päivitysten tarkistusmekanismi.

Henkilökohtaisen Envato-tokenin luominen

Henkilökohtainen token on uusi Envaton API-todennusstandardi, joka korvasi vanhat 32-merkkiset avaimet. Sinun on luotava se ennen lisäosan asentamista: Envaton järjestelmä ei käsittele uusia tokeneita välittömästi, eikä lisäosa välttämättä tunnista sitä ensimmäisten minuuttien aikana.

Mene osoitteeseen build.envato.com, kirjaudu sisään ThemeForest-tililläsi ja napsauta Create a token. Anna tokenille kuvaava nimi, esimerkiksi "Teemojen automaattipäivitys asiakassivustolla", ja aseta käyttöoikeudet:

• View and search Envato sites, pakollinen
• View your Envato account username, pakollinen
• View your purchases, pakollinen
• Verify purchases, valinnainen mutta hyödyllinen teemoille, joissa on lisensointijärjestelmä
• Jätä loput käyttöoikeudet pois päältä

Kopioi token luomisen jälkeen. Toisin kuin vanha API-avain, token näytetään vain kerran. Jos suljet välilehden, menetät pääsyn siihen. Tallenna se salasanahallintaan.

Envato Market -lisäosan lataaminen ja asentaminen

Toisin kuin tavalliset lisäosat, Envato Marketia ei ole listattu wordpress.orgin luettelossa. Sitä jaetaan vain GitHubin kautta. Mene osoitteeseen envato.github.io/wp-envato-market ja lataa ZIP docs/-kansiosta.

Tärkeää: älä napsauta "Download ZIP" GitHub-varaston pääsivulla. Arkiston nimeksi tulee wp-envato-market-master, eikä WordPress tunnista sitä lisäosaksi. Hae ZIP nimenomaan docs/-kansiosta, joka on paketoitu oikein.

Jatka sitten tavallisella asennuksella:

• Mene WordPressin hallintapaneelissa kohtaan Lisäosat → Lisää uusi.
• Napsauta Lisää lisäosa ja valitse ladattu ZIP.
• Napsauta Asenna nyt ja sitten Ota käyttöön.

Aktivoinnin jälkeen Envato Market -kohta ilmestyy hallintapaneelin sivupalkin valikkoon.

Määritys: tokenin linkittäminen ostoksiisi

Avaa Envato Market hallintapaneelissa. Näet kaksi kenttää: Envato-käyttäjätunnus ja henkilökohtainen token. Liitä aiemmassa vaiheessa kopioimasi token, syötä ThemeForest-kirjautumistunnuksesi ja napsauta Tallenna muutokset.

Lisäosa tekee kyselyn Envaton APIin ja näyttää listan kaikista tällä tilillä ostetuista teemoista ja lisäosista. Jos lista on tyhjä, odota 10-15 minuuttia ja päivitä sivu. Envato tarvitsee aikaa "polttaakseen" tuoreen tokenin sisään infrastruktuuriinsa. Jos tämä ei auta, varmista, että tokenilla on "View your purchases" -käyttöoikeus käytössä ja että olet kirjautuneena juuri sillä tilillä, jolla ostit teemat.

Huomio usean sivuston omistajille: voit luoda erillisen tokenin jokaiselle verkkotunnukselle tai yhden yleisen tokenin. Yleinen on kätevämpi: liität sen kaikille sivustoille, ja jokainen teema näkee lisenssinsä. Mutta jos luovutat sivuston asiakkaalle, on parempi mitätöidä yleinen token ja myöntää kapea-alainen token tietylle verkkotunnukselle.

Automaattiset teemapäivitykset

Tokenin linkittämisen jälkeen Teemat-välilehti näyttää listan ostetuista teemoista ja niiden nykyiset versiot. Jos teemaan on saatavilla päivitys, sen viereen ilmestyy Päivitys saatavilla -painike.

Napsauta sitä, ja WordPress suorittaa vakiopäivitysmekanismin: lataa tuoreen ZIPin Envaton palvelimilta, purkaa sen ja korvaa teematiedostot.

Ennen päivitystä on tärkeä huomio muokkauksiin liittyen. Jos muokkasit teematiedostoja suoraan (tyylit, mallipohjat, functions.php), päivitys korvaa ne, ja kaikki muutokset menetetään. Tämä ei koske asetuksia, jotka on tehty WordPressin muokkausnäkymän tai teeman asetuspaneelin kautta: ne on tallennettu tietokantaan ja säilyvät.

Oikea lähestymistapa on lapsiteema. Siirrä kaikki koodimuokkaukset siihen äläkä koske pääteemaan koskaan. Silloin "Päivitys saatavilla" -painikkeesta tulee turvallinen, ja voit napsauttaa sitä pelkäämättä muokkausten menettämistä.

Lisäosa lisää myös automaattisen päivitysten tarkistuksen: WordPress kysyy säännöllisesti Envaton APIa ja näyttää ilmoitukset uusista versioista suoraan tavallisessa päivitysosiossa.

⁉️🤔 Usein kysytyt kysymykset

Miten henkilökohtainen token eroaa vanhasta API-avaimesta?

Henkilökohtainen token toimii OAuthin kautta. Asetat tietyt käyttöoikeudet, voit mitätöidä tokenin milloin tahansa, eikä se näy URL-pyynnöissä. Vanha API-avain oli yksi pysyvä merkkijono ilman tarkennettuja oikeuksia. Envato on lopettanut uusien avainten luomisen, ja kaikki uudet integraatiot toimivat vain tokeneilla.

Voinko jatkaa vanhan Envato Toolkitin käyttöä?

Teknisesti kyllä, jos sinulla on se jo asennettuna ja toiminnassa. Mutta lisäosaa ei ole päivitetty vuoden 2021 jälkeen, sen varasto on arkistoitu, ja Envaton infrastruktuuri on vähitellen lopettamassa vanhojen API-avainten tuen. Ennemmin tai myöhemmin Toolkit lakkaa hakemasta ostoksia. On parempi vaihtaa nyt, kun se vielä toimii, kuin hätäillä, kun teema lakkaa päivittymästä.

Envato Market -lisäosa ei näe ostoksiani. Mitä minun pitäisi tehdä?

Yleisin syy on, että token on luotu eri Envato-tilillä (monilla on useita tilejä eri markkinapaikoille). Varmista, että olet kirjautuneena juuri sillä tilillä, jolla ostit teemat. Toinen syy on, että tuoretta tokenia ei ole vielä käsitelty: odota 15-30 minuuttia. Kolmas on, että tokenilla ei ole "View your purchases" -käyttöoikeutta käytössä.

Täytyykö Envato Market asentaa jokaiselle sivustolle erikseen?

Kyllä, lisäosa toimii sivustokohtaisesti, ja jokainen sivusto tarvitsee oman aktivoinnin. Voit käyttää samaa tokenia kaikilla sivustoilla (se on sidottu tiliin, ei verkkotunnukseen), mutta lisäosa asennetaan ja määritetään jokaisella sivustolla itsenäisesti.

Mitä tapahtuu teeman muokkauksille automaattipäivityksen jälkeen?

Pääteeman tiedostot korvataan kokonaan. Muokkausnäkymän ja teeman asetuspaneelin asetukset säilyvät, koska ne ovat tietokannassa. Suoraan teematiedostoihin tehdyt koodimuokkaukset menetetään. Käytä lapsiteemaa kaikkiin koodimuokkauksiin. Tämä on paras käytäntö, ei pelkkä suositus.

Kannattaako Envato Toolkitista vaihtaa juuri nyt

Jos käytät edelleen vanhaa Toolkitiä, vaihda tänään. Prosessi vie 10 minuuttia: poista Toolkit käytöstä, asenna Envato Market, liitä token. Tokenin luominen vie minuutin, lisäosan asentaminen toiset pari minuuttia, ja kaikki toimii.

Suurin hyöty ei ole siinä, että "vanha vielä toimii". Hyöty on siinä, että uusi lisäosa käyttää infrastruktuuria, jota Envato kehittää ja tukee. Vanha Toolkit on umpikuja, eikä kysymys ole "hajoanko se" vaan "milloin". Tämä tapahtuu yleensä pahimmalla mahdollisella hetkellä, kun teemasta julkaistaan haavoittuvuuden korjaava päivitys, etkä pysty päivittämään.

Käytä 10 minuuttia, asenna Envato Market ja unohda manuaaliset teemapäivitykset ikuisesti.