Internationalize WordPress Plugin þinn

WordPress tappi gerir þér kleift að breyta og bæta bloggið þitt auðveldlega með því að færa nýja virkni sem er ekki í boði í grunnkóðanum.

Notkun tappa virkar betur en að reyna að breyta heildarforrituninni sem gerir WordPress. Skilgreint sem forrit eða sett af aðgerðum sem eru skrifaðar í PHP, bæta við viðbótum sérstökum eiginleikum sem auðvelt er að samþætta við bloggið með WordPress API.

Ef þú hefur skrifað WordPress tappi geturðu gert það aðgengilegri með því að þýða það á öðru tungumáli. Þetta er þekkt sem alþjóðavæðing.

Alþjóðavæðing vs staðsetning

Áður en þú getur alþjóðað tappi þína verður þú að vita hvað það þýðir. Einnig þekktur sem i18n, þetta þýðir að breyta tappi þannig að aðrar menningarheimar sem tala önnur tungumál geta auðveldlega notað tappi þína.

Staðsetning hins vegar er raunverulegt ferli breytinga.

Það er meira að alþjóðavæðingu en bara að þýða viðmótið. Til dæmis þarf að taka tillit til forsendna sem þú hefur gert um einingar í einingar og mæligildi, greinarmerki eins og að nota kommu til að aðskilja þúsundir í stað tímabils, auk annarra menningarviðfangsefna áður en þú getur rétt staðsetur vinnu þína.

Þó að þetta sé leiðarvísir sem fjallar um að undirbúa að staðsetja tappi er enn mikilvægt að halda þessum viðbótarstillingum í huga.

Lén og frumstilling

Staðsetja tappi þinn þýðir að þú þarft að koma upp með texta lén, halda hvert og eitt aðskildum frá þeim sem WordPress notar eða sem aðrir viðbætur hafa skilgreint. Hvað sem þú vilt nota fyrir texta lén er niður til þín, en þú vilt að velja eitthvað bæði einstakt og skynsamlegt, sem tengist því sem tappi þín snýst um.

Áður en þú getur fullkomlega staðsetja tappi þína þarftu að gera það að segja WordPress hvernig það getur fundið strengana þína. Ef kóðinn er ekki þegar til, verður þú að setja eitthvað eins og eftirfarandi línu í kóðann þinn:

add_action( 'init', 'myFunction' );

Þessi kóði stendur í samskiptum við WordPress til að segja frá því að nota aðgerðina sem kallast myFunction þegar það er hlaðið. Þessi aðgerð nefnir síðan texta lénið þitt í WordPress og kennir því hvernig það getur hlaðið staðbundnum strengjum sem ætti að birtast svipað og þetta:

function myFunction() {load_plugin_textdomain( 'mytextdomain', 'wp-content/plugins' );}

WordPress aðgerðin load_plugin_textdomain upplýsir WordPress að það er texti lén sem heitir mytextdomain, og skrár sem hafa staðbundnar strengir hvílir inni í miðlara möppunni wp-efni / tappi. (Auðvitað, ef þú setur tappi skrárnar í annan möppu og slóð, þá þarftu að skipta um þetta með viðeigandi slóð.)

Alþjóðlegt mynd um Shutterstock.

Undirbúningur strengja

Eftir upphafsstöðu þarftu að breyta truflanirnar í aðgerð sem leyfir WordPress að nota rétta staðbundna útgáfu þessara strenga. Eftir allt saman virkar það ekki vel að hafa WordPress röng tungumál.

Þessi aðgerð býður upp á stutt nafn sem gerir það auðvelt að alþjóðavæða: tvöfaldur-stórkostlegur virka _ (strengur, lén). Aðgerðin hefur tvær breytur, fyrsti er sjálfgefið strengurinn sem tappi notar ætti ekki að vera staðbundin útgáfa í boði. Önnur breytu er sama textalén sem þú valdir í kóðanum fyrr.

Fyrir þetta skref kann kóðinn þinn að birtast svona:

function addMyAdminPage() {add_options_page('A Page Title','A Menu Title',7, __FILE__, 'myAdminFunction' );}

Eftir að kóða hefur verið bætt við kann það að virðast svona:

function addMyAdminPage() {add_options_page(__( 'A Page Title', 'textdomain' ),__( 'A Menu Title', 'textdomain' ),7, __FILE__, 'myAdminFunction' );}

Alþjóðlegt mynd um Shutterstock.

Staðsetning

Með allri undirbúningi út af leiðinni ertu að lokum tilbúinn fyrir raunverulegt ferli til að breyta WordPress tappi á mörgum tungumálum.

Til að búa til staðsetningar fyrir tappann þinn þarf að búa til .po skrá með nafni sem líkist skráarefninu þínu og ISO 639 2 stafa bréf fyrir hvert land og tungumál. Til dæmis, ef tappi þín var kallað examplename og þú vildir að staðsetja það á spænsku (evrópskum), virðist það sem "examplename-es_ES.po".

Þó að WordPress codex býður upp á verkfæri sem geta aðstoðað við staðsetning, þá er það oft betra að einfaldlega fara með .po skrá frá einum viðbót sem upphafspunkt. .po skrár eru gerðar úr einum haus og síðan þýðingar pör:

msgid "Options"msgstr "Opciones"

The msgid er staðalstrengurinn sem birtist í tvöfalda virkni sem þú ræður fyrir. Með .po skráin búin til, getur þú notað eitt af verkfærunum sem WordPress býður upp á til að búa til .mo skrá, sem er önnur skrá sem WordPress krefst.

