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 z własnym pakietem instalacyjnym PHP, a miliony więcej korzysta z internetowej, zdalnie hostowanej usługi WordPress.com. To nie przypadek ani błąd. WordPress jest po prostu najbardziej funkcjonalną, niedrogą (za darmo!) 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 stwierdza, że ​​oprogramowanie nie ma jednej lub dwóch podstawowych funkcji, bez których po prostu nie mogą żyć.

wchodzić WordPress Wtyczki.

Ci niezadowoleni użytkownicy pójdą na poszukiwanie, duże wyszukiwanie, w celu znalezienia odpowiedniej wtyczki do wykonania zadania. Niektóre osoby uważają tę potrzebną wtyczkę, ALE wielu innych po prostu nie uważa, że ​​jej szuka.

Niektórzy użytkownicy WordPress mogą być zadowoleni z tego, że po prostu rezygnują z walki i rezygnują z życia, w którym brakuje jednej istotnej funkcji na ich stronie internetowej. Ale spora grupa tych użytkowników po prostu nie chce rzucić ręcznika, a oni będą kontynuować proces projektowania własnej wtyczki, aby wykonać zadanie. Może to brzmieć skomplikowanie i zastraszanie, 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 będą zadowoleni z drugiego miejsca i myślą o stworzeniu własnej wtyczki, muszą wykonać tylko poniższe kroki, aby wprowadzić instalację WordPress na ścieżkę do większej funkcjonalności i zgodności z dużymi pomysłami i dużymi planami 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 przesłali już garść wtyczek, aby już poprawić funkcjonalność swoich instalacji WordPress. Jednak dla tych, którzy naprawdę podchodzą do tego procesu jako kompletni i nowicjusze, katalog zawierający wszystkie pliki z wtyczkami 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 oczywista nazwa nie jest przypadkowo usuwana ani przedwcześnie aktywowana podczas procesu programowania. Po utworzeniu tego pliku i przesłaniu go na serwer, użyj klienta FTP, aby bezpośrednio edytować ten plik (za pomocą wbudowanego edytora tekstu), dopóki jest on hostowany na serwerze. Jest to najlepszy sposób edycji plików zdalnych, ponieważ sprawia, że ​​zapisywanie i przesyłanie jest w zasadzie automatyczne i zdecydowanie łatwiejsze niż zarządzanie wieloma wersjami tego samego pliku przechowywanego w różnych lokalizacjach.

