Yksi asioista, joita olen ponnistellut paljon yhten\u00e4isemmin, todenn\u00e4k\u00f6isesti enemm\u00e4n kuin koskaan ennen, on huolenaiheiden erottaminen WordPressin ja ongelma-alueen kanssa ty\u00f6skentelyst\u00e4 vastaavien luokkien v\u00e4lill\u00e4.<\/p>\n
Oletetaan esimerkiksi, ett\u00e4 ty\u00f6skentelet laajennuksen parissa ja se kommunikoi kolmannen osapuolen API:n kanssa. Lis\u00e4ksi t\u00e4m\u00e4 laajennus tarjoaa my\u00f6s valikoita, viestityyppej\u00e4, taksonomioita ja niin edelleen WordPressin hallinta-alueella.<\/p>\n
T\u00e4ss\u00e4 on kaksi vastuualuetta:<\/p>\n
Voit todeta, ett\u00e4 WordPressin kanssa kommunikoivien testialueiden yhdist\u00e4minen on t\u00e4rke\u00e4\u00e4, mutta tied\u00e4n my\u00f6s, ett\u00e4 n\u00e4m\u00e4 ovat kokeiltuja ja oikeita API-liittymi\u00e4, joilla on omat testins\u00e4.<\/p>\n
Sen sijaan meid\u00e4n pit\u00e4isi keskitty\u00e4 yksikk\u00f6testaukseen ja erottaa liiketoimintalogiikkamme WordPressist\u00e4.<\/p>\n
Mutta se ei ole t\u00e4m\u00e4n postauksen tarkoitus. Sen sijaan kyse on tavasta mahdollisesti laatia projekti, kun osa siit\u00e4 on vuorovaikutuksessa WordPressin kanssa.<\/p>\n
Olen puhunut nimiavaruuksien t\u00e4rkeydest\u00e4 ja eduista aikaisemmissa viesteiss\u00e4ni, jotta en sukeltaa liian syv\u00e4lle t\u00e4h\u00e4n keskusteluun t\u00e4\u00e4ll\u00e4.<\/p>\n
Sen sijaan olen kiinnostunut keskustelemaan tiedostojen j\u00e4rjest\u00e4misest\u00e4 tiedostoj\u00e4rjestelm\u00e4tasolla ja nimiavaruuden tasolla, jotta ne erotettaisiin selke\u00e4sti erikoisaloihinsa ja jotta voimme varmistaa, ett\u00e4 esimerkiksi keskit\u00e4mme yksikk\u00f6testej\u00e4mme (ja muita testaus) kriittisimmill\u00e4 alueilla.<\/p>\n
Haluan varmistaa, ett\u00e4 hakemistoni ja tiedostorakenteeni heijastavat nimiavaruuksieni rakennetta. Toki se auttaa tiedostojen j\u00e4rjest\u00e4misess\u00e4, mutta my\u00f6s k\u00e4sitteellisess\u00e4 organisoinnissa.<\/p>\n
Eli jos aion ty\u00f6skennell\u00e4 metalaatikoiden kanssa, tied\u00e4n, ett\u00e4 l\u00f6yd\u00e4n todenn\u00e4k\u00f6isesti metalaatikkotiedostot hakemistosta, joka on sis\u00e4kk\u00e4inen WordPress<\/strong> -emohakemiston kanssa ja sitten Admin<\/strong> – alihakemistosta, jota seuraa MetaBox-<\/strong> hakemisto.<\/p>\n Milt\u00e4 sit\u00e4 varten luokkien joukko, joka on suunniteltu ty\u00f6skentelem\u00e4\u00e4n metalaatikoiden kanssa, voisi n\u00e4ytt\u00e4\u00e4, jos meid\u00e4n pit\u00e4isi kirjoittaa niille koodi uudelleen k\u00e4ytett\u00e4v\u00e4ll\u00e4 tavalla? Koska tied\u00e4mme metalaatikoista, tied\u00e4mme, ett\u00e4 tarvitsemme todenn\u00e4k\u00f6isesti seuraavan:<\/p>\n Yll\u00e4 olevat seikat huomioon ottaen hakemistorakenne voisi ehk\u00e4 n\u00e4ytt\u00e4\u00e4 t\u00e4lt\u00e4:<\/p>\n<\/p>\n Seuraavaksi meill\u00e4 on koodi, joka heijastaa t\u00e4t\u00e4 rakennetta. Eli WordPress<\/strong> -hakemistossamme olisi Admin<\/strong> – alihakemisto, koska metaruutu n\u00e4kyy WordPressin hallinta-alueella, ja meill\u00e4 olisi N\u00e4yt\u00e4<\/strong> – alihakemisto, joka sis\u00e4lt\u00e4\u00e4 tietojen n\u00e4ytt\u00e4misest\u00e4 vastaavan tiedoston.<\/p>\n T\u00e4m\u00e4n vuoksi meid\u00e4n on luotava muutama yll\u00e4 lueteltu luokka. Ehk\u00e4 abstrakti perusluokka n\u00e4ytt\u00e4isi t\u00e4lt\u00e4:<\/a><\/strong><\/p>\n Sitten konkreettinen toteutus laajentaisi luokkaa, ja se n\u00e4ytt\u00e4isi t\u00e4lt\u00e4:<\/a><\/strong><\/p>\n Ja lopuksi, luokan n\u00e4kym\u00e4 sis\u00e4lt\u00e4isi merkint\u00e4- ja mallikoodin tietojen render\u00f6inti\u00e4 varten<\/a><\/strong> :<\/p>\n T\u00e4m\u00e4 antaa meille juuri sen, mit\u00e4 tarvitsemme hyvin organisoidussa, uudelleenk\u00e4ytett\u00e4v\u00e4ss\u00e4 ty\u00f6skentelyss\u00e4 metalaatikoiden kanssa. Se voidaan my\u00f6s toistaa esimerkiksi valikoissa, viestityypeiss\u00e4, taksonomioissa ja niin edelleen.<\/p>\n Mutta poikkean.<\/p>\n Kuten aiemmin postauksessa mainitsin, uskon, ett\u00e4 yksikk\u00f6testausluokat, jotka ratkaisevat ongelmatilanteemme ainutlaatuisia ongelmia, ovat t\u00e4rkeit\u00e4. T\u00e4m\u00e4 tarkoittaa, ett\u00e4 sinun on kerrottava PHPUnit-m\u00e4\u00e4ritystiedostollesi j\u00e4tt\u00e4m\u00e4\u00e4n WordPress-keskeiset tiedostosi pois.<\/p>\n Edell\u00e4 esitt\u00e4m\u00e4ni etuna on, ett\u00e4 t\u00e4st\u00e4 tulee triviaalisen helppoa. Yksinkertaisesti sanottuna voit lis\u00e4t\u00e4 t\u00e4m\u00e4n<\/a><\/strong> phpunit.xml –<\/strong> tiedostoosi:<\/p>\n T\u00e4m\u00e4 antaa sinulle mahdollisuuden keskitty\u00e4 testien kirjoittamiseen erityisesti ongelmatilanteeseesi ja samalla varmistaa, ett\u00e4 kirjoitat skaalautuvaa, yll\u00e4pidett\u00e4v\u00e4\u00e4 ja uudelleen k\u00e4ytett\u00e4v\u00e4\u00e4 WordPress-pohjaista koodia.<\/p>\n Kirjoitan t\u00e4ll\u00e4 hetkell\u00e4 e-kirjaa (monenlaisen muun premium-sis\u00e4ll\u00f6n ohella). Jos olet kiinnostunut, katso mit\u00e4 saat<\/a>.<\/p>\n\n
<?php\n\nnamespace AcmeWordPressAdminMetaBox;\n\nabstract class AbstractMetaBox\n{\n protected $postType;\n\n public function __construct()\n {\n $this->postType = 'acme_post_type';\n }\n\n abstract public function render();\n abstract public function display();\n}\n<\/code><\/pre>\n<?php\n\nnamespace AcmeWordPressAdminMetaBox;\n\nclass AcmeMetaBox extends AbstractMetaBox\n{\n \/**\n * {@inheritdoc}\n *\/\n public function render()\n {\n add_meta_box(\n 'acme-product-image',\n 'Product Image',\n [$this, 'display'],\n $this->postType,\n 'side',\n 'default'\n );\n }\n\n \/**\n * {@inheritdoc}\n *\/\n public function display()\n {\n include_once plugin_dir_path(__FILE__).'Views\/acme-product-image.php';\n }\n}\n<\/code><\/pre>\n<div class=\"product-image-metabox\">\n <p>\n <img src=\"<?= esc_html(get_post_meta(get_the_ID(), 'product_image', true)); ?>\" alt=\"<?= esc_attr(get_the_title()); ?>\" \/>\n <input type=\"text\" value=\"<?= esc_html(get_post_meta(get_the_ID(), 'product_image', true)); ?>\" \/>\n <\/p>\n<\/div><\/code><\/pre>\nSana yksikk\u00f6testauksesta (PHPUnitilla)<\/h3>\n
<testsuites>\n <testsuite name=\"Plugin\">\n <directory>.\/tests<\/directory>\n <exclude>.\/tests\/phpunit<\/exclude>\n <exclude>.\/src\/WordPress<\/exclude>\n <\/testsuite>\n<\/testsuites><\/code><\/pre>\n