Mit\u00e4 tulee nopeisiin prototyyppeihin ja WordPressiin, olemme t\u00e4h\u00e4n menness\u00e4 tehneet kaksi asiaa:<\/p>\n
T\u00e4ss\u00e4 vaiheessa olemme tehneet tarpeeksi ty\u00f6t\u00e4 oikeuttaaksemme koodimme uudelleenmuodostamisen. Toisin sanoen aiomme alkaa muuntaa prototyyppi\u00e4 koodiksi. Mutta t\u00e4m\u00e4 on jotain, joka on teht\u00e4v\u00e4 kahdessa vaiheessa.<\/p>\n
Ensinn\u00e4kin aiomme yksinkertaisesti esitell\u00e4 luokat, jotka edustavat edellisen viestin kaavioita ja jotka kiteytt\u00e4v\u00e4t kunkin projektin vastuun.<\/p>\n
Sen j\u00e4lkeen tarkastellaan koodin j\u00e4rjest\u00e4mist\u00e4 nimiavaruuksiin ja paketeihin. Ennen kuin voimme tehd\u00e4 sen, meid\u00e4n on kuitenkin varmistettava, ett\u00e4 koodi on oliosuuntautunut ja toimii edelleen. N\u00e4in siis t\u00e4ss\u00e4 postauksessa tapahtuu.<\/p>\n
Jos olet lukenut aiempia viestej\u00e4, huomaa, ett\u00e4 aion seurata edellisess\u00e4 viestiss\u00e4 hahmottelemaani organisaatiota. Sinun ei tietenk\u00e4\u00e4n tarvitse noudattaa t\u00e4t\u00e4 erityist\u00e4 mallia.<\/p>\n
Jos k\u00e4yt\u00e4t l\u00e4hdeohjausta, suosittelen t\u00e4ss\u00e4 tapauksessa luomaan p\u00e4\u00e4haaran<\/a> haaran (jos k\u00e4yt\u00e4t Giti\u00e4), jotta voit tehd\u00e4 ty\u00f6si ilman koodin vakaan version ankaruutta.<\/p>\n T\u00e4m\u00e4 on hieman sarjan soveltamisalan ulkopuolella, joten jos et k\u00e4yt\u00e4 l\u00e4hteen hallintaa, \u00e4l\u00e4 huoli. Jos olet, valitsen t\u00e4m\u00e4n sivuliikkeen nimen kehitt\u00e4v\u00e4n .<\/strong> Yhdist\u00e4n sen takaisin masteriin\u00a0<\/strong>, kun olen varma, ett\u00e4 se toimii.<\/p>\n Eilen luonnostellun ty\u00f6n mukaisesti aion luoda kaksi luokkaa:<\/p>\n Koodia k\u00e4ytet\u00e4\u00e4n jonkin verran uudelleen siit\u00e4, mit\u00e4 olemme jo n\u00e4hneet, kuten n\u00e4et seuraavassa koodissa.<\/p>\n Ensinn\u00e4kin metalaatikkomme<\/a> :<\/p>\n Ja seuraavaksi meid\u00e4n n\u00e4ytt\u00f6mme<\/a> :<\/p>\n Ett\u00e4 metaruutukoodissa, metalaatikkokoodissa me eksplisiittisesti instantoimme n\u00e4yt\u00f6n, jotta voimme tarvittaessa kutsua sit\u00e4 n\u00e4ytt\u00f6menetelm\u00e4ksi.<\/p>\n Toinen vaihtoehto olisi instantoida n\u00e4m\u00e4 kaksi objektia erikseen ja sitten ruiskuttaa n\u00e4ytt\u00f6 metalaatikkoon konstruktoriinjektiolla tai jollain vastaavalla. T\u00e4m\u00e4 on teht\u00e4v\u00e4 kolmannen osapuolen luokassa.<\/p>\n T\u00e4m\u00e4n edut tulevat siit\u00e4, ett\u00e4 kaksi luokkaa irrotetaan hieman enemm\u00e4n. Ehk\u00e4 k\u00e4ymme l\u00e4pi, kuinka t\u00e4m\u00e4 tehd\u00e4\u00e4n seuraavassa postauksessa.<\/p>\n Sen j\u00e4lkeen meid\u00e4n on edett\u00e4v\u00e4 ja m\u00e4\u00e4ritelt\u00e4v\u00e4 luokka, joka on vastuussa viestien n\u00e4ytt\u00e4misest\u00e4 Meta Box Display -kontekstissa. T\u00e4t\u00e4 kutsumme Post Messengeriksi<\/a> :<\/p>\n Huomaa t\u00e4ss\u00e4, ett\u00e4 Post Messenger viittaa my\u00f6s viestikyselyyn<\/a>. T\u00e4m\u00e4 on luokka, jossa tiedonsiirto tietokantaan tapahtuu. Olen my\u00f6s lis\u00e4nnyt muutaman aputoiminnon yksinkertaistaakseni n\u00e4kym\u00e4koodia, kuten hetken kuluttua n\u00e4emme.<\/p>\n Ja siin\u00e4 se ydinluokille. Tietysti meid\u00e4n on viel\u00e4 puhuttava n\u00e4kemyksist\u00e4.<\/p>\n N\u00e4kym\u00e4t vastaavat HTML:n hahmontamisesta metalaatikon yhteydess\u00e4. En pid\u00e4 HTML:n kirjoittamisesta PHP:n yhteydess\u00e4 (enk\u00e4 my\u00f6sk\u00e4\u00e4n pid\u00e4 PHP:n sekoittamisesta HTML:n yhteydess\u00e4, mutta t\u00e4m\u00e4 on v\u00e4ist\u00e4m\u00e4t\u00f6nt\u00e4 t\u00e4ss\u00e4 projektissa).<\/p>\n On olemassa hienoja malliprojekteja, jotka tekev\u00e4t t\u00e4m\u00e4n helpommaksi, mutta poikkean. Joka tapauksessa huomaat, ett\u00e4 post-list.php-<\/strong> tiedostossa on viittauksia Post Query -luokan aputoimintoihin. T\u00e4m\u00e4 varmistaa, etten paljasta liikaa ominaisuuksia ja riko Demeterin lakia.<\/p>\n Katsotaanpa ensin tuota tiedostoa, koska se on monimutkaisin<\/a> :<\/p>\n Se n\u00e4ytt\u00e4\u00e4 tavalliselta WordPress-koodilta, mutta muista, ett\u00e4 koska t\u00e4t\u00e4 tiedostoa kutsutaan Post Messengeriss\u00e4<\/strong>, se viittaa kyselyyn kyselyn\u00e4, jonka t\u00e4m\u00e4 luokka k\u00e4\u00e4rii.<\/p>\n Kaksi viimeist\u00e4 tiedostoa ovat melko suoraviivaisia. Yksi niist\u00e4 tarjoaa kuvauksen<\/a> :<\/p>\n Toinen antaa viestin, kun viestej\u00e4 ei ole<\/a> :<\/p>\n Muuten perustoiminnot on tehty.<\/p>\n Viimeinen asia, joka meid\u00e4n on teht\u00e4v\u00e4, on k\u00e4ynnist\u00e4\u00e4 laajennus. T\u00e4t\u00e4 varten muutamme p\u00e4\u00e4laajennustiedoston koodia siten, ett\u00e4 se n\u00e4ytt\u00e4\u00e4 t\u00e4lt\u00e4<\/a> :<\/p>\n Se kytkeytyy WordPressiin, instantoi laajennuksen ja k\u00e4ynnist\u00e4\u00e4 sen sitten. Kun k\u00e4yt\u00e4t sit\u00e4 WordPress-asennuksessasi, sen pit\u00e4isi n\u00e4ytt\u00e4\u00e4 t\u00e4sm\u00e4lleen samalta kuin ensimm\u00e4isen version aikana.<\/p>\n Ainoa ero on, ett\u00e4 meill\u00e4 on nyt asiat j\u00e4rjestetty luokittain yksitt\u00e4isten toimintojen sijaan.<\/p>\n Ensinn\u00e4kin t\u00e4ss\u00e4 on mahdollisuuksia uudelleenj\u00e4rjestelyyn, joka v\u00e4hent\u00e4isi irrottamista entisest\u00e4\u00e4n (kuten erilaiset riippuvuusruiskeet<\/a> jne.), mutta t\u00e4m\u00e4n sarjan tarkoitus ei ole kattaa sit\u00e4.<\/p>\n Sen sijaan on ajatus n\u00e4hd\u00e4 monien proseduuritoimintojen kirjoittamia laajennuksia ja sitten jakaa ne k\u00e4sitteellisempiin luokkiin, jotka kiteytt\u00e4v\u00e4t heid\u00e4n vastuunsa.<\/p>\n Toiseksi, jos tarkastelet projektin t\u00e4m\u00e4n version arkistossa olevaa l\u00e4hdekoodia, huomaat, ett\u00e4 esittelin my\u00f6s composer.jsonin. T\u00e4m\u00e4 on siksi, ett\u00e4 voin hy\u00f6dynt\u00e4\u00e4 PHP CodeSnifferi\u00e4<\/a> ja WordPress-<\/a> koodausstandardeja kirjoittaessani koodia.<\/p>\n Sarjan viimeisess\u00e4 osassa k\u00e4ymme l\u00e4pi nimiv\u00e4lit<\/a> ja j\u00e4rjest\u00e4mme tiedostot uudelleen. Jos aika sallii, sis\u00e4llyt\u00e4mme automaattisen latausohjelman, jotta meid\u00e4n ei tarvitse lis\u00e4t\u00e4 tiedostoja manuaalisesti laajennustiedostomme yl\u00e4osaan.<\/p>\n Lopuksi olen yhdist\u00e4nyt t\u00e4m\u00e4n koodin master-koodiin ja merkinnyt sen 0.2.1:ksi<\/a> (koska minun piti tehd\u00e4 pieni hotfix-korjaus), koska se on viel\u00e4 keskener\u00e4inen.<\/p>\nKoodin kirjoittaminen<\/h3>\n
\n
Koodi<\/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>\nKatselukerrat<\/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>\nPluginin k\u00e4ynnistys<\/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>\nHuomautuksia<\/h2>\n
Sarjan postaukset<\/h2>\n
\n