Pagsusulat ng isang Simpleng WordPress Plugin, Panimulang Tutorial

Sa wika ng layman, isang plugin ng WordPress ay isang simpleng programa na makakatulong sa iyo upang ipasadya at mapahusay ang iyong website ng WordPress nang hindi kinakailangang i-edit ang pangunahing programming. Kapag master ka Pag-unlad ng plugin ng WordPress, magagawa mong idagdag ang lahat ng paraan ng pag-andar sa iyong WordPress blog nang hindi sa anumang oras. Ngunit bago ka maging isang pro, dapat mong malaman ang mga lubid.


Ang isang WordPress Plugin ay isang programa, o isang hanay ng isa o higit pang mga pag-andar, na nakasulat sa wika ng script ng PHP, na nagdaragdag ng isang tiyak na hanay ng mga tampok o serbisyo sa WordPress weblog, na maaaring maayos na isinama sa weblog gamit ang mga punto ng pag-access at pamamaraan ibinigay ng WordPress Plugin Application Program Interface (API). – Pagsulat ng isang Plugin, WordPress Codex

Sa post ngayon, papatnubayan ka namin sa proseso ng paglikha ng iyong unang plugin ng WordPress. Panatilihin naming simple ang tutorial upang magsilbi para sa unang developer ng oras na may kaunting walang kaalaman PHP (ang wika ng script sa likuran ng WordPress).

Bago bumaba sa aktwal na pag-coding, gayunpaman, titingnan namin ang ilang mga bagay na dapat mong maunawaan tungkol sa pag-unlad ng plugin ng WordPress.

Mga Pangunahing Kaalaman Upang Malaman Bago Lumikha ng Plugin ng WordPress

Sa bahaging ito, ibubunyag namin ang unang ilang mga hakbang kailangan mong sundin kapag lumilikha ng isang plugin ng WordPress. Bilang karagdagan, banggitin namin ang lahat ng iba’t ibang mga bagay na kailangan mong isaalang-alang habang isinusulat mo ang iyong plugin. Malaki. Magsimula tayo sa mga pangunahing kaalaman.

Paano Pangalanan ang isang WordPress Plugin

Bago ang lahat, kailangan mong makabuo ng isang natatanging pangalan para sa iyong WordPress plugin. Ang isa sa mga pinakamahusay na paraan upang matukoy ang isang kanais-nais na pangalan ay upang isipin kung ano ang gagawin ng iyong plugin. Kaya, halimbawa, kung ang iyong plugin ay makakatulong sa mga tao na magbahagi ng nilalaman sa pamamagitan ng social media, maaari mong isama ang pariralang “pagbabahagi ng social media” sa pangalan. Ang isa pang bagay, ang mga pangalan ng plugin ay maaaring maraming mga salita, kaya’t hindi mince pagkamalikhain.

Ang iyong pangalan ng plugin ay dapat na natatangi upang maiwasan ang mga salungatan sa iba pang mga plugin. Upang matiyak na kakaiba ang iyong pangalan, maaari kang gumawa ng paghahanap sa Google sa pangalan. Bilang karagdagan, maaari kang maghanap sa iba’t ibang mga direktoryo ng plugin kabilang ang Ang plugin ng WordPress plugin.

Upang pangalanan ang anumang plugin, kailangan naming lumikha ng hindi bababa sa isang plugin file (ang pangunahing file ng PHP), na nagpapakilala sa amin sa aming susunod na seksyon.

Paano Gumawa ng Plugin Files

Ang isang plugin ay maaaring binubuo ng isang solong file na PHP o maraming mga file depende sa kung ano ang idinisenyo na gawin. Ang pinakamahalagang file ay ang pangunahing PHP file, na kung saan ay katumbas ng index.php at index.html sa mga tema ng WordPress at mga disenyo ng HTML ayon sa pagkakabanggit.

Inirerekumenda na pangalan ng mga developer ng WordPress ang kanilang pangunahing plugin file pagkatapos ng kanilang plugin ayon sa kombensyon. Halimbawa, ang pangunahing plugin ng plugin para sa isang plugin na tinatawag na WP Renym plugin ay magiging wp-renym.php. Kung ang pagdaragdag ng isang separator sa iyong pangalan, gumamit lamang ng mga hyphens (-) sa pagitan ng mga salita kumpara sa mga underscore (_).