Leyfa öðrum þýðendum hjálp

Enginn þekkir hvert einasta tungumál, þannig að þú vilt auka auðlindir þínar og láta annað fólk hjálpa þýða yfir í önnur tungumál. Hins vegar verður þú að fara í sérstakan málsmeðferð til að búa til nauðsynlegar skrár til að gefa þýðendum þínum þar sem þú vilt ekki að þau fái upprunakóðann þinn til að brjóta fyrir slysni.

Skráin sem þú vilt gefa þýðendum er POT-skrá, sem líkist þessu:

#: wp-admin/admin-header.php:49msgid "Options"msgstr ""

Það eru tvær leiðir til að búa til þessa skrá. Ef þú hefur sett tappi inn í geymsluna skaltu bara fara á stjórnandasíðuna og velja "Búa til POT-skrá". Þessi skrá er það sem þú sendir til þýðenda til þess að staðsetja þær, þótt þú munir líklega vilja senda tappi með það, þá þurfa þýðendur ekki að spyrja þig spurninga um viðbótina.

Ef þú ert ekki með viðbótina í geymslunni ennþá getur þú heimsótt WordPress I18n verkfæri skrá og notaðu handrit makepot.php á eftirfarandi hátt:

php makepot.php wp-plugin the-plugin-directory

Hafðu í huga að þú verður að setja upp GNU alþjóðavæðingarhugbúnaðinn þinn á þjóninum þínum áður en þú keyrir þessa skipun.

Alþjóðlegt mynd um Shutterstock.

Prófun

Með öllum staðbundnum skrám þínum í staðinn er kominn tími til að prófa þær og sjá hvort eitthvað sé til sem þú gleymir. Prófaðu staðsetninguna þína þýðir að breyta einföldum línu á WordPress stillingum til þess að losa það inn í að hugsa að það ætti að nota annan skrá. Breyttu skránni wp-config og finndu eftirfarandi línu:

define ('WPLANG', 'en_US');

Ef þessi lína var ekki fyrir hendi, þá viltu tvöfalt athuga og sjá að uppsetningin þín virkar enn í lagi. Ef svo er skaltu fara aftur í skrána og breyta landinu og tungumálakóðanum. Með fyrra dæmi myndi þetta vera sem hér segir:

define ('WPLANG', 'es_ES');

Að lokum, virkjaðu tappi þína til að prófa hvernig það lítur út. Mundu að fara aftur í upphaflegu sjálfgefið tungumálið þitt þegar þú hefur lokið prófunum.

Uppfærir tappi þína

Með öllum þeim breytingum sem WordPress tekur með tímanum getur viðbótin þín ekki verið fullkomlega virk með síðari uppfærslum. Gakktu úr skugga um að þú hafir alltaf tíma til að uppfæra tappann þegar það er mögulegt. Miðað við að þú hafir það þegar hýst í WordPress Plugin Repository getur þú tekið nokkrar ráðstafanir til að bæta við nýjum eiginleikum eða uppfæra plástra við tappann þinn með tímanum. Þú getur gert þetta eins oft og þú þarft.

Þegar þú hefur lokið við að uppfæra tappi þína og vilt sleppa nýjustu útgáfunni þarftu að halda tékklista í huga:

• Prófaðu tappi þína og tryggðu að nýjasta útgáfan virki virkilega rétt. Gakktu úr skugga um að þú hafir í huga allar mismunandi WordPress útgáfur eru og prófa þær út með öllum útgáfum sem hægt er. Prófaðu einfaldlega ekki nýja eiginleika þar sem þú getur óvart brotið eldri eiginleika eins og heilbrigður.
• Fara inn í skottinu möppuna og breyttu hausinn athugasemd í helstu PHP skrá svo þú getir uppfært útgáfuna númer. Gakktu úr skugga um að þú breytir einnig útgáfunniúmerinu í readme.txt skránni í skottinu sem er í stöðugum reitnum.
• Það er alltaf skynsamlegt að búa til annan undirhluta breytingarsvæðis lesme.txt skráarinnar svo að þú getir stuttlega lýst því hvað er nýtt í nýjasta útgáfu miðað við fyrri. Hvað sem þú setur inn hér verður bætt við breytingaskrána flipann á síðunni fyrir tappann þinn.
• Gakktu úr skugga um að þú sért að búa til nýtt SVN tag sem hluta af skottinu.
• Leyfa nokkrar mínútur fyrir kerfið til að skrá nýjar breytingar og þá fara á viðbótarsíðuna þína og á blogg sem hefur nýja viðbótina þína til að staðfesta að allt sé rétt uppfært. Hafðu í huga að þessar uppfærsluathuganir geta verið afritaðar, svo það gæti verið nauðsynlegt að bíða aðeins lengur til að hægt sé að uppfæra hana að fullu.

Allt í allt er ekki mikið annað að alþjóðavæða tappi þína á mismunandi tungumálum. Svo lengi sem þú fylgir þessum skrefum vandlega geturðu staðsetið tappi þína á eins mörgum mismunandi tungumálum og þú þarft.

Hefur þú staðsetur WordPress tappi? Hvaða tungumál óskast voru oftar studdar? Láttu okkur vita í athugasemdunum.

• ← Einföld leiðarvísir til Móttækilegur ritgerð
• Firefox 16 hrun og brennur →