{"id":9189,"date":"2022-04-11T13:32:00","date_gmt":"2022-04-11T11:32:00","guid":{"rendered":"https:\/\/zeni.cz\/?p=9189"},"modified":"2024-07-10T10:55:29","modified_gmt":"2024-07-10T08:55:29","slug":"improve-wordpress-theme-and-plugin-development-using-design-patterns","status":"publish","type":"post","link":"https:\/\/zeni.cz\/en\/blog-o-wordpress-woocommerce\/wordpress-development\/improve-wordpress-theme-and-plugin-development-using-design-patterns\/","title":{"rendered":"Improve WordPress Theme and Plugin Development Using Design Patterns"},"content":{"rendered":"
\n\n

Do you want to create cleaner, more maintainable code, that is lot easier to change and build on in the WordPress environment? Giving some attention to concept of design patterns could make a massive difference here. If usage of design patterns is executed correctly during the development it can save you some time too.<\/strong><\/strong><\/p>\n\n<\/div>\n\n

\n\n

What Are Design Patterns? <\/h2>\n\n\n\n

Design patterns help us to build<\/strong> our software<\/strong> (obviously including WordPress plugins and themes) on the knowledge of others<\/strong> before us. We don’t have to reinvent the wheel for solving some common problems that happened to many developers before us and we can focus on the specifics of our problem domain and customer requirements. <\/p>\n\n\n\n

Design pattern<\/strong> is repeatable solution to commonly reoccurring problem<\/strong> in the software design. It cannot be used directly, but it provides us with template for solving the problem<\/strong> that can be reused in many similar situations.<\/p>\n\n\n\n

Studying<\/strong> design patterns and applying<\/strong> them when creating new code can drastically improve<\/strong> the structure<\/strong> and overall functionality<\/strong> and scalability<\/strong>. <\/p>\n\n\n\n

After studying<\/strong> them you can also try to refactor<\/strong> your older code<\/strong> using design patterns<\/strong> and you will see how much more managable code<\/strong> could be.<\/p>\n\n<\/div>\n\n

\n\n

Demystifying the Design Patterns Using Hooks <\/h2>\n\n\n\n

Let’s start with something most of the WordPress developers are already familiar with and these are hooks<\/a>, more specifically the actions<\/a> and filters<\/a> that are used in the WordPress a lot.\u00a0<\/p>\n\n\n\n

This is specific implementation of something called publisher-subscriber(pub-sub) pattern<\/strong>. In this pattern we define publishers, subscribers and a message broker:<\/p>\n\n\n\n

The publisher<\/strong> publishes a specific event, in our case by executing do_action<\/a><\/strong> or apply_filters<\/strong><\/a>.<\/strong><\/p>\n\n\n\n

Subscribers <\/strong>can subscibe to specific events by calling add_action<\/strong><\/a> or add_filter<\/strong><\/a> and execute an action when the event they are subscribed occurs.<\/p>\n\n\n\n

Message broker<\/strong>, in our case WordPress core <\/strong>make sure that all of the subscribers <\/strong> are notified about the publishers events they are subscribed to.<\/p>\n\n<\/div>\n\n

\n\n

Benefits of Publisher-Subscriber (pub-sub) Pattern<\/strong><\/strong><\/h3>\n\n\n\n

This gives us a lot of benefits<\/strong>. Publisher does not need to know anything about its subscriber and also subscribers does not need to know anything about publisher, as long as they can react to occurring event. Even if we deactivate the plugin<\/strong> that creates events or consumes the events, this will cause no errors<\/strong>. <\/p>\n\n\n\n

I think that it is very useful <\/strong>not just consume hooks from WordPress core or plugins but also create hooks<\/strong> in our code and build<\/strong> our code around<\/strong> them. You are not just going to make other developers life easier if they decide to build on<\/strong> your plugin or theme<\/strong> functionality but trust me your life will also be much easier when implementing new functionality to your plugin or theme.<\/p>\n\n\n\n

There are many other smart design patterns<\/strong> that can be used in WordPress<\/strong>. They mostly require a bit more work<\/strong> to be applied then the hooks, but they can make a huge difference in design of your plugin or theme. Great example of the design pattern that can be used in the context of WordPress is singleton pattern<\/strong>.<\/p>\n\n<\/div>\n\n

\n\n

Singleton Pattern<\/h2>\n\n\n\n

This pattern requires knowledge of object-oriented programing<\/strong>. If you are not familiar with that, please study that first, and then you could come back.<\/p>\n\n\n\n

Singleton pattern<\/strong> restricts initiation of certain class, so only one instance of the class can be created. This can be achieved by creating the private constructor, static property to store the instance and static function getInstance()<\/code>.<\/em>This functions responsibility is to instantiate the object if it is not already instantiated and stored in the variable $instance<\/code>. <\/em>You can see the example<\/strong> down bellow<\/p>\n\n\n\n

class SingletonClass\n{\n    private static $instance<\/strong> = null<\/em>;\n\n    private function __construct<\/strong>() {}\n\n    public static function getInstance<\/strong>()\n    {\n        if (null<\/em> === self::$instance<\/strong>) {\n            self::$instance<\/strong> = new<\/em> self();\n        }\n        return self::$instance<\/strong>;\n    }\n}<\/code><\/pre>\n\n\n\n
Every time some code tries to create new instance of this class, error is triggered, because the constructor is private (this better be documented to avoid confusion), so the only way to get the instance is trough our getInstance()<\/code> function. <\/em><\/p>\n\n\n\n
Example usage<\/strong> for this would be to create a base class<\/strong> that responsibility is to instantiate all of our plugin functionality. We can bound for example configuration data<\/strong> to this instance, so this is accessible from anywhere in the plugin and it does not need to be fetched from database or config file<\/strong> multiple times, only on the single instantiation of this class.<\/p>\n\n<\/div>\n\n
\n\n
Don’t Overuse Singleton Pattern<\/strong><\/strong><\/h3>\n\n\n\n
I think this pattern is a good example partially because it can be very tempting<\/strong> to overuse<\/strong> it, as it is easy to see the benefits<\/strong> of using it in many situations<\/strong>. I am not saying it should not be used but you have to consider drawbacks<\/strong> of the pattern too before using it.\u00a0<\/p>\n\n\n\n
Main drawback<\/strong> of this pattern, in my opinion, is that every time we use this pattern we bound <\/strong>our functionality<\/strong> to direct knowledge about the singleton class. This is creating coupling of code and could cause that if we decide to change something in the singleton, we have to make many changes<\/strong> trough the project. <\/p>\n\n\n\n
So always think<\/strong> with caution before using<\/strong> this pattern or any other pattern, but if you are going to do a good job, this is going to be very rewarding to you<\/strong>.<\/p>\n\n<\/div>\n\n
\n\n
More Patterns <\/h2>\n\n\n\n
We have described two design patterns<\/strong> in this article. These patterns can be used in many situations<\/strong> during the WordPress development<\/strong> and could improve<\/strong> your code <\/strong>and thinking. <\/p>\n\n\n\n
But this is just a very small showcase<\/strong> of what could be done thanks to the concept of design patterns. There is a lot more<\/strong> design patterns out there that could be applied during the development. Studying<\/strong> them and applying<\/strong> them could make a huge difference during the development and could have very positive impact<\/strong> on what you are developing. <\/p>\n\n\n\n
I encourage you to give this a try either using well-known and high-quality literature such as Design Patterns: Elements of Reusable Object-Oriented Software<\/a>or Head First Design Patterns<\/a> or on the websites such as refactoring.guru<\/a>, where a lot of patterns<\/strong> are well described<\/strong> including examples<\/strong> in PHP<\/strong>.<\/p>\n\n<\/div>","protected":false},"excerpt":{"rendered":"
Do you want to create cleaner, more maintainable code, that is lot easier to change and build on in the WordPress environment? Giving some attention to concept of design patterns could make a massive difference here. If usage of design patterns is executed correctly during the development it can save you some time too.<\/p>\n","protected":false},"author":29,"featured_media":7250,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"advgb_blocks_editor_width":"","advgb_blocks_columns_visual_guide":"","footnotes":""},"categories":[312],"tags":[],"class_list":["post-9189","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-wordpress-development","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-33"],"author_meta":{"display_name":"rjurinek","author_link":"https:\/\/zeni.cz\/en\/blog-o-wordpress-woocommerce\/author\/rjurinek\/"},"featured_img":"https:\/\/zeni.cz\/app\/uploads\/2022\/04\/Zlepsite-vyvoj-WordPress-tem-a-pluginov-za-pouzitia-navrhovych-vzorov-300x200.jpeg","coauthors":[],"tax_additional":{"categories":{"linked":["WordPress Development<\/a>"],"unlinked":["WordPress Development<\/span>"]}},"comment_count":"0","relative_dates":{"created":"Posted 4 years ago","modified":"Updated 2 years ago"},"absolute_dates":{"created":"Posted on 11.4.2022","modified":"Updated on 10.7.2024"},"absolute_dates_time":{"created":"Posted on 11.4.2022 13:32","modified":"Updated on 10.7.2024 10:55"},"featured_img_caption":"Zlep\u0161ite v\u00fdvoj WordPress t\u00e9m a pluginov za pou\u017eitia n\u00e1vrhov\u00fdch vzorov","series_order":"","_links":{"self":[{"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/posts\/9189","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/comments?post=9189"}],"version-history":[{"count":6,"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/posts\/9189\/revisions"}],"predecessor-version":[{"id":12408,"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/posts\/9189\/revisions\/12408"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/media\/7250"}],"wp:attachment":[{"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/media?parent=9189"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/categories?post=9189"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/zeni.cz\/en\/wp-json\/wp\/v2\/tags?post=9189"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}