WordPress How-To: Podstawy rozwoju wtyczek WP

Artykuł napisany przez:
  • Porady dotyczące blogowania
  • Zaktualizowano: Aug 12, 2013

Będziemy pracować nad serią artykułów skupiających się na "jak zrobić X z WordPress". Artykuły te będą nieco dłuższe i są przeznaczone głównie dla doświadczonych webmasterów i programistów; jeśli nie masz doświadczenia w WordPressie, sprawdź moje Przewodnik po Twoim pierwszym blogu WordPress.

A teraz podstawowe wprowadzenie.

Rozszerzanie funkcjonalności WordPress poprzez opracowywanie nowej wtyczki

Strona główna WordPress

WordPress jest najpopularniejszą platformą do zarządzania treścią na świecie, z ponad 60 milionami użytkowników swojego hostowanego pakietu instalacyjnego PHP i milionami więcej za pomocą internetowej, zdalnie hostowanej usługi WordPress.com. To nie przypadek ani błąd. WordPress jest po prostu najbardziej w pełni funkcjonalną, przystępną cenowo (za darmo!), Łatwą w użyciu aplikacją do zarządzania treścią na świecie. Jednak nawet ten tytan zarządzania treścią nie jest absolutnie doskonały, a wielu użytkowników ostatecznie odkrywa, że ​​oprogramowanie nie ma jednej lub dwóch podstawowych funkcji, z których po prostu nie mogą żyć.

wchodzić WordPress Wtyczki.

Ci niezadowoleni użytkownicy wezmą udział w poszukiwaniach, dużym wyszukiwaniu, starając się znaleźć odpowiednią wtyczkę, aby wykonać zadanie. Niektóre osoby uznają tę potrzebną wtyczkę, ale wiele innych po prostu nie znajduje tego, czego szuka.

Niektórzy użytkownicy WordPressa mogą po prostu zrezygnować z walki i zrezygnować z życia, którego brakuje na ich stronie internetowej. Ale spora grupa tych użytkowników po prostu nie chce rzucić ręcznika, a oni będą realizować proces projektowania własnych niestandardowych wtyczek, aby wykonać zadanie. To może wydawać się skomplikowane i zastraszające, a niektóre jego części mogą być. Na pewno, solidna znajomość PHP będzie wymagane w przypadku bardziej zaawansowanych wtyczek, które dodają rzeczywiste funkcje do funkcji WordPress. Wtyczka jest stosunkowo łatwa do napisania, zwłaszcza w przypadku podstawowych funkcji, które są standardem w całym WordPressie i po prostu muszą być "przerobione", aby lepiej wykonywać tę pracę i prezentować ją w bardziej przyjemny sposób.

Użytkownicy, którzy nie zadowalają się drugorzędnymi osiągnięciami i myślą o stworzeniu własnej wtyczki, muszą tylko wykonać poniższe proste czynności, aby umieścić swoją instalację WordPress na ścieżce prowadzącej do większej funkcjonalności i zgodności z ich dużymi pomysłami i wspaniałymi planami dotyczącymi dominacji w Internecie. .

Krok 1: Utwórz nowy plik w katalogu wtyczek i nadaj mu cel

Wtyczki WP

Pierwszym krokiem do stworzenia wtyczki jest po prostu utworzenie nowego pliku wtyczki PHP w istniejącym katalogu wtyczek WordPress.

Do tej pory większość użytkowników powinna wiedzieć, gdzie zlokalizować ten katalog, ponieważ prawdopodobnie załadował on kilka wtyczek, aby ulepszyć już funkcjonalność instalacji WordPress. Jednak dla tych, którzy naprawdę zbliżają się do tego procesu jako kompletny i kompletny nowicjusz, katalog zawierający wszystkie mopsy w plikach znajduje się w następującej lokalizacji dla każdej wersji i iteracji oprogramowania WordPress:

/ public_html / wp-content / plugins /