Wtyczka zostanie teraz nazwana, opisana i oznaczona „byline”. Jest to ten sam rodzaj informacji, który jest umieszczony na górze pliku arkusza stylów „style.css” motywu, a twórcy kompozycji poczują się jak w domu, wypełniając z poniższych informacji. Umieść tę informację w górnej części pliku wtyczki przed jakimkolwiek innym kodem. Nawet otwierający tag PHP nie powinien być umieszczany przed tymi komentarzami. Jeśli te wiersze zostaną niepoprawnie umieszczone lub zostaną całkowicie pominięte, sama wtyczka nie pojawi się w panelu 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 wypełnieniu tych informacji wtyczka zostanie teraz zauważona przez Pulpit nawigacyjny WordPress, a jej informacje będą poprawnie wyświetlane obok innych wtyczek w panelu administracyjnym aktywacji / usuwania wtyczek. Wtyczka otrzymała teraz nazwę pliku, przyjazną nazwę i cel. Brakuje tylko niektórych funkcji. Tam właśnie 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 we wtyczce, ustalimy, czy pole sieci społecznościowej zawiera dane. Jeśli tak, pojawi się „pasek” linków do udostępniania w mediach społecznościowych. Jeśli nie ma w nim żadnych danych, łącza te zostaną pominięte. Jest to świetny sposób na wyłączenie udostępniania postów w witrynie, które po prostu nie są przeznaczone do oglądania przez szerszą publiczność, a robienie tego we wtyczce to świetny sposób, aby upewnić się, że ta funkcjonalność dotyczy wszystkich tematów, a nie tylko szablon wprowadzania 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 dodana „akcja” w pliku wtyczki, gdy jest on całkowicie wypełniony:

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. "";
}
}
działanie dodatkowe („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 sprawdza, czy zawartość znajduje się w tabeli bazy danych pola. Następnie przechodzi przez warunek. Jeśli treść jest równa „1”, jest kontynuowana. Użycie „1” w tym przypadku oznacza „jeśli pole zawiera dane”. Odwrotnością tego byłoby „0”, co oznaczałoby „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 warunku. Ta sekcja przewiduje wyświetlanie linków do udostępniania w mediach społecznościowych. Dla celów zwięzłości linki te nie zostały włączone do funkcji. Można je jednak udawać, używając prostego XHTML w cudzysłowach następujących po instrukcji „return $ post_ID”.

Jeśli w polu niestandardowym nie ma danych, to w zakresie kodu tej wtyczki jest równy „0”. Ponieważ jednak ten warunek jest instrukcją typu / lub zamiast wielu z różnymi wynikami, po prostu używamy konstrukcji „else”, aby poinstruować wtyczkę, aby wydrukowała alternatywną treść w każdych innych okolicznościach. W takim przypadku po prostu nic nie drukuje. Z tego powodu wszystko, co należy umieścić w funkcji, to:

return $ post_ID ""

Na dole instrukcji dodajemy naszą nową funkcję jako „akcję” do istniejącej zmiennej PHP „the_content”. Spowoduje to dołączenie przycisków udostępniania w sieci społecznościowej na dole wpisu bezpośrednio po zakończeniu drukowania wpisu. Oświadczenia w tym nawiasowym oświadczeniu są chronologiczne, co oznacza, że ​​nowe działanie („social_links”) może zostać umieszczone przed „the_content”, jeśli te przyciski miałyby być wyświetlane na początku treści, bezpośrednio po wydrukowaniu tytułu wpisu na ekran.

Po zakończeniu funkcji i dodaniu akcji do pętli WordPress bezpośrednio po wydrukowaniu głównej treści wpisu na stronie, wtyczka jest zasadniczo ukończona. Jest to odpowiedni czas na dodanie zamykającego znacznika PHP, zapisanie pliku i przesłanie go na serwer w celu 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 aktywacji i testowania pojawią się jakiekolwiek błędy, ważne jest, aby sprawdzić plik wtyczki i upewnić się, że wszystkie instrukcje są poprawnie otwierane i zamykane. Oznacza to sprawdzanie interpunkcji, w wielu przypadkach, w tym nawiasów, średników, nawiasów i małych liter. Pamiętaj, że w PHP rozróżniana jest wielkość liter, a także interpunkcja: każde niezamknięte polecenie zasadniczo trwa nieskończenie długo i może powodować, że strony po prostu się nie ładują 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ć, co robi wtyczka, jak została zbudowana lub jak działa w obrębie sama pętla WordPress. Jednak wielu programistów tworzy wtyczki z zamiarem rozpowszechniania ich wśród szerszej społeczności WordPress, a przy ponad milionie użytkowników 60 jest to lukratywny sposób promowania strony internetowej i zarabiania dodatkowego dochodu.

Użytkownicy ci są praktycznie zobowiązani do stworzenia dokumentu ReadMe, który opisuje funkcje wtyczki, sposób instalowania pliku na serwerze oraz konfigurowania i dostosowywania jego funkcji. Ten plik może także zawierać informacje, takie jak dziennik zmian, który szczegółowo opisuje każdą zmianę i aktualizację wtyczki z czasem. Jednak ważne jest, aby wyjaśnić, co robi wtyczka, jak działa i jak ją zainstalować. Początkujący użytkownicy nie będą wiedzieli, co zrobić, jeśli nie zostaną poprowadzeni przez ten proces, podobnie jak nowi twórcy wtyczek nie wiedzieli, jak utworzyć nową funkcję WordPress aż do ostatniego kroku tego przewodnika.

Kiedy plik wtyczki zostanie skompletowany i sparowany z plikiem ReadMe (zwykle plikiem .txt), czas umieścić oba dokumenty w ich 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 na serwer programisty w celu uzyskania rozwiązania hostowanego samodzielnie.

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 o sprawdzeniu błędów, błędów sprawdzania poprawności i konfliktów funkcji przed włączeniem wtyczki do aktywnego użytku lub udostępnieniem jej szerszej społeczności WordPress. Gdy proces ten zostanie zakończony, a wtyczka działa poprawnie, etap programowania jest zakończony 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 wtyczek 20 Essential WordPress, Poręczne fragmenty kodu 25 dla programistów WordPress, Najbardziej poszukiwane hacki, porady i sztuczki WordPress; a jeśli szukasz dobrego hostingu WordPress, sprawdź, z czego ostatnio korzystałem - Silnik WP - to dość drogi host (dlatego nie jest zalecany dla początkujących), 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.