W ko\u0144cu jeste\u015bmy w ostatnim po\u015bcie z serii o refaktoryzacji WordPress Widget Boilerplate. Pod koniec tego posta b\u0119dziemy mie\u0107 sko\u0144czon\u0105 ga\u0142\u0105\u017a dewelopersk\u0105 naszego kodu i b\u0119dziemy gotowi do scalenia wszystkiego w ga\u0142\u0105\u017a master.<\/p>\n
Jest jednak jeszcze troch\u0119 do zrobienia. Mianowicie<\/a> :<\/p>\n Ostatni\u0105 rzecz\u0105, na kt\u00f3r\u0105 spojrzymy po tym, jest zaostrzenie niekt\u00f3rych logiki warunkowej wraz ze s\u0142owem o buforowaniu danych (poniewa\u017c robili\u015bmy ju\u017c troch\u0119 tego we wcze\u015bniejszych postach).<\/p>\n<\/blockquote>\n To s\u0105 dwie rzeczy, kt\u00f3rym b\u0119dziemy si\u0119 przygl\u0105da\u0107 w tym po\u015bcie. W szczeg\u00f3lno\u015bci przyjrzymy si\u0119 obs\u0142udze logiki warunkowej dla frontonu, a nast\u0119pnie jak zaimplementowa\u0107 podstawowe buforowanie.<\/p>\n Zanim przejdziemy do ostatniej rundy szczeg\u00f3\u0142\u00f3w, chc\u0119 si\u0119 upewni\u0107, \u017ce korzystasz z najnowszej wersji kodu<\/a>, poniewa\u017c jest to jedyny raz, kiedy uwa\u017cam, \u017ce konieczne jest przygotowanie kodu do ostatniej rundy zmian.<\/p>\n Wi\u0119c je\u015bli nie masz kodu uruchomionego na swoim komputerze, nadszed\u0142 czas. Ostatni fragment kodu, nad kt\u00f3rym musimy popracowa\u0107, jest do\u015b\u0107 ma\u0142y.<\/p>\n Ale wa\u017cne jest, aby upewni\u0107 si\u0119, \u017ce korzystasz z najnowszej wersji. Wi\u0119c kiedy ju\u017c zrobisz pobranie najnowszego kodu, jeste\u015bmy gotowi, aby to zako\u0144czy\u0107.<\/p>\n Przypomnijmy w poprzednim po\u015bcie, \u017ce wyrenderowali\u015bmy og\u00f3lne informacje o wid\u017cecie \u2013 tytu\u0142, tre\u015b\u0107 i czy tytu\u0142 powinien by\u0107 wy\u015bwietlany \u2013 po prostu wy\u015bwietlaj\u0105c warto\u015bci na interfejsie u\u017cytkownika.<\/p>\n Ale teraz nadszed\u0142 czas, aby skonfigurowa\u0107 informacje, aby upewni\u0107 si\u0119, \u017ce nie tylko b\u0119dziemy renderowa\u0107 informacje na podstawie opcji w obszarze administracyjnym wid\u017cetu, ale tak\u017ce czy w og\u00f3le s\u0105 jakie\u015b informacje.<\/p>\n Zaczniemy wi\u0119c od najprostszej opcji: opcji, kt\u00f3ra pozwala nam prze\u0142\u0105cza\u0107, czy tytu\u0142 jest wy\u015bwietlany. Innymi s\u0142owy, za\u0142o\u017cymy, \u017ce warto\u015bci s\u0105 wype\u0142nione, a opcja jest zaznaczona w backendzie.<\/p>\n Przypomnijmy,\u00a0 plik Widget.php<\/strong> obecnie wygl\u0105da tak<\/a> :<\/p>\n Wi\u0119c najpierw dokonamy refaktoryzacji tej cz\u0119\u015bci. Oczywi\u015bcie jest to stosunkowo \u0142atwe do wprowadzenia, prawda? Oznacza to, \u017ce logika wygl\u0105da tak:<\/p>\n Mo\u017cna si\u0119 z tym upora\u0107 za pomoc\u0105 prostej\u00a0 instrukcji if<\/strong>, oceniaj\u0105c warto\u015b\u0107 opcji display-title<\/strong>, kt\u00f3r\u0105 mamy. Ze wzgl\u0119du na spos\u00f3b, w jaki zbudowali\u015bmy t\u0119 funkcj\u0119 w tej serii, je\u015bli ta opcja jest zaznaczona, ma ona opcj\u0119 on<\/strong> ; w przeciwnym razie jest pusty.<\/p>\n Oznacza to, \u017ce mo\u017cemy ustawi\u0107 taki warunek w tym samym kodzie, kt\u00f3ry udost\u0119pnili\u015bmy powy\u017cej<\/a> :<\/p>\n W ten spos\u00f3b, je\u015bli opcja jest zaznaczona, tytu\u0142 zostanie wy\u015bwietlony.<\/p>\n My\u015bl\u0119, \u017ce warto wspomnie\u0107 o tym, \u017ce czasami ludzie mog\u0105 aktywowa\u0107 wid\u017cety, ale nie chc\u0105 mie\u0107 \u017cadnych tre\u015bci. Jasne, mo\u017cesz argumentowa\u0107, \u017ce je\u015bli to robi\u0105, to ich wina.<\/p>\n Jest w tym prawda.<\/p>\n Ale my\u015bl\u0119 te\u017c, \u017ce dbanie o u\u017cytkownik\u00f3w, kt\u00f3rzy mog\u0105 co\u015b rozgry\u017a\u0107 lub kt\u00f3rzy przypadkowo zrobili co\u015b, o czym nie wiedzieli, \u017ce mog\u0105 im pom\u00f3c. By\u0107 mo\u017ce czyni nas to odpowiedzialnymi programistami (a mo\u017ce czyni nas bardziej agresywnymi \u2013 wybieraj, ja jestem z tym pierwszym).<\/p>\n My\u015bl\u0119 wi\u0119c, \u017ce w tym przypadku warto upewni\u0107 si\u0119, \u017ce tytu\u0142 i tre\u015b\u0107 nie s\u0105 puste. Je\u015bli tak, nie renderuj niczego.<\/p>\n Kod wygl\u0105da wtedy tak<\/a> :<\/p>\n I to b\u0119dzie koniec, je\u015bli chodzi o front-end. Ale co z buforowaniem, o kt\u00f3rym m\u00f3wili\u015bmy we wcze\u015bniejszym po\u015bcie?<\/p>\n Buforowanie, dla takiego wid\u017cetu, jest czym\u015b, co uwa\u017cam za opcjonalne, ale poniewa\u017c wbudowali\u015bmy podstawow\u0105 funkcjonalno\u015b\u0107 w Boilerplate do opr\u00f3\u017cniania pami\u0119ci podr\u0119cznej, logicznie rzecz bior\u0105c, nale\u017cy wprowadzi\u0107 funkcj\u0119 buforowania danych, prawda?<\/p>\n Wi\u0119c zr\u00f3bmy to. To te\u017c nie powinno by\u0107 trudne. W rzeczywisto\u015bci po prostu bierzemy tytu\u0142, tre\u015b\u0107 i pole wyboru i buforujemy warto\u015bci dla danej instancji wid\u017cetu.<\/p>\n Aby to zrobi\u0107, musimy zlokalizowa\u0107 funkcj\u0119 wid\u017cetu<\/strong>, a nast\u0119pnie wykona\u0107 nast\u0119puj\u0105ce czynno\u015bci:<\/p>\n Najpierw przedstawimy funkcj\u0119 buforowania wid\u017cetu<\/a> :<\/p>\n Nast\u0119pnie wprowadzimy funkcj\u0119 do pobierania wersji wid\u017cetu z pami\u0119ci podr\u0119cznej<\/a> :<\/p>\n Nast\u0119pnie wracamy do oryginalnej funkcji, aby upewni\u0107 si\u0119, \u017ce wy\u015bwietlamy to, co jest potrzebne. Je\u015bli pami\u0119\u0107 podr\u0119czna jest pusta, nie robimy nic poza wy\u015bwietlaniem warto\u015bci bez zmian<\/a>.<\/p>\n I to ko\u0144czy funkcjonalno\u015b\u0107 ca\u0142kowicie zrefaktoryzowanej p\u0142yty Widget Boilerplate.<\/p>\n Ta powa\u017cna sprawa trwa ju\u017c od dawna. Osobi\u015bcie naprawd\u0119 dobrze by\u0142o ponownie odwiedzi\u0107 WordPress Widget Boilerplate i dostosowa\u0107 go do bardziej nowoczesnych standard\u00f3w.<\/p>\n Jest jeszcze kilka rzeczy, kt\u00f3re musz\u0119 zrobi\u0107, jak zaktualizowa\u0107 plik README, a nast\u0119pnie poda\u0107 kilka dodatkowych instrukcji, zanim scal\u0119 go z\u00a0 ga\u0142\u0119zi\u0105 master<\/strong>, ale je\u015bli \u015bledzi\u0142e\u015b ca\u0142\u0105 t\u0119 seri\u0119, prawdopodobnie jeste\u015b na pok\u0142adzie ze wszystkim. Co wi\u0119cej, doceniam Tw\u00f3j czas sp\u0119dzony z tym i mam nadziej\u0119, \u017ce na niekt\u00f3rych poziomach by\u0142o to dla Ciebie korzystne.<\/p>\n Maj\u0105c to na uwadze, b\u0119d\u0119 chcia\u0142 przej\u015b\u0107 do tre\u015bci premium o kr\u00f3tszej formie, poniewa\u017c ta i ostatnia seria by\u0142y do\u015b\u0107 d\u0142ugie. Jak zwykle zawsze mo\u017cesz si\u0119 ze mn\u0105 skontaktowa\u0107 lub w razie potrzeby zaoferowa\u0107 pull request \u2013 jest to oprogramowanie typu open source i mile widziane ulepszenia.<\/p>\n Na razie jednak to zamyka t\u0119 seri\u0119.<\/p>\n\n
Szablon WordPress Widget: Refaktoryzacja, cz\u0119\u015b\u0107 13<\/h2>\n
1 Renderowanie front-endu<\/h3>\n
<?php\n\n\/*\n * This file is part of WordPress Widget Boilerplate\n * (c) Tom McFarlin <tom@tommcfarlin.com>\n *\n * This source file is subject to the GPL license that is bundled\n * with this source code in the file LICENSE.\n *\/\n?>\n<div id=\"<?php echo $args['id']; ?>\">\n <h3 class=\"widget-title\"><?php echo $instance['title']; ?><\/h3>\n <p><?php echo $instance['content']; ?><\/p>\n <pre><?php echo $instance['display-title']; ?><\/pre>\n<\/div><!-- #<?php echo $args['id']; ?>-->\n<\/code><\/pre>\n\n
<?php\n\n\/*\n * This file is part of WordPress Widget Boilerplate\n * (c) Tom McFarlin <tom@tommcfarlin.com>\n *\n * This source file is subject to the GPL license that is bundled\n * with this source code in the file LICENSE.\n *\/\n?>\n<div id=\"<?php echo $args['id']; ?>\">\n <?php if (isset($instance['display-title']) && 'on' === $instance['display-title']): ?>\n <h3 class=\"widget-title\"><?php echo $instance['title']; ?><\/h3>\n <?php endif; ?>\n <p><?php echo $instance['content']; ?><\/p>\n<\/div><!-- #<?php echo $args['id']; ?>-->\n<\/code><\/pre>\nNast\u0119pstwem tego<\/h3>\n
<?php\n\n\/*\n * This file is part of WordPress Widget Boilerplate\n * (c) Tom McFarlin <tom@tommcfarlin.com>\n *\n * This source file is subject to the GPL license that is bundled\n * with this source code in the file LICENSE.\n *\/\n?>\n\n<?php if (empty($instance['title']) && empty($instance['content'])): return;\nendif; ?>\n\n<div id=\"<?php echo $args['id']; ?>\">\n <?php if (isset($instance['display-title']) && 'on' === $instance['display-title']): ?>\n <h3 class=\"widget-title\"><?php echo $instance['title']; ?><\/h3>\n <?php endif; ?>\n <p><?php echo $instance['content']; ?><\/p>\n<\/div><!-- #<?php echo $args['id']; ?>-->\n<\/code><\/pre>\n2 Przedstawiamy buforowanie<\/h3>\n
<?php\n\n\/**\n * Caches the values for the instance of this widget.\n *\n * @param array $args argument provided by WordPress that may be useful in rendering the widget\n * @param array $instance the values of the widget\n *\/\nprivate function cacheWidget($args, $instance)\n{\n $cache = [];\n $cache['widget_id'] = $args['widget_id'];\n $cache['title'] = empty($instance['title'])? '': $instance['title'];\n $cache['content'] = empty($instance['content'])? '': $instance['content'];\n\n $instance['display-title'] = isset($instance['display-title'])? $instance['display-title']: '';\n $cache['display-title'] = $instance['display-title'];\n\n wp_cache_set($this->getWidgetSlug(), $cache, 'widget');\n}<\/code><\/pre>\n<?php\n\n\/**\n * @return array the cached instance of this widget if it's not empty\n *\/\nprivate function getCachedWidget()\n{\n $cache = wp_cache_get($this->getWidgetSlug(), 'widget');\n if (!empty($cache)) {\n return $cache;\n }\n return [];\n}<\/code><\/pre>\n<?php\n\n\/**\n * Displays the widget based on the contents of the included template.\n *\n * @param array $args argument provided by WordPress that may be useful in rendering the widget\n * @param array $instance the values of the widget\n *\/\npublic function widget($args, $instance)\n{\n \/\/ Get a cached version of the widget. If it's empty, cache what we have.\n $cache = $this->getCachedWidget();\n if (empty($cache)) {\n $this->cacheWidget($args, $instance);\n }\n\n return $this->widgetDisplay->show($args, $instance);\n}<\/code><\/pre>\nKoniec<\/h2>\n