Kezdő útmutató a WordPress bővítmény fejlesztéséhez

A WordPress CMS megváltoztatta az internetünk arcát, és lehetővé tette, hogy az új ötletek fellendüljenek, és nyílt forráskódú mozgása erősen jelen van a szoftverek és a webes fejlesztésekben. A WordPress egy olyan blogolási platform, amely számos más szkriptekre, például webes fórumokra, munkafórumokra és még egy klasszikus weboldal tartalmi menedzsment rendszerre is elindítható..

Néhány módon megkezdjük a WordPress bővítményeinek fejlesztését. A lépések meglehetősen egyszerűek és nem igényelnek nagy odaadást a tanulásra. A PHP alapos ismerete akkor is hasznos lenne, ha a WordPress fájlszerkezetének és az Adminisztráció panelnek az alapvető megértése lenne.

Ebben a rövid bemutatóban átmegyünk az alapvető lépésekhez, amelyek egy egyszerű WordPress plug-in létrehozásához szükségesek. A funkcionalitást arra használjuk, hogy dinamikus részleteket hozzunk létre a függvényhívásunkba átadott szám alapján. Fel kell töltenie a plug-in fájlt, és aktiválnia kell az adminisztrátori panelen, majd követnie kell a funkciót a kívánt oldalakról. A kitöltött plug-in forráskódra mutató linkek már hozzáadódtak a cikkhez később :)

Miért kell fejleszteni a WordPress számára?

A bővítmények nagyszerű módja annak, hogy növeljék a blog funkcióit, ha további funkciókat adnak hozzá. Ezeket a sablonon belül bárhol elhelyezhetjük függvényhorgokkal. Idővel a WordPress plug-in rendszer bővíthetősége óriási növekedést és több száz fejlesztő által benyújtott szoftvert tartalmaz..

A WordPress kifejezetten olyan speciális funkciókat kínál a CMS-ben, hogy az egyedi plug-inek kevések és messze vannak. Fejlesztõként teljes körûen ellenõrizheted a weblogod sajátosságait. Egy PHP-fejlesztő bérlése egy rendszerbővítmény létrehozásához sokkal többet fizetne, mint amennyit elképzelhet, és az API elég könnyű ahhoz, hogy dolgozzon és tanuljon meg.

Másodlagos érvként a WordPress-re való áttérés nagyszerű gyakorlat más területekre való hangoláshoz. A kisebb pluginok és oldalsáv-widgetek építése a WordPressben segít abban, hogy megértsék, hogyan működik a háttérrendszer. Ez nem csak a WordPressre korlátozódik, mivel mélyebb megértést szerez a Tartalomrendszerek túlnyomó többségéről.

1. WP mappa szerkezete

A WordPress mappaszerkezetbe való bevezetés az alkalmazás alapkönyvtárait mutatja. A wp-tartalom belsejében található a plugins Könyvtár. Itt van, ahol az összes egyedi plug-in elhelyezésre kerül, vagy egyetlen fájl vagy megfelelően nevezett alkönyvtár.

A kisebb plug-inek esetében, amelyek csak egy .php fájlt igényelnek, lehetősége van arra, hogy ezt közvetlenül a plug-inekbe / könyvtárba helyezze. Ha azonban bonyolultabb alkalmazások fejlesztését kezdjük, sokkal hasznosabb, ha egy alkönyvtárat hozunk létre a plug-in nevével. A házon belül JavaScript, CSS és HTML is szerepel a PHP funkcióival együtt.

A readme.txt a fájl akkor is hasznos lehet, ha tervezi a bővítmény letöltését. A fájlnak tartalmaznia kell a nevét és a bővítményt. Szerzőként Ön is fontolóra veheti az egyes módosítások részleteit, és a frissítések megjelenését.

2. A PHP fájl indítása

Egy új bővítmény létrehozásakor egy egyszerű PHP fájlból kell indulnia. Ezt bármit meg lehet nevezni, de általában a plug-in hivatalos nevét kell tükröznie. Így például létrehoztam alapkódomat, és hongkiat-excerpt.phps fájlomat neveztem el.

A plug-in első sorai kell legyen a megjegyzési információ az elemző motor számára. Ez rendkívül fontos, mivel a WordPress nem tudja feldolgozni a fájlt. Az alábbiakban egy példakódot láthatsz, amit a sajátod felé másolhatsz és formázhatsz.

A Plugin név az, amit az adminisztrátori háttérpanelen fog megjelenni az aktiváláskor. Ugyanaz az URI-vel, amely a bővítmények panelen található részletes panelen kerül elhelyezésre. Bár nem kell tartalmaznia egy verziót vagy leírást, akkor a plugin sokkal professzionálisabbá teszi.

3. WordPress elnevezési egyezmények és legjobb gyakorlatok

Van néhány módja annak, hogy a plug-inet ténylegesen strukturálja. A PHP fejlesztői sokszor egy egész osztályrendszert hoznak létre annak érdekében, hogy elkerüljék az ütközéseket a funkciókkal és a változó nevekkel. Ha nem ismeri a fejlett OOP funkcionalitást a PHP-nél, akkor a legjobb, ha a kódot csak a minta funkciókba írja.

