Písanie jednoduchého doplnku WordPress, výučba pre začiatočníkov

V laikovom jazyku je doplnok WordPress jednoduchý program, ktorý vám pomôže prispôsobiť a vylepšiť webovú stránku WordPress bez toho, aby ste museli upravovať základné programovanie. Keď ovládate Vývoj doplnkov WordPress, do svojho blogu WordPress budete môcť kedykoľvek pridať všetky funkcie. Ale predtým, ako sa stanete profesionálom, musíte sa naučiť laná.


Doplnok WordPress je program alebo skupina jednej alebo viacerých funkcií napísaných v skriptovacom jazyku PHP, ktorý do weblogu WordPress pridáva špecifickú sadu funkcií alebo služieb, ktoré je možné bez problémov integrovať do weblogu pomocou prístupových bodov a metód. poskytuje rozhranie aplikačného programového rozhrania WordPress Plugin Application API (API). – Písanie doplnku, WordPress Codex

V dnešnom príspevku vás prevedieme procesom vytvorenia prvého doplnku WordPress. Udržujeme tutoriál jednoduchý na to, aby vyhovoval prvému vývojárovi, ktorý má málo alebo vôbec žiadne vedomosti PHP (skriptovací jazyk za WordPress).

Predtým, ako sa pustíme do skutočného kódovania, sa však pozrieme na pár vecí, ktorým by ste mali porozumieť pri vývoji doplnku WordPress.

Základy, ktoré treba vedieť pred vytvorením doplnku WordPress

V tejto časti odhalíme prvých pár krokov musíte postupovať pri vytváraní doplnku WordPress. Pri písaní doplnku sa navyše zmienime o všetkých rôznych veciach, ktoré musíte vziať do úvahy. Skvelé. Začnime základmi.

Ako pomenovať doplnok WordPress

Pred všetkým ostatným musíte prísť s jedinečným názvom pre váš doplnok WordPress. Jedným z najlepších spôsobov, ako zistiť priaznivé meno, je vymyslieť si, čo bude váš doplnok robiť. Napríklad, ak váš doplnok pomôže ľuďom zdieľať obsah prostredníctvom sociálnych médií, do názvu môžete uviesť frázu „zdieľanie sociálnych médií“. Ďalšou vecou môže byť, že názvy doplnkov môžu obsahovať niekoľko slov, takže kreativitu neprekážajte.

Názov doplnku musí byť jedinečný, aby nedošlo k konfliktom s inými doplnkami. Ak sa chcete ubezpečiť, že vaše meno je jedinečné, môžete pre toto meno vyhľadať vyhľadávanie Google. Ďalej môžete prehľadávať rôzne adresáre doplnkov vrátane Archív doplnkov WordPress.

Aby sme mohli pomenovať ľubovoľný doplnok, musíme vytvoriť aspoň jeden súbor doplnku (hlavný súbor PHP), ktorý nás uvedie do našej ďalšej časti..

Ako vytvárať súbory doplnkov

Doplnok môže pozostávať z jedného súboru PHP alebo viacerých súborov v závislosti od toho, na čo je určený. Najdôležitejším súborom je hlavný súbor Súbor PHP, čo je ekvivalent index.php a index.html v témach WordPress a HTML dizajnoch.

Odporúča sa, aby vývojári WordPress pomenovali svoj hlavný súbor doplnku podľa svojho doplnku podľa konvencie. Napríklad hlavný súbor doplnku pre doplnok s názvom doplnok WP Renym by bol wp-renym.php. Ak do svojho názvu pridávate oddeľovač, na rozdiel od podčiarkov (_) používajte iba spojovníky (-) medzi slovami.