Przejdź do tego katalogu i utwórz nowy (pusty w tym momencie) plik o nazwie "my-custom-plugin.php". Jest to plik, który będzie zawierał całą naszą pracę od początku do końca, a my damy mu nazwa oczywistego kapelusza nie zostaje przypadkowo usunięta lub przedwcześnie aktywowana podczas procesu tworzenia. Po utworzeniu i przesłaniu tego pliku na serwer użyj klienta FTP, aby bezpośrednio edytować ten plik (za pomocą wbudowanego edytora tekstu), gdy nadal jest hostowany na serwerze. Jest to najlepszy sposób na edycję plików zdalnych, ponieważ pozwala na zapisywanie i przesyłanie w zasadzie automatycznie i zdecydowanie łatwiej niż zarządzanie wieloma wersjami tego samego pliku przechowywanymi w różnych lokalizacjach.

Wtyczka zostanie teraz nazwana, opisana i opatrzona "linkiem". Jest to ten sam rodzaj informacji, który jest umieszczony na górze pliku stylów "style.css", a twórcy motywów poczują się jak w domu, wypełniając poniżej informacje. Umieść te informacje w górnej części pliku wtyczki przed jakimkolwiek innym kodem. Nawet otwierający tag PHP nie powinien być umieszczony przed tymi skomentowanymi liniami. Jeśli te wiersze zostaną umieszczone niepoprawnie lub zostaną całkowicie pominięte, sama wtyczka nie pojawi się na pulpicie nawigacyjnym WordPress. Oznacza to, że nie można go aktywować, używać, testować ani debugować, a to nie jest dobre. Oto, co należy wypełnić przed otwarciem pliku i przystąpieniem do definiowania funkcji:

/*
Nazwa wtyczki: niestandardowa wtyczka używana do poznawania dróg WordPress
Plugin URI: http://www.your-website-here.com
Opis: Ta wtyczka służy do demonstrowania, w jaki sposób kod PHP, zmienne WordPress, XHTML, CSS i inne informacje są umieszczane w standardowym pliku PHP wtyczki, aby dodać nową funkcjonalność do standardowej instalacji WordPress.
Autor: Twoje imię tutaj
Wersja: 1.0
Identyfikator URI autora: http://www.your-website-here.com
*/

Po kompletnym wypełnieniu tej informacji wtyczka zostanie teraz zauważona przez pulpit nawigacyjny WordPress, a informacje będą wyświetlane poprawnie wraz z innymi wtyczkami w panelu administracyjnym aktywacji / usuwania wtyczki. Wtyczka ma teraz nazwę pliku, przyjazną nazwę i cel. W tym momencie brakuje tylko niektórych funkcji. Tam wkracza krok drugi.

Wtyczki WP

Krok 2: Definiowanie funkcji wtyczki (lub funkcji) do użycia w witrynie WordPress

Ta demonstracja wtyczki zakłada, że ​​programista utworzył pole niestandardowe. To pole służy do określania, czy linki do mediów społecznościowych są dołączane do postu, aby użytkownicy mogli udostępniać wpis swoim znajomym i członkom rodziny, którzy zasubskrybowali swoje aktualizacje w serwisach społecznościowych na stronach takich jak Twitter, Facebook, LinkedIn i MySpace . Utworzono niestandardowe pole, w tym przypadku o nazwie "social_links".

Korzystając z kodu PHP w wtyczce, określimy, czy w polu społecznościowym znajdują się dane wewnątrz niego. Jeśli tak, pojawi się "pasek" linków do udostępniania mediów społecznościowych. Jeśli nie ma w nim żadnych danych, linki te zostaną pominięte. Jest to świetny sposób, aby wyłączyć udostępnianie postów na swojej stronie internetowej, które nie są przeznaczone do oglądania przez szerszą publiczność, a robienie tego w wtyczce to świetny sposób na zapewnienie, że ta funkcjonalność dotyczy wszystkich tematów, a nie tylko w szablon wpisu jednego motywu.

Ten proces jest realizowany przez "dodanie" akcji do kodu WordPress. Odbywa się to za pomocą polecenia PHP "add_action", zaparkowanego z kilkoma instrukcjami "echo" i istniejącym obiektywem kodu WordPress, który można przeportować bezpośrednio z istniejących plików szablonów WordPress. Pamiętaj, że praktycznie dowolna zmienna, która może być użyta w szablonie, jest również ważna do włączenia do pliku wtyczki, chociaż otwieranie i zamykanie znaczników PHP musi zostać pominięte, ponieważ kod jest już zawinięty w jedną, wszechogarniającą otwierającą i zamykającą obudowę znaczników PHP .