Tulad ng nabanggit sa itaas, ang isang plugin ay maaaring gawin ng isang solong o maraming mga file (mga imahe, JavaScript, wika, mga file ng CSS atbp). Alinmang paraan, ang iyong mga file ng plugin ay dapat manirahan sa isang direktoryo. Kaya para sa isang plugin na nagngangalang WP Renym the wp-renym.php mailalagay ang file sa isang wp-renym folder. Ang mga karagdagang sub folder ay maaaring idagdag sa loob ng pangunahing folder ng plugin upang maglaman at ayusin ang iba pang mga file.

Matapos mong ihiga ang lahat ng code para sa isang plugin pagkatapos ay i-compress mo ang iyong pangunahing folder sa isang file ng zip (sa kasong ito magiging wp-renym.zip archive) na mai-upload at mai-install sa isang WordPress site.

Pagdaragdag ng isang File Header sa Main PHP file

Kapag pinangalanan ang iyong plugin dapat kang magdagdag ng iba pang mga detalye tulad ng paglalarawan, bersyon, lisensya, pangalan ng may-akda – talaga ang lahat na lilitaw sa ilalim at kasabay ng iyong plugin sa Screen ng WordPress Plugins – ang header ng plugin. Para sa mga ito dapat mong gamitin ang isang standard header ng impormasyon ng plugin sa tuktok ng iyong pangunahing file ng PHP. Ganito ang hitsura ng isang tipikal na header:


/ *
Pangalan ng Plugin: Pangalan ng iyong plugin
Plugin URI: http: // link sa iyong homepage ng plugin
Paglalarawan: Ilarawan kung ano ang lahat ng tungkol sa iyong plugin sa ilang maiikling pangungusap
Bersyon: 1.0
May-akda: Ang iyong pangalan (Yay! Narito ang katanyagan ...)
May-akda URI: http: // link sa iyong website
Lisensya: GPL2 atbp
Lisensya ng Lisensya: http: // link sa iyong lisensya ng plugin
* /

Ang bawat parameter sa header sa itaas ay paliwanag sa sarili kaya hindi ako napunta sa mga detalye. Siguraduhing isama mo ang nauugnay http: // o https: // kapag sinusulat ang iyong Plugin at May-akda URI o ang mga link ay hindi gagana.

Sundin ang iyong header gamit ang sumusunod na impormasyon ng lisensya kung gagamitin mo ang Lisensya ng GPL2 o isang lisensya katugma sa GPL2:

/ * Copyright YEAR PLUGIN_AUTHOR_NAME (email: iyong email address)
(Pangalan ng Plugin) ay libre ng software: maaari mo itong muling ibigay at / o baguhin
ito sa ilalim ng mga tuntunin ng GNU General Public Lisensya tulad ng nai-publish ng
ang Libreng Software Foundation, alinman sa bersyon 2 ng Lisensya, o
anumang bersyon sa ibang pagkakataon.

(Pangalan ng Plugin) ay ipinamamahagi sa pag-asa na ito ay magiging kapaki-pakinabang,
ngunit WALANG ANUMANG SALAMAT; nang walang kahit na ang ipinahiwatig na garantiya ng
MERCHANTABILITY o PAGKAKAROON PARA SA ISANG LAYUNIN NA LAYUNIN. Tingnan ang
GNU General Public Lisensya para sa karagdagang detalye.

