Kiedy usiad\u0142em, \u017ceby zacz\u0105\u0107 ten post, planowa\u0142em napisa\u0107 co\u015b o wiele bardziej zaanga\u017cowanego ni\u017c to, czym zamierzam si\u0119 podzieli\u0107. Pocz\u0105tkowo chcia\u0142em przej\u015b\u0107 przez jedn\u0105 z dw\u00f3ch rzeczy:<\/p>\n
Pierwszym z nich by\u0142oby skupienie si\u0119 na wielu innych rzeczach, o kt\u00f3rych m\u00f3wi\u0142em, powi\u0105zanie ich wszystkich razem i posiadanie ostatecznego odniesienia. Ale to jest co\u015b, na co chcia\u0142bym po\u015bwi\u0119ci\u0107 troch\u0119 czasu, aby upewni\u0107 si\u0119, \u017ce jest zrobione dobrze.<\/p>\n
Drugi to taki, kt\u00f3ry uwa\u017cam za wa\u017cny, ale jestem w fazie przej\u015bciowej z niekt\u00f3rymi moimi w\u0142asnymi narz\u0119dziami. Dop\u00f3ki tego nie zrobi\u0119, wola\u0142bym o tym nie pisa\u0107.<\/p>\n
Mimo to zawsze jest co\u015b do ukrycia, prawda? Wi\u0119c dzisiaj zdecydowa\u0142em si\u0119 na co\u015b prostszego: rozbicie u\u017cycia klas, szablon\u00f3w i podszablon\u00f3w we wtyczkach WordPress na prostym przyk\u0142adzie.<\/p>\n
W przypadku tego konkretnego tematu, natychmiastowe pytanie, kt\u00f3re mo\u017ce przyj\u015b\u0107 do g\u0142owy, jest proste: po co zawraca\u0107 sobie g\u0142ow\u0119 m\u00f3wieniem o tym?<\/p>\n
Poniewa\u017c jest rok 2018 i wci\u0105\u017c widzimy mieszank\u0119 PHP, CSS, znacznik\u00f3w i JavaScript w jednym pliku. Nie chodzi o to, aby uderza\u0107 w inne technologie, kt\u00f3re domy\u015blnie to robi\u0105 (takie jak React). M\u00f3wi\u0119 konkretnie o wtyczkach do WordPressa i pisaniu mo\u017cliwego do utrzymania kodu w taki spos\u00f3b, aby [oczywi\u015bcie] by\u0142 \u0142atwy w utrzymaniu, pisaniu i czytaniu.<\/p>\n
Za\u0142\u00f3\u017cmy, \u017ce pracujesz nad stron\u0105 podmenu dotycz\u0105c\u0105 czego\u015b, co ma si\u0119 pojawi\u0107 w menu niestandardowym. Rejestrujesz swoj\u0105 stron\u0119<\/a> za pomoc\u0105 API WordPress:<\/p>\n Ale kiedy konfigurujesz funkcj\u0119 wywo\u0142ania zwrotnego do wy\u015bwietlania strony, nie<\/strong> u\u017cywasz tej funkcji do mieszania wszystkich r\u00f3\u017cnych j\u0119zyk\u00f3w. Zamiast tego u\u017cywasz go do do\u0142\u0105czenia pliku.<\/a><\/strong><\/p>\n Zauwa\u017c, \u017ce w powy\u017cszym pliku odwo\u0142uj\u0119 si\u0119 do w\u0142a\u015bciwo\u015bci $this->pluginPath<\/strong>. Jest to ustawiane w konstruktorze klasy, dzi\u0119ki czemu mog\u0119 \u0142atwo uzyska\u0107 dost\u0119p do katalogu g\u0142\u00f3wnego wtyczki.<\/p>\n Zreszt\u0105, jak mo\u017ce wygl\u0105da\u0107 ten plik?<\/p>\n W tym przypadku zak\u0142adam, \u017ce Tw\u00f3j szablon ma dostarczy\u0107 informacji u\u017cytkownikowi i b\u0119dzie prosi\u0107 o jego wprowadzenie. Cz\u0119\u015b\u0107 b\u0119dzie odpowiedzialna za wy\u015bwietlanie u\u017cytkownikowi komunikatu o sukcesie, b\u0142\u0119dzie lub ostrze\u017cenie.<\/p>\n Aby by\u0142o to proste, staram si\u0119, aby zar\u00f3wno szablon, jak i podszablony by\u0142y jak najszczuplejsze. W tym przypadku za\u0142\u00f3\u017cmy, \u017ce wyrenderujemy stron\u0119, poprosimy u\u017cytkownika o zapisanie warto\u015bci, a je\u015bli warto\u015b\u0107 zostanie pomy\u015blnie zapisana (i dlatego istnieje w tabeli wp_options<\/strong> ), wy\u015bwietlimy komunikat o powodzeniu.<\/p>\n To znaczy:<\/p>\n Sp\u00f3jrz na kod szablonu poni\u017cej:<\/a><\/strong><\/p>\n Zauwa\u017c, \u017ce tak, ma wej\u015bcie, przycisk zapisywania i jednorazowy, z kt\u00f3rych wszystkie s\u0105 wa\u017cne (ale wykraczaj\u0105 poza zakres tego postu) do zapisywania informacji.<\/p>\n Ale zauwa\u017c, \u017ce ma funkcj\u0119 pomocnicz\u0105, kt\u00f3rej u\u017cywam do sprawdzania obecno\u015bci pomy\u015blnego zapisywania informacji. Ta funkcja znajduje si\u0119 w tej samej klasie, kt\u00f3ra odpowiada za renderowanie szablonu.<\/p>\n Wygl\u0105da to mniej wi\u0119cej tak:<\/a><\/strong><\/p>\n<?php\n\npublic function addMenuPage()\n{\n add_menu_page(\n 'Acme Menu',\n 'Acme Menu',\n 'manage_options',\n 'acme-custom-menu',\n array($this, 'display'),\n 'dashicons-dashboard',\n 30\n );\n\n add_submenu_page(\n 'acme-custom-menu',\n 'Acme Menu',\n 'Acme Menu',\n 'Acme Menu',\n 'acme-custom-menu',\n array($this, 'display')\n );\n}\n<\/code><\/pre>\n<?php\n\npublic function display()\n{\n include_once $this->pluginPath. 'views\/acme-settings.php';\n}\n<\/code><\/pre>\nSzablon i cz\u0119\u015bciowe<\/h3>\n
Szablon<\/h4>\n
\n
<?php\n\/**\n * Renders the settings page for the plugin.\n *\/\n?>\n<div class=\"wrap\">\n <h1 class=\"wp-heading-inline\"><?php echo get_admin_page_title(); ?><\/h1>\n <?php if ($this->showSuccessMessage()) { ?>\n <?php include_once 'partials\/settings-saved.php'; ?>\n ?>\n <div id=\"acme-settings-schedule\">\n <form id=\"acme-form\" method=\"post\" action=\"<?php echo esc_html(admin_url('admin-post.php')); ?>\"\">\n <!-- This is where your settings go. -->\n <p>\n <?php\n submit_button(\n 'Save',\n 'primary',\n 'acme-save-settings',\n false\n );\n wp_nonce_field(\n 'acme-save',\n 'acme-save-nonce'\n );\n ?>\n <\/p>\n <\/form>\n <\/div>\n<\/div>\n<\/code><\/pre>\nCz\u0119\u015bciowy<\/h4>\n
<?php\n\npublic function showSuccessMessage()\n{\n return (false !== get_option('acme_custom_setting'));\n}\n<\/code><\/pre>\n