Oto jak wygląda "akcja" w pliku wtyczki, gdy jest całkowicie wypełniona:

function social_links ($ post_ID) {
global $ wp_query;
$ ID = $ wp_query-> post-> ID;
if (get_post_meta (13); == 1)
{
return $ post_ID. "Społecznościowe przyciski łączenia";
}
więcej
{
return $ post_ID. "";
}
}
add_action ("the_content", "social_links");

Pierwsze wiersze kodu są po prostu używane do określenia, czy w panelu WordPress została wypełniona informacja "meta" dla konkretnego wpisu, który jest przeglądany. Odbywa się to poprzez zapytanie do bazy danych WordPress (przy użyciu zmiennej $ wp_query) i poszukiwanie informacji w obrębie numeru pola meta 13. Każde pole niestandardowe otrzymuje numeryczną identyfikację, podobnie jak wpisy, komentarze i strony. Ta liczba może być używana w zmiennych dla instrukcji warunkowych.

Tak więc najpierw wtyczka sprawdza niestandardowe pole dla każdego wpisu i widzi, czy zawartość jest obecna w tabeli bazy danych pola. Następnie przechodzi przez tryb warunkowy. Jeśli zawartość jest równa "1", kontynuuje. Użycie "1" w tym przypadku oznacza "jeśli pole zawiera dane." Odwrotnością tego byłoby "0", które tłumaczyłoby się na "jeśli pole nie zawiera danych." Tak więc, jeśli pole zawiera dane lub równa się "1", funkcja przechodzi do pierwszej części warunkowej. Ta sekcja zapewnia wyświetlanie linków do udostępniania mediów społecznościowych. W celu zwięzłości łącza te nie zostały dołączone do tej funkcji. Mogą one jednak być udawane za pomocą prostego XHTML w cudzysłowach, które następują po wyrażeniu "return $ post_ID".

Jeśli pole niestandardowe nie zawiera danych, to faktycznie jest równe "0" w odniesieniu do kodu tego wtyczki. Ponieważ jednak warunkowe jest albo / albo instrukcją, zamiast jedną z wieloma różnymi wynikami, po prostu używamy konstrukcji "else", aby polecić wtyczce drukowanie alternatywnej treści w dowolnych innych okolicznościach. W tym przypadku po prostu nic nie drukuje. Z tego powodu wszystko, co należy umieścić w funkcji, to:

return $ post_ID ""

W dolnej części tego oświadczenia dodajemy naszą nową funkcję jako "działanie" do istniejącej zmiennej PHP "the_content". Spowoduje to dołączenie przycisków udostępniania sieci społecznościowej na dole wpisu bezpośrednio po zakończeniu drukowania zawartości wpisu. Oświadczenia w tym nawiasie są chronologiczne, co oznacza, że ​​nowa akcja ("social_links") może być umieszczona przed "the_content", jeśli te przyciski powinny być wyświetlane na początku treści, bezpośrednio po tym, jak tytuł wpisu został wydrukowany na ekran.

Po zakończeniu działania funkcji i dodaniu do pętli WordPress bezpośrednio po wydrukowaniu głównej zawartości zawartości na stronie, wtyczka jest w zasadzie ukończona. Jest to odpowiedni czas na dodanie zamykającego tagu PHP, zapisanie pliku i przesłanie go na serwer do użycia.

Krok 3: Aktywuj wtyczkę i wypróbuj ją

Najważniejszą częścią procesu jest aktywacja wtyczki i sprawdzenie, czy jej funkcje działają zgodnie z oczekiwaniami i nie powodują problemów z istniejącymi wtyczkami lub standardowymi funkcjami WordPress. Jest to również dobry moment, aby zweryfikować integralność kodu PHP i upewnić się, że wszelkie dane wyjściowe (XHTML lub inne) są drukowane zgodnie z potrzebami.

Jeśli podczas procesu aktywacji i testowania pojawią się jakiekolwiek błędy, należy sprawdzić plik wtyczki i upewnić się, że wszystkie instrukcje są poprawnie otwierane i zamykane. Oznacza to sprawdzanie interpunkcji, w wielu przypadkach włącznie z nawiasami, średnikami, nawiasami i małymi literami. Pamiętaj, że w PHP rozróżniana jest wielkość liter i jest ona również wrażliwa na interpunkcje: każde niezamknięte oświadczenie w zasadzie ciągnie się w nieskończoność i może powodować, że strony po prostu nie ładują się lub ładują się bardzo wolno.

