Ръководство за начинаещи за разработка на плагин за WordPress

CMS на WordPress промени лицето на нашия интернет и позволи на процъфтяването на нови идеи и движението с отворен код притежава силно присъствие, вкоренено в софтуерното и уеб разработката. WordPress е платформа за блогове, която има възможност да стартира в много други скриптове, като например уеб форуми, табла за работа и дори класическа уеб страница..

Ще разгледаме няколко начина да стартираме разработването на плъгини за WordPress. Стъпките са доста прости и не изискват голямо посвещение за изучаване. Рудиментарните познания за PHP биха били полезни дори и при основно разбиране на структурата на WordPress и панела за администриране.

В този кратък урок ще прегледаме основните стъпки, необходими за създаване на прост WordPress plug-in. Функционалността ще се използва за създаване на динамични откъси, базирани на броя, прехвърлен в нашата функция. Ще трябва да качите файла с приставката и да го активирате от Административния панел, след което да последвате, като извикате нашата функция от страниците, които искаме да се появи. Връзките към пълния изходен код на приставката вече са добавени по-късно в тази статия :)

Защо се разработва за WordPress?

Приставките са чудесен начин да подобрите функционалността на блога си, като добавите допълнителни функции. Те могат да се поставят навсякъде във вашия шаблон чрез функционални куки. С течение на времето разширяемостта на plug-in системата на WordPress позволява огромен растеж и стотици софтуерни продукти, представени от разработчиците.

WordPress специално предлага такива усъвършенствани функции в своята CMS, че уникалните плъгини са много малко. Като разработчик държите пълен контрол върху спецификата на вашия уеблог. Наемането на PHP разработчик, за да създаде системен плъгин, ще струва много повече, отколкото можете да си представите, а API е достатъчно лесен, за да работи и да се учи сам.

Като втори аргумент, разработването на WordPress е добра практика за настройване в други области. Изграждането на по-малки плъгини и widget-и в WordPress ще ви помогне да разберете как наистина работи системата. Това не е ограничено само до WordPress, тъй като ще получите по-дълбоко разбиране на по-голямата част от системите за съдържание.

1. Структура на папката на WP

Въведение в структурата на папките на WordPress ще покаже основните директории на приложения. Вътре в wp-съдържанието ще намерите плъгини директория. Тук е мястото, където ще бъдат поместени всичките ви отделни плъгини - или отделни файлове, или правилно наименувани под-директории.

За по-малки плъгини, които изискват само един .php файл, имате възможност да го поставите директно в плъгините / директорията. Въпреки това, когато започнете да разработвате по-сложни приложения, е много по-полезно да създадете поддиректория, наречена след плъгина. Вътре можете да включите JavaScript, CSS и HTML заедно с PHP функциите.

А readme.txt Файлът също може да бъде полезен, ако планирате да предлагате плъгина си за изтегляне. Този файл трябва да включва името ви и какво прави приставката. Като автор може да обмислите и включването на подробности за всяка ревизия и кои актуализации са излезли.

2. Стартиране на вашия PHP файл

Когато създавате нов плъгин, ще трябва да започнете с прост PHP файл. Това може да бъде наречено каквото и да е, но обикновено трябва да отразява официалното име на плъгина. Така например създадох нашия базов код и нарекох моя файл hongkiat-excerpt.phps.

Първите редове на приставката ви трябва да да бъде информация за коментар на двигателя за разбор. Това е изключително важно, тъй като WordPress няма да може да обработва файла ви. По-долу е показан примерен код, който можете да копирате и формите към собствения си.

Името на приставката е това, което ще се появи в панела на администратора ви, когато отидете да активирате. Същото е и с URI, който ще бъде поставен в прозореца с подробности в панела с приставки. Въпреки че не е необходимо да включва версия или описание, това прави плъгина ви по-професионален.

3. Конвенции за наименуване на WordPress и най-добри практики

Има няколко начина да структурирате приставката си. Много пъти разработчиците на PHP ще създават цяла система от класове, за да избегнат сблъсъци с функции и имена на променливи. Ако не сте запознати с напредналата функционалност на OOP на PHP, най-добре е просто да напишете кода си в примерни функции.