Ako je uvedené vyššie, doplnok môže byť vyrobený z jedného alebo viacerých súborov (obrázky, JavaScript, jazyk, súbory CSS atď.). V žiadnom prípade však vaše súbory pluginu musia žiť v jednom adresári. Takže pre doplnky s názvom WP Renym the wp-renym.php súbor by sa umiestnil do súboru wp-Reny zložky. Do hlavnej zložky doplnku je možné pridať ďalšie podpriečinky, ktoré obsahujú a usporiadajú ďalšie súbory.

Po nastavení celého kódu pre doplnok potom komprimujete svoju hlavnú zložku do súboru ZIP (v tomto prípade by to bol archív wp-renym.zip), ktorý sa má nahrať a nainštalovať na webovú stránku WordPress..

Pridanie hlavičky súboru do hlavného súboru PHP

Pri pomenovávaní doplnku by ste mali pridať ďalšie podrobnosti, ako napríklad popis, verziu, licenciu, meno autora – v podstate všetko, čo sa objaví pod a vedľa doplnku v Obrazovka doplnkov WordPress – hlavička doplnku. Na tento účel musíte použiť a štandardná hlavička informácií o doplnkoch v hornej časti hlavného súboru PHP. Takto vyzerá typická hlavička:


/ *
Názov doplnku: Názov doplnku
URI doplnku: http: // odkaz na domovskú stránku doplnku
Popis: Popíšte, o čom váš doplnok je, v niekoľkých krátkych vetách
Verzia: 1.0
Autor: Vaše meno (Yay! Tu je sláva ...)
URI autora: http: // odkaz na vaše webové stránky
Licencia: GPL2 atď
URI licencie: http: // odkaz na vašu licenciu doplnku
* /

Každý parameter v hlavičke vyššie je samovysvetľujúci, takže sa nebudem venovať podrobnostiam. Len sa uistite, že ste zahrnuli príslušné informácie http: // alebo https: // keď píšete URI doplnkov a autorov alebo odkazy nebudú fungovať.

Ak použijete a, sledujte v hlavičke nasledujúce licenčné informácie Licencia GPL2 alebo licenciu kompatibilný s GPL2:

/ * Autorské práva YEAR PLUGIN_AUTHOR_NAME (e-mail: vaša e-mailová adresa)
(Plugin Name) je bezplatný softvér: môžete ho distribuovať a / alebo upravovať
to za podmienok Všeobecnej verejnej licencie GNU uverejnenej spoločnosťou
- Free Software Foundation, buď verzia 2 licencie, alebo -
akúkoľvek neskoršiu verziu.

(Názov doplnku) je distribuovaný v nádeji, že to bude užitočné,
ale BEZ ŽIADNEJ ZÁRUKY; bez predpokladanej záruky
OBCHODOVATEĽNOSŤ alebo VHODNOSŤ PRE URČITÝ ÚČEL. Pozri
GNU General Public License pre viac informácií.

