Ostsid ThemeForestist esmaklassilise teema, käivitasid saidi, kõik töötab. Möödub kuus kuud ja administraatori paneeli ilmub teade: teema on aegunud koos paari kriitilise turvaauguga. Käsitsi uuendamine, ZIP-faili allalaadimine ThemeForestist, üleslaadimine ja failide asendamine on stsenaarium, mis on tõeliselt tüütu. Eriti kui sul on rohkem kui üks teema.

Varem oli selleks otstarbeks olemas Envato WordPressi Toolkit, väike plugin, mis tõmbas su ostud ThemeForestist ja uuendas teemasid paari klõpsuga. Kuid Envato asendas selle ametlikult Envato Market pluginaga, mis on moodsam ja kasutab aegunud API-võtmete asemel OAuth-tokeni autentimist. Vana Toolkit liikus GitHubi arhiivi ega ole enam toetatud.

See juhend pakub Envato Marketi samm-sammulist seadistamist nullist: alates isikliku tokeni hankimisest kuni automaatsete teemauuendusteni, sealhulgas nüansid neile, kes lähevad üle vanalt Toolkitilt.

💡 Kiire ülevaade:

• Genereeri isiklik Envato token oma ThemeForesti konto seadetes
• Laadi alla ja paigalda Envato Market plugin ametlikust GitHubi repositooriumist
• Sisesta token ja kasutajanimi ning plugin tõmbab automaatselt kõik ostetud teemad
• Uuenda teemasid ühe klõpsuga otse WordPressi administraatori paneelist

Mis juhtus vana Envato Toolkitiga

Kui kasutad endiselt Envato WordPress Toolkiti, on aeg üle minna. Plugin on ametlikust toest eemaldatud: selle GitHubi repositoorium liikus aadressile envato-archive ja API-võtme mehhanism, millele see tugines, on tunnistatud ebaturvaliseks. Envato on täielikult üle läinud isiklikele tokenitele OAuthi kaudu, mis on seotud kindlate õiguste komplektiga, neid saab igal ajal tühistada ja need ei „leki" serveri logide kaudu nii, nagu vanad võtmed seda tegid.

Uus plugin, Envato Market, asub aktiivses repositooriumis ja saab perioodilisi uuendusi. See näeb välja sarnane: sama administraatori paneeli integratsioon, sama ostude nimekiri. Kuid kapoti all on kaasaegne autentimine ja usaldusväärsem uuenduste kontrollimise mehhanism.

Isikliku Envato tokeni genereerimine

Isiklik token on uus Envato API autentimisstandard, mis asendas vanad 32-kohalised võtmed. Pead selle looma enne plugina paigaldamist: Envato süsteem ei töötle uusi tokeneid koheselt ja plugin ei pruugi seda esimestel minutitel ära tunda.

Mine aadressile build.envato.com, logi sisse oma ThemeForesti kontoga ja klõpsa Create a token. Anna tokenile arusaadav nimi, näiteks „Auto-update themes on client site" ja määra õigused:

• View and search Envato sites, nõutav
• View your Envato account username, nõutav
• View your purchases, nõutav
• Verify purchases, valikuline, kuid kasulik litsentsisüsteemidega teemade puhul
• Jäta ülejäänud õigused keelatuks

Pärast loomist kopeeri token. Erinevalt vanast API-võtmest kuvatakse tokenit ainult üks kord. Kui sulged vahelehe, kaotad sellele juurdepääsu. Salvesta see paroolihaldurisse.

Envato Market plugina allalaadimine ja paigaldamine

Erinevalt tavalistest pluginatest ei ole Envato Market loetletud wordpress.org kataloogis. Seda levitatakse ainult GitHubi kaudu. Mine aadressile envato.github.io/wp-envato-market ja laadi ZIP alla kaustast docs/.

Oluline: ära klõpsa GitHubi repositooriumi pealehel nuppu „Download ZIP". Arhiivi nimeks saab wp-envato-market-master ja WordPress ei tunne seda pluginana ära. Hangi ZIP spetsiaalselt kaustast docs/, mis on korrektselt pakendatud.

Seejärel jätka tavalise paigaldusega:

• WordPressi administraatori paneelis mine Plugins → Add New.
• Klõpsa Upload Plugin ja vali allalaaditud ZIP.
• Klõpsa Install Now, seejärel Activate.

Pärast aktiveerimist ilmub administraatori külgmenüüsse Envato Market kirje.

Seadistamine: tokeni sidumine sinu ostudega

Ava administraatori paneelis Envato Market. Näed kahte välja: Envato kasutajanimi ja isiklik token. Kleebi token, mille eelmises sammus kopeerisid, sisesta oma ThemeForesti kasutajanimi ja klõpsa Save Changes.

Plugin pärib Envato API-t ja kuvab kõigi selle kontoga ostetud teemade ja pluginate nimekirja. Kui nimekiri on tühi, oota 10-15 minutit ja värskenda lehte. Envatol kulub aega, et värske token oma infrastruktuuri kaudu „sisse põletada". Kui see ei aita, kontrolli, et tokenil oleks luba „View your purchases" ja et oleksid sisse logitud täpselt selle kontoga, millega teemasid ostsid.

