Kategorie filtrów Ajax hosting wordpress

Wprowadzenie

Ten artykuł, którego celem twórców wtyczek, opisuje jak dodać Ajax do wtyczki. Przed przeczytaniem tego artykułu, należy zapoznać się z następującymi zasadami:

• Ajax - Przegląd technologii
• Napisanie wtyczki - Jak napisać plugin
• Plugin API - Filtry i działania - czym są i jak z nich korzystać
• Jak dodać HTML do odpowiedniej strony w systemie WordPress, pocztą, lub ekranu - na przykład, jeśli chcesz dodać Ajax do ekranów administracyjnych utworzonych, musisz zrozumieć, jak dodać do menu administracji WordPress; Jeśli chcesz dodać Ajax do wyświetlania pojedynczego postu, musisz dowiedzieć się odpowiednie filtry i działania, aby dodać HTML do tego miejscu na blogu ekranów od strony widza. Ten artykuł nie obejmuje tych tematów.

Ajax w administracji Side

Ponieważ Ajax jest już wbudowany w podstawowych ekranów administracji WordPress, dodając więcej funkcji po stronie administracji Ajax do wtyczki jest bardzo prosta.

Ten krótki przykład używa PHP napisać naszą JavaScript w stopce strony. Ten skrypt następnie wyzwala żądania AJAX, gdy strona jest w pełni załadowany:

UWAGA: Od wersji 2.8. Kod JavaScript zmienna globalna ajaxurl może być stosowany w przypadku, gdy chcesz oddzielić kod JavaScript z plików PHP w JavaScript tylko pliki. Jest to prawdą tylko na stronie administracyjnej. Jeśli używasz AJAX na front-end, trzeba dokonać JavaScript świadomi url admin-ajax.php. Najlepszą praktyką jest opisany w przykładzie IV, poniżej, z użyciem wp_localize_script ().

Następnie należy skonfigurować funkcję PHP, aby obsłużyć żądania AJAX.

Zauważ, jak wartość „my_action” kluczem „działanie” jest zdefiniowany w naszym JavaScript powyżej, mecze drugiej połowy akcji „wp_ajax_my_action” w naszej obsługi AJAX poniżej. To dlatego, że jest on używany do wywołania funkcji PHP po stronie serwera przez administratora-ajax.php. Jeśli akcja nie jest określony, admin-ajax.php wyjdzie, i zwraca 0 w tym procesie.

trzeba będzie dodać kilka szczegółów, takich jak sprawdzanie błędów i sprawdzeniu, że żądanie pochodzi z właściwym miejscu (za pomocą check_ajax_referer ()), ale mam nadzieję, że powyższy przykład wystarczy, aby zacząć grę na swojej własnej administracji stronie Ajax plugin ,

Zauważ użycie wp_die (). Zamiast matrycy () i wyjścia (). Większość czasu należy używać wp_die () w funkcji wywołania zwrotnego Ajax. Zapewnia to lepszą integrację z WordPress i sprawia, że ​​łatwiej testować swój kod.

Oddzielnym pliku JavaScript

Ten sam przykład jak poprzedni, z wyjątkiem kodu JavaScript w oddzielnym pliku zewnętrznego Zadzwonimy js / my_query.js. Przykłady są względne do folderu wtyczek.

Z zewnętrznych plików JavaScript, musimy najpierw wp_enqueue_script (), więc są one zawarte na stronie. Dodatkowo musimy użyć wp_localize_script (), aby przekazać wartości do właściwości obiektu JavaScript, PHP, ponieważ nie można bezpośrednio wartości echo język naszego pliku JavaScript. Funkcja obsługi jest taka sama, jak w poprzednim przykładzie.

Ajax po stronie Viewer-Facing

Ponieważ WordPress 2.8, jest podobna do wp_ajax_ hak (działanie).

Tak więc, jeśli chcesz go odpalić na front-end dla obu gości i zalogowanych, można to zrobić:

Uwaga: W odróżnieniu od strony administratora The ajaxurl javascript globalne nie są automatycznie zdefiniowane dla Ciebie, chyba że masz BuddyPressa lub inny Ajax polegania wtyczki zainstalowanej. Więc zamiast opierania się na zmiennej globalnej javascript, zadeklarować JavaScript Object namespace z własnej nieruchomości, ajaxurl. Można również użyć wp_localize_script (), aby uczynić URL dostępnych do skryptu i wygenerować go za pomocą tego wyrażenia: admin_url ( „admin-ajax.php”)

Uwaga 2: Zarówno front-end i back-end żądań Ajax używać admin-ajax.php tak is_admin () zawsze zwraca wartość true w swoim akcja przenoszenia kodu. Kiedy selektywnie wczytywania teleskopowe skryptów AJAX dla front-end i back-end, a przy użyciu funkcji is_admin (), Twój wp_ajax_ (działanie) i wp_ajax_nopriv_ (działanie) haki muszą być wewnątrz is_admin () === prawdziwe części.

Ajax wnioski związane z działaniami albo wp_ajax_ lub wp_ajax_nopriv_ są wykonywane w kontekście WP Admin. Ostrożnie przeglądu czynności wykonujesz w kodzie od nieuprzywilejowani użytkownicy lub odwiedzający będą mogli wyzwalać żądania z podwyższonymi uprawnieniami, które nie mogą być dopuszczone do.

Tutaj akcja my_frontend_action Ajax wywoła funkcję my_frontend_action_callback () w PHP dla wszystkich użytkowników. Ajax akcja my_backend_action wywoła funkcję my_backend_action_callback PHP () Tylko dla zalogowanych.

Post-load JavaScript Event

Wtyczki i motywy, które wstawić zawartość za pośrednictwem AJAX musi wyzwalać zdarzenia po obciążeniu na document.body po zawartość jest włożona. Inne skrypty, które zależą od interakcji JavaScript po wprowadzeniu danych, takich jak AddToAny lub skryptu jQuery murarskie, wykrywać zdarzenie po obciążeniu zainicjowanie ich wymaganą JavaScript. Gdy zdarzenie po obciążeniu jest zwolniony od Nieskończonego Zwoju Jetpack jest. na przykład AddToAny wyświetla przyciski akcję dla każdego postu, a jQuery murarskie ustawia elementy na stronie.

JavaScript wyzwalania zdarzenie po obciążeniu po zawartość została włożona przez Ajax:

JavaScript słuchania przypadku post-obciążenia:

Uwaga na jQuery: Strzeż się przy użyciu metody load jQuery za pomocą wyrażenia wybieraka, aby wstawić zawartość, ponieważ spowoduje to