Téma testreszabót wordpress átfogó fejlesztői útmutató
Ez a leírás megmondja részletesen a téma WordPress dugó Theme Customizer (a továbbiakban: a tuner).
A beállító mutatkozott be WordPress verzió 3.4. Ez lehetővé teszi, hogy a rendszergazda módosíthatja a környezetet, hogy megpróbálja szál alkalmazása előtt azokat a munkavégzés helyszínére. Ebben a leckében lesz szó, hogyan kell ezt a funkciót, hogy a téma.
Megjegyzés: Számos módja van, hogy csatlakoztassa a tuner beállítások és a módosítások mentéséhez. Ez az útmutató áttekinti az eljárás theme_mod. Ha nem tudja, hogy ez mit jelent, hogy nem számít. Nem kell, hogy megértsük a célja a különböző módszerek, ha ragaszkodik a jelen útmutató.
1. Add az oldalt testreszabót témát az admin panel menüjében.
Először nyissa meg a témát a functions.php fájlt, és adjuk hozzá a következő kódot. Ez nem kritikus, pontosan ott, ahol a fájlban fogjuk fel a kódot, amíg benne van egy másik funkció.
Ez biztosítja, hogy a felhasználó rendelkezik a szükséges jogosultsággal a tuner.
(Bővebb információ a WordPress felhasználóknak [javaslat szünetek - kb Trans.].
Megjegyzés: Ha létrehoz egy témát nyilvános használatra, a paraméterek $ page_title és $ menu_title lehetővé kell tenni, hogy lefordítani őket más nyelveken. További információ a lokalizáció megtalálható I18n a WordPress lokalizáció szabályok oldalt.
Most, ha visszamegyünk a WordPress admin panel, a menü «Megjelenés» elérhető lesz az új oldal címe «Customize». Kattintva «Megjelenés> Customize», akkor megnyílik egy új oldal a tuner, ami csak teremtett. A panel bal oldalán a képernyő storoy azt látjuk, hogy ott már megjelenik a négy beállítás részén. „Címe az oldalon, és flow címkék”, mint a „Static Fő» hozzáadjuk a rádió automatikusan. Szakaszai „Színek” és a „Wallpaper” hozzá, mert a téma támogatja az egyéni háttérképet lehetőség, beépített WordPress core. A következő fejezetben fogunk hozzá saját oldalán.
2. Adjon hozzá egy új szakaszt a tuner
Ahhoz, hogy hozzon létre saját konfigurációs szakasz, helyezze a következő kódot a functions.php fájlt egyszer a kódot, már csak hozzá a korábbi (szintén a helyét nagyrészt irreleváns, csak kényelmesebb lehet a kódot egy rendezett).
Nem kötelező. Attól függően, hogy a téma támogatja sajátossága részén jelenik meg, vagy rejtett
A fenti példában, nem használtuk argumentuma «képesség» vagy «theme_supports«. Azonban az opcionális érvek «leírás» használtak, és a «prioritás». így kedvet kapjanak, hogyan működnek. Folytatás és megváltoztatni az értéküket, hogy megértsék a munkájukat. A következő fejezetben fogunk létrehozni egy lehetőséget az új szakasz.
3. Új lehetőség
3.1. Regisztráció opció
Options bejelentkezve keresztül add_setting () metódust. Azt tedd közvetlenül a hívás után add_setting (), és csak a záró zárójelek example_customizer () függvényt.
Nem kötelező. A függvény neve, hogy fogják hívni, hogy ellenőrizze és állítsa be az adatokat az adatbázisból a testreszabóban. Alapértelmezés: üres karakterlánc.
Valószínűleg észrevette, hogy a «alapértelmezett» fogjuk használni a fenti kód egyetlen érv. A legtöbb egyéb érvek ésszerű alapértelmezett, így nem kell aggódnia, és add hozzá a kihívás add_setting () metódust. Néhány érv érdemelnek nagyobb figyelmet rájuk, hiszen nem megy tovább.
Először is, az érvelés «sanitize_callback» használjuk, hogy ellenőrizze a beírt adatokat, mielőtt tárolja őket egy adatbázisba. Az egyszerűség kedvéért én még nem mozgósított az érv, de vissza fog térni később ebben az útmutatóban. Úgy vélem, hogy az ellenőrzés és a korrekciós adatok gyakran elhanyagolják, és szeretném kijavítani.
Másodszor «sanitize_js_callback» nem lehet, amit várnánk. Jellemzően lefolytatása az ellenőrzés és javítás az adatok, ha valami baj van az adatok a felhasználó által megadott, mielőtt az adatbázisban tárolt. Azonban a függvény «sanitize_js_callback» hívják, hogy ellenőrizze és korrigálja az adatokat már az adatbázisban tárolt idején azok átadása a tuner. Az egyetlen eset, hogy véleményem szerint indokolt a hívás ezt a funkciót -, hogy adjunk „#” elején egy hexadecimális szám, ha azt egy adatbázisban tároljuk nélkül ezt a jelet.
Nos, mi lett volna, így adjuk meg a lehetőséget rajtunk.
3.2 Készítsen ellenőrzés
ellenőrzések egyszerűen egy interfész használt, hogy módosítsa az értékeket a lehetőségeket. Mindegyik opció, hogy a vezérlést megjelenik a testreszabási. A kontroll hozzáadjuk használata révén a módszer add_control (). Ahogy a korábbi módszerekkel, akkor két paramétert. Először - ez az azonosító (ID) az ellenőrzés. Az érték egyenlőnek kell lennie az értéket ID opciót, ahol a vezérlőelem tartozik. Mivel a fenti lehetőséget kellett ID «szövegdobozba», a vezérlő is kell «szövegdobozba». Mint korábban, a második lehetőség - ez a tömb érveket. Mi megszervezzük a kihívás add_control () metódus után azonnal add_setting () függvény hívás előtt a záró zárójel example_customizer () függvényt.
Ha az érték «powered by» tároltuk a pincében a kijelzőn az „Ez a webhely működik köszönhetően WordPress». Azonban, ha az értéke lett mentve, «WordPress» helyébe a szórakoztató lehetőség a listából.
6. ellenőrzése és kijavítása adatok
Már említettem, hogy az egyszerűség kedvéért én nem csak az elejétől beront egy ilyen összetett téma az adatok érvényesítését. Azonban nem akarom elhagyni azt a benyomást, hogy ne érintse meg, mert ez lényegtelen. Ó, hát legyen, én kiemelni az egész fejezetet ebben a kézikönyvben. Tehát igen, úgy gondolom, hogy ez nagyon fontos. Én azonban nem mászik be az összes részletet, és miért olyan fontos, vagy leírni a következményei miatt ezt a tesztet. Én csak annyit: soha ne bízz a felhasználó által bevitt adatokat!
6,01 szövegbevitel megtekintése
Ismét WordPress automatikusan korlátozza a típusú fájlokat lehet letölteni, de a terhelés ebben az esetben nem korlátozódik a képeket. Hozhat létre egy ellenőrző funkciót betölteni, csak képeket. De mivel ez az útmutató a tuner, nem ellenőrzése és kijavítása adatok fogom hagyni ezt a témát nem nyilvános.
8. létrehozása egyéni vezérlők
Tehát azt mondta az összes beépített WordPress ellenőrzéseket, és ha azt akarjuk, hogy további elemeket? Otto írt egy kiváló cikket létrehozására egyéni vezérlők, így ez a rész nem kerül alapul.
Lehet, hogy korábban észrevette, hogy milyen típusú beviteli mező (textarea) nem szerepel a WordPress beépített típusokkal. Itt fogunk létrehozni egy egyéni vezérlő használati szövegdobozokba bemeneti típusok a testreszabási.
Ahhoz, hogy hozzon létre saját ellenőrzés, akkor kell bővíteni WP_Customize_Control osztály és felülbírálja render_content () függvény, hogy megjelenítse az új szabályozás. Ha ismeri az objektum-orientált PHP nyelv, egyértelmű lesz neked, ha nem - semmit, csak utánam. Nem lesz nagyon nehéz.
Azt hogy mi osztály example_customizer () függvényt. hoztuk létre az elején ebben a kézikönyvben. Ez a funkció szoktuk szabni, és adjunk hozzá az összes lehetőséget a testreszabóban. Ahhoz, hogy az osztály működött, ahogy kellene, akkor meg kell határozni ezen belül funkció:
- Megváltozott a korábbi értéke ID «színes beállítás» a «font-color» mindhárom helyen, ahol jelen van.
- Megváltozott az alapértelmezett színe.
- Megváltoztatták a nevét.
- És végül, változott «színek» részén az ingatlan egy lehetőséget adunk a meglévő «Colors» fejezet.
Már elmondta, hogyan kell használni a lehetőségeket tárolt menet, így az alkalmazás az eljárás mentésére a színét a téma, bízom az Ön, mint a házi feladatot.
Visszatérünk a paraméter «szállítás» és jelentését «postMessage«, amit röviden tárgyalt fejezet 3. Adjunk hozzá egy új lehetőség változtatni a háttér színét a tartalmi terület a honlapon. Először is, akkor adjunk hozzá még egy színben az «Színek» részben a tuner:
11. AJAX előre beállított lehetőségek
Mi van, ha meg akarjuk változtatni a közlekedési paramétert a beépített lehetőségek? Egy ilyen lehetőség is. Annak bizonyítására, módosítani fogjuk a beépített opció «Honlap címe» (oldal neve), hogy kapott a tuner segítségével «postMessage«, nem a szokásos, «refresh«. Először is, adjuk hozzá a következő sort a fő funkciója example_customizer (). korábban létrehozott:
Lehetséges hibák a Customizer amely a sablon, sajnos a pontosabb válasz Több információra van szüksége.
Js hiba van (látható a konzolon)?