Jak wielu z Was wie, w zeszłym tygodniu Syed Balkhi uczestniczył w WordCamp Raleigh 2012. Podczas tego wydarzenia, jeden z jego tweetów wywołał niemałą debatę. W tym artykule nasz założyciel Syed Balkhi będzie debatował nad tym, czy własne typy treści WordPressa znajdują się w pliku functions.php, czy we wtyczkach. Poniżej znajduje się tweet, który rozpoczął tę debatę:
Don't add Custom Post Types in functions.php -> You should ALWAYS use a site-specific plugin – http://t.co/bebYXq2F #wcraleigh
— WordPress Beginner (@wpbeginner) November 4, 2012
Po tym tweecie, wielu szanowanych ludzi w społeczności WordPressa włączyło się do dyskusji. Pełną rozmowę można zobaczyć tutaj. Curtis McHale poszedł o krok dalej i rozwinął temat w swoim nowym wpisie na blogu.
Rozmowa z Twittera przyniosła kilka świetnych punktów.
Podsumowanie argumentów
Argument wtyczki: Użytkownik zawsze będzie miał te dane, nawet jeśli zmieni motyw. Mogą nie wyglądać tak ładnie, ale pozostaną tam.
Functions.php Argument: Dane bez projektu byłyby nieistotne. To jeszcze bardziej zdezorientuje użytkowników.
Z którą stroną zgadzasz się bardziej? Oczywiście obie strony mają swoje problemy, ale która jest mniejszym złem?
Oto dlaczego uważamy, że własne typy treści powinny ZAWSZE znajdować się we wtyczce specyficznej dla witryny lub w osobnej wtyczce.
Niech żyją dane
Własne typy treści to dane. W większości przypadków twoje dane przetrwają obecny, aktualny projekt. Zmieniając nasze motywy kilka razy, doskonale rozumiemy to stwierdzenie. Wpisy, strony, odnośniki, załączniki i wersje to typy treści, które są wbudowane w WordPress. Do tego dochodzą typy treści takie jak Książki, Referencje, Oferty itp. Czy można sobie wyobrazić, że po zmianie motywu wszystkie te typy znikną? Z pewnością nie chcielibyśmy, aby tak się stało.
Mając programistów w naszym zespole, nie powinno to mieć większego znaczenia. Biorąc pod uwagę, że wszystkie nasze motywy są projektowane na zamówienie przez nasz zespół, jaką to naprawdę robi różnicę? Sekret tkwi w dwóch słowach: czas i centralizacja. Tak długo, jak mamy wszystkie niezbędne dane, wszystko, co będziemy musieli zrobić w przyszłości, to zmienić stylizację. Nie będziemy musieli martwić się o kopiowanie i wklejanie funkcji z jednego pliku do drugiego za każdym razem. Co zrobić, jeśli chcemy powielić tę funkcjonalność? Wystarczy pobrać wtyczkę i wrzucić ją na twoją nową witrynę. Zmień stylizację i gotowe.
Zasady i standardy
Kiedy używasz słowa ZAWSZE, tak jak zrobiliśmy to w naszym tweecie, może ono oznaczać zarówno zasady, jak i standardy. Zarówno zasady, jak i standardy są tworzone dla większości. Zawsze będą istniały specjalne scenariusze, w których zasady są naginane, a standardy łamane, ale to nie znaczy, że powinniśmy całkowicie pozbyć się standardów.
Istnieje mnóstwo ogólnych typów treści, które w większości wymagają tego samego zestawu dodatkowych pól meta. Niektóre przykłady, które przychodzą na myśl, to: Cytaty, Książki, Przepisy, Referencje, Portfolio itp.
Biorąc pod uwagę dużą liczbę motywów fotograficznych i portfolio, które są dostępne na rynku bezpłatnym i komercyjnym, prawie nie ma sensu, aby użytkownik ponownie wpisał wszystkie informacje o własnym typie treści za każdym razem, gdy zmienia motyw. Przyjrzyjmy się przykładowemu scenariuszowi:
Fotograf – Użytkownik skonfigurował WordPressa, który ma funkcjonalność bloga (domyślny „wpis” CPT). Chce dodać portfolio swoich prac (wymaga CPT Portfolio). Chce pokazać referencje klientów (wymaga CPT Testimonial). Wszystkie te informacje z pewnością przetrwają po zaprojektowaniu motywu. Rok później użytkownik chce zmienić wygląd swojej witryny i odświeżyć ją. Znajduje nowy motyw, który ma wszystkie podobne funkcje. W momencie, gdy przełącza motyw, BOOM. Wszystkie poprzednie dane, które wpiszemy zniknęły. Istnieje menu o nazwie Portfolio i menu o nazwie Testimonials, ale nie ma tam żadnych danych. Użytkownik myśli „HOLY CRAP, straciłem całą treść”. Tworzy nowe pytania pomocy technicznej na forum. Wysyła e-mail do witryn takich jak WPBeginner itp. Jeśli nie otrzymają dobrej odpowiedzi, będą musieli ponownie wpisz wszystkie dane. To kiepskie doświadczenie użytkownika.
Jak więc rozwiązać ten problem?
Możliwe rozwiązanie?
Tworzymy nową standardową bazę. Justin Tadlock już jakiś czas temu rozpoczął pracę nad tym problemem, tworząc wtyczkę do portfolio bazowego. Czy będzie to idealne rozwiązanie dla wszystkich? NIE, ale będzie dla większości.
Jak Justin pyta w swoim wpisie, jakie standardowe pola powinny znaleźć się we wtyczce portfolio (odnosząc się do meta wpisów). Ten rodzaj rozmowy musi mieć miejsce wśród programistów, którzy tworzą podobną funkcjonalność w swoich motywach. Po co kopiować i wklejać to samo w kółko z jednego motywu do drugiego, skoro można to zrobić za pomocą wtyczki? Gdy stanie się to standardem, inni autorzy motywów zaczną się do niego dostosowywać.
Na przykład obserwujemy wzrost obsługi stylu Gravity Forms w ramach motywów WordPress, takich jak Genesis i inne. Dlaczego? Ponieważ rozumieją, że ich użytkownicy z niego korzystają.
Istnieje kilka solidnych motywów WordPress, które są wczytywane z funkcjonalnością, która naszym zdaniem powinna być wtyczką. Motywy Job Board, motywy do śledzenia problemów, motywy Classified Ads, motywy Real Estate itp. Wszystkie one powinny być obsługiwane przez podstawową wtyczkę. Dzieje się tak już w przypadku WooCommerce. WooThemes wydało wiele motywów, które mają wbudowaną obsługę stylizacji dla wtyczki. Inne firmy zajmujące się motywami obiecały również wydanie motywów e-handlu opartych na WooCommerce. Możesz przełączać się z jednego motywu na inny i zachować wszystkie twoje produkty bez zmian. To prawie tak, jakby zmienił się motyw, ale wszystko po prostu znalazło się na swoim miejscu. To jest doświadczenie zmiany motywu, do którego musimy dążyć.
Dlaczego nie zrobić tego samego z Portfolio, Testimonials i innymi typami treści? Czy to dlatego, że jest to zbyt proste, a e-handel jest większą bestią do pokonania? Najwyraźniej e-handel ma o wiele za dużo pól w porównaniu do innych, więc powinno być o wiele łatwiej dla tych ogólnych typów treści. To tylko kwestia podjęcia świadomego wysiłku w kierunku poprawy sytuacji.
Spójrz na wtyczkę ReciPress. Tworzy ona własny metabox z polami przepisów i dołącza go do wpisów. Możliwe jest jednak dołączenie go do własnych typów treści. Każdy, kto korzysta z tej wtyczki, może zmienić motyw bez konieczności przechodzenia przez takie kłopoty.
Byłoby miło, gdyby motywy takie jak AgentPress były zasilane przez scentralizowaną wtyczkę bazową. Byłoby wspaniale, gdyby zmiana motywów stała się łatwiejsza. Na przykład, jeśli użytkownik przełącza się z jednego motywu fotograficznego na inny, nie powinno to być chaosem. Mogą wystąpić drobne błędy, ale przynajmniej w szerszej perspektywie wszystko będzie działać.
Zawsze można podać przykłady super dostosowanych typów treści stworzonych do jednorazowego użytku przez klientów, ale jest to wyjątek, a nie reguła.
Co myślicie na ten temat? Gdzie powinien znajdować się kod własnych typów treści? W pliku functions.php czy we wtyczkach?
Yazmin
Having been on the end of losing my CPTs numerous times as I switched themes, I find it frustrating to have to set up the same functionality over and over again in functions.php.
I completely prefer the plugin route and that is the method I will be using from here on out for my business projects as well.
Joshua Jarvis
Having this exact issue with a real estate theme. The „listings” were all custom types in a theme that is now functionally obsolete. When I went to upgrade the theme I lost all the custom post content, now I have to figure out a way to transfer it all. I have options, but if it were plugin, this wouldn’t be necessary.
Editorial Staff
Extremely sorry about your inconvenience. This is why we wrote this post because we know that it really makes the end-user’s life harder.
Administrator
Hugh H. Sands
„We won’t have to worry about copying and pasting the functions from one file to another every single time.”
I can’t imagine someone writing code for a CPT in functions.php when it’s so easy to isolate it with includes
This debate goes most of the times around data vs design and I wonder, being quite new to WP, what about performance? Do plugins impose any overload?
Editorial Staff
This article should answer your question about plugins and performance:
https://www.wpbeginner.com/opinion/how-many-wordpress-plugins-should-you-install-on-your-site/
Administrator
Hugh Sands
Thanks for the link, really helpful!
Kelvin Alfonso
I’ve always included CPT’s through a separate file into the functions.php but I think I’ll be switching over to the plugins route. Thank you!
Sudhakar
I am a beginner and I have no expertise to comment one way or the other in favor or against of a plug-in or functions.php. But I am wondering if I want to go the functions.php route and do it under a child theme, what is the problem then? Why do I need to have it in a plug-in, wouldn’t my child theme save me from future theme upgrades and changes in the themes?
Editorial Staff
Your child theme would save you from future theme updates. However, it will NOT save you if you change your themes. Because you change the child theme if you change the active theme.
Administrator
Pat Ramsey
I’m a believer in the plugin route for custom post types & taxonomies. The author’s mention of a site-specific plugin is how I do it. I place any custom post types, custom taxonomies & metaboxes in this plugin, tailored for the site’s purpose. Eventually the site’s theme will change but the data lives on & is still easily accessible.
shawn
If developers continue to ignore the fact that separating „data” from for „design” is necessary to create modular apps, and it does not matter where it is the data placed, reusing that data / code will always be problem.
There seems to be a perception by some in the WP community, for one reason or the other that you can only access data in the WordPress ecosystem if it is wrapped in a plugin so we keep seeing discussions like this contributing to „The great plugin vs theme debate”.
Focus needs to placed on evolving the WordPress’ archaic plugin system, to creating libraries based on a modular design patterns that separate code / data from design. Libraries that can be used in both themes and plugins….
Debates like these are pointless in the WP post PHP4 era!!! (re-post)
Mark Simchock
Re: „As Justin asks in his post, what standard fields should be included in the portfolio plugin (referring to post meta). This type of conversation needs to happen among developers who are creating similar functionality in their themes.”
Moi? I would prefer a well documented plugin that’s engineered to be enhanced than a „closed”, one size fits all approach that difficult to work with (that code).
My point is, perhaps it’s possible to say, „I’m not trying to be all things to all people. Here’s my basic plugin. Here’s how you trick it out. It’s designed to be tricked out.” and just leave it at that. No matter what you do it’s difficult to anticipate every use case, every use need. So why bother? Why not approach it as a framework (of sorts) and let the dev in need just customize as needed?
Justin Tadlock
That’s actually the plan. I’m building an extremely small and easily-customizable base. But, I’d like to know what, if any, fields should be standard.
Kevin Maines
Typo?:
„Considering all of our teams are custom designed by our team”
Editorial Staff
Fixed it. Thanks for catching that
Administrator
Affan Ruslan
I believe it should be on plugin.
In case the user might not need the data in future, they can always convert the custom post type post to the „normal” post type. There’s plugin to do so, search in the repo and you’ll find at least one.
Christophe Debruel
I don’t really care what people say. Custom post type goes into a plugin. A theme can easily be modified to fit the custom post type in the frontend. I find it more logic to style the theme for the CTP than having different themes with the same CTP code.
Ingo
„Pods Framework” could be a good plugin solution, too. For CPT, CT and CF.
http://wordpress.org/extend/plugins/pods/
Editorial Staff
Yes, pods is awesome.
Administrator
Elliott Richmond
Plugin for me. At least for a non technical client, although the theme might not function correctly it will become apparent that there is a problem and that will prompt them to get a developer onboard.
Kailas Mahajan
Its all depend on the project…
if one handling project which needs to change theme after a certaine period of time…can use plugin..
or if project which are sticking with the one theme.. can go with function.php
Ross W
Everyone’s talking about how the data needs to be styled by the theme, and examples where that’s the case and where the data and theme can be separated.
What I don’t see is anyone talking about cases where a theme depends on having some specific data available. Lets say you have a theme that has a map of countries and some country-specific data, and that, without that map and data the theme loses some of its key functionality.
Yes, you could still do this with the data in a plugin, but is it reasonable for a theme to assume that some data exists? Is it reasonable to assume that the plugin that creates the data types is installed and enabled? (Genuine questions…discuss!)
What if my slightly non-technical client wants to create a copy of the site with their 'theme’. They enable the theme on a new Wordpress install only to find that a whole load of stuff is missing or broken? They thought that the theme contained all that they needed for their site to look right?
I can see uses for both approaches. For most of my client work I set up CPT’s, meta-boxes, and some functions to make accessing them simple, in library files and include them. This keeps all the 'stuff’ that my theme needs to work in one package, but keeps it simple to move the CPT’s to a new theme should I want to.
Of course, if a CPT looks like it could be used across multiple themes and isn’t SO specific that it only really applies to a single client’s data then you turn it into a plugin that can be deployed at will.
I don’t think there’s a simple, one-way relationship between data and themes. It’s not always the case that 'I have some data that needs styling’…sometimes 'my styling needs some data’.
Thoughts on that?
Andres Hermosilla
I definitely agree that there is a benefit to having one „complete” package. Often times there is very theme specific functionality that is better to be tied in directly (i.e. P2 from Auttomatic) vs. installed theme and theme plugin.
Konstantin Kovshenin
Plugins. Period.
Curtis McHale
Your reference to AgentPress is one of the reasons I’m 100% for CPT’s in plugins. I’ve had to deal with themes like that and it’s so hard to skin them properly unless you remove the custom function from the theme. My client and I spent 20 hours getting the code to a point we could actually work on it.
Birgit
my best and favorite, recommended solution is the highly flexible TOOLBOX: http://wordpress.org/extend/plugins/toolbox/
Editorial Staff
Neat idea. I wish I could understand what the screenshot was showing without downloading the plugin.
-Syed
Administrator
Birgit
The plugin is a „toolbox” for code snippets, that you do normally in your functions.php.
But with a theme update, custom code in the theme’s function.php might get lost.
So I use within my network installation this plugin, activated it network-wide and then the plugin comes with „modules”, that you can access for example by FTP.
You can create modules as much as you like – I have one for each of my blogs within this network. In this modules (= just .php files, let’s say just like site-specific plugins) you can add all the code, that you normally put in your theme’s function.php.
Then at the options page of the plugin you can activate in each blog, which module you would like to load and whether to load it only for frontend or only for backend or for both.
So I only need to have 1 plugin to serve all blogs with individual code snippets, that normally go to their functions.php – and can decide, where to load these modules.
uff, hope this is understandable, because my English is not the best
Perhaps this will work for you to read it: http://tinyurl.com/bf5dflt
Editorial Staff
Brigit, I did translate the WP.org page as well. I understood what the plugin was intended for. However the screenshots were in German, and google is not smart enough to translate images just yet. Same issue is with the link you posted
Sara
I always prefer plugins over functions.php for anything that would materially „break” on the front end or lose data if the theme were changed. This is for precisely the reasons you cite, and I also feel that it is NUTSO for those of us who are not really php programmers to try to troubleshoot conflicts when you have to be commenting out stuff in functions.php to isolate a problem.
matt
ok, so which cpt plugin do you recommend?
Editorial Staff
The idea is that you should register CPT’s in a site-specific plugin. There is not a specific plugin out there yet. But this is just tossing around the idea of creating a base plugin for generic post types.
Administrator
Muhammad Waqas
I’m more convinced with the use of local functions. but in this case I think plugin can be trusted more. For example if you start using wp with a specific framework. In most of cases It possible that you’ll become a slave for a long time unless until you hire a wp professional to help you escape from that framework without losing your settings and data. On the other hand plugins can work at almost at every theme.
When I started working with wp I preferred framework over plugin. The reality is that plugin developer consider newbie and less literate people when developing something. I personally believe that most part of wp users like manual code hacks than depending on plugins for core functions of sites. in long term plugins aren’t reliable. I fee so..