Godny uwagi przewodnik po tworzeniu własnych niestandardowych widżetów w WordPress

Opublikowany: 2021-07-06

Własne niestandardowe widżety

Jak tworzyć niestandardowe widżety w witrynie WordPress?

Jeśli prowadzisz witrynę WordPress od jakiegoś czasu, z pewnością będziesz miał dobry pomysł na widżety i ich wykorzystanie. Widżety służą jako doskonałe narzędzie, pomagając użytkownikom WordPressa dodawać więcej treści i funkcji do pasków bocznych (zwanych również obszarami widżetów) ich motywu witryny.

Ponadto widżety można dodawać do kilku innych obszarów motywu WP, takich jak nagłówek, stopka itp.) W zależności od potrzeb i potrzeb.

Widgety pomagają głównie przeciągać i upuszczać elementy w witrynie. Domyślnie w panelu administracyjnym motywu WordPress można znaleźć kilka widżetów.

Możesz jednak sprawić, że pulpit nawigacyjny Twojej witryny będzie jeszcze bardziej przydatny do tworzenia niestandardowych widżetów. W tym poście wyjaśnię, jak możesz stworzyć własny niestandardowy widżet na pulpicie nawigacyjnym witryny WordPress.

Powiązany post: Jak dodać widżety i zacząć z nich korzystać w witrynie WordPress?

Jak stworzyć niestandardowy widżet w panelu?

Załóżmy, że chcesz utworzyć niestandardowy widżet w panelu administratora swojej witryny. W tym celu pierwszą rzeczą, którą musisz zrobić, to zarejestrować swój widżet w WordPress.

Aby to zrobić, wystarczy skorzystać z funkcji wp_add_dashboard_widget(). Jest to domyślna funkcja WordPressa, która informuje WordPressa o nowo utworzonym widżecie.

Poniżej znajduje się kod, który zademonstruje, jak zarejestrować niestandardowy widżet:

// Register your custom widget function by hooking into the 'wp_dashboard_setup' action
add_action( 'wp_dashboard_setup', 'first_custom_dashboard_widget' );

funkcja first_custom_dashboard_widget() {

wp_add_dashboard_widget(

'pierwszy_niestandardowy_widget_dashboard',
//to jest widget slug
'Pierwszy niestandardowy widżet pulpitu nawigacyjnego',
//to jest tytuł twojego widżetu
„first_custom_dashboard_widget_display”
//Funkcja wyświetlania
);

}
//Utwórz funkcję wyświetlającą zawartość do wyświetlenia w widżecie Dashboard.
funkcja first_custom_dashboard_widget_display() {

echo 'Tu opisujesz swój widżet Widget';

}

Uwaga: powyższy kod należy dodać do pliku functions.php motywu.

Powyższy fragment kodu pomoże w stworzeniu niestandardowego widżetu o nazwie „Pierwszy niestandardowy widżet pulpitu nawigacyjnego”. Rozumiem teraz, jak działa kod:

  • W pierwszym wierszu kodu funkcja register_first_custom_dashboard_widget() jest podłączona do haka akcji wp_dashboard_setup. W prostych słowach, początkowy wiersz kodu oznacza, że ​​za każdym razem, gdy akcja wp_dashboard_setup pojawi się w kodzie twojego motywu, zostanie wykonana first_custom_dashboard_widget().
  • Następnie funkcja wp_dashboard_setup() wykonuje proste wywołanie funkcji wp_add_dashboard_widget() z różnymi parametrami, takimi jak:
    • Poślizg widżetu
    • Tytul widzeta
    • Funkcja wyświetlania

    Wszystkie te parametry są potrzebne do tworzenia niestandardowych widżetów.

  • Wreszcie funkcja my_dashboard_widget_display() jest zdefiniowana i zawiera pewną treść tekstową mówiącą: „To jest mój pierwszy niestandardowy widżet”.


Po wykonaniu kodu po prostu przejdź do panelu administratora, a zobaczysz nowo utworzony widżet dodany na dole strony panelu administratora. Po prostu przeciągnij ten widżet i umieść go w dowolnym miejscu.

