Comme beaucoup d’entre vous le savent, la semaine dernière, Syed Balkhi a participé au WordCamp Raleigh 2012. Au cours de l’évènement, l’un de ses tweets a suscité tout un débat. Dans cet article, notre fondateur Syed Balkhi débattra de la question de savoir si les types de publication personnalisés de WordPress appartiennent au fichier functions.php ou aux extensions. Voici le tweet qui a lancé le débat :
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
Après le tweet, de nombreuses personnes réputées de la communauté WordPress ont réagi. Vous pouvez consulter cette page. Curtis McHale est allé plus loin et a développé le sujet dans sa nouvelle publication de blog.
La conversation sur Twitter a soulevé d’excellents points.
Résumé des arguments
Argument des extensions : Les utilisateurs/utilisatrices disposeront toujours des données, même s’ils modifient le thème. Elles ne seront peut-être pas aussi belles, mais elles resteront là.
Argument de Functions.php : Des données sans design ne seraient pas pertinentes. Les utilisateurs/utilisatrices seraient encore plus désorientés.
Quel est le camp avec lequel vous êtes le plus d’accord ? Il est clair que les deux camps ont leurs problèmes, mais lequel est le moindre des deux maux ?
Voici pourquoi nous pensons que les types de publication personnalisés devraient TOUJOURS être placés dans une extension spécifique au site ou dans une extension distincte.
En direct des données
Les types de publication personnalisés sont des données. Dans la plupart des cas, vos données survivront au design actuel. Ayant modifié nos thèmes à plusieurs reprises, nous comprenons parfaitement cette affirmation. Les articles, les pages, les liens, les pièces jointes et les révisions sont tous des types de publication intégrés à WordPress. En plus de cela, nous avons des types de publication comme Books, Testimonials, Deals, etc. Pouvez-vous imaginer que si nous modifions un thème, tous ces types d’articles disparaissent ? Confirmez-vous que nous ne voudrions pas que cela se produise.
Ayant des développeurs/développeuses dans notre équipe, cela ne devrait pas avoir beaucoup d’importance. Etant donné que tous nos thèmes sont personnalisés par notre équipe, quelle différence cela fait-il ? Le secret tient en deux mots : temps et centralisation. Tant que nous disposons de toutes les données nécessaires, tout ce que nous aurions à faire à l’avenir serait de modifier le style. Nous n’aurons pas à nous soucier de copier et coller les fonctions d’un fichier à l’autre à chaque fois. Et si vous voulez reproduire la fonctionnalité ? Il suffit de prendre l’extension et de l’Avancer dans votre nouveau site. Modifiez le style, et le tour est joué.
Règles et normes
Lorsque vous utilisez le mot TOUJOURS comme nous l’avons fait dans notre tweet, il peut signifier à la fois règle et norme. Les règles et les normes sont toutes deux conçues pour la majorité. Il y aura toujours des cas particuliers où les règles seront contournées et les normes enfreintes, mais cela ne signifie pas qu’il faille se débarrasser complètement des normes.
Il existe des tonnes de types de publications génériques qui nécessitent pour la plupart le même ensemble de champs Meta obligatoires. Voici quelques exemples qui me viennent à l’esprit : Citations, Livres, Recettes, Témoignages, Portfolio, etc.
Compte tenu du grand nombre de thèmes de photographie et de portfolio disponibles sur le marché gratuit et commercial, il est presque insensé de faire en sorte que l’utilisateur saisisse à nouveau toutes les informations de son type de publication personnalisé à chaque fois qu’il modifie son thème. Examinons un exemple de scénario :
Photographe – L’utilisateur configure un site WordPress doté d’une fonctionnalité de blog (CPT « post » par défaut). Il souhaite ajouter un portfolio de ses travaux (Prérequis : CPT « Portfolio »). Il souhaite afficher les témoignages de ses clients (nécessite un CPT « Testimonial »). Toutes ces informations vont certainement En direct au-delà de la conception d’un thème. Un an ultérieurement, l’utilisateur/utilisatrice souhaite modifier l’aspect de son site et l’actualiser. Il trouve un nouveau thème qui a toutes les mêmes fonctions. Dès qu’il change de thème, BOOM. Toutes les données qu’il avait saisies/saisie ont disparu. Il y a un menu appelé Portfolio et un menu appelé Témoignages, mais aucune des données n’y figure. Les utilisateurs/utilisatrices se disent « Mince, j’ai perdu tout mon contenu ». Crée une nouvelle question de support dans le forum. Il envoie des e-mails à des sites comme WPBeginner, etc. S’il ne reçoit aucune bonne responsive, il devra saisir à nouveau toutes les données. Il s’agit d’une mauvaise expérience pour les utilisateurs/utilisatrices.
Comment résoudre ce problème ?
Solution possible ?
Nous créons une nouvelle base standard. Justin Tadlock a déjà commencé à travailler sur cette question il y a un certain temps en créant une extension de base pour les portfolios. Est-ce que ce sera la solution parfaite pour tout le monde ? Aucun, mais ce sera le cas pour la majorité.
Comme Justin le demande dans sa publication, quels sont les champs standards qui devraient être inclus dans l’extension portfolio (en référence aux méta des posts). Ce type de conversation doit avoir lieu entre les développeurs/développeuses qui créent des fonctionnalités similaires dans leurs thèmes. Pourquoi copier et coller la même chose encore et encore d’un thème à l’autre quand cela peut être fait via une extension ? Une fois que cela deviendra un standard, d’autres auteurs/autrices de thèmes commenceront à s’y adapter.
Par exemple, nous voyons une augmentation du support de style pour Gravity Forms dans les frameworks de thèmes WordPress comme Genesis et d’autres. Pourquoi ? Parce qu’ils comprennent que leurs utilisateurs/utilisatrices l’utilisent.
Il y a quelques thèmes WordPress robustes qui sont chargés de fonctionnalités qui, selon nous, devraient être des extensions. Les thèmes d’offres d’emploi, de suivi des problèmes, de publicités classées, d’immobilier, etc. Ils devraient tous être alimentés par une extension de base. C’est déjà le cas avec WooCommerce. WooThemes a sorti de nombreux thèmes qui ont un support de style intégré pour l’extension. D’autres entreprises de thèmes ont promis de sortir des thèmes e-commerce basés sur WooCommerce également. Vous pouvez passer d’un thème à l’autre et conserver tous vos produits tels quels. C’est presque comme si le thème avait été modifié, mais que tout était rentré dans l’ordre. C’est l’expérience de modification de thème que nous devons viser.
Pourquoi ne pas faire la même chose avec Portfolio, Testimonials, et d’autres types de publications personnalisées génériques ? Est-ce parce que c’est trop simple vs. l’e-commerce est une bête plus grande à conquérir ? Clairement, l’e-commerce a beaucoup trop de champs par rapport aux autres, donc cela devrait être beaucoup plus facile pour ces types de publications génériques. Il s’agit simplement de faire un effort conscient pour améliorer les choses.
Jetez un coup d’œil à l’extension ReciPress. Il crée une boîte méta personnalisée avec des champs de recettes et la joint aux publications. Outil de personnalisation, il est cependant possible de la joindre à des types de publication personnalisés. Toute personne utilisant cette extension peut modifier ses thèmes sans avoir à passer par ce genre de tracas.
Il serait agréable de voir des thèmes comme AgentPress être alimentés par une extension de base centralisée. Il serait formidable de voir la transition de modification des thèmes devenir plus facile. Par exemple, si un compte passe d’un thème de photographie à un autre, cela ne devrait pas être le chaos. Des erreurs mineures peuvent se produire, mais au moins dans l’ensemble, les choses fonctionneront.
Vous pouvez toujours donner des exemples de types de publication super personnalisés créés pour l’usage unique d’un client/cliente, mais c’est l’exception et non la règle.
Que pensez-vous de ce Sujet ? Où doit se trouver le code des types de publications personnalisés ? Dans le fichier functions.PHP ou dans les extensions ?
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.
Administrateur
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/
Administrateur
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.
Administrateur
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
Administrateur
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.
Administrateur
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
Administrateur
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.
Administrateur
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..