Így például példakódunkhoz egy funkciót írunk az adatok tárolására. Néhány változót is meg kell határoznunk, amelyek kulcsfontosságúak a sablonfájljaink megvalósításához. Az alábbiakban egy példa a kódból, amelyet a plugin fájlunkból vettünk el, és eltávolítottuk az alapvető logikát.

A minta kódjának írásakor a legjobb, ha a WordPress által meghatározott szabályokat és útmutatókat követjük. Mivel már sok belső funkció van már definiálva, elkerülheti a duplikációkat, ha a címkéket az összes változójához és függvénynevéhez előzőleg elhelyezi..

A fenti példákban az összes beállítási nevet előtaggal jelöltük hongkiat. Ezt a választott kulcsszó helyettesítheti, általában a bővítmény nevével. A fenti kód csak igaz minta beállításai és nem tartozhat a végső bővítményünkhöz. Ez csak annyit jelent, hogy bepillantást nyerhessünk a változó nevek és funkcióhívások írásába.

4. Szűrőkbe és műveletekbe történő belépés

Van még egy fogalom, amit érdemes megemlíteni, mielőtt belépünk a nyers kódunkba. Hozzászólások és szűrők két teljesen különböző fogalom, amelyek mélyen kapcsolódnak a plugin adatok manipulálásának módjaihoz.

Ezek a kódok két bitje a WordPress API-n belül szabványos. A szűrők és a műveletek lehetővé teszik, hogy a plug-in fejlesztők frissítsék a kódokat a WordPress admin panelen, amely az új plug-inre vonatkozik. Ez azt jelenti, hogy új lapot vehet fel az oldalsávba vagy további beállításokat tartalmazó linkeket a Plug-in beállításaihoz.

Az add_filter () megértése

A szűrő a WordPress-be átadott szöveg vagy adat egy kicsit használ. Szűrőkkel meglehetősen szó szerint képes szűrő tartalmát a saját egyéni írásos funkciók segítségével bármilyen módon módosíthatja az adatokat.

Például létrehozhat egy szűrőt a változtatáshoz $ the_content amely egy WordPress által beállított változó, amely egy WordPress cikk teljes tartalmát tartalmazza. A mi plug-inünk lesz $ the_content és a karakterek hosszának lerövidítése egy részletre.

A szűrők praktikusak, ha bővítményeket írnak, hogy testreszabják a blogod megjelenését és hangulatát. Ezek különösen népszerűek oldalsáv widgetek vagy kisebb funkciók írásakor, hogy megváltoztassák, hogyan kell megjeleníteni egy bejegyzést. Az alábbiakban a szűrő alkalmazásának módját bemutató kódsor látható.

add_filter ('wp_title', 'hongkiat_func');

Itt hozzáadunk egy szűrőt a WordPress oldalcíméhez. Ne feledje, hogy ez a kód nem kapcsolódik a hivatalos bővítményünkhöz, és csak példaként használjuk.

A add_filter A funkció a WordPresshez tartozik, és egy új szűrő hozzáadására szolgál az oldal tartalmában található változóhoz. A fenti sorban célzunk $ wp_title amely tartalmazza az aktuális oldal címét. Ezután ezt a változót hamis függvénynek nevezzük hongkiat_func () amely az új címcímkét manipulálhatja és visszaküldheti bármilyen célra.

A hozzáértés értelmezése ()

A műveletek hasonlóak a szűrőkhöz, hogy az adatok bitjein nem működnek, hanem a sablonok és az admin panel előre meghatározott területeit célozzák meg. Példaként alkalmazhat egy műveletet, ha frissíti vagy szerkeszti az oldal tartalmát. A WordPress átfogó cselekvési listát kínál az API dokumentációjában. Az alábbiakban egy kis listát láthatsz a példákról, amelyekkel megismerkedhetsz az előre meghatározott célterületekkel.

• publish_post - hívás, ha egy hozzászólás közzétételre kerül, vagy amikor az állapot megváltozik “közzétett”
• save_post - hívás, ha egy posztot / oldalt elindítanak vagy frissítenek
• wp_head - a sablon betöltése és a wp_head () funkció
• loop_end - azonnali hívást követően az utolsó hozzászólás feldolgozása a WordPress hurkon keresztül történik
• trackback_post - hívott, amikor egy új trackback hozzáadódik egy bejegyzéshez

Ismét láthatjuk, hogy mennyire egyszerű ez a kód. Ha megértheti a különbséget a cselekvések és a szűrők között, akkor sokkal közelebb lesz az átfogó, működő WordPress bővítményekhez. Az alábbiakban a kód egy másik sora van, amely egy műveleti funkciót inicializál save_post horog. Hogy újra tisztázzuk, ez nem a jelenlegi fejlesztő bővítményünkre vonatkozik, és csak példakódként használjuk, hogy megértsük ADD_ACTION () funkció.