Dapat ay nakatanggap ka ng isang kopya ng GNU General Public License
kasama ang (Pangalan ng Plugin). Kung hindi, tingnan ang (http: // link sa iyong lisensya ng plugin).
* /

Ang saklaw ng tutorial na ito ay hindi pinapayagan sa amin na lampas sa mga pangunahing hakbang na ito. Kailangan mong suriin ang pagsulat ng isang plugin gabay sa codex upang matuto nang higit pa tungkol sa mga plugin ng WordPress plugin, mga tag ng template, pag-save ng data ng plugin sa mga database, mekanismo ng mga pagpipilian sa plugin at pag-update ng iyong plugin kasama ng iba pang mga bagay. Kasama rin sa codex ang isang napakalaking Mga Mapagkukunang Plugin koleksyon na puno ng mga gabay sa video, mga advanced na paksa at iba pa.

Ngayon na natakpan namin ang mga pangunahing kaalaman, magsulat tayo ng isang simpleng plugin ng WordPress na magsasagawa ng dalawang pangunahing (ngunit masarap) na pag-andar:

  • Palitan ang mga salita sa iyong nilalaman ng iyong sariling pagpili ng mga salita
  • Magdagdag ng isang “Salamat sa pagbabasa ng tutorial na ito …” tala sa dulo ng bawat post sa blog.

Paano Sumulat ng isang Simpleng WordPress Plugin – WP Renym

Sa seksyong ito, isusulat namin ang code para sa plugin ng WP Renym na nabanggit ko nang magkasama.

Ang iyong kailangan:

Pangalan ng aming Plugin

Una, sinuri namin ang imbakan ng plugin ng WordPress at ginawa ang isang paghahanap sa Google sa aming pangalan; Malaya ang WP Renym. Ang una kong pagpipilian ay ang WP Rename ngunit nakuha na ito.

Paglipat sa … Magbukas ng isang bagong file sa iyong editor ng code, at idagdag ang sumusunod na code sa tuktok pagkatapos buksan ang iyong plugin :

/ *
Pangalan ng Plugin: WP Renym
Plugin URI: http: // link sa iyong homepage ng plugin
Paglalarawan: Ang plugin na ito ay pumapalit ng mga salita sa iyong sariling pagpili ng mga salita.
Bersyon: 1.0
May-akda: Freddy Muriuki
May-akda URI: http: // link sa iyong website
Lisensya: GPL2 atbp
Lisensya ng Lisensya: https: // link sa iyong lisensya ng plugin

Copyright YEAR PLUGIN_AUTHOR_NAME (email: iyong email address)
(Pangalan ng Plugin) ay libre ng software: maaari mo itong muling ibigay at / o baguhin
ito sa ilalim ng mga tuntunin ng GNU General Public Lisensya tulad ng nai-publish ng
ang Libreng Software Foundation, alinman sa bersyon 2 ng Lisensya, o
anumang bersyon sa ibang pagkakataon.

(Pangalan ng Plugin) ay ipinamamahagi sa pag-asa na ito ay magiging kapaki-pakinabang,
ngunit WALANG ANUMANG SALAMAT; kahit na walang ipinahiwatig na garantiya ng
MERCHANTABILITY o PAGKAKAROON PARA SA ISANG LAYUNIN NA LAYUNIN. Tingnan ang
GNU General Public Lisensya para sa karagdagang detalye.

Dapat ay nakatanggap ka ng isang kopya ng GNU General Public License
kasama ang (Pangalan ng Plugin). Kung hindi, tingnan ang (http: // link sa iyong lisensya ng plugin).
* /

I-save ang file bilang wp-renym.php sa folder na wp-renym. Kung wala ka nang folder, lumikha ito. wp-renym.php ay ang iyong pangunahing file ng PHP.

Pagdaragdag ng Mga Pag-andar

Ngayon upang idagdag ang aktwal na pag-andar sa plugin. Sa ibaba lamang ng code sa itaas, idagdag ang sumusunod na pag-andar upang iwasto ang mga maling impormasyon ng wordpress sa WordPress:

pag-andar renym_wordpress_typo_fix ($ text) {
bumalik str_replace ('wordpress', 'WordPress', $ text);
}
add_filter ('the_content', 'renym_wordpress_typo_fix');

renym_wordpress_typo_fix ay ang natatanging pangalan na ibinigay namin sa aming function. Kapag nagdaragdag ng mga bagong pag-andar ay hindi kailanman magsisimula sa kanila wp_ – upang maiwasan ang anumang mga hindi pagkakatugma sa hinaharap sa mga pag-andar ng code ng WordPress na ginagamit ng lahat ng prefix wp_.

Tumatagal ang aming function ng PHP ($ text) bilang argumento, at ibabalik ang 1st string na ‘wordpress’ na pinalitan ng 2nd string na ‘WordPress’.

Nagdagdag kami ng isang filter (add_filter) sa aming plugin upang sabihin sa aming pag-andar ( renym_wordpress_typo_fix ) upang gumana sa teksto na napili natin, na sa kasong ito ay ang buong nilalaman ng post (ang_content).

Upang palitan ang higit sa isang salita (marahil ay nais mong i-edit ang maraming mga salita sa buong blog o gamitin ang plugin bilang isang simpleng kabastusan filter), palitan ang code sa itaas sa sumusunod na code:

function renym_content_replace ($ nilalaman) {
$ search = array ('wordpress', 'kambing', 'Easter', '70', 'sensational');
$ replacement = array ('WordPress', 'kape', 'Easter holiday', 'pitumpu', 'pambihirang');
bumalik str_replace ($ search, $ palitan, $ nilalaman);
}
add_filter ('the_content', 'renym_content_replace');

Sa aming code sa itaas, napili na namin ang mga salita upang palitan ang hal. wordpress, kambing, Easter, atbp Napili din namin ang mga kapalit na salita e.g. WordPress, kape, pista opisyal ng Pasko atbp. Sana ang code ay medyo paliwanag sa sarili:

  • Ang renym_content_replace Tumatagal ang pag-andar ($ nilalaman) bilang argumento, pinapalitan ang lahat ng mga salita na nilalaman sa $ search array at ibabalik ang ngayon na binagong mga salita sa WordPress.
  • Ang paghahanap sa $ ay naglalaman ng lahat ng mga salita na papalitan
  • Ang $ palitan ay naglalaman ng mga salitang kapalit
  • ginagawa ng str_replace kung ano ang pinakamahusay na ginagawa, pinapalitan ang mga salita sa mga bagong salita

Tandaan kung paano namin idagdag ang prefix renym sa bawat pag-andar. Pinipigilan nito ang mga salungatan sa iba pang mga plugin na maaaring mai-install. Dapat kang sumali sa pagdaragdag ng mga prefix sa iyong mga pag-andar kung nakabubuo ka ng mga plugin, tema o mga widget.

Kung nakumpleto mo na ang mga hakbang sa itaas na maaaring mapalitan ng iyong plugin nang epektibo ang lahat ng iyong napiling mga salita. Ngayon ay idagdag ang “Salamat sa pagbabasa ng tutorial na ito …” na lilitaw na lilitaw sa ilalim ng bawat post. Idagdag ang sumusunod na code sa iyong pangunahing plugin file ( renym_content_replace ) bago ang pagsasara ng PHP bracket ( ?> ) Na darating sa huling linya:

pag-andar renym_content_footer_note ($ nilalaman) {
$ nilalaman. = '
Salamat sa pagbabasa ng tutorial na ito. Baka sa susunod ay hahayaan kitang bumili ng kape ko! Para sa higit pang mga tutorial sa WordPress bisitahin ang aming Blog
'; ibalik ang nilalaman ng $; } add_filter ('the_content', 'renym_content_footer_note');

I-save ang mga pagbabago. Ang renym_content_footer_note Ang pag-andar ay nagdaragdag ng markup ng HTML sa parameter ng nilalaman ng $ at ibabalik ang bagong halaga sa WordPress. Nagdagdag din kami ng isang klase ng footer sa aming teksto upang madali itong mai-istilo sa susunod.

Nagsama kami ng isang filter (add_filter) na nagsasabi sa aming pag-andar na gumana sa teksto na napili namin, na ang nilalaman ng post na kinakatawan ng_content.

I-compress ang Iyong Folder

Sa puntong ito, ang iyong pangwakas wp-renym.php ang file ay dapat magmukhang ganito:

Salamat sa pagbabasa ng tutorial na ito. Baka sa susunod ay hahayaan kitang bumili ng kape ko! Para sa higit pang mga tutorial sa WordPress bisitahin ang aming Blog';
ibalik ang nilalaman ng $;
}
add_filter ('the_content', 'renym_content_footer_note');

?>

I-save ang lahat ng iyong mga pagbabago. I-compress ang WP Renym folder sa isang wp-renym.zip archive (sa isang Mac ito ay kasingdali ng pag-click sa kanan, i-compress ang file – at sa PC ay beleive ko ito halos). Siguraduhin lamang na nakakatipid ang iyong file bilang isang extension ng ZZ o hindi mai-install ang plugin.

Gamitin ang Iyong Plugin

Mag-upload at buhayin ang iyong bagong WP Renym plugin sa pamamagitan ng Screen ng WordPress Plugins. Binabati kita sa pagsulat ng iyong unang plugin!

I-install ang Renym WordPress Plugin

Mga mapagkukunan

Upang matuto nang higit pa sa pag-unlad ng plugin ng WordPress, mangyaring suriin ang mga sumusunod na mapagkukunan:

Konklusyon

Inaasahan ko na itinuro ka ng tutorial na ito sa tamang direksyon hanggang sa pag-unawa sa mga plugin. Ang post na ito ay dapat na magsilbi bilang isang hakbang sa pagbuo ng kumplikadong mga plugin ng WordPress na gumagawa ng anumang nais mo. Huwag tumigil dito, tingnan ang mga mapagkukunang inirerekumenda ko sa itaas upang madagdagan ang iyong kaalaman sa pag-unlad ng plugin ng WordPress.

Kung natagpuan mo ang kapaki-pakinabang na tutorial na ito o kung mayroon kang iba pa upang madagdagan ang nais naming malaman. Mangyaring ibahagi ang iyong mga saloobin sa seksyon ng mga komento sa ibaba. Makita ka sa paligid ��

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map