Така че за нашия пример код ще напишем една функция, за да поместим нашите данни. Също така трябва да дефинираме няколко променливи, които са ключови за въвеждане в нашите шаблонни файлове. По-долу е даден пример на малко код от нашия плъгин с премахната основна логика.

Когато пишете пробния си код, най-добре е да следвате правилата и указанията, създадени от WordPress. Тъй като има толкова много вътрешни функции, които вече са дефинирани, можете да избегнете дублирането, като префиксирате етикет на всичките си променливи и имена на функции.

В горните примери ние поставихме представки с всички наши имена за настройка hongkiat. Това може да бъде заменено с всяка ключова дума по ваш избор, обикновено свързана с името на плъгина. Горният код е точно примерни настройки и не трябва да се отнасят до нашия последен плъгин. Това е само за да ви дадем представа как трябва да бъдат написани имената на променливите и функционалните повиквания.

4. Гмуркане във филтри и действия

Има и друга концепция, заслужаваща да се спомене, преди да скочим в нашия суров код. мерки и филтри са две напълно различни концепции, които се отнасят дълбоко в начините, по които манипулират данните за плъгините.

Тези два бита код идват стандартно в WordPress API. Филтрите и действията позволяват на разработчиците на plug-in да актуализират битовете на кода в целия администраторски панел на WordPress, отнасящи се до новия ви модул. Това означава, че можете да добавите нов раздел в страничната лента или допълнителни връзки за настройки за опциите на приставката.

Разбиране на add_filter ()

А филтър се използва за малко текст или данни, предавани в WordPress. С филтри, на които сте буквално способни филтърно съдържание чрез собствени персонализирани писмени функции за промяна на данните по какъвто и да е начин.

Например, можете да създадете филтър за промяна $ the_content което е променлива, зададена от WordPress, съдържаща цялото съдържание на публикация в WordPress. За нашия щепсел ще поемаме $ the_content и съкращаване на дължината на символите в извадка.

Филтрите са полезни, когато пишете приставки, за да персонализирате облика на блога си. Те са особено популярни, когато пишете widgets или по-малки функции, за да промените начина на показване на публикацията. По-долу е даден примерен ред от код, показващ как да приложите филтър.

add_filter ('wp_title', 'hongkiat_func');

Тук добавяме филтър в заглавието на WordPress. Забележете, че този код не е свързан с нашия официален плъгин и се използва само като пример тук.

Най- add_filter Функцията е собственост на WordPress и се използва за добавяне на нов филтър към променлива, която се намира в съдържанието на страницата. В горния ред насочваме $ wp_title който съдържа заглавието на настоящата ни страница. След това прехвърляме тази променлива в подправена функция hongkiat_func () които след това могат да манипулират и да върнат нов таг заглавие за каквито и да е цели.

Разбиране на add_action ()

Действията са подобни на филтрите, тъй като не работят с битове данни, а са насочени към предварително дефинирани области във вашите шаблони и администраторски панел. Като пример можете да приложите действие всеки път, когато актуализирате или редактирате съдържанието на страницата. WordPress предлага изчерпателен списък с действия в документацията си за API. По-долу е даден малък списък от примерни действия, за да се запознаете с някои от предварително дефинираните целеви области.

publish_post - извиква, когато публикацията е публикувана или когато статусът е променен на “публикувано”
запази поста - се извиква, когато дадена публикация / страница е създадена от началото или актуализирана
wp_head - извиква, когато шаблонът се зареди и стартира wp_head () функция
loop_end - извика веднага след като последната публикация е била обработена чрез цикъла на WordPress
trackback_post - извиква всеки път, когато в публикацията е добавена нова trackback

Отново можем да видим доколко просто се състои този бит код. Ако разберете разликата между действия и филтри, ще бъдете много по-близо до изграждането на всеобхватни, работещи WordPress плъгини. По-долу е показан друг ред, който инициализира функция за действие на запази поста кука. За да се изясни отново, това не се отнася за текущия ни разработван плъгин и се използва само като част от примерния код за разбиране на ADD_ACTION () функция.

add_action ('save_post', 'notify');