add_action ('save_post', 'értesítés');

Tehát itt egy hasonló beállítást látunk korábban add_filter (). Szükségünk van 2 változóra, az első az általunk célzott horog nevét tartalmazza. Ebben az esetben save_post ami azt jelenti, hogy amikor egy új bejegyzés mentésre kerül, a második pozícióban definiált függvényt fogjuk hívni (értesíti ()). Nyilvánvalóan frissítené a bejelentést, hogy bármi legyen a funkció neve, amit futtatni szeretne, ez azonban nem szükséges a jelenlegi példakép-bővítményünk esetében.

A Plugin Logic befejezése

Befejezzük az utunkat, és a végső funkciót közvetlenül a plug-in fájlunkba adjuk hozzá. Az API dokumentáció nagyon specifikus, és kiváló forrást jelent a fejlesztők számára, akik előzetes kérdéseket tarthatnak. Az anyag nehéznek tűnhet, ha nem ismeri a PHP-t, de időt vesz igénybe a koncepciókkal és a dolgok természetesen elkezdenek folyni!

Az alábbi funkciót közvetlenül a bővítmény fejléc-megjegyzése után kell hozzáadni. Másik lehetőségként ezt a témát is be lehet helyezni functions.php fájlba. A kódot dinamikus üzenet tartalmának létrehozására használják, korlátozott számú karakter alapján.

Így például példánkban csak 55 karakter hosszúságú történeteket lehet korlátozni a hk_trim_content () funkció. Ezt a kódot könnyedén meghívhatja egy oldalsáv-widgetből vagy a témaköreinek egyikéből $ the_content.

= $ limit) array_pop ($ tartalom); $ content = implode ("", $ tartalom). '…';  else $ content = implode ("", $ tartalom);  $ content = preg_replace ('/\t./\t/', ", $ content); $ content = apply_filters ('the_content', $ tartalom); 

Nem szabad elvárni, hogy teljes mértékben megértse az összes itt használt belső változót vagy funkciót. Nagyon jó kezdet, ha általános megértést szereztünk arról, hogyan kell megírni a funkciókat, és hogy milyen példát fog kinézni.

Azt is észrevehetjük, hogy hívást használunk apply_filters amely egy másik WordPress-specifikus funkció. Ez egy másik szempont, amit nem kell teljes mértékben megérteni, de segít a jövőbeni WP programozásban. További részletekért és a témakörre vonatkozó GYIK-okért nézze meg az alkalmazási_szűrők hivatkozási oldalát.

A fenti központi függvény neve hk_trim_content (). Ez csak 1 paramétert igényel $ limit. Ez is lerövidíthető $ lim melynek egész számát kell tárolnia, amely meghatározza, hogy hány karaktert szűkítsen a kivonat. A tartalmat teljes postaoldalakon és statikus oldalakon is használják (rólunk, kapcsolat).

Ezért ahhoz, hogy ezt a funkciót hívjuk, hozzá kell adnunk a paramétert sablonfájljainkhoz. Ez valahol esetleg elhelyezhető lenne index.php vagy loop.php fájl (ok) és először be kell telepítenie a bővítményt. Az alábbi példa:

A bővítmény telepítése és futtatása

Létrehoztam egy mintafájlt a bővítményhez a demóhoz, ha ki akarja hagyni a kemény kódolást. Egyszerűen töltse le ezt a fájlt (átnevezze azt .php-be), vagy másolja / illessze be a kódot egy új PHP-dokumentumba, és töltse fel / Wp-content / plugins Könyvtár.

Miután elkészült, hozzáférni akar a WordPress adminisztrációs paneléhez, és böngészhet a jelenlegi telepített demo-modulok jelenlegi készletében. Miután aktiválta semmi új, nem fog megtörténni, csak addig, amíg manuálisan hozzáadjuk a funkcióhívásunkhoz. Ehhez egyszerűen navigáljon Megjelenés -> Szerkesztő és keresse meg single.php.

Ez a fájl tartalmazza az alap cikk-postai oldal összes HTML / CSS-sablonját. Görgessen lefelé, amíg meg nem találja A tartalmat() és cserélje ki a fenti példakódot. Ez az összes cikkoldalat 55 karakterre korlátozza, függetlenül attól, hogy milyen nézetet használ. Ehhez a funkcióhoz hasonló sablonokat is hozzáadhat a sablonok könyvtárához, mint például search.php vagy archive.php.

Következtetés

Ezek az alapok ahhoz, hogy elkezdhessük a WordPress fejlesztését. A bővítményrendszer hatalmas és sok belső funkcióval rendelkezik. Ha már van ötlete egy plug-in-nek, próbálja ki a WordPress helyi telepítésén, hogy gyakorolhassa ezeket a témákat.

Ha még mindig zavarodik az információk nagy része, tekintse át a WordPress dokumentációját és keresse meg a választ. A fejlesztési közösség tele van hasznos felhasználókkal, és a fórumok évek óta archívumokat tartanak.