WordPress-laajennusten muokkaaminen: pieni esimerkki

Yksi tapa, jolla WordPress-laajennukset syntyvät, on se, että ainakin minun tapauksessani ne alkavat kokoelmana toimintoja, joita käytetään auttamaan tietyn projektin tiettyyn tarkoitukseen. Siitä eteenpäin ajattelet "Hei, ehkä joku muu pitää tästä hyödyllistä."

Ainakin se on ollut minun kokemukseni useammin kuin ei.

Mutta asia on, että ennen kuin julkaiset sen muiden kokeiltavaksi, haluat käydä läpi koodin puhdistamisprosessin. En myöskään puhu WordPress-laajennusten uudelleenmuodostamisesta – ainakaan vielä.

Puhun koodin ottamisesta, sen saamisesta johonkin, joka toimii WordPress-laajennuksena, ja sitten mahdollisesti koodin uudelleenmuodostamisesta.

WordPress-laajennusten muokkaaminen

Koko WordPress-laajennusten – puhumattakaan yhdestä WordPress-laajennuksesta – uudelleenmuodostusprosessin läpikäyminen voi olla työlästä, mutta laajennuksen osan uudelleenmuodostamisen jakaminen on mahdollista.

Joten aion käyttää esimerkkiä siitä, kuinka käytin jotain äskettäin (koodia on tiivistetty hieman, jotta en vaivaudu tarkentamaan tiettyä projektia).

Vaihtoehtojen ihanteellisen tuoton kartoittaminen.

Ennen kuin teet niin, mielestäni on kuitenkin tärkeää kertoa, että prosessini voi poiketa – tai todennäköisesti – poiketa sinun (koska monilla meistä on erilaisia ​​prosesseja).

1. Suunnittele komponentti (kyllä, ei edes koko laajennus) muistikirjaan,
2. Laadi tarkistuslista käyttötapauksista, joissa sen pitäisi läpäistä ja milloin sen pitäisi epäonnistua,
3. Kirjoita mitä tietoja tarvitaan, miten niitä tarvitaan ja milloin se tulisi jättää huomiotta
4. Muunna kaikki yllä oleva koodiksi.

En tietenkään muuta kaikkea kirjaimellisesti koodiksi, mutta ymmärrätte idean. Ehkä ytimekkäin tapa ilmaista se on seuraava:

• Aloita pitkällä menetelmällä, joka palvelee ihanteellista käyttötapausta. Refaktoroi sitten tämä koodi niin, että funktiot ovat pienempiä ja ota huomioon tapaukset, joissa tulos epäonnistuu.

Näin ollen koodi saattaa näyttää tältä.

1 Kirjoitus ihanteelliseen käyttöön

Tässä esimerkissä ihanteellinen käyttötapaus on, kun käyttäjä lataa vaihtoehdot, vaihtoehdot ovat läsnä ja sitten hänen on suoritettava toiminto, jos vaihtoehdoilla on tietyt arvot.

Tämän osan pitäisi olla helppolukuinen, mutta se ei ota huomioon mitään muuta kuin ihanteellinen polku koodin läpi.

2 Ota hieman puolustusta

Seuraavaksi haluan varmistaa, että asetukset on asetettu ennen kuin yritän lukea niitä. Joissakin tapauksissa saatat haluta näyttää ilmoituksen, tehdä poikkeuksen tai lokitietoja.

Tässä esimerkissä palaan vain, koska se on helppolukuinen ja sitä voidaan helpoimmin mukauttaa käyttöösi.

Joten se käsittelee vaihtoehdot, mutta entä jos vaihtoehdot on asetettu, mutta niillä ei ole odotettuja arvoja? Tämä tarkoittaa, että meidän on myös varmistettava, että ne tekevät. Ja jos ei, ohita ne, palauta, kirjaa virhe, tee poikkeus ja niin edelleen.

Tiedätkö: Sama asia kuin edellä. Paitsi tässä tapauksessa en aio tehdä mitään, ellei koodissa ole ihanteellista tietoa.

3 Pidentyä hieman

Tässä vaiheessa menetelmästä tulee hieman pitkä ja sitä on vaikeampi lukea. Tietysti, jos olet kokenut ohjelmoija, voit todeta, että "tämä on koodi, se ei ole englantia", mutta miksi et pyri tekemään siitä hieman helpompi seurata?

Lisäksi se helpottaa testaamista. Mutta se ei kuulu tämän postauksen piiriin. Ota vaihtoehtojen arviointi koodin ensimmäisenä esimerkkinä.

1. Tämä on jotain, joka voidaan päätellä sen toimintoon, joka ei vain eristä tätä tarkistusta, vaan myös helpottaa tuloksena olevaa kutsua.
2. Ota seuraavaksi toinen koodilohko, joka tarkistaa ihanteelliset vaihtoehdon arvot. Tämä voidaan myös abstraktisti samoista syistä edellä.
3. Ja lopuksi määritä funktio varmistaaksesi, että odotetut arvot on asetettu jokaiselle määritetylle arvolle :

Joten nyt sinulla on kaksi pienempää menetelmää, jotka kapseloivat saman tarkistuksen, jonka teit.

4 Viimeinen toiminto

Tässä vaiheessa lopullinen funktio on paljon helpompi lukea, koska siinä on kaksi aputoimintoa, jotka kiteyttävät heidän vastuunsa, kun taas tämä on palannut arvioimaan ihanteellista polkua koodin läpi:

Riittää, kun sanotaan, että kun kyse on WordPress-laajennusten uudelleenmuodostamisesta, tämä on vain yksi esimerkki siitä, kuinka tehdä siitä vain osa. Mutta se on alku, eikö?

Kokonaiset lisäosat?

Tiedän, eikö? WordPress-laajennusten muokkaaminen ei ole vitsi. Mutta jos aloitat tämän kaltaisilla pienillä funktioilla ja liikut vähitellen koodikannan ympäri, se helpottuu.

Ja jos käytät aikaa projektin suunnitteluun alusta alkaen, se voi säästää paljon aikaa palaamiseen ja tällaisten asioiden uudelleenkäsittelyyn.