Водич за почетнике за ВордПресс Плугин развој

ВордПресс ЦМС је променио лице нашег Интернета и омогућио напредак нових идеја и његов опен соурце покрет држи снажну присутност укорењену у развоју софтвера и веба. ВордПресс је платформа за блогове која има могућност да покрене многе друге скрипте као што су веб форуми, форуми за посао, па чак и класични систем за управљање садржајем на веб страници..

Прећи ћемо на неколико начина да започнемо развој плуг-инова за ВордПресс. Кораци су прилично једноставни и не захтевају велику посвећеност учењу. Основно знање о ПХП-у било би корисно и уз основно разумијевање ВордПресс структуре датотека и администрацијског панела.

У овом кратком туторијалу бавићемо се основним корацима потребним за креирање једноставног ВордПресс додатка. Функционалност ће се користити за креирање динамичких извода на основу броја који је прешао у наш позив функције. Мораћете да отпремите датотеку додатка и активирате је са Админ панела, а затим наставите тако што ћете позвати нашу функцију са било које странице коју желимо да се појави. Везе до довршеног изворног кода додатка су већ додане касније у овом чланку :)

Зашто развити за ВордПресс?

Додаци су одличан начин да побољшате функционалност свог блога додавањем додатних функција. Они се могу поставити било гдје унутар вашег предлошка помоћу кукица за функције. Временом је проширивост ВордПресс-овог плуг-ин система омогућила огроман раст и стотине софтвера који су послали програмери.

ВордПресс посебно нуди такве напредне функције у свом ЦМС-у да су јединствени плуг-инови малобројни. Као програмер имате потпуну контролу над специфичностима вашег веблог-а. Унајмљивање ПХП програмера за креирање системског додатка коштало би много више него што можете замислити, а АПИ је прилично једноставан да бисте радили и сами учили.

Као секундарни аргумент, развијање у ВордПресс-у је одлична пракса за подешавање себе у друге области. Изградња мањих додатака и видгета у ВордПресс-у ће вам помоћи да схватите како позадински систем заиста функционише. Ово није ограничено само на ВордПресс јер ћете стећи дубље разумевање велике већине садржаја система.

1. Структура ВП фолдера

Увод у структуру фолдера ВордПресс-а ће приказати основне директорије апликација. Унутар вп-садржаја наћи ћете плугинс директоријум. Овде ће бити смештени сви ваши појединачни додаци, или појединачни фајлови или правилно именовани под-директоријуми.

За мање плуг-инове који захтевају само једну .пхп датотеку имате опцију да је поставите директно у плуг-инс / директоријум. Међутим, када почнете да развијате компликованије апликације, много је корисније креирати под директоријум по имену вашег додатка. Унутар можете укључити ЈаваСцрипт, ЦСС и ХТМЛ заједно са вашим ПХП функцијама.

А реадме.ткт датотека такође може бити корисна ако планирате да понудите свој додатак за преузимање. Ова датотека треба да садржи ваше име и шта плугин ради. Као аутор можете размотрити и детаље о свакој ревизији и која су ажурирања објављена.

2. Покретање ПХП датотеке

Приликом креирања новог додатка морате почети са једноставном ПХП датотеком. Ово се може назвати било чиме, али би требало да одражава званично име вашег додатка. Тако сам, на пример, креирао наш основни код и назвао сам свој хонгкиат-екцерпт.пхпс.

Први редови вашег додатка муст бити информација о коментарима за анализирање мотора. Ово је изузетно важно јер ВордПресс неће моћи да обради вашу датотеку без. У наставку је приказан примјер одломка кода који можете копирати и обликовати према властитом.

Назив додатка је оно што ће се приказати у панелу Админ позадине када идете да активирате. Исто је и са УРИ-јем који ће бити смештен у окну са детаљима унутар плуг-инс панела. Иако није потребно укључити верзију или опис, ваш додатак ће изгледати много професионалније.

3. ВордПресс конвенције именовања и најбоље праксе

Постоји неколико начина да структуришете свој додатак. Много пута ПХП програмери креирају цео систем класа како би избегли колизије са функцијама и именима променљивих. Ако нисте упознати са напредним ООП функционалностима ПХП-а онда је најбоље да напишете свој код у узорцима функција.

