{"id":2624,"date":"2023-01-16T18:28:39","date_gmt":"2023-01-16T21:28:39","guid":{"rendered":"https:\/\/felipeelia.com.br\/?p=2624"},"modified":"2023-01-18T09:24:06","modified_gmt":"2023-01-18T12:24:06","slug":"deprecated-code-in-open-source-with-wordpress-functions","status":"publish","type":"post","link":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/","title":{"rendered":"Deprecated code in Open Source (with WordPress functions)"},"content":{"rendered":"\n<p>Keeping a codebase organized always requires some changes: functions, files, structures, everything someday needs a new name or place. <strong>How do we make a change without breaking anything?<\/strong><\/p>\n\n\n\n<p>Open-source codebases come with several advantages but some specific challenges. Different from a service that simply provides a more strict API, like a REST API, for example, <strong>others can call almost anything in your code<\/strong>. That said, you must be cautious even while renaming the simplest function.<\/p>\n\n\n\n<p>Although all this can sound painful, it is not. <strong>Keeping your codebase organized is worth it!<\/strong><\/p>\n\n\n\t\t\t\t<div class=\"wp-block-uagb-table-of-contents uagb-toc__align-left uagb-toc__columns-1  uagb-block-8264f735     \"\n\t\t\t\t\tdata-scroll= \"1\"\n\t\t\t\t\tdata-offset= \"30\"\n\t\t\t\t\tstyle=\"\"\n\t\t\t\t>\n\t\t\t\t<div class=\"uagb-toc__wrap\">\n\t\t\t\t\t\t<div class=\"uagb-toc__title\">\n\t\t\t\t\t\t\tTable of Contents\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<div class=\"uagb-toc__list-wrap\">\n\t\t\t\t\t\t<ol class=\"uagb-toc__list\"><li class=\"uagb-toc__list\"><a href=\"#make-the-change-in-phases\" class=\"uagb-toc-link__trigger\">Make the change in phases<\/a><ul class=\"uagb-toc__list\"><li class=\"uagb-toc__list\"><a href=\"#semantic-versioning\" class=\"uagb-toc-link__trigger\">Semantic Versioning<\/a><li class=\"uagb-toc__list\"><li class=\"uagb-toc__list\"><a href=\"#practical-example\" class=\"uagb-toc-link__trigger\">Practical Example<\/a><ul class=\"uagb-toc__list\"><li class=\"uagb-toc__list\"><a href=\"#version-250-implement-new-code-and-change-the-old-code-without-breaking-it\" class=\"uagb-toc-link__trigger\">Version 2.5.0: Implement new code and change the old code without breaking it<\/a><li class=\"uagb-toc__list\"><li class=\"uagb-toc__list\"><a href=\"#version-300-remove-the-old-code\" class=\"uagb-toc-link__trigger\">Version 3.0.0: Remove the old code<\/a><\/li><\/ul><li class=\"uagb-toc__list\"><a href=\"#move-deprecated-code-into-separate-files\" class=\"uagb-toc-link__trigger\">Move deprecated code into separate files<\/a><\/li><\/ul><\/li><li class=\"uagb-toc__list\"><a href=\"#the-more-you-communicate-the-better\" class=\"uagb-toc-link__trigger\">The more you communicate, the better<\/a><ul class=\"uagb-toc__list\"><li class=\"uagb-toc__list\"><a href=\"#changelog\" class=\"uagb-toc-link__trigger\">Changelog<\/a><li class=\"uagb-toc__list\"><li class=\"uagb-toc__list\"><a href=\"#wordpress-functions\" class=\"uagb-toc-link__trigger\">WordPress Functions<\/a><\/li><\/ul><\/li><\/ul><\/li><li class=\"uagb-toc__list\"><a href=\"#obsolete-vs-deprecated\" class=\"uagb-toc-link__trigger\">Obsolete vs. deprecated<\/a><li class=\"uagb-toc__list\"><a href=\"#conclusion\" class=\"uagb-toc-link__trigger\">Conclusion<\/a><\/ul><\/ul><\/ol>\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\n\n\n<h2 class=\"wp-block-heading\" id=\"faca-a-limpeza-em-fases\">Make the change in phases<\/h2>\n\n\n\n<p>Simply renaming the function is not a good idea: any solution depending on it will suddenly break. You need to <strong>warn that action will be needed<\/strong> and, after enough time, really implement the new solution.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote has-text-align-center is-style-plain has-medium-font-size is-layout-flow wp-block-quote-is-layout-flow\">\n<p>To define what and when needs to be changed, we can use <strong>Semantic Versioning<\/strong>.<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"versionamento-semantico\"><strong>Semantic Versioning<\/strong><\/h3>\n\n\n\n<p><strong><a href=\"https:\/\/semver.org\/\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">Semantic Versioning<\/a> gives meaning to the numbers of a software version<\/strong>, aligning expectations of what can happen in each new release.<\/p>\n\n\n\n<p>The following table summarizes what would be the <strong>major, minor, and patch<\/strong> version number of a software in its 2.4.3 release, in addition to what we could expect from the upcoming 2.4.4, 2.5.0, or 3.0.0 releases.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table class=\"has-fixed-layout\"><tbody><tr><td class=\"has-text-align-center\" data-align=\"center\"><strong>Major <\/strong>(<strong>2.<\/strong>4.3)<\/td><td class=\"has-text-align-center\" data-align=\"center\"><strong>Minor<\/strong> (2.<strong>4.<\/strong>3)<\/td><td class=\"has-text-align-center\" data-align=\"center\"><strong>Patch <\/strong>(2.4.<strong>3<\/strong>)<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Changes that <strong>do break<\/strong> backward compatibility<\/td><td class=\"has-text-align-center\" data-align=\"center\">New features that <strong>do not break <\/strong>backward compatibility<\/td><td class=\"has-text-align-center\" data-align=\"center\">Bug fixes only<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Updating to <strong>version 3.0.0<\/strong> requires attention, as the current solution can break<\/td><td class=\"has-text-align-center\" data-align=\"center\">Updating to <strong>version 2.5.0<\/strong> means that everything continues to work but with some new functionality<\/td><td class=\"has-text-align-center\" data-align=\"center\">Updating to <strong>version 2.4.4<\/strong> means some bugs were fixed<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"exemplo-pratico\">Practical Example<\/h3>\n\n\n\n<p>Keeping both the function rename example and our 2.4.3 version in mind, let&#8217;s see how we could plan that out. Let&#8217;s split the process into some steps and define their release versions.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"versao-2-5-0-implementar-o-codigo-novo-e-alterar-o-codigo-velho-sem-quebrar\">Version 2.5.0: Implement new code and change the old code without breaking it<\/h4>\n\n\n\n<ol>\n<li><strong>Implement the new code.<\/strong> It doesn&#8217;t matter if it is a renamed function or a brand-new method, the new code needs to be there so people can do the switch;<\/li>\n\n\n\n<li><strong>Change the old code.<\/strong> In case it is just a simple switch, the old code needs to become a wrapper of the new function with a warning about the (now) wrong usage;<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code php\"><code>\nfunction new_name( $parameter ) {\n\t\/\/ Do something\n}\n\nfunction old_name( $parameter ) {\n\t_deprecated_function( __FUNCTION__, '2.5.0', 'new_name' );\n\tnew_name( $parameter );\n}<\/code><\/pre>\n\n\n\n<p>Note that calling <code>old_name()<\/code> still works but a warning was added there saying that starting from version 2.5.0 <code>new_name()<\/code> is the function that should be called.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"versao-3-0-0-remover-o-codigo-velho\">Version 3.0.0: Remove the old code<\/h4>\n\n\n\n<p><strong>After warning for long enough, you can remove the old code.<\/strong> Attention: this removal is expected to happen in a <em>major<\/em> version.<\/p>\n\n\n\n<p>You do not need to remove the code in the immediate following version, though. Depending on your user base and your release calendar you can wait for any major version, like 4.0.0 or 5.0.0, for example.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>A project that just releases a major version per year can have a slightly different approach from a project that releases a major version per month.<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"arquivos-com-codigos-obsoletos\">Move deprecated code into separate files<\/h3>\n\n\n\n<p>One of the intentions behind these changes is to keep your codebase clean and organized. With that in mind, keeping these functions in your main files can make you uncomfortable as things can actually look messier than before.<\/p>\n\n\n\n<p>Some development teams <strong>move these pieces of code to specific files<\/strong>, named <code>deprecated.php<\/code>, for example. In addition to a readability increase, this also helps when you need to identify which code can be removed while launching 3.0.0.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"quanto-mais-comunicacao-melhor\">The more you communicate, the better<\/h2>\n\n\n\n<p>In the example above we called the <code>_deprecated_function()<\/code> WordPress function but that will only have an effect if the <code>WP_DEBUG<\/code> constant is set to true.<\/p>\n\n\n\n<p>Unfortunately, quite often these warnings are useless: in many cases, people are not paying any attention to logs. <strong>You also need to warn your users in an accessible and human-readable way.<\/strong><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>Inform your users about important changes in all ways possible: logs warnings, items in your changelog, blog posts, and even social media if needed.<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"changelog-ou-registro-de-alteracoes\">Changelog<\/h3>\n\n\n\n<p>The best place to communicate changes in your software is in its <em>changelog<\/em>. In WordPress, this type of log is kept in a specific section of the <em>readme.txt<\/em> file and is displayed on both the plugin page and in a modal inside the Dashboard.<\/p>\n\n\n\n<p>Using Akismet as an example, this is the link to see the next version&#8217;s details.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2023\/01\/image.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2023\/01\/image.png\" alt=\"\" class=\"wp-image-2593\" width=\"677\" height=\"150\" srcset=\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image.png 903w, https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image-300x66.png 300w, https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image-768x170.png 768w\" sizes=\"(max-width: 677px) 100vw, 677px\" \/><\/a><figcaption class=\"wp-element-caption\">Plugins list in WordPress&#8217;s Dashboard. The yellow notice is delayed when there is a new version of the plugin.<\/figcaption><\/figure>\n\n\n\n<p>Clicking on the link will open a modal with the <em>changelog<\/em>:<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2023\/01\/image-1.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2023\/01\/image-1.png\" alt=\"\" class=\"wp-image-2594\" width=\"492\" height=\"420\" srcset=\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image-1.png 984w, https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image-1-300x256.png 300w, https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image-1-768x656.png 768w\" sizes=\"(max-width: 492px) 100vw, 492px\" \/><\/a><figcaption class=\"wp-element-caption\">Modal with the plugin&#8217;s changelog. Versions are usually ordered from the newest to the oldest.<\/figcaption><\/figure>\n\n\n\n<p>WordPress gets that information from the <code>== Changelog ==<\/code> section of the readme.txt plugin&#8217;s file, hosted in WP.org official repository:<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><a href=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2023\/01\/image-2.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2023\/01\/image-2.png\" alt=\"\" class=\"wp-image-2595\" width=\"617\" height=\"184\" srcset=\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image-2.png 822w, https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image-2-300x89.png 300w, https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/image-2-768x229.png 768w\" sizes=\"(max-width: 617px) 100vw, 617px\" \/><\/a><figcaption class=\"wp-element-caption\"><a href=\"https:\/\/plugins.trac.wordpress.org\/browser\/akismet\/tags\/5.0.2\/readme.txt\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">Akismet&#8217;s readme.txt file<\/a><\/figcaption><\/figure>\n\n\n\n<p>Usually, changelogs are divided into sections, separating what was added, changed, fixed, removed, and deprecated. An example of this division can be seen in both <a href=\"https:\/\/github.com\/10up\/ElasticPress\/releases\/tag\/4.4.1\" target=\"_blank\" rel=\"noreferrer noopener\">ElasticPress&#8217;s release notes<\/a> and its changelog.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"funcoes-do-wordpress\">WordPress Functions<\/h3>\n\n\n\n<p>WordPress has some functions that help to inform the usage of deprecated code. Here is the list:<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<pre class=\"wp-block-code\"><code>_deprecated_function( $function, $version, $replacement = '' )<\/code><\/pre>\n\n\n\n<p>This function is in the example we used before. <strong>A simple way to mark a function as deprecated.<\/strong><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<pre class=\"wp-block-code\"><code>apply_filters_deprecated( $hook_name, $args, $version, $replacement = '', $message = '' )<\/code><\/pre>\n\n\n\n<p>This and the next are wrappers for <code>_deprecated_hook()<\/code>, which is not part of this list, as it should not be called directly. As the name says, this function <strong>applies a filter<\/strong> but also informs it is deprecated and, if available, provides its proper replacement.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<pre class=\"wp-block-code\"><code>do_action_deprecated( $hook_name, $args, $version, $replacement = '', $message = '' )<\/code><\/pre>\n\n\n\n<p>Similar to the last one but <strong>applied to an action<\/strong>.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<pre class=\"wp-block-code\"><code>_doing_it_wrong( $function, $message, $version )<\/code><\/pre>\n\n\n\n<p>Although not necessarily related to deprecated code, I&#8217;m adding <code>_doing_it_wrong()<\/code> to the list as it can be super <strong>useful when the change requires more attention than a simple name change<\/strong>.  <\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<pre class=\"wp-block-code\"><code>_deprecated_argument( $function, $version, $message = '' )<\/code><\/pre>\n\n\n\n<p>As the name implies, this is for a <strong>change in an argument<\/strong>.<\/p>\n\n\n\n<p>Although always related to an argument, there are a couple of different scenarios where this function can be used:<\/p>\n\n\n\n<ul>\n<li>A change in the expected value of an argument like <code>'blacklist_keys'<\/code> that is now <code>'disallowed_keys'<\/code>;<\/li>\n\n\n\n<li>An argument that does not exist anymore;<\/li>\n\n\n\n<li>An index of an array argument. Let&#8217;s say before <code>$args['cat']<\/code> was expected but now it is <code>$args['taxonomy']<\/code>.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<pre class=\"wp-block-code\"><code>_deprecated_file( $file, $version, $replacement = '', $message = '' )<\/code><\/pre>\n\n\n\n<p><strong>Marks an entire file as deprecated.<\/strong> Usage examples are renamed files or files that are not needed anymore. The <code>wp-includes\/class-json.php<\/code> file calls that function, as since WP 5.3.0 the native PHP extension is required.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<pre class=\"wp-block-code\"><code>_deprecated_constructor( $class, $version, $parent_class = '' )<\/code><\/pre>\n\n\n\n<p>This is <strong>related to object constructors<\/strong>. Years ago, constructors methods in PHP had their class name but since PHP 5.4 the recommended way is using the magic <code>__construct()<\/code> method. Class name constructors are deprecated since PHP 7.0 and should not be used anymore.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"sobre-os-termos-em-portugues\">Obsolete vs. deprecated<\/h2>\n\n\n\n<p>Each language has its own specificity. For Brazilian Portuguese, for example, we don&#8217;t have a specific word for &#8220;deprecated&#8221;. People quite often wrongly translate that as &#8220;depreciated.&#8221; So, we use obsolete and deprecated interchangeably.<\/p>\n\n\n\n<p>In English, those two words refer to different states of the code: deprecated code is still functional and present, obsolete code usually doesn&#8217;t work anymore, and\/or was removed from the codebase.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"conclusao\">Conclusion<\/h2>\n\n\n\n<p>Keeping your codebase clean and organized is essential. To make the needed changes and keep retro compatibility you need to plan the <strong>changes in phases<\/strong>.<\/p>\n\n\n\n<p><strong>Semantic Versioning<\/strong> can help you to plan which changes are shipped in which versions, so your users are not caught off guard.<\/p>\n\n\n\n<p>Communicating changes through your <strong><em>changelogs<\/em> <\/strong>also brings more visibility to actions your users will need to take. Specific sections listing those changes help even more.<\/p>\n\n\n\n<p>We also saw some <strong>WordPress functions<\/strong> that can help to inform changes in several different scenarios.<\/p>\n\n\n\n<p>Lastly, we saw how these terms can vary in different languages and the <strong>difference between deprecated and obsolete<\/strong>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Improving your code requires changes: functions, files, structures, everything someday needs a new name or place. How do we make a change without breaking anything?<\/p>\n","protected":false},"author":1,"featured_media":2626,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","footnotes":""},"categories":[197,145,91],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v21.9.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Deprecated code in Open Source (with WordPress functions) | Felipe Elia<\/title>\n<meta name=\"description\" content=\"Improving your code requires changes: functions, files, structures, everything someday needs a new name or place. How do we make a change without breaking anything?\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/\" \/>\n<meta property=\"og:locale\" content=\"pt_BR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Deprecated code in Open Source (with WordPress functions) | Felipe Elia\" \/>\n<meta property=\"og:description\" content=\"Improving your code requires changes: functions, files, structures, everything someday needs a new name or place. How do we make a change without breaking anything?\" \/>\n<meta property=\"og:url\" content=\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/\" \/>\n<meta property=\"og:site_name\" content=\"Felipe Elia\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/felipe.elia\" \/>\n<meta property=\"article:author\" content=\"https:\/\/www.facebook.com\/felipe.elia\" \/>\n<meta property=\"article:published_time\" content=\"2023-01-16T21:28:39+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2023-01-18T12:24:06+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1920\" \/>\n\t<meta property=\"og:image:height\" content=\"1080\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Felipe Elia\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@https:\/\/twitter.com\/felipe_elia\" \/>\n<meta name=\"twitter:site\" content=\"@felipe_elia\" \/>\n<meta name=\"twitter:label1\" content=\"Escrito por\" \/>\n\t<meta name=\"twitter:data1\" content=\"Felipe Elia\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. tempo de leitura\" \/>\n\t<meta name=\"twitter:data2\" content=\"8 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/\"},\"author\":{\"name\":\"Felipe Elia\",\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"headline\":\"Deprecated code in Open Source (with WordPress functions)\",\"datePublished\":\"2023-01-16T21:28:39+00:00\",\"dateModified\":\"2023-01-18T12:24:06+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/\"},\"wordCount\":1234,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"articleSection\":[\"Open Source\",\"Programming\",\"WordPress\"],\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/\",\"url\":\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/\",\"name\":\"Deprecated code in Open Source (with WordPress functions) | Felipe Elia\",\"isPartOf\":{\"@id\":\"https:\/\/felipeelia.com.br\/#website\"},\"datePublished\":\"2023-01-16T21:28:39+00:00\",\"dateModified\":\"2023-01-18T12:24:06+00:00\",\"description\":\"Improving your code requires changes: functions, files, structures, everything someday needs a new name or place. How do we make a change without breaking anything?\",\"breadcrumb\":{\"@id\":\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/#breadcrumb\"},\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/felipeelia.dev\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Deprecated code in Open Source (with WordPress functions)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/felipeelia.com.br\/#website\",\"url\":\"https:\/\/felipeelia.com.br\/\",\"name\":\"Felipe Elia\",\"description\":\"Programa\u00e7\u00e3o com WordPress de um jeito f\u00e1cil, do b\u00e1sico ao avan\u00e7ado\",\"publisher\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/felipeelia.com.br\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"pt-BR\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\",\"name\":\"Felipe Elia\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg\",\"contentUrl\":\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg\",\"width\":400,\"height\":400,\"caption\":\"Felipe Elia\"},\"logo\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/\"},\"description\":\"Associate Director of Platform Engineering na 10up, WordPress Core Contributor, Global Polyglots Mentor na comunidade internacional do WordPress e Locale Manager na comunidade WordPress Brasil.\",\"sameAs\":[\"https:\/\/www.facebook.com\/felipe.elia\",\"https:\/\/www.instagram.com\/felipe.elia\/\",\"https:\/\/www.linkedin.com\/in\/felipeelia\/\",\"https:\/\/twitter.com\/https:\/\/twitter.com\/felipe_elia\",\"https:\/\/www.youtube.com\/channel\/UCD_26rOE3ClALcZreTkyIoQ\"],\"url\":\"https:\/\/felipeelia.com.br\/author\/admin\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Deprecated code in Open Source (with WordPress functions) | Felipe Elia","description":"Improving your code requires changes: functions, files, structures, everything someday needs a new name or place. How do we make a change without breaking anything?","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/","og_locale":"pt_BR","og_type":"article","og_title":"Deprecated code in Open Source (with WordPress functions) | Felipe Elia","og_description":"Improving your code requires changes: functions, files, structures, everything someday needs a new name or place. How do we make a change without breaking anything?","og_url":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/","og_site_name":"Felipe Elia","article_publisher":"https:\/\/www.facebook.com\/felipe.elia","article_author":"https:\/\/www.facebook.com\/felipe.elia","article_published_time":"2023-01-16T21:28:39+00:00","article_modified_time":"2023-01-18T12:24:06+00:00","og_image":[{"width":1920,"height":1080,"url":"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions.jpg","type":"image\/jpeg"}],"author":"Felipe Elia","twitter_card":"summary_large_image","twitter_creator":"@https:\/\/twitter.com\/felipe_elia","twitter_site":"@felipe_elia","twitter_misc":{"Escrito por":"Felipe Elia","Est. tempo de leitura":"8 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/#article","isPartOf":{"@id":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/"},"author":{"name":"Felipe Elia","@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"headline":"Deprecated code in Open Source (with WordPress functions)","datePublished":"2023-01-16T21:28:39+00:00","dateModified":"2023-01-18T12:24:06+00:00","mainEntityOfPage":{"@id":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/"},"wordCount":1234,"commentCount":0,"publisher":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"articleSection":["Open Source","Programming","WordPress"],"inLanguage":"pt-BR","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/","url":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/","name":"Deprecated code in Open Source (with WordPress functions) | Felipe Elia","isPartOf":{"@id":"https:\/\/felipeelia.com.br\/#website"},"datePublished":"2023-01-16T21:28:39+00:00","dateModified":"2023-01-18T12:24:06+00:00","description":"Improving your code requires changes: functions, files, structures, everything someday needs a new name or place. How do we make a change without breaking anything?","breadcrumb":{"@id":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/#breadcrumb"},"inLanguage":"pt-BR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/felipeelia.dev\/deprecated-code-in-open-source-with-wordpress-functions\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/felipeelia.dev\/"},{"@type":"ListItem","position":2,"name":"Deprecated code in Open Source (with WordPress functions)"}]},{"@type":"WebSite","@id":"https:\/\/felipeelia.com.br\/#website","url":"https:\/\/felipeelia.com.br\/","name":"Felipe Elia","description":"Programa\u00e7\u00e3o com WordPress de um jeito f\u00e1cil, do b\u00e1sico ao avan\u00e7ado","publisher":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/felipeelia.com.br\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"pt-BR"},{"@type":["Person","Organization"],"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292","name":"Felipe Elia","image":{"@type":"ImageObject","inLanguage":"pt-BR","@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/","url":"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg","contentUrl":"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg","width":400,"height":400,"caption":"Felipe Elia"},"logo":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/"},"description":"Associate Director of Platform Engineering na 10up, WordPress Core Contributor, Global Polyglots Mentor na comunidade internacional do WordPress e Locale Manager na comunidade WordPress Brasil.","sameAs":["https:\/\/www.facebook.com\/felipe.elia","https:\/\/www.instagram.com\/felipe.elia\/","https:\/\/www.linkedin.com\/in\/felipeelia\/","https:\/\/twitter.com\/https:\/\/twitter.com\/felipe_elia","https:\/\/www.youtube.com\/channel\/UCD_26rOE3ClALcZreTkyIoQ"],"url":"https:\/\/felipeelia.com.br\/author\/admin\/"}]}},"uagb_featured_image_src":{"full":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions.jpg",1920,1080,false],"thumbnail":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-150x150.jpg",150,150,true],"medium":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-300x169.jpg",300,169,true],"medium_large":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-768x432.jpg",768,432,true],"large":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-1024x576.jpg",1024,576,true],"1536x1536":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-1536x864.jpg",1536,864,true],"2048x2048":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions.jpg",1920,1080,false],"ocean-thumb-m":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-600x600.jpg",600,600,true],"ocean-thumb-ml":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-800x450.jpg",800,450,true],"ocean-thumb-l":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-1200x700.jpg",1200,700,true],"yarpp-thumbnail":["https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/01\/deprecated-code-in-open-source-with-wordpress-functions-120x120.jpg",120,120,true]},"uagb_author_info":{"display_name":"Felipe Elia","author_link":"https:\/\/felipeelia.com.br\/author\/admin\/"},"uagb_comment_info":0,"uagb_excerpt":"Improving your code requires changes: functions, files, structures, everything someday needs a new name or place. How do we make a change without breaking anything?","_links":{"self":[{"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/posts\/2624"}],"collection":[{"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/comments?post=2624"}],"version-history":[{"count":0,"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/posts\/2624\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/media\/2626"}],"wp:attachment":[{"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/media?parent=2624"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/categories?post=2624"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/felipeelia.dev\/wp-json\/wp\/v2\/tags?post=2624"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}