Je\u015bli chodzi o refaktoryzacj\u0119 WordPress Widget Boilerplate, jeste\u015bmy w dobrym miejscu. Wykonano du\u017co pracy, aby wprowadzanie nowych klas, funkcji i funkcjonalno\u015bci by\u0142o znacznie prostsze.<\/p>\n
I nie tylko to: powinno by\u0107 \u0142atwiej \u015bledzi\u0107.<\/p>\n
Dzi\u0119ki pracy w ostatnim po\u015bcie<\/a> mamy du\u017co pracy do zbudowania \u2013 mianowicie podstawowy interfejs administracyjny.<\/p>\n Wreszcie ostatni post m\u00f3wi\u0142:<\/p>\n W ci\u0105gu kilku nast\u0119pnych artyku\u0142\u00f3w b\u0119dzie to ewoluowa\u0107, ale jak wida\u0107, upewniamy si\u0119, \u017ce mamy jedn\u0105 podstawow\u0105 klas\u0119 funkcjonalno\u015bci do komunikacji z WordPressem i klas\u0119 specjalnie do renderowania formularza administracyjnego.<\/p>\n<\/blockquote>\n I w\u0142a\u015bnie to zajmiemy si\u0119 w tym artykule. W szczeg\u00f3lno\u015bci przyjrzymy si\u0119 oczyszczaniu i serializacji danych, a tak\u017ce pobieraniu danych zapisanych w wid\u017cecie.<\/p>\n Zanim przejdziemy do serializacji, musimy wykona\u0107 niewielk\u0105 prac\u0119 w naszym widoku administracyjnym. Przypomnij sobie z poprzednich post\u00f3w z serii, \u017ce zbudowali\u015bmy formularz, kt\u00f3ry akceptuje:<\/p>\n Wy\u015bwietla si\u0119 to dobrze, ale wyklucza niekt\u00f3re kluczowe funkcje interfejsu Widgets API<\/a>. Mianowicie musimy upewni\u0107 si\u0119, \u017ce poprawnie nazywamy nasze elementy za pomoc\u0105 nast\u0119puj\u0105cych funkcji:<\/p>\n A potem napiszemy nasz\u0105 funkcj\u0119 o nazwie po prostu get<\/a>, kt\u00f3r\u0105 wyja\u015bni\u0119 za chwil\u0119.<\/p>\n Powy\u017csze funkcje s\u0105 niezb\u0119dne, poniewa\u017c pomagaj\u0105 WordPressowi \u015bledzi\u0107, ile wyst\u0105pie\u0144 wid\u017cetu jest u\u017cywanych i kt\u00f3re z nich edytuje u\u017cytkownik. Innymi s\u0142owy, du\u017co funkcjonalno\u015bci dostajemy za darmo.<\/p>\n Zanim poka\u017c\u0119 kod, chc\u0119 kr\u00f3tko om\u00f3wi\u0107 przeznaczenie\u00a0 funkcji get<\/strong>, kt\u00f3r\u0105 zamierzamy wprowadzi\u0107. Kr\u00f3tko m\u00f3wi\u0105c, jest to spos\u00f3b, w jaki mo\u017cemy przekaza\u0107 klucz (jak w kluczu w parze klucz\/warto\u015b\u0107) do funkcji, a nast\u0119pnie \u0142atwo pobra\u0107 dla nas warto\u015b\u0107, tak aby nasz interfejs by\u0142 tak czysty, jak to mo\u017cliwe.<\/p>\n Tak wi\u0119c najpierw metoda get<\/a> :<\/p>\n Nale\u017cy zauwa\u017cy\u0107, \u017ce ta metoda akceptuje nie tylko klucz dla odczytanej warto\u015bci, ale tak\u017ce tablic\u0119 odwo\u0142uj\u0105c\u0105 si\u0119 do instancji tablicy.<\/p>\n A teraz zrefaktoryzowany interfejs u\u017cytkownika<\/a> :<\/p>\n Ale to wci\u0105\u017c powoduje brak funkcjonalno\u015bci i pozostawia nam prac\u0119 do wykonania. Mianowicie musimy oczy\u015bci\u0107 dane i przekaza\u0107 je z powrotem do WordPressa, aby zapisywa\u0142 dane.<\/p>\n Na potrzeby naszego przyk\u0142adu b\u0119dziemy bardzo surowi w tym, na co pozwalamy. Mianowicie zamierzamy wspiera\u0107 tylko podstawowy tekst i zamierzamy agresywnie usuwa\u0107 wszystko.<\/p>\n Oznacza to, \u017ce nie pozwolimy na znaczniki ani nic podobnego. Zamiast tego usuniemy wszystko, co nie jest tekstem podstawowym. Mo\u017cemy go troch\u0119 udekorowa\u0107, gdy przyjdzie czas na wy\u015bwietlenie go na froncie, ale zostawiamy to do odpowiedniego postu.<\/p>\n W tym celu u\u017cyjemy nast\u0119puj\u0105cych funkcji:<\/p>\n Przypomnijmy, \u017ce w naszym widgecie mamy dwa pola \u2013 tytu\u0142 i tre\u015b\u0107. W zale\u017cno\u015bci od typu wid\u017cetu, kt\u00f3ry tworzysz, mo\u017cesz potrzebowa\u0107 tylko jednej klasy lub funkcji do oczyszczenia danych. W innych sytuacjach mo\u017cesz potrzebowa\u0107 czego\u015b bardziej z\u0142o\u017conego.<\/p>\n Miej to na uwadze, przechodz\u0105c przez ten kod, poniewa\u017c nie b\u0119dzie to rozwi\u0105zanie uniwersalne. Zamiast tego b\u0119dzie specjalnie do tego.<\/p>\n W ka\u017cdym razie, aby oczy\u015bci\u0107 dane, napiszemy klas\u0119 specjalnie do tego celu, a nast\u0119pnie udost\u0119pnimy j\u0105 naszej klasie WidgetAdmin.<\/p>\n\n
WordPress Widget Boilerplate: Refaktoryzacja Cz\u0119\u015b\u0107 10<\/h2>\n
Refaktoryzacja interfejsu u\u017cytkownika<\/h3>\n
\n
\n
<?php\n\n\/**\n * If the value for the key exists in the current instance of the widget, then it will\n * retrieve it. Otherwise, it will return an empty value.\n *\n * @param string $key the used to identify the value of the widget.\n * @param array $instance the options for the instance of this widget\n *\/\nprotected function get($key, $instance)\n{\n return empty($instance[$key])? '': $instance[$key];\n}<\/code><\/pre>\n<?php\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<div class=\"widget-content\">\n <p>\n <input\n type=\"text\"\n id=\"<?php echo esc_attr($this->get_field_id('title')); ?>\"\n name=\"<?php echo esc_attr($this->get_field_name('title')); ?>\"\n value=\"<?php echo $this->get('title', $instance) ?>\"\n placeholder=\"Widget Title\"\n class=\"widefat\"\n \/>\n <\/p>\n\n <p>\n <textarea\n id=\"<?php echo esc_attr($this->get_field_id('content')); ?>\"\n name=\"<?php echo esc_attr($this->get_field_name('content')); ?>\"\n placeholder=\"Widget Content\"\n style=\"width:100%;\"><?php echo $this->get('content', $instance) ?><\/textarea>\n <\/p>\n\n <p>\n <input\n type=\"checkbox\"\n value=\"on\"\n name=\"<?php echo esc_attr($this->get_field_name('display-title')); ?>\"\n id=\"<?php echo esc_attr($this->get_field_id('display-title')); ?>\"\n <?php checked('on', $this->get('display-title', $instance), true); ?>\n class=\"checkbox\"\n \/>\n <label for=\"<?php echo esc_attr($this->get_field_id('display-title')); ?>\">Display Title?<\/label>\n <\/p>\n<\/div><!-- .widget-content -->\n<\/code><\/pre>\nSanityzacja i serializacja<\/h3>\n
\n