W Internecie pełno jest krótkich, użytecznych kawałków kodu, które pozwalają na dodanie lub zmodyfikowanie jakiejś funkcji WordPressa. Jakiś czas temu rozważałem, gdzie taki kod należy umieszczać – w pliku functions.php motywu czy we wtyczce. Teraz chciałbym zaprezentować trzecią możliwość – darmowe rozszerzenie Code Snippets, które pozwala na łatwe zarządzanie takimi „wstawkami”.

Ogólna zasada jest taka: jeśli kod jest związany z używanym przez nas motywem i jego wyglądem, to wrzucamy go do pliku functions.php, a jeśli jest od niego niezależny – do wtyczki. Głównym problemem jest fakt, iż dodanie kilku krótkich kawałków kodu wymaga od nas albo stworzenia własnego rozszerzenia, albo skorzystania z gotowych. Oficjalne repozytorium WordPressa jest pełne prostych wtyczek, które składają się z nie więcej niż kilku lub kilkunastu linii kodu – może się okazać, że aby osiągnąć nasz cel potrzebujemy zainstalować kilka takich wtyczek. Pomijając kwestię wydajności takiego rozwiązania, duża ilość aktywnych rozszerzeń na pewno nie pomaga w utrzymaniu strony w należytym porządku.

Dzięki wtyczce Code Snippets nie musimy się martwić o to, w którym miejscu umieścić nasz kod. Dodatkowo łatwo możemy włączyć lub wyłączyć dowolne „wstawki”, bez konieczności przeszukiwania plików i grzebania na serwerze.

Po instalacji i aktywacji rozszerzenia w menu panelu administracyjnego pojawi się nowa sekcja Snippets, w której znajdziemy wszystkie nasze kawałki kodu.

Korzystając z opcji dostępnych pod snippetem możemy go aktywować, dezaktywować, edytować, usunąć lub wyeksportować. Kod jest eksportowany do pliku XML, ale w menu Masowe działania jest również dostępny eksport do PHP – jego wynikiem jest kod PHP, który bez żadnych zmian możemy wkleić na przykład do pliku functions.php.

Tworzenie nowego snippeta jest bardzo proste. Wystarczy nadać mu tytuł (najlepiej taki, który powie nam do czego dany kawałek kodu służy) i wkleić nasz kod PHP w polu Code. Opcjonalnie możemy dodać równie opis, dzięki któremu za rok wciąż będziemy wiedzieli do czego nasz snippet służy.

Dodatkową zaletą wtyczki jest możliwość importu wyeksportowanych wcześniej kawałków kodu. Jest to szczególnie wygodne gdy mamy własny zestaw snippetów, którego używamy w wielu serwisach. Import jest robiony za pomocą standardowego mechanizmu WordPressa – odpowiedni importer jest dostępny w sekcji Narzędzia → Import panelu administracyjnego. Wystarczy wybrać wygenerowany podczas eksportu plik XML i kliknąć przycisk Upload file and import.