Дакле, за наш пример код ћемо написати једну функцију да бисмо похранили наше податке. Такође морамо да дефинишемо неколико променљивих које су кључне за имплементацију у нашим датотекама шаблона. У наставку је приказан примјер кода преузетог из наше датотеке додатка са уклоњеном логичком језгром.

Приликом писања узорка најбоље је да се придржавате прописа и упутстава које је поставио ВордПресс. Пошто постоји толико много интерних функција које су већ дефинисане, можете избећи дупликате префиксом ознаке на све ваше променљиве и имена функција.

У горе наведеним примјерима смо префиксирали сва наша имена за постављање хонгкиат. Ово се може заменити било којом кључном речју по вашем избору која се обично односи на ваше име додатка. Горњи код је праведан сампле сеттингс и не треба се односити на наш коначни додатак. Ово је само да би вам дало увид у то како би требало да се напишу имена променљивих и позиви функција.

4. Роњење у филтере и акције

Постоји још један концепт који вриједи споменути прије него што скочимо у наш сирови код. Акције и филтери су два потпуно различита концепта који се дубоко односе на начин на који манипулишу подацима о додатцима.

Ова два бита кода долазе стандардно унутар ВордПресс АПИ-ја. Филтри и акције дозвољавају програмерима плуг-ина да ажурирају битове кода кроз ВордПресс админ панел који се односи на ваш нови плуг-ин. То значи да можете додати нову картицу у бочну траку или додатне везе поставки за опције додатка.

Разумевање адд_филтер ()

А филтер се користи на мало текста или података који се преносе у ВордПресс. Са филтерима које сте дословно у могућности филтер цонтент преко сопствених прилагођених писаних функција за промену података на било који начин.

На пример, можете да креирате филтер за промену $ тхе_цонтент која је варијабла постављена од стране ВордПресс-а која садржи целокупан садржај поруке у ВордПресс чланку. За наш плуг-ин ћемо га узети $ тхе_цонтент и скраћивање дужине знакова у одломак.

Филтри су корисни када пишете додатке да бисте прилагодили изглед и дојам блога. Они су посебно популарни када пишете видгете бочне траке или мање функције да бисте променили начин приказа поста. У наставку је приказан пример линије кода која показује како да примените филтер.

адд_филтер ('вп_титле', 'хонгкиат_фунц');

Овде додајемо филтер у наслов ВордПресс странице. Овај код се не односи на наш званични додатак и користи се само као пример.

Тхе адд_филтер Функција је природна за ВордПресс и користи се за додавање новог филтера променљивој која се налази унутар садржаја странице. У горњем реду циљамо $ вп_титле која садржи наслов наше тренутне странице. Ми онда преносимо ову варијаблу у лажну функцију под називом хонгкиат_фунц () који би онда могао манипулирати и вратити нову ознаку наслова за било коју сврху.

Разумевање адд_ацтион ()

Радње су сличне филтерима у томе што не раде на битовима података, већ се преусмеравају на унапред дефинисане области у шаблонима и администраторском панелу. Као примјер можете примијенити радњу сваки пут када ажурирате или уредите садржај странице. ВордПресс нуди свеобухватну листу акција у својој АПИ документацији. У наставку се налази мала листа примера акција за вас да се упознате са неким од унапред дефинисаних циљних области.

публицатион_пост - позвани када се пост објави или када се статус промени у “објављено”
саве_пост - зове се када се пошта / страница креира од почетка или ажурира
вп_хеад - позива када се учитава шаблон и покреће вп_хеад () функције
лооп_енд - позвани одмах након завршетка задњег поста кроз ВордПресс петљу
трацкбацк_пост - се зове кад год се дода нова трацкбацк у пост

Опет можемо да видимо на који се начин овај бит кода једноставно своди. Ако можете да разумете разлику између акција и филтера, биће вам много ближе изградњи свеобухватних, радних ВордПресс додатака. Испод је друга линија кода која иницијализује акциону функцију на саве_пост хоок. Да би се ово разјаснило, ово се не односи на наш тренутни развојни плугин и користи се само као део примера кода за разумевање адд_ацтион () функције.

адд_ацтион ('саве_пост', 'пријави');

