N\u00e4r det g\u00e4ller snabba prototyper och WordPress har vi hittills gjort tv\u00e5 saker:<\/p>\n
Vid det h\u00e4r laget har vi gjort tillr\u00e4ckligt mycket arbete f\u00f6r att motivera att vi b\u00f6rjar omstrukturera v\u00e5r kod. Det vill s\u00e4ga, vi ska b\u00f6rja konvertera prototypen till kod. Men det h\u00e4r \u00e4r n\u00e5got som kommer att beh\u00f6va g\u00f6ras i tv\u00e5 faser.<\/p>\n
F\u00f6rst kommer vi helt enkelt att introducera klasser som representerar diagrammen fr\u00e5n f\u00f6reg\u00e5ende inl\u00e4gg och som kapslar in ansvaret f\u00f6r varje projekt.<\/p>\n
Efter det kommer vi att titta p\u00e5 att organisera koden i namnutrymmen och paket. Innan vi kan g\u00f6ra det m\u00e5ste vi dock se till att koden \u00e4r objektorienterad och f\u00f6rblir funktionell. S\u00e5 det \u00e4r vad som kommer att h\u00e4nda i det h\u00e4r inl\u00e4gget.<\/p>\n
Om du har l\u00e4st de tidigare inl\u00e4ggen, notera att jag planerar att f\u00f6lja organisationen som jag skissade p\u00e5 i f\u00f6rra inl\u00e4gget. Du beh\u00f6ver naturligtvis inte f\u00f6lja den h\u00e4r designen.<\/p>\n
Om du anv\u00e4nder k\u00e4llkontroll, \u00e4r det h\u00e4r jag rekommenderar att du skapar en f\u00f6rgrening<\/a> av huvudgrenen (om du anv\u00e4nder Git) s\u00e5 att du kan g\u00f6ra ditt arbete utan att f\u00f6rsv\u00e5ra den stabila versionen av koden.<\/p>\n Detta \u00e4r lite utanf\u00f6r seriens omfattning, s\u00e5 om du inte anv\u00e4nder k\u00e4llkontroll, oroa dig inte. Om du \u00e4r det v\u00e4ljer jag att g\u00e5 med utveckla<\/strong> som namnet p\u00e5 denna gren. Jag sl\u00e5r ihop den tillbaka till master\u00a0<\/strong> n\u00e4r jag \u00e4r s\u00e4ker p\u00e5 att den fungerar.<\/p>\n Enligt arbetet som skissades ig\u00e5r kommer jag att skapa tv\u00e5 klasser:<\/p>\n Det kommer att finnas en viss \u00e5teranv\u00e4ndning av kod fr\u00e5n det vi redan har sett som du kommer att se i f\u00f6ljande kod.<\/p>\n F\u00f6rst v\u00e5r metabox<\/a> :<\/p>\n Och n\u00e4sta, v\u00e5r display<\/a> :<\/p>\n Att i metaboxkoden, i metaboxkoden instansierar vi uttryckligen displayen s\u00e5 att vi kan kalla dens displaymetod n\u00e4r det beh\u00f6vs.<\/p>\n Ett annat alternativ skulle vara att instansiera de tv\u00e5 objekten separat och sedan injicera displayen i metaboxen via konstruktorinjektion eller n\u00e5got liknande. Detta skulle beh\u00f6va g\u00f6ras i en tredje parts klass.<\/p>\n F\u00f6rdelarna med detta kommer fr\u00e5n att koppla de tv\u00e5 klasserna lite mer. Vi kanske ska granska hur man g\u00f6r detta i n\u00e4sta inl\u00e4gg.<\/p>\n Efter det m\u00e5ste vi g\u00e5 vidare och definiera klassen som \u00e4r ansvarig f\u00f6r att visa meddelanden inom ramen f\u00f6r Meta Box Display. Det h\u00e4r \u00e4r vad vi kommer att kalla Post Messenger<\/a> :<\/p>\n Observera h\u00e4r att Post Messenger ocks\u00e5 refererar till Post-fr\u00e5gan<\/a>. Det h\u00e4r \u00e4r klassen d\u00e4r kommunikationen till databasen sker. Jag har ocks\u00e5 inkluderat n\u00e5gra hj\u00e4lpfunktioner f\u00f6r att g\u00f6ra visningskoden lite enklare som vi kommer att se ett \u00f6gonblick.<\/p>\n Och det \u00e4r det f\u00f6r k\u00e4rnklasserna. Naturligtvis beh\u00f6ver vi fortfarande prata om synpunkterna.<\/p>\n Vyerna \u00e4r ansvariga f\u00f6r att rendera HTML i kontexten av metaboxen. Jag gillar inte att skriva HTML inom PHP-sammanhang (och jag gillar inte heller att blanda PHP i HTML-sammanhang, men detta \u00e4r oundvikligt i det h\u00e4r projektet).<\/p>\n Det finns n\u00e5gra bra mallprojekt f\u00f6r att g\u00f6ra det h\u00e4r enklare, men jag avviker. Hur som helst, du kommer att m\u00e4rka att det i post-list.php-<\/strong> filen finns referenser till hj\u00e4lpfunktioner i klassen Post Query. Detta f\u00f6r att se till att jag inte exponerar f\u00f6r m\u00e5nga egenskaper och bryter mot Demeterlagen.<\/p>\n L\u00e5t oss ta en titt p\u00e5 den filen f\u00f6rst eftersom den \u00e4r den mest komplicerade<\/a> :<\/p>\n Det ser ut som den d\u00e4r vanliga WordPress-koden, men kom ih\u00e5g att eftersom den h\u00e4r filen anropas i Post Messenger<\/strong> kommer den att h\u00e4nvisa till fr\u00e5gan som den fr\u00e5ga som lindas av den klassen.<\/p>\n De tv\u00e5 sista filerna \u00e4r ganska okomplicerade. En av dem ger en beskrivning<\/a> :<\/p>\n Den andra ger ett meddelande n\u00e4r det inte finns n\u00e5gra inl\u00e4gg<\/a> :<\/p>\n Annat \u00e4n det \u00e4r den grundl\u00e4ggande funktionaliteten klar.<\/p>\n Det sista vi beh\u00f6ver g\u00f6ra \u00e4r att starta insticksprogrammet. F\u00f6r att g\u00f6ra detta \u00e4ndrar vi koden i huvudpluginfilen s\u00e5 att den ser ut s\u00e5 h\u00e4r<\/a> :<\/p>\n Det kommer att ansluta till WordPress, instansiera v\u00e5rt plugin och sedan s\u00e4tta ig\u00e5ng det. N\u00e4r du k\u00f6r det i din installation av WordPress b\u00f6r det se ut precis som det gjorde under den f\u00f6rsta versionen.<\/p>\n Den enda skillnaden \u00e4r att vi nu har saker organiserade i klasser snarare \u00e4n individuella funktioner.<\/p>\n F\u00f6r det f\u00f6rsta finns det m\u00f6jligheter till refaktorisering h\u00e4r som skulle minska frikopplingen ytterligare (som olika typer av beroendeinjektion<\/a>, etc.) men syftet med den h\u00e4r serien \u00e4r inte att t\u00e4cka det.<\/p>\n Ist\u00e4llet \u00e4r det att ta tanken p\u00e5 att se plugins skrivna av m\u00e5nga procedurfunktioner och sedan dela upp dem i mer konceptuella klasser som kapslar in deras ansvar.<\/p>\n F\u00f6r det andra, om du granskar k\u00e4llkoden i arkivet f\u00f6r den h\u00e4r versionen av projektet, kommer du att se att jag ocks\u00e5 introducerade composer.json. Detta f\u00f6r att jag ska kunna dra nytta av PHP CodeSniffer<\/a> och WordPress Coding Standards<\/a> n\u00e4r jag skriver kod.<\/p>\n I den sista delen av serien g\u00e5r vi igenom namnavst\u00e5nd<\/a> och omorganiserar filerna. Om tiden till\u00e5ter kommer vi att inkludera en autoloader s\u00e5 att vi inte beh\u00f6ver inkludera filer manuellt \u00f6verst i v\u00e5r plugin-fil.<\/p>\n Slutligen har jag slagit ihop den h\u00e4r koden till master och taggat den som 0.2.1<\/a> (eftersom jag var tvungen att g\u00f6ra en liten snabbkorrigering) eftersom det fortfarande \u00e4r ett mycket p\u00e5g\u00e5ende arbete.<\/p>\nAtt skriva kod<\/h3>\n
\n
Koden<\/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>\nUtsikterna<\/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>\nBootstrapping Plugin<\/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>\nAnteckningar<\/h2>\n
Serie inl\u00e4gg<\/h2>\n
\n