{"id":231128,"date":"2022-12-13T13:10:00","date_gmt":"2022-12-13T10:10:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=231128"},"modified":"2022-12-13T13:10:21","modified_gmt":"2022-12-13T10:10:21","slug":"wordpress-widgetit-oliolaehtoeinen-laehestymistapa","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fi\/wordpress-widgetit-oliolaehtoeinen-laehestymistapa\/","title":{"rendered":"WordPress-widgetit: oliol\u00e4ht\u00f6inen l\u00e4hestymistapa"},"content":{"rendered":"\n

Vuosia sitten loin WordPress Widget Boilerplaten<\/a><\/strong>, jonka tavoitteena on olla seuraava:<\/p>\n

\n

J\u00e4rjestetty, yll\u00e4pidett\u00e4v\u00e4 pohjalevy widgetien rakentamiseen WordPressin parhaiden k\u00e4yt\u00e4nt\u00f6jen avulla.<\/p>\n<\/blockquote>\n

Sen j\u00e4lkeen Widgets-sovellusliittym\u00e4ss\u00e4<\/a><\/strong> (jota tarkastelemme my\u00f6hemmin t\u00e4ss\u00e4 viestiss\u00e4) ei ole juurikaan muuttunut, mutta se, mit\u00e4 pid\u00e4n "parhaina k\u00e4yt\u00e4nt\u00f6in\u00e4", on muuttunut. Lis\u00e4ksi se, miss\u00e4 m\u00e4\u00e4rin t\u00e4m\u00e4 API on mielest\u00e4ni vakaa esimerkki johdanto olio-ohjelmointi WordPressiss\u00e4 on korkea.<\/p>\n

Se ei johdu siit\u00e4, ett\u00e4 se k\u00e4ytt\u00e4\u00e4 paljon oliopohjaisia \u200b\u200bperiaatteita, ei siksi, ett\u00e4 se k\u00e4ytt\u00e4\u00e4 nykyaikaisia \u200b\u200bstandardeja (ainakin nykyaikaisen PHP:n osalta), vaan siit\u00e4, ett\u00e4 se k\u00e4ytt\u00e4\u00e4 muutamia asioita, jotka auttavat meit\u00e4 tunnistamaan muutamia, esimerkiksi signaalit WordPressin olio-ohjelmoinnista.<\/p>\n

Ja t\u00e4t\u00e4 ei pid\u00e4 aliarvioida: Jos etsit esimerkkej\u00e4 olio-ohjelmoinnista WordPressiss\u00e4, etsi sit\u00e4 k\u00e4ytt\u00e4vi\u00e4 sovellusliittymi\u00e4.<\/p>\n

Lis\u00e4ksi, jos etsit tapoja mitata omaa tasosi koodinpalan arvioinnissa (puhumattakaan koodipohjasta) luokkien ja joidenkin OOP:n edistyneempien ominaisuuksien k\u00e4ytt\u00f6\u00e4 varten, miksi et hankkisi jonkinlaista lakmustestill\u00e4 n\u00e4hd\u00e4ksesi kuinka voit?<\/p>\n<\/p>\n

Ja Widgets API tekee juuri sen.<\/p>\n

WordPress-widgetit: Johdanto<\/h2>\n

Joten pienemm\u00e4ss\u00e4 sarjassa kuin edellisess\u00e4, aion tarkastella Widgets API:a ja tehd\u00e4 muutamia asioita:<\/p>\n

    \n
  1. n\u00e4ytt\u00e4\u00e4 sinulle widgetin perusrungon ja miksi se on oliosuuntautunut,<\/li>\n
  2. keskustella siit\u00e4, mit\u00e4 asioita sinun pit\u00e4isi pysty\u00e4 huomaamaan ja miksi,<\/li>\n
  3. p\u00e4ivit\u00e4 Widget Boilerplate ensin suoraan t\u00e4lle sivustolle ja siirr\u00e4 se sitten GitHubiin,<\/li>\n
  4. rakentaa widget API:n avulla, jonka pohjana on ty\u00f6mme.<\/li>\n<\/ol>\n

    Ja t\u00e4ss\u00e4 viestiss\u00e4 aloitamme ensimm\u00e4isest\u00e4 yll\u00e4 olevasta kohdasta.<\/p>\n

    Mutta ensin\u2026<\/h3>\n

    Ennen kuin siirryt t\u00e4h\u00e4n postaukseen, suosittelen lukemaan seuraavat viestit:<\/p>\n

      \n
    1. Kaksi olio-ohjelmoinnin pilaria: Osa 1\/2<\/a><\/strong><\/li>\n
    2. Olio-ohjelmoinnin kaksi pilaria: Osa 2\/2<\/a><\/strong><\/li>\n
    3. Abstract Classes, Osa 1 \u2013 Abstraktiok\u00e4ytt\u00e4ytyminen<\/a><\/strong><\/li>\n
    4. Abstraktit luokat, osa 2 \u2013 Abstraktit luokat ja k\u00e4ytt\u00f6liittym\u00e4t<\/a><\/strong><\/li>\n<\/ol>\n

      Kun olet valmis (tai jos sinusta tuntuu, ett\u00e4 sinulla on jo k\u00e4sitys aiheista), olemme valmiita l\u00e4htem\u00e4\u00e4n.<\/p>\n

      [rajoita maksettua ="true"]<\/p>\n

      Widgets API:n perusteet<\/h2>\n

      Jos luet Widgetien k\u00e4sikirjasivun, n\u00e4et paljon sis\u00e4lt\u00f6\u00e4. T\u00e4m\u00e4 on hyv\u00e4 asia, mutta se ei ole aina paras tapa, kun yrit\u00e4t tislata sis\u00e4lt\u00f6\u00e4 itsellesi kaltaiselle yleis\u00f6lle, kun etsit k\u00e4yt\u00e4nn\u00f6llisi\u00e4, olio-ohjeita.<\/p>\n

      Joten aion poimia asiaankuuluvat osat API-dokumentaatiosta ja soveltaa niit\u00e4 sitten my\u00f6s toimittamiimme koodiin.<\/p>\n

      Mik\u00e4 on widget?<\/h3>\n

      Luulen, ett\u00e4 useimmat meist\u00e4, jotka ty\u00f6skentelev\u00e4t WordPressin kanssa, tiet\u00e4v\u00e4t, mik\u00e4 widget on, mutta on t\u00e4rke\u00e4\u00e4 m\u00e4\u00e4ritell\u00e4 termi, jotta me kaikki ty\u00f6skentelemme saman idean pohjalta. K\u00e4sikirjassa lukee:<\/a><\/strong><\/p>\n

      \n

      Widget on PHP-objekti, joka tulostaa jonkin verran HTML-koodia. Samanlaista widgeti\u00e4 voidaan k\u00e4ytt\u00e4\u00e4 useita kertoja samalla sivulla (esim. Tekstiwidget). Widgetit voivat tallentaa tietoja tietokantaan (asetustaulukkoon).<\/p>\n<\/blockquote>\n

      Kun t\u00e4m\u00e4 on paikallaan, katsotaanpa mukautetun widgetin koodia, ainakin osa siit\u00e4, ja katsotaan, mit\u00e4 voimme saada selville sen oliosuuntautuneisuudesta.<\/p>\n

      Widget-luokka<\/h3>\n

      Ennen kuin edes katsomme koodia, tied\u00e4mme, ett\u00e4 siell\u00e4 on jonkin verran olio-ohjelmointia, koska dokumentaatio k\u00e4skee meit\u00e4 tekem\u00e4\u00e4n kolme asiaa:<\/p>\n

        \n
      1. Luo widgetin luokka laajentamalla WP_Widget<\/a> -standardin luokkaa ja joitakin sen toimintoja.<\/li>\n
      2. Rekister\u00f6i widgettisi, jotta se on k\u00e4ytett\u00e4viss\u00e4 Widgetit<\/strong> – n\u00e4yt\u00f6ss\u00e4.<\/li>\n
      3. Varmista, ett\u00e4 teemassasi on v\u00e4hint\u00e4\u00e4n yksi widget-alue<\/a><\/strong>, johon voit lis\u00e4t\u00e4 widgetej\u00e4.<\/li>\n<\/ol>\n

        T\u00e4ss\u00e4 viestiss\u00e4 aion keskitty\u00e4 ensimm\u00e4iseen kohtaan (tosin lopulta p\u00e4\u00e4semme siihen, kuinka esittelemme widgetimme teemaan ennen sarjan p\u00e4\u00e4ttymist\u00e4).<\/p>\n

        Laitetaan siis koodi<\/a><\/strong> sellaisena kuin se on esitetty dokumentaatiossa ja puhutaan siit\u00e4, mit\u00e4 voimme oppia siit\u00e4:<\/p>\n

        <?php\nclass AcmeWidget extends WP_Widget \n{ \n    public function __construct() \n    {\n    }\n\n    public function widget($args, $instance) \n    {\n    }\n\n    public function form($instance)\n    {\n    }\n\n    public function update($newInstance, $oldInstance)\n    {\n    }\n}<\/code><\/pre>\n
        Ensinn\u00e4kin huomaamme, ett\u00e4 vaikka m\u00e4\u00e4rittelimme luokan (jolle voimme nimet\u00e4 mit\u00e4 haluamme, minun tavallani), sen on laajennettava WP_Widget<\/strong>. T\u00e4m\u00e4 tarkoittaa, ett\u00e4 WordPress-ytimess\u00e4 on WP_Widget-<\/strong> luokka. Voit tarkastella l\u00e4hdekoodin hyvin organisoitua erittely\u00e4 t\u00e4ll\u00e4 sivulla.<\/a><\/strong><\/p>\n
        Toiseksi avainsana laajenee<\/strong> osoittaa, ett\u00e4 k\u00e4yt\u00e4mme PHP<\/a><\/strong> -perint\u00f6\u00e4, joka on olioohjelmoinnin peruspilari.<\/p>\n
        Kolmanneksi meid\u00e4n on toteutettava nelj\u00e4 funktiota, joista kaksi vaatii argumentteja. Toiminnot, jotka meid\u00e4n on toteutettava, ovat seuraavat:<\/p>\n