1. 1. Wprowadzenie do dostosowywania motywów WordPress
  2. 2). Interakcja z programem WordPress Customizer
  3. 3). WordPress Theme Customizer Boilerplate
  4. 4. Teraz czytam: Rozszerzenie szablonu dostosowywania motywu WordPress
  5. 5. Szablon niestandardowego szablonu dostosowywania – opcje warunkowe, motywy podrzędne i wtyczki

Część 3 serii Theme Customizer wprowadziła Cię do Boilerplate Theme Customizer, który pozwala uprościć kod, który obsługuje opcje motywu. Wystarczy przekazać szereg pól opcji, a płyta główna zajmie się rejestrowaniem sekcji, ustawień i elementów sterujących dostosowywania motywu za kulisami.


Do tej pory płyta wzorcowa pozwalała na używanie pól tekstowych, pól wyboru, przycisków opcji i wybierania pól w Theme Customizer, w tym artykule pokazano, jak można ją rozszerzyć.

Uwaga: przed kontynuowaniem pobierz najnowszą wersję programu WordPress Theme Customizer Boilerplate ze swojego repozytorium Github. Wprowadziłem w nim kilka ulepszeń od ostatniego samouczka i ważne jest, aby Twój kod był aktualny. Spójrz na poprzedni post, aby uzyskać więcej notatek o zmianach, ale w skrócie, po skopiowaniu płyty głównej do folderu motywu, nie musisz w ogóle edytować jej plików – cała edycja odbywa się za pomocą haków filtru i akcji.

Podłączenie do szablonu dostosowywania motywu

Istnieje kilka haków akcji i filtrów w szablonie dostosowywania motywu WordPress. Możesz podłączyć się do dowolnego z nich z pliku functions.php swojego motywu za pomocą działanie dodatkowe i add_filter Funkcje:

  • „Thsp_cbp_directory_uri” – Filtr haczyka zdefiniowany w helpers.php, pozwala zmienić lokalizację Customizer Boilerplate w folderze motywu. Domyślnie ścieżka płyty kotła wygląda następująco – get_template_directory_uri (). „/ Customizer -ilerplate” – ale jeśli wolisz przenieść go do niestandardowej lokalizacji, to hak może Ci pomóc.
  • „Thsp_cbp_menu_link_text” – Filtr haka zdefiniowany w helpers.php, pozwala zmienić link tekstowy Menu. Boilerplate dodaje link w sekcji Wygląd w desce rozdzielczej WordPress, umożliwiając użytkownikom łatwy dostęp do Theme Customizer. Domyślnie ten link powie „Dostosowywanie motywów” i możesz zmienić tekst za pomocą haka filtru „thsp_cbp_menu_link_text”.
  • „Thsp_cbp_capability” – Filtr haka zdefiniowany w helpers.php. Umożliwia zmianę domyślnej wymaganej zdolności używanej w metodzie $ wp_customize-> add_setting.
  • „Thsp_cbp_option” – Filtr haka zdefiniowany w helpers.php. Jeśli używasz „opcji” w argumentach ustawień, użyj tego haka, aby zmienić nazwę wpisu, w którym wartości ustawień motywu będą przechowywane w tabeli wp_options. Wartość domyślna to „thsp_cbp_theme_options”, upewnij się, że podpinasz się do tego i zmieniasz go na coś, co zawiera nazwę twojego motywu.
  • „Thsp_cbp_options_array” – Filtruj hak zdefiniowany w options.php, MUSISZ do niego podłączyć i zastąpić domyślną tablicę opcji (zawierającą przykładowe opcje) opcjami, które są używane w twoim motywie. Powtórzę to, pogrubię i podkreślę: YUST MUSISZ do niego dołączyć i zastąpić domyślną tablicę opcji opcjami używanymi w Twoim motywie.
  • „Thsp_cbp_custom_controls” – Hak akcji zdefiniowany w custom-controls.php, zaczepiając się w nim, możesz tworzyć własne niestandardowe kontrolki, czytaj dalej, aby zobaczyć przykład, jak to zrobić.
  • „Tshp_cbp_remove_sections”„Tshp_cbp_remove_controls” i „Tshp_cbp_remove_settings” – Filtruj haki zdefiniowane w customizer.php. Możesz przekazać im tablice wbudowanych identyfikatorów sekcji (lub identyfikatorów kontrolek lub identyfikatorów ustawień), aby usunąć niektóre wbudowane sekcje, kontrolki lub ustawienia.

Uwaga: Chociaż jesteśmy przy rozszerzaniu i tworzymy własne haki, aby inni programiści mogli je wykorzystać do rozszerzenia twojego kodu, nie można przecenić, jak ważne jest to. W końcu tak działa WordPress (rdzeń). I nie mogłem podziękować Pippin i jego artykuły wystarczy, aby wprowadzić ten pomysł do mojej głowy.

Niestandardowe elementy sterujące

Zaktualizowana wersja Theme Customizer (którą właśnie wypisałeś, prawda?) Ma kilka dodatkowych elementów sterujących, których możesz użyć – pole tekstowe, pole numeru HTML5 i pole obrazów, które są w zasadzie fantazyjną wersją przycisków opcji.

Te niestandardowe elementy sterujące są zdefiniowane w pliku custom-controls.php, nie przejrzę ich tutaj, ale spójrzmy na jedno (pole liczbowe HTML5), aby zobaczyć, jak to wszystko działa:

/ **
* Tworzy formant Customizer dla pola wejściowego [type = number]
*
* @since Theme_Customizer_Boilerplate 1.0
* /
klasa CBP_Customizer_Number_Control rozszerza WP_Customize_Control {

public $ type = 'number';

funkcja publiczna render_content () {
Echo '„;
}

}

Jak widać, wszystko, co musisz zrobić, to zdefiniować nowy typ kontrolny $ i jego funkcję render_content, która wyświetla formant na ekranie Theme Customizer.

Korzystanie z wbudowanych niestandardowych elementów sterujących Customizer Boilerplate

Jest to to samo, co proste pola omówione w poprzednim samouczku, jedyne, o czym musisz wiedzieć, to „typy”, których musisz użyć dla każdego z nich:

  • Pole liczbowe – ‘numer’
  • Pole tekstowe – „Textarea”
  • Obrazy, które działają jak przyciski opcji – „Images_radio”, oto przykład tej kontroli w nadchodzącym darmowym Motyw Cazuela:

Szablon dostosowywania motywu

Znając nazwy tych nowych typów kontrolek, dodanie jednego jest łatwe. Oto jak możesz dodać kontrolkę pola liczbowego do tablicy zawierającej wszystkie opcje:

/ *
* ============
* ============
* Pole liczbowe
* ============
* ============
* /
'new_number_field' => tablica (
'setting_args' => tablica (
„default” => ”,
„typ” => „opcja”,
„capability” => $ thsp_cbp_capability,
„transport” => „odśwież”,
),
'control_args' => tablica (
„label” => __ („Number”, „my_theme_textdomain”),
„type” => „number”, // Kontrola Textarea
„priorytet” => 8
)
)

Uwaga: jeśli nie masz pewności, gdzie to dodać, sprawdź sekcję „Korzystanie z tablicy opcji, aby dodać sekcje, ustawienia i elementy sterujące dostosowywania” w części 3 tej serii. Jest też próbka dla każdego z niestandardowych elementów sterujących w pliku options.php.

Dodanie własnych niestandardowych elementów sterujących

Wróćmy do haka akcji „thsp_cbp_custom_controls”, o którym wspominałem wcześniej:

/ **
* Hak akcji, który pozwala tworzyć własne kontrolki
* /
do działań ('thsp_cbp_custom_controls');

Jest to prosty hak akcji WordPress, który pozwala dodawać własne niestandardowe elementy sterujące bez modyfikowania plików szablonu dostosowywania motywu. Dlaczego nie chcesz ich edytować? Ponieważ jeśli zamiast tego podłączasz się do szablonu, za każdym razem, gdy ktoś go aktualizuje, możesz po prostu pobrać najnowszą wersję, upuścić ją w swoim motywie i nie stracić wprowadzonych zmian. Pomyśl o edycji podstawowych plików WordPress a pisaniu wtyczki, edycji motywu lub tworzeniu motywu potomnego itp.

Jeśli kiedykolwiek chcesz dodać własne niestandardowe elementy sterujące, możesz to zrobić w następujący sposób:

funkcja my_theme_add_customizer_boilerplate_control () {
/ **
* Tworzy niestandardową kontrolę do użycia z szablonem dostosowywania motywu
* Użyj unikalnego prefiksu klasy!
*
* @since Theme_Customizer_Boilerplate 1.0
* /
klasa CBP_Customizer_My_Control rozszerza WP_Customize_Control {

public $ type = 'my_type'; // Zmień to

funkcja publiczna render_content () {
// Wyjście sterujące jest tutaj
}

}
}
add Działalności („thsp_cbp_custom_controls”, „my_theme_add_customizer_boilerplate_control”);

Upewnij się, że poprzedzasz niestandardową klasę kontrolną czymś unikalnym, aby jej nazwa nie kolidowała z inną klasą. Użyłem „CBP_” (Customizer Boilerplate) – ponieważ używasz szablonu w temacie, nazwa Twojego motywu ma wiele sensu i powinna dobrze działać.

Dostosowywanie motywów: co dalej?

Teraz, gdy planszę dostosowywania motywu WordPress można rozszerzać za pomocą haczyków, przyjrzymy się, aby dodać „opcje motywu warunkowego” – te, które pojawią się tylko wtedy, gdy określona wtyczka jest aktywna i pomogą utrzymać porządek na ekranie dostosowywania motywu.

Jakie są Twoje dotychczasowe opinie na temat kotła Customizer? Czy planujesz używać go w swoich motywach? Wszelkie pomysły na to, jak można to poprawić? Twoja opinia jest zawsze mile widziana.

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me