Тако да овде видимо сличну поставку као раније адд_филтер (). Потребне су нам 2 варијабле, прва садржи име наше куке коју циљамо. У овом случају саве_пост што значи да кад год се сачува нова порука, позват ћемо нашу функцију дефинирану на другој позицији (нотифи ()). Очигледно бисте могли да ажурирате обавештење да буде било које име функције које желите да покренете, али ово није потребно за наш тренутни пример плуг-ина.

Завршавамо нашу Плугин Логиц

Завршавајући на нашем путу, додаћемо нашу завршну функцију директно у наш плуг-ин фајл. АПИ документација је веома специфична и пружа одличан ресурс за програмере који могу да имају напредна питања. Материјал се може чинити тешким ако нисте упознати са ПХП-ом, али узмите си времена са концептима и ствари ће почети да тече природно!

Функцију у наставку треба додати одмах након коментара заглавља вашег додатка. Алтернативно, ово може бити постављено унутар ваше теме фунцтионс.пхп филе. Код се користи за креирање динамичког садржаја на основу ограниченог опсега знакова.

Дакле, за наш примјер можемо ограничити изводе из приче само 55 знакова хк_трим_цонтент () функције. Можете лако да позовете овај део кода из видгета у бочној траци или неке од ваших тема за замену $ тхе_цонтент.

= $ лимит) арраи_поп ($ цонтент); $ цонтент = имплоде ("", $ цонтент). "...";  елсе $ цонтент = имплоде ("", $ цонтент); $ цонтент = прег_реплаце ('/ \ _). \ т $ цонтент = аппли_филтерс (' тхе_цонтент ', $ цонтент);

Не треба очекивати да у потпуности разумете све интерне варијабле или функције које се овде користе. Само добијање општег знања о томе како би ваше функције требало да буду написане и како би изгледао пример скупа је веома добар почетак.

Такође можете приметити да користимо позив аппли_филтерс што је још једна специфична функција за ВордПресс. Ово је још један аспект који не морате у потпуности схватити, али помаже у будућем програмирању преко ВП-а. Погледајте референтну страницу аппли_филтерс за више детаља и често постављана питања о тој теми.

Горе наведена функција језгра је именована хк_трим_цонтент (). За ово је потребан само један параметар $ лимит. Ово се такође може скратити на $ лим који би требало да сачува цео број који одређује колико знакова треба да ограничи ваш извод. Садржај се користи на пуним страницама поста и статичним страницама (о нама, контакту).

Стога, да бисмо позвали ову функцију, морали бисмо додати параметар у наше датотеке предложака. Ово би се могло поставити негде у вашем индек.пхп или лооп.пхп филе (с) и захтеваће да прво инсталирате плугин. Пример испод:

Инсталирање и покретање додатка

Направио сам узорак датотеке за додатак за демо ако желите да прескочите хард кодирање. Једноставно преузмите ову датотеку (преименујте је у .пхп) или копирајте / налепите код у нови ПХП документ и пренесите га на свој / вп-цонтент / плугинс директоријум.

Када завршите, пожељет ћете приступити ВордПресс администрацијском панелу и прегледати тренутни скуп додатака за инсталирану демо верзију. Када активирате ништа ново неће се десити, док не додамо ручно у наш функцијски позив. Да бисте то урадили, једноставно идите Изглед -> Едитор и потражите сингле.пхп.

Овај фајл садржи све ХТМЛ / ЦСС шаблоне за вашу основну страницу поста чланка. Померите се надоле док не пронађете садржај() и замените горе наведеним кодом примера. Ово ће ограничити све ваше странице чланка на 55 знакова без обзира на то који се приказ користи. Можете додати и ову функцију на сличне странице у вашем директоријуму предложака као што је сеарцх.пхп или арцхиве.пхп.

Закључак

Ово су неке од основа за почетак рада у оквиру ВордПресс развоја. Систем додатака је огроман и садржи много интерне функционалности. Ако већ имате идеју за плуг-ин, испробајте га на локалној инсталацији ВордПресс-а да бисте вежбали ове теме.

Ако још увек будете збуњени већином информација, можете прегледати ВордПресс документацију и тамо потражити свој одговор. Развојна заједница је пуна корисних корисника и форуми чувају архиве са питањима од пре неколико година.