Märkus mitme saidi omanikele: saad luua igale domeenile eraldi tokeni või ühe globaalse tokeni. Globaalne on mugavam: kleebi see kõikidele saitidele ja iga teema näeb oma litsentsi. Kuid kui annad saidi kliendile üle, on parem globaalne token tühistada ja väljastada kitsas token konkreetsele domeenile.

Automaatsed teemauuendused

Pärast tokeni sidumist kuvab vahekaart Themes ostetud teemade nimekirja koos nende praeguste versioonidega. Kui teemale on uuendus saadaval, ilmub selle kõrvale nupp Update Available.

Klõpsa sellel ja WordPress käivitab standardse uuendusmehhanismi: laadib Envato serveritest alla värske ZIP-i, pakib selle lahti ja asendab teema failid.

Enne uuendamist on oluline punkt seoses kohandamisega. Kui muutsid teema faile otse (stiilid, mallid, functions.php), kirjutab uuendus need üle ja kõik muudatused lähevad kaotsi. See ei kehti seadete kohta, mis on tehtud WordPressi kohandaja või teema valikute paneeli kaudu: need on salvestatud andmebaasi ja säilivad.

Õige lähenemine on alamteema. Teisalda kõik koodimuudatused sinna ja ära kunagi puuduta peateemat. Siis muutub nupp „Update Available" ohutuks ja saad sellel klõpsata, kartmata kohanduste kaotamist.

Plugin lisab ka automaatse uuenduste kontrolli: WordPress pärib perioodiliselt Envato API-t ja kuvab teateid uutest versioonidest otse standardses uuenduste jaotises.

⁉️🤔 Korduma kippuvad küsimused

Kuidas erineb isiklik token vanast API-võtmest?

Isiklik token töötab OAuthi kaudu. Määrad konkreetsed õigused, saad tokeni igal ajal tühistada ja see ei ilmu URL-päringutes. Vana API-võti oli üksainus alatine sõne ilma detailsemate õigusteta. Envato on lõpetanud uute võtmete genereerimise ja kõik uued integratsioonid töötavad ainult tokenite kaudu.

Kas ma saan jätkata vana Envato Toolkiti kasutamist?

Tehniliselt jah, kui see on sul juba paigaldatud ja töötab. Kuid pluginat pole uuendatud alates 2021. aastast, selle repositoorium on arhiveeritud ja Envato infrastruktuur loobub järk-järgult vanade API-võtmete toest. Varem või hiljem lõpetab Toolkit ostude tõmbamise. Parem on üle minna nüüd, kuni see veel elab, kui paanitseda siis, kui teema lõpetab uuenemise.

Envato Market plugin ei näe minu oste. Mida ma peaksin tegema?

Kõige levinum põhjus on see, et token loodi teise Envato konto all (paljudel inimestel on mitu kontot erinevate turgude jaoks). Kontrolli, et oleksid sisse logitud täpselt selle kontoga, millega teemasid ostsid. Teine põhjus on see, et värsket tokenit pole veel töödeldud: oota 15-30 minutit. Kolmas on see, et tokenil pole luba „View your purchases" lubatud.

Kas ma pean Envato Marketi igale saidile eraldi paigaldama?

Jah, plugin töötab saidipõhiselt ja iga sait vajab oma aktiveerimist. Saad kasutada sama tokenit kõigil saitidel (see on seotud kontoga, mitte domeeniga), kuid plugin tuleb igale saidile iseseisvalt paigaldada ja seadistada.

Mis juhtub teema kohandustega pärast automaatset uuendamist?

Peateema failid kirjutatakse täielikult üle. Kohandaja ja teema valikute paneeli seaded säilivad, sest need on andmebaasis. Otse teema failides tehtud koodimuudatused lähevad kaotsi. Kasuta kõigi koodimuudatuste jaoks alamteemat. See on parim praktika, mitte lihtsalt soovitus.

Kas peaksid Envato Toolkitilt kohe üle minema

Kui kasutad endiselt vana Toolkiti, mine täna üle. Protsess võtab aega 10 minutit: deaktiveeri Toolkit, paigalda Envato Market, kleebi token. Tokeni loomine võtab minuti, plugina paigaldamine veel paar minutit ja kõik töötab.

Peamine kasu ei ole see, et „vana veel töötab". Kasu on see, et uus plugin kasutab infrastruktuuri, mida Envato arendab ja toetab. Vana Toolkit on ummiktee ja küsimus ei ole „kas see läheb katki", vaid „millal". See juhtub tavaliselt kõige ebasobivamal hetkel, kui ilmub turvaauku parandav teemauuendus ja sa ei saa uuendada.

Võta 10 minutit, paigalda Envato Market ja unusta käsitsi teemauuendused igaveseks.