Така че тук виждаме подобна настройка преди add_filter (). Нуждаем се от 2 променливи, първата съдържа името на нашата кука, която насочваме. В такъв случай запази поста което означава, че когато се запази нова публикация, ще извикаме функцията ни, дефинирана във втората позиция (уведомява ()). Очевидно е, че можете да актуализирате уведомяването, за да бъде името на функцията, което искате да изпълните, но това не е необходимо за нашия текущ примерен плъгин.

Завършване на нашата Plugin логика

Завършвайки нашия път, ще добавим нашата финална функция директно в нашия плъгин. Документацията на API е много специфична и предоставя отличен ресурс за разработчиците, които могат да заемат напреднали въпроси. Материалът може да изглежда труден, ако не сте запознати с PHP, но отделете време с концепциите и нещата ще започнат да текат естествено!

Функцията по-долу трябва да бъде добавена директно след коментара на заглавката на плъгина. Като алтернатива това може да се постави и във вашата тема functions.php файл. Кодът се използва за създаване на динамично съдържание за публикуване въз основа на ограничен брой знаци.

Така че за нашия пример можем да ограничим откъси от историята само с 55 знака hk_trim_content () функция. Можете лесно да извикате този бит код от приспособление в страничната лента или някой от файловете на темата, които искате да замените $ the_content.

= $ limit) array_pop ($ content); $ content = implode ("", $ content). "...";  else $ content = implode ("", $ content); $ content = apply_filters ('the_content', $ content), връщат се $ content;?> \ t $ content = preg_replace ('/ \ t

Не трябва да се очаква, че напълно разбирате всички вътрешни променливи или функции, използвани тук. Просто получавате общо разбиране за това как трябва да бъдат написани вашите функции и какъв пример ще изглежда като един много добър старт.

Може също да забележите, че използваме обаждане apply_filters което е друга специфична за WordPress функция. Това е още един аспект, от който не е нужно да разбирате напълно, но това помага при бъдещото програмиране през WP. Разгледайте страницата с указанията за apply_filters за повече подробности и често задавани въпроси по темата.

По-горе е посочена основната функция hk_trim_content (). Това изисква само един параметър с име лимит $. Това също може да бъде съкратено до $ Лим който трябва да съхрани цяло число, посочващо колко знака да ограничи изваждането ви. Съдържанието се използва на цели страници за публикации, както и на статични страници (за нас, за контакт).

Затова, за да извикаме тази функция, ще трябва да добавим параметъра в нашите шаблони. Това ще бъде поставено някъде, където е възможно index.php или loop.php файл (и) и ще изисква първо да инсталирате плъгина. Пример по-долу:

Инсталиране и стартиране на приставката

Създадох примерен файл за плъгина, за да демонстрирам, ако искате да пропуснете твърдото кодиране. Просто изтеглете този файл (преименувайте го в .php) или копирайте / поставете кода в нов PHP документ и го качете на вашия / WP-съдържание / приставки указател.

След като приключите, ще искате да получите достъп до панела за администриране на WordPress и да прегледате текущия набор от плъгини за инсталираната демо версия. След като активирате нищо ново, няма да се случи, докато не добавим ръчно нашата функция. За да направите това просто навигирайте Външен вид -> Редактор и търсете single.php.

Този файл съдържа всички HTML / CSS шаблони за основната страница на статия. Превъртете надолу, докато намерите съдържанието() и заменете с примера по-горе. Това ще ограничи всички страници на статии до 55 знака, без значение какъв изглед се използва. Можете също да добавите в тази функция към подобни страници във вашата директория на шаблони, като например search.php или archive.php.

заключение

Това са някои от основните неща, за да започнете да работите в рамките на развитието на WordPress. Системата на приставката е огромна и съдържа голяма част от вътрешната функционалност. Ако вече имате идея за плъгин, опитайте го на локална инсталация на WordPress, за да практикувате тези теми.

Ако все още сте объркани от голяма част от информацията, можете да прегледате документацията на WordPress и да потърсите отговора си там. Общността за развитие е пълна с полезни потребители, а форумите поддържат архиви с въпроси от години.