Je\u015bli chodzi o szybkie prototypy i WordPress, do tej pory zrobili\u015bmy dwie rzeczy:<\/p>\n
W tym momencie wykonali\u015bmy wystarczaj\u0105co du\u017co pracy, aby uzasadni\u0107 rozpocz\u0119cie refaktoryzacji naszego kodu. Oznacza to, \u017ce zaczniemy konwertowa\u0107 prototyp na kod. Ale to jest co\u015b, co trzeba b\u0119dzie zrobi\u0107 w dw\u00f3ch fazach.<\/p>\n
Najpierw po prostu wprowadzimy klasy, kt\u00f3re reprezentuj\u0105 diagramy z poprzedniego postu i zawieraj\u0105 odpowiedzialno\u015b\u0107 za ka\u017cdy projekt.<\/p>\n
Nast\u0119pnie przyjrzymy si\u0119 organizacji kodu w przestrzenie nazw i pakiety. Zanim jednak b\u0119dziemy mogli to zrobi\u0107, musimy upewni\u0107 si\u0119, \u017ce kod jest zorientowany obiektowo i pozostaje funkcjonalny. A wi\u0119c to w\u0142a\u015bnie wydarzy si\u0119 w tym po\u015bcie.<\/p>\n
Je\u015bli czyta\u0142e\u015b poprzednie posty, pami\u0119taj, \u017ce zamierzam \u015bledzi\u0107 organizacj\u0119, kt\u00f3r\u0105 naszkicowa\u0142em w ostatnim po\u015bcie. Oczywi\u015bcie nie musisz pod\u0105\u017ca\u0107 za tym konkretnym projektem.<\/p>\n
Je\u015bli u\u017cywasz kontroli \u017ar\u00f3d\u0142a, w tym miejscu zalecam utworzenie ga\u0142\u0119zi<\/a> z ga\u0142\u0119zi master (je\u015bli u\u017cywasz Git), aby m\u00f3c wykonywa\u0107 swoj\u0105 prac\u0119 bez naruszania stabilnej wersji kodu.<\/p>\n Jest to nieco poza zakresem serii, wi\u0119c je\u015bli nie u\u017cywasz kontroli \u017ar\u00f3d\u0142a, nie martw si\u0119. Je\u015bli tak, to wybieram rozwini\u0119cie<\/strong> jako nazw\u0119 tej ga\u0142\u0119zi. Po\u0142\u0105cz\u0119 go z powrotem w master\u00a0<\/strong>, gdy b\u0119d\u0119 pewien, \u017ce dzia\u0142a.<\/p>\n Zgodnie z naszkicowan\u0105 wczoraj prac\u0105 stworz\u0119 dwie klasy:<\/p>\n Nast\u0105pi ponowne wykorzystanie kodu z tego, co ju\u017c widzieli\u015bmy, jak zobaczysz w poni\u017cszym kodzie.<\/p>\n Po pierwsze, nasze meta box<\/a> :<\/p>\n A nast\u0119pnie nasz wy\u015bwietlacz<\/a> :<\/p>\n \u017be w kodzie meta box, w kodzie meta box jawnie tworzymy instancj\u0119 wy\u015bwietlania, aby\u015bmy w razie potrzeby mogli wywo\u0142a\u0107 jego metod\u0119 wy\u015bwietlania.<\/p>\n Inn\u0105 alternatyw\u0105 by\u0142oby utworzenie oddzielnego wyst\u0105pienia dw\u00f3ch obiekt\u00f3w, a nast\u0119pnie wstrzykni\u0119cie wy\u015bwietlacza do pola meta za pomoc\u0105 wstrzykni\u0119cia konstruktora lub czego\u015b podobnego. Musia\u0142oby to zosta\u0107 zrobione w klasie innej firmy.<\/p>\n Zalet\u0105 tego jest nieco wi\u0119ksze rozdzielenie obu klas. By\u0107 mo\u017ce om\u00f3wimy, jak to zrobi\u0107 w nast\u0119pnym po\u015bcie.<\/p>\n Nast\u0119pnie musimy przej\u015b\u0107 dalej i zdefiniowa\u0107 klas\u0119 odpowiedzialn\u0105 za wy\u015bwietlanie wiadomo\u015bci w kontek\u015bcie Meta Box Display. Oto, co nazwiemy Post Messenger<\/a> :<\/p>\n Zauwa\u017c, \u017ce Post Messenger r\u00f3wnie\u017c odwo\u0142uje si\u0119 do Post Query<\/a>. Jest to klasa, w kt\u00f3rej odbywa si\u0119 komunikacja z baz\u0105 danych. Do\u0142\u0105czy\u0142em r\u00f3wnie\u017c kilka funkcji pomocniczych, aby kod widoku by\u0142 nieco prostszy, jak zobaczymy za chwil\u0119.<\/p>\n I to wszystko w przypadku klas podstawowych. Oczywi\u015bcie musimy jeszcze porozmawia\u0107 o pogl\u0105dach.<\/p>\n Widoki odpowiadaj\u0105 za renderowanie kodu HTML w kontek\u015bcie pola meta. Nie lubi\u0119 pisa\u0107 HTML w kontek\u015bcie PHP (ani te\u017c lubi\u0119 miesza\u0107 PHP w kontek\u015bcie HTML, ale jest to nieuniknione w tym projekcie).<\/p>\n Jest kilka \u015bwietnych projekt\u00f3w szablon\u00f3w, kt\u00f3re to u\u0142atwiaj\u0105, ale mam dygresj\u0119. W ka\u017cdym razie zauwa\u017cysz, \u017ce w\u00a0 pliku post-list.php<\/strong> znajduj\u0105 si\u0119 odniesienia do funkcji pomocniczych w klasie Post Query. Ma to na celu upewnienie si\u0119, \u017ce nie ujawniam zbyt wielu w\u0142a\u015bciwo\u015bci i nie naruszam Prawa Demeter.<\/p>\n Przyjrzyjmy si\u0119 najpierw temu plikowi, poniewa\u017c jest najbardziej skomplikowany<\/a> :<\/p>\n Wygl\u0105da jak standardowy kod WordPressa, ale pami\u0119taj, \u017ce skoro ten plik jest wywo\u0142ywany w Post Messenger<\/strong>, b\u0119dzie odnosi\u0107 si\u0119 do zapytania jako do zapytania, kt\u00f3re jest opakowane przez t\u0119 klas\u0119.<\/p>\n Ostatnie dwa pliki s\u0105 do\u015b\u0107 proste. Jeden z nich zawiera opis<\/a> :<\/p>\n Drugi wy\u015bwietla komunikat, gdy nie ma \u017cadnych post\u00f3w<\/a> :<\/p>\n Poza tym jest wykonywana podstawowa funkcjonalno\u015b\u0107.<\/p>\n Ostatni\u0105 rzecz\u0105, kt\u00f3r\u0105 musimy zrobi\u0107, to uruchomi\u0107 wtyczk\u0119. W tym celu zmieniamy kod w g\u0142\u00f3wnym pliku wtyczki tak, aby wygl\u0105da\u0142 tak<\/a> :<\/p>\n To pod\u0142\u0105czy si\u0119 do WordPressa, utworzy instancj\u0119 naszej wtyczki, a nast\u0119pnie wprawi j\u0105 w ruch. Kiedy uruchomisz go w swojej instalacji WordPressa, powinien wygl\u0105da\u0107 dok\u0142adnie tak, jak w pierwszej wersji.<\/p>\n Jedyna r\u00f3\u017cnica polega na tym, \u017ce mamy teraz rzeczy zorganizowane w klasy, a nie w poszczeg\u00f3lne funkcje.<\/p>\n Po pierwsze, istniej\u0105 tutaj mo\u017cliwo\u015bci refaktoryzacji, kt\u00f3ra jeszcze bardziej zmniejszy\u0142aby rozdzielenie (takie jak r\u00f3\u017cne rodzaje wstrzykiwania zale\u017cno\u015bci<\/a> itp.), ale celem tej serii nie jest pokrycie tego.<\/p>\n Zamiast tego jest to pomys\u0142 zobaczenia wtyczek napisanych przez wiele funkcji proceduralnych, a nast\u0119pnie rozbicie ich na bardziej konceptualne klasy, kt\u00f3re obejmuj\u0105 ich obowi\u0105zki.<\/p>\n Po drugie, je\u015bli przejrzysz kod \u017ar\u00f3d\u0142owy w repozytorium dla tej wersji projektu, zobaczysz, \u017ce wprowadzi\u0142em r\u00f3wnie\u017c composer.json. Dzieje si\u0119 tak, aby podczas pisania kodu m\u00f3c korzysta\u0107 z PHP CodeSniffer<\/a> i WordPress Coding Standards .<\/a><\/p>\n W ostatniej cz\u0119\u015bci serii zajmiemy si\u0119 przestrzeni\u0105 nazw<\/a> i reorganizacj\u0105 plik\u00f3w. Je\u015bli czas pozwoli, dodamy autoloader, dzi\u0119ki czemu nie b\u0119dziemy musieli r\u0119cznie umieszcza\u0107 plik\u00f3w na g\u00f3rze naszego pliku wtyczki.<\/p>\n W ko\u0144cu po\u0142\u0105czy\u0142em ten kod z masterem i oznaczy\u0142em go jako 0.2.1<\/a> (poniewa\u017c musia\u0142em zrobi\u0107 ma\u0142\u0105 poprawk\u0119), poniewa\u017c wci\u0105\u017c jest to bardzo w toku.<\/p>\nPisanie kodu<\/h3>\n
\n
Kod<\/h4>\n
<?php\n\/**\n * Registers the Meta Box with WordPress.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Registers the Meta Box with WordPress. Defines the ID, title, display function,\n * and the post type on which it will live.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Meta_Box {\n\n \/**\n * A reference to the class that will display the contents in the meta box.\n *\n * @access private\n * @var Meta_Box_Display\n *\/\n private $meta_box_display;\n\n \/**\n * Instantiates the class by setting its property equal to a reference to its display.\n *\/\n public function __construct() {\n $this->meta_box_display = new Meta_Box_Display();\n }\n\n \/**\n * The function responsible for hooking into the WordPress API.\n *\/\n public function init() {\n\n add_meta_box(\n 'three-recent-posts',\n 'Three Recent Posts',\n array( $this->meta_box_display, 'display' ),\n 'post',\n 'side'\n );\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Defines the display for the meta box.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Defines the display for the meta box that will render the content in the\n * context of its meta box.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Meta_Box_Display {\n\n \/**\n * A reference to the class that will display the contents in the meta box.\n *\n * @access private\n * @var Post_Messenger\n *\/\n private $messenger;\n\n \/**\n * Instantiates the object by setting a property equal to that of the class\n * responsible for rendering the messages from the post query.\n *\/\n public function __construct() {\n $this->messenger = new Post_Messenger( $this );\n }\n\n \/**\n * If there are posts to display, renders them in the metabox. Otherwise, displays\n * a note that there are no posts to display.\n *\/\n public function display( $message) {\n $this->messenger->get_message();\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Display content for the meta box when requested.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Retrieves information from the class responsible for querying the database and\n * renders it in the context of our meta box when called via the Meta Box Display.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Post_Messenger {\n\n \/**\n * A reference to the query resonsible for retrieving post information from\n * the database.\n *\n * @access private\n * @var WP_Query\n *\/\n private $query;\n\n \/**\n * A reference to the message that's displayed in the view of the\n * meta box.\n *\n * @access private\n *\/\n private $message;\n\n \/**\n * Instantiates the class by setting a reference to the query.\n *\/\n public function __construct() {\n $this->query = new Post_Query();\n }\n\n \/**\n * Retrieves the content to be displayed in the meta box.\n *\/\n public function get_message() {\n\n $this->get_description();\n\n if ($this->query->has_posts()) {\n $this->get_post_message();\n } else {\n $this->get_no_posts_message();\n }\n }\n\n \/**\n * Displays the description of the content of the meta box.\n *\n * @access private\n *\/\n private function get_post_message() {\n include_once 'post-list.php';\n }\n\n \/**\n * Displays the description of the content of the meta box.\n *\n * @access private\n *\/\n private function get_description() {\n include_once 'message-description.php';\n }\n\n \/**\n * Displays a message of there are no recent posts.\n *\n * @access private\n *\/\n private function get_no_posts_message() {\n include_once 'no-post-list.php';\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Queries the database for three most recent posts.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Queries the database for three most recent posts. Returns the query to the\n * caller so that it can be interrogates for posts or not.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Post_Query {\n\n \/**\n * A reference to the WP_Query this class wraps.\n *\n * @access private\n * @var WP_Query\n *\/\n private $query;\n\n \/**\n * Instantiates the class by preparing instance data and executing the\n * query so the display can render the contents.\n *\/\n public function __construct() {\n\n $this->query = null;\n $this->get_posts();\n }\n\n \/**\n * Executes the query for returning the post recent posts ordered by date.\n *\n * @access private\n *\/\n private function get_posts() {\n\n $args = array(\n 'post_type' => 'post',\n 'post_status' => 'publish',\n 'orderby' => 'date',\n 'order' => 'desc',\n );\n $this->query = new WP_Query( $args );\n\n return $this->query;\n }\n\n \/**\n * A helper function to determine if the query has any posts.\n *\/\n public function has_posts() {\n return! $this->query->have_posts();\n }\n\n \/**\n * A helper function for retrieving the next post in the list of\n * posts\n *\/\n public function the_post() {\n return $this->query->the_post();\n }\n}\n<\/code><\/pre>\nWidoki<\/h4>\n
<ol>\n <?php while ($this->query->has_posts()) { ?>\n <?php $this->query->the_post(); ?>\n <li>\n <a href=\"<?php get_the_permalink(); ?>\" target=\"_blank\">\n <?php echo get_the_title(); ?>\n <\/a>\n <\/li>\n <?php } ?>\n<\/ol><\/code><\/pre>\n<p>\n <span class=\"description\">\n Displays up to the three most recent posts.\n <\/span><!-- .description -->\n<\/p><\/code><\/pre>\n<p>There are no recent posts.<\/p><\/code><\/pre>\nUruchamianie wtyczki<\/h3>\n
<?php\n\/**\n * Three Recent Posts\n *\n * @package TRP\n * @author Tom McFarlin\n * @copyright 2017 Tom McFarlin\n * @license MIT\n *\n * @wordpress-plugin\n * Plugin Name: Three Recent Posts\n * Plugin URI: https:\/\/tommcfarlin.com\/three-recent-posts\/\n * Description: Displays the three mot recent posts in your post editor screen.\n * Version: 0.2.0\n * Author: Tom McFarlin\n * Author URI: https:\/\/tommcfarlin.com\n * Text Domain: three-recent-posts\n * License: GPL\n * License URI: http:\/\/www.gnu.org\/licenses\/gpl-3.0.txt\n *\/\n\ninclude 'class-meta-box.php';\ninclude 'class-meta-box-display.php';\ninclude 'class-post-messenger.php';\ninclude 'class-post-query.php';\n\nadd_action( 'add_meta_boxes', 'trp_start' );\n\/**\n * Starts the plugin.\n *\/\nfunction trp_start() {\n\n $meta_box = new Meta_Box();\n $meta_box->init();\n}\n<\/code><\/pre>\nUwagi<\/h2>\n
Posty z serii<\/h2>\n
\n