Cutia de instrumente a dezvoltatorului inteligent WordPress GitHub Plugin Updater

Nu doriți să găzduiți pluginul în directorul de pluginuri WordPress.org? Bineînțeles, poți decide să nu-ți fie o comunitate liberă. Dar trebuie să-l găzduiți undeva, astfel încât plugin-ul să poată fi găsit, și tu, de asemenea, ar trebui să ofere utilizatorilor dvs. actualizări plugin-ul. 

Majoritatea oamenilor care decid să nu găzduiască pluginurile lor pe WordPress.org tind să utilizeze GitHub, dar WordPress nu știe cum să actualizeze pluginurile găzduite de GitHub - are nevoie de ajutor. Și astăzi, vă vom ajuta să vă ajutați să vă actualizați pluginurile WordPress, ați ghicit-o, o clasă de ajutor.

În această parte a seriei "Toolbox a dezvoltatorului inteligent WordPress", vom trece prin programul WordPress GitHub Plugin Updater, un instrument pentru a gestiona procesul de actualizare a pluginurilor WordPress găzduite pe GitHub.

De ce să folosiți GitHub în loc de WordPress.org?

Ca orice alt sistem modular de gestionare a conținutului, WordPress are propriul depozit de plugin-uri. Și nu aș fi greșit dacă aș spune că WordPress.org Plugin Directory a devenit standardul comunității pentru găzduirea pluginurilor gratuite și open source WordPress.

Dar, după cum am spus la început, aceasta este o comunitate gratuită. WordPress nu ne cere să găzduim fiecare plugin și temă pe care o facem în directorul Plugin WordPress.org. Oamenii pot alege să se îndepărteze de ea, și asta e perfect natural.

Primul loc pe care oamenii le găzduiesc pluginurile WordPress după ce directorul de pluginuri WordPress.org este GitHub. Folosind sistemul minunat de control al revizuirii numit Git, GitHub este unul dintre cele mai bune locuri pentru a partaja software-ul open source cu restul lumii. În ultimii ani, tot mai mulți dezvoltatori WordPress au publicat noile plug-in-uri pe GitHub.

Avantaje și dezavantaje ale schimbării de la directorul de pluginuri WordPress.org la GitHub

Cred că există un echilibru între avantajele și dezavantajele găzduirii pluginurilor WordPress pe GitHub în locul directorului Plugin WordPress.org. Mă voi pronunța pe cei care îmi vin în minte, dar mi-ar plăcea și contribuția la asta, deci nu ezitați să trageți un comentariu în secțiunea Comentarii după ce ați citit acest.

Când găzduiți pluginurile pe WordPress.org:

• Trebuie să utilizați SVN.
• Pluginul dvs. trebuie să fie aprobat de un reviewer WordPress.org înainte de al putea încărca. (Acest lucru este un avantaj și un dezavantaj pentru mine, deoarece având un al doilea set de ochi pe cod este bun pentru a observa defectele de securitate.)
• Puteți utiliza GPL (versiunea 2 sau o versiune ulterioară) ca licențiere.
• Actualizările pluginului dvs. vor fi notificate rapid utilizatorilor dvs..
• Actualizările plugin-ului de urgență (din motive de securitate) vor fi împinse automat către utilizatori.
• Oamenii vă pot găsi plugin-ul direct de pe panoul de administrare, ceea ce reprezintă un plus imens.
• Puteți utiliza forumurile de asistență ale WordPress.org.

Și când decideți să treceți la GitHub:

• Veți putea folosi Git.
• Vei avea libertate infinit mai mare.
• Puteți utiliza alte tipuri de licențe (cum ar fi MIT sau CC, chiar dacă CC nu este recomandat pentru software).
• Puteți crea un wiki, accepta angajamente și discutați despre probleme cu utilizatorii dvs..
• Nu veți avea niciun rating pentru pluginurile dvs., ceea ce este rău pentru feedback.
• Va trebui să finalizați acest tutorial pentru a oferi mai ușor actualizări de pluginuri.

Există, de asemenea, o discuție plăcută despre Taverna WordPress care - cred că - ar trebui să citiți și ea.

Integrarea aplicației WordPress GitHub Plugin Updater în plug-in-ul dvs.

Sunteți gata să furnizați notificări de actualizare pentru utilizatorii dvs.?

În primul rând și evident, trebuie să descărcați WordPress GitHub Plugin Updater din depozitul său GitHub. Veți avea nevoie doar de updater.php fișier, deci nu vă faceți griji cu ceilalți.

După aceea, trebuie să puneți updater.php fișier undeva în dosarul plugin-ului și includeți-l în plugin-ul dvs. De exemplu, dacă puneți updater.php fișier într-un folder numit github-plugin-updater și doriți să-l includeți în fișierul principal de plugin, trebuie să adăugați următoarea linie în acel fișier:

De asemenea, trebuie să inițializați WP_GitHub_Updater clasă cu argumente corecte pentru a conecta pluginul la repo GitHub:

 plugin_basename (__FILE__), 'proper_folder_name' => 'plugin-name', 'api_url' => 'https://api.github.com/repos/username/repository-name', 'raw_url' /raw.github.com/username/repository-name/master ',' github_url '=>' https://github.com/username/repository-name ',' zip_url '=>' https://github.com / username / repository-name / zipball / master ',' sslverify '=> true,' requires '=>' 3.0 ',' tested '=>' 3.3 ',' readme '=>' README.md ',' access_token '=> "); noul WP_GitHub_Updater ($ config);?>

• melc: Blocul plugin-ului tău.
• proper_folder_name: Numele folderului pluginului.
• api_url: Adresa URL API a GitHub repo.
• raw_url: URL-ul dvs. brut al repo-ului GitHub.
• github_url: Adresa URL a repo GitHub.
• zip_url: Adresa dvs. URL ZIP a lui GitHub repo.
• sslverify: Verificarea SSL sau nu.
• necesită: Versiunea minimă WordPress pe care pluginul dvs. o cere.
• testat: Versiunea WordPress maximă cu care ați testat pluginul.
• Citește-mă (depreciat): Fișierul README pentru verificarea versiunii pluginului.
• jeton de acces: Indicativul dvs. de acces GitHub, dacă utilizați un repo privat.

Pentru a vă notifica utilizatorii, tot ce trebuie să faceți este să modificați versiunea pluginului în antetele principale ale fișierului. (Se pare că acest instrument a folosit pentru a verifica fișierul README pentru o linie care conține ~ Versiunea curentă: X.X ~ dar din versiunea 1.6, ea caută mai întâi fișierul plugin principal.)

Si asta e! Urmând acești pași, veți permite notificări de actualizare pentru pluginul dvs..

Împachetarea pentru ziua de azi

Dacă doriți să găzduiți pluginul WordPress pe GitHub și doriți să furnizați notificări de actualizare pentru utilizatorii dvs., WordPress GitHub Plugin Updater este unul dintre instrumentele esențiale pe care ar trebui să le utilizați.

Ce credeți despre acest instrument sau ce găzduiți pluginuri WordPress pe GitHub în general? Împărtășiți-vă gândurile cu noi comentând în secțiunea Comentarii de mai jos. Și dacă ți-a plăcut articolul, nu uita să îl împarți cu prietenii tăi!