Kiedy wszystkie załamania zostały opracowane, praca jest w dużej mierze zakończona. Jednak w przypadku innych scenariuszy należy pamiętać o kilku dodatkowych kwestiach.

Krok 4: Tworzenie pliku ReadMe wtyczki

Utwórz wtyczkę WordPress

Jeśli wtyczka jest przeznaczona wyłącznie do użytku prywatnego, po prostu nie ma powodu, aby utworzyć plik "ReadMe", chyba że obawiasz się, że możesz zapomnieć o tym, co robi wtyczka, jak została ona zbudowana lub jak działa sama pętla WordPress. Jednak wielu programistów tworzy wtyczki z zamiarem dystrybucji ich do szerszej społeczności WordPressa, a przy ponad 60 milionach użytkowników jest to lukratywny sposób na promowanie strony internetowej i uzyskiwanie dochodów wtórnych.

Tacy użytkownicy są praktycznie zobowiązani do stworzenia dokumentu ReadMe, który opisuje funkcje wtyczki, jak zainstalować plik na serwerze i jak go skonfigurować i dostosować jego funkcje. Ten plik może również zawierać informacje, takie jak dziennik zmian, który szczegółowo opisuje każdą zmianę i aktualizację wtyczki w czasie. Jednak ważne jest, aby wyjaśnić, co robi wtyczka, jak to działa i jak ją zainstalować. Początkujący użytkownicy nie będą wiedzieli, co robić, jeśli nie są prowadzeni przez proces, podobnie jak początkujący deweloperzy wtyczek nie wiedzieli, jak utworzyć nową funkcję WordPress do ostatniego kroku tego przewodnika.

Kiedy plik wtyczki zostanie skompletowany i sparowany z plikiem ReadMe (zazwyczaj plikiem .txt), nadszedł czas, aby umieścić oba dokumenty w swoim własnym folderze i skompresować je przy użyciu standardowego formatu pliku ZIP. Wtyczkę można następnie przesłać do społeczności wtyczek i motywów WordPress Extend, a także do serwera programisty w celu samodzielnego rozwiązania.

Stosunkowo łatwe do wykonania, zwłaszcza ze zmiennymi i funkcjami WordPress

Wspaniałą rzeczą w rozwoju nowej wtyczki do WordPressa jest to, że plik może korzystać z dowolnej istniejącej funkcji PHP, zmiennej lub pętli, które WordPress już zdefiniował i zainicjował. Dzięki temu można łatwo rozszerzyć funkcje WordPress i rozszerzyć ich funkcjonalność na wiele różnych tematów, dzięki czemu proces tworzenia wtyczek jest tak prosty, jak stworzenie nowego motywu dla samego oprogramowania.

Zawsze pamiętaj, aby przetestować błędy, błędy sprawdzania poprawności i konflikty funkcji przed włączeniem wtyczki do aktywnego użytkowania lub udostępniania z szerszą społecznością WordPress. Gdy proces ten zostanie zakończony, a wtyczka działa poprawnie, etap opracowywania jest kompletny i będziesz mógł cieszyć się sukcesem i nowymi funkcjami, które właśnie stworzyłeś. ;)

Dalsze odczyty na temat WHSR

Aby dowiedzieć się więcej, sprawdź Lista Jerry'ego z 20 Essential WordPress Plugins, Poręczne fragmenty kodu 25 dla programistów WordPress, Najbardziej poszukiwane hacki, porady i sztuczki WordPress; a jeśli szukasz dobrego hostingu WordPress, sprawdź, co ostatnio używałem - Silnik WP - to dość drogi host (więc nie polecany początkującym), ale dostajesz to, za co płacisz.

O Jerry Low

Założyciel WebHostingSecretRevealed.net (WHSR) - przegląd hostingu zaufany i używany przez użytkowników 100,000. Więcej niż doświadczenie 15 w hostingu, marketingu afiliacyjnym i SEO. Współpracuje z ProBlogger.net, Business.com, SocialMediaToday.com i innymi.