Mali ste dostať kópiu Všeobecnej verejnej licencie GNU
spolu s (Názov doplnku). Ak nie, pozrite si (http: // odkaz na vašu licenciu doplnku).
* /

Rozsah tohto návodu nám neumožňuje prekročiť tieto základné kroky. Budete sa musieť pozrieť na písanie doplnku Sprievodca v kódexe sa dozviete viac o hákoch doplnkov WordPress, značkách šablón, ukladaní údajov doplnkov do databáz, mechanizme možností doplnkov a aktualizácii doplnku okrem iného. Codex tiež obsahuje masívne Zdroje doplnkov zbierka plná sprievodcov videa, pokročilých tém a ďalších tém.

Teraz, keď sme sa zaoberali základmi, napíšme jednoduchý doplnok WordPress, ktorý bude vykonávať dve základné (ale šikovné) funkcie:

  • Nahraďte slová vo svojom obsahu podľa vlastného výberu slov
  • Na koniec každého blogového príspevku pridajte poznámku „Ďakujem za prečítanie tohto tutoriálu …“.

Ako napísať jednoduchý doplnok WordPress – WP Renym

V tejto sekcii napíšeme kód pre doplnok WP Renym, o ktorom som hovoril.

Čo potrebuješ:

Pomenovanie nášho doplnku

Najprv sme skontrolovali úložisko doplnkov WordPress a vykonali vyhľadávanie Google na našom mene; WP Renym bol voľný. Moja pôvodná voľba bola WP Premenovať, ale už bola vybraná.

Pohybuje sa … Otvorte nový súbor v editore kódu a po otvorení doplnku pridajte nasledujúci kód hore :

/ *
Názov doplnku: WP Renym
URI doplnku: http: // odkaz na domovskú stránku doplnku
Popis: Tento doplnok nahrádza slová podľa vlastného výberu slov.
Verzia: 1.0
Autor: Freddy Muriuki
URI autora: http: // odkaz na vaše webové stránky
Licencia: GPL2 atď
URI licencie: https: // odkaz na vašu licenciu doplnku

Autorské práva YEAR PLUGIN_AUTHOR_NAME (e-mail: vaša e-mailová adresa)
(Plugin Name) je bezplatný softvér: môžete ho distribuovať a / alebo upravovať
to za podmienok Všeobecnej verejnej licencie GNU uverejnenej spoločnosťou
- Free Software Foundation, buď verzia 2 licencie, alebo -
akúkoľvek neskoršiu verziu.

(Názov doplnku) je distribuovaný v nádeji, že to bude užitočné,
ale BEZ ŽIADNEJ ZÁRUKY; bez predpokladanej záruky
OBCHODOVATEĽNOSŤ alebo VHODNOSŤ PRE URČITÝ ÚČEL. Pozri
GNU General Public License pre viac informácií.

Mali ste dostať kópiu Všeobecnej verejnej licencie GNU
spolu s (Názov doplnku). Ak nie, pozrite si (http: // odkaz na vašu licenciu doplnku).
* /

Uložte súbor ako wp-renym.php v priečinku wp-renym. Ak priečinok ešte nemáte, vytvorte ho. wp-renym.php bude váš hlavný súbor PHP.

Pridávanie funkcií

Teraz pridajte aktuálne funkcie do doplnku. Hneď pod kódom vyššie pridajte nasledujúcu funkciu, aby ste opravili pravopisné chyby wordpress na WordPress:

funkcia renym_wordpress_typo_fix ($ text) {
return str_replace ('wordpress', 'WordPress', $ text);
}
add_filter ('the_content', 'renym_wordpress_typo_fix');

renym_wordpress_typo_fix je jedinečné meno, ktorému sme dali funkciu. Pri pridávaní nových funkcií ich nikdy nezačínajte wp_ – predídete tým akýmkoľvek budúcim nekompatibilitám s funkciami kódu WordPress, ktoré používajú predponu wp_.

Naša funkcia PHP berie ako argument argument ($ text) a vracia prvý reťazec „wordpress“ nahradený druhým reťazcom „WordPress“.

Do nášho doplnku sme pridali filter (add_filter), ktorý hovorí našej funkcii ( renym_wordpress_typo_fix ) pracovať na vybratom texte, ktorým je v tomto prípade celý príspevok (the_content).

Ak chcete nahradiť viac ako jedno slovo (možno by ste chceli na svojom blogu upraviť viac slov alebo použiť doplnok ako jednoduchý profanitový filter), nahraďte vyššie uvedený kód nasledujúcim kódom:

function renym_content_replace ($ content) {
$ search = array ('wordpress', 'goat', 'Easter', '70', 'sensational');
$ Nahradiť = array ('WordPress', 'káva', 'Veľkonočné sviatky', 'sedemdesiat', 'mimoriadne');
return str_replace ($ search, $ Nahradiť, $ content);
}
add_filter ('the_content', 'renym_content_replace');

V našom kóde vyššie sme už vybrali slová, ktoré sa majú nahradiť napr. wordpress, koza, Veľká noc atď. Vybrali sme aj náhradné slová, napr. WordPress, káva, veľkonočné sviatky atď. Dúfajme, že kód je trochu samovysvetľujúci:

  • renym_content_replace Funkcia berie ($ content) ako argument, nahradí všetky slová obsiahnuté v $ vyhľadávacom poli a vráti teraz upravené slová do WordPress.
  • $ search obsahuje všetky slová, ktoré sa majú nahradiť
  • $ nahradiť obsahuje náhradné slová
  • str_replace robí to, čo vie najlepšie, a nahrádza slová novými slovami

Všimnite si, ako pridávame predponu Reny pre každú funkciu. Tým sa zabráni konfliktom s inými nainštalovanými doplnkami. Mali by ste si zvyknúť pridávať predpony do svojich funkcií, či už vyvíjate doplnky, témy alebo widgety.

Ak ste dokončili vyššie uvedené kroky, váš doplnok môže efektívne nahradiť všetky vybraté slová. Teraz pridajte poznámku „Ďakujeme vám za prečítanie tohto tutoriálu …“, ktorá sa objaví v dolnej časti každého príspevku. Pridajte nasledujúci kód do hlavného súboru doplnku ( renym_content_replace ) pred uzatváracou zátvorkou PHP ( ?> ), Ktorá sa nachádza v poslednom riadku:

function renym_content_footer_note ($ content) {
$ content. = '
Ďakujeme vám za prečítanie tohto návodu. Možno nabudúce ti dovolím kúpiť si kávu! Ďalšie príručky WordPress nájdete na našom blogu
,; návrat $ content; } add_filter ('the_content', 'renym_content_footer_note');

Uložte zmeny. renym_content_footer_note Funkcia pridá značku HTML do parametra $ content a vráti novú hodnotu do WordPress. Do nášho textu sme tiež pridali triedu päty, aby sme ju mohli neskôr ľahko upraviť.

Zaradili sme filter (add_filter), ktorý hovorí, že naša funkcia má pracovať s textom, ktorý sme vybrali, čo je obsah príspevku, ktorý reprezentuje the_content.

Skomprimujte priečinok

V tomto okamihu, vaše finále wp-renym.php súbor by mal vyzerať takto:

Ďakujeme vám za prečítanie tohto návodu. Možno nabudúce ti dovolím kúpiť si kávu! Ďalšie príručky WordPress nájdete na našom blogu,;
návrat $ content;
}
add_filter ('the_content', 'renym_content_footer_note');

?>

Uložte všetky svoje zmeny. Komprimujte priečinok WP Renym do a wp-renym.zip archív (v počítačoch Mac je to rovnako jednoduché ako kliknutie pravým tlačidlom myši, komprimovanie súboru – a na počítači sa domnievam, že je veľmi podobný). Len sa uistite, že sa váš súbor uloží ako prípona .ZIP alebo sa doplnok nenainštaluje.

Použite svoj doplnok

Nahrajte a aktivujte svoj nový doplnok WP Renym pomocou Obrazovka doplnkov WordPress. Gratulujeme vám k vytvoreniu prvého doplnku!

Nainštalujte doplnok Renym WordPress

zdroje

Ak sa chcete dozvedieť viac o vývoji doplnkov WordPress, pozrite si nasledujúce zdroje:

záver

Dúfam, že tento tutoriál vás nasmeroval správnym smerom, pokiaľ ide o pochopenie doplnkov. Tento príspevok by mal slúžiť ako odrazový mostík pre vývoj zložitých doplnkov WordPress, ktoré robia všetko, čo chcete. Nezastavujte sa tu, pozrite sa na zdroje, ktoré som odporúčal vyššie, aby ste si rozšírili svoje znalosti o vývoji doplnkov WordPress.

Ak by vám tento tutoriál pomohol alebo ak by ste chceli pridať čokoľvek iné, radi by sme to vedeli. Prosím, podeľte sa o svoje myšlienky v sekcii komentárov nižšie. Uvidíme sa ��

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