Wyjście:
kciuk

Jak zmienić pozycję niestandardowych widżetów?

W powyższej sekcji omówiliśmy kod, który pomaga w tworzeniu i dodawaniu niestandardowych widżetów na pulpicie nawigacyjnym witryny WordPress.

Najwyraźniej chciałbyś dać użytkownikom wtyczki możliwość umieszczenia "Niestandardowego widżetu pulpitu nawigacyjnego" w wybranej przez nich lokalizacji, po prostu przeciągając go.

Niestety, WordPress nie jest wyposażony w łatwy w użyciu interfejs API, który umożliwiłby wstępne sortowanie domyślnych widżetów. Oznacza to, że Twój niestandardowy widżet będzie zawsze wyświetlany na dole listy pulpitu nawigacyjnego.

Ale co, jeśli chcesz umieścić swój niestandardowy widżet ponad wszystkimi domyślnymi widżetami? Możesz to zrobić, bawiąc się kodem.

Jednym z najlepszych sposobów na osiągnięcie takiego celu jest ręczna zmiana wewnętrznej tablicy metaboksów. Następnie możesz umieścić nowo utworzony widżet na górze listy widżetów. Oto kod, który wykonuje to samo zadanie:

function first_custom_dashboard_widgets() {
wp_add_dashboard_widget( 'first_custom_dashboard_widget', 'First Custom Dashboard Widget', 'first_custom_dashboard_widget_function' );
// Globalize the array of the metaboxes, this will apply to all the widgets for wp-admin
global $wp_meta_boxes;
// Fetch array of the regular dashboard widgets
$normal_dashboard = $wp_meta_boxes['dashboard']['normal']['core'];
// Create a backup of the custom dashboard widget and delete it from the end of the array
$first_custom_widget_backup = array( 'first_custom_dashboard_widget' => $normal_dashboard['first_custom_dashboard_widget'] );
unset( $normal_dashboard['first_custom_dashboard_widget'] );
// Combine both the arrays together to put custom widget at the beginning
$sorted_dashboard = array_merge( $first_custom_widget_backup, $normal_dashboard );
// Save the value of sorted array back into the main metaboxes
$wp_meta_boxes['dashboard']['normal']['core'] = $sorted_dashboard;
}

Pamiętaj, że ten kod będzie działał dla właścicieli witryn WordPress, którzy w ogóle nie zmienili kolejności swoich widżetów. Ale gdy tylko użytkownik wykona tę funkcję, jego obecne preferencje zastąpią to. W rezultacie użytkownicy będą musieli przenieść widżet na górę.

Zawijanie
Chociaż WordPress zapewnia dostęp do kilku domyślnych widżetów rozszerzających możliwości pulpitu administracyjnego Twojej witryny, nadal może nie spełniać Twoich szczególnych potrzeb.

Możesz jednak osiągnąć wszystkie pożądane cele i zwiększyć użyteczność pulpitu administracyjnego, tworząc niestandardowy widżet. W końcu widżety to doskonały sposób na dodawanie dodatkowej zawartości i funkcjonalności.

Nie trzeba dodawać, że utworzenie nowego widżetu dostosowanego do wykonania niektórych zadań w panelu administratora będzie dla Ciebie korzystne.

Mam nadzieję, że ten post będzie przydatnym przewodnikiem, który pomoże Ci lepiej zrozumieć, jak tworzyć niestandardowe widżety w panelu administracyjnym witryny.

Pamiętaj, że jeśli masz problemy z kodowaniem, lepiej zatrudnij programistę WordPress, który pomoże Ci w ukończeniu projektu.

Biografia autora:
Samuel Dawson jest twórcą aplikacji internetowych i menedżerem plików w Designs2html Ltd. Z powodzeniem wykonuje również konwersję motywów HTML do WordPress.

Dynamicznie utrzymuje ogólne przetwarzanie plików WordPress. Powyższy artykuł na temat zarządzania widżetami w WordPressie został napisany przez niego.