View source for Search Engine Friendly URLs/sw

<noinclude><languages /></noinclude>
<onlyinclude>
URL '''Unaofaa kwa Mashini ya Kutafuta (SEF)''', '''kuweza kusomeka na mtu yoyote''' au [[wikipedia:Clean_URL|clean URLs]] ni ma URL yote ambayo yanaweza kusomeka na mtu yoyote na mashini za kutafuta, kwa sababu yanaeleza njia za kila ukurasa halisi kwa kila namna. Tangu toleo 1.5,  Joomla! ina uwezo wa kutengeza na kuchambua URL na fomati zozote, hatakama ni SEF URL. Hii haita tegemea na seva ambayo unarekebisha URL, kwa hivyo itafanya hatakama Joomla! inaendesha kwa seva nyingine zaidi ya Apache ilio na moduli wa mod_rewrite. SEF URL zitafuata patani fulani za kudumu, lakini mtumiaji anaweza kufafanua [[S:MyLanguage/Alias|maandishi mafupi ya maelezo (alias)]] kwa kila kitengwa cha URL.

Ndani, ni sehemu ya kawaida ya SEF URL (ni sehemu baada ya jina la kikoa) linaitwa '''njia (route)'''. Usindikaji na utengezaji wa SEF URL huu unajulika kama '''kuruta (routing)''', na kodi inayohusika inaitwa '''ruta (router)'''.
</onlyinclude>
Mfano mzuri wa kuruta  ni URL wa makala "Karibu  kwa Joomla!" katika data za sampuli

* Bila ya kuwasha SEF URL, URL ni <code><nowiki>http://www.example.com/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki></code>
* Ukiwasha SEF URL na ukizima mod_rewrite, ni <code><nowiki>http://www.example.com/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki></code>
* Ukiwasha SEF URL pamoja na mod_rewrite, ni <code><nowiki>http://www.example.com/the-news/1-latest-news/1-welcome-to-joomla</nowiki></code>

URL unaofaa kwa mashini ya kutafuta (SEF URL) unaweza kuamilishwa kwa kuwashwa chaguo la '''URL Unaofaa kwa Mashini ya Kutafuta (SEF URL)''' katika ''Usanidi wa kidunia''. Chaguo hili la difoti ni tangu Joomla! 1.6. Angalia [[S:MyLanguage/Enabling Search Engine Friendly (SEF) URLs|Kuwezesha URL Unaofaa kwa Mashini ya Kutafuta (SEF URL)]] kwa maelezo zaidi.

== FAQs ==

=== Nambari katika URL zinamaanisha nini? ===
Ni kulinganisha URL wa zamani na URL mpya ndio utaona nambari za zamani za URL,

<pre><nowiki>http://www.example.com/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki></pre>

Na pia kwa URL mpya ni:

<pre><nowiki>http://www.example.com/the-news/1-latest-news/1-welcome-to-joomla</nowiki></pre>

Nambari hizi ni za maparamita yanayohitajika kwa Joomla! kuweza kupata URL wa ndani na kuonyesha kurasa unazotaka kuona. (Kwa kesi hii, nambari za kwanza ni kitamulisho cha jamii, nambari za pili ni kitambulisho cha makala.)

=== Hakuna <code>index.php</code> kwa URL tena. Unaweza kufuta faili hii sasa? ===
Sio! URL pengine hauna <code>index.php</code> tena, lakini ndani ya mod_rewrite utakuelekeza kwa njia pekee kabla ya ku kuonyesha wewe.

=== Ni nini thamani ya [[S:MyLanguage/Alias|Jina bandia]]? Na ina tengezwa vipi? ===
Jina bandia limeorodheshwa chini ya eneo la kichwa cha Makala, Majamii, Vitu vya Menyu na Sehemu. Joomla! itakutengezea moja kwa moja majina ya bandia yako. Matengezaji ya bandia yanaanza na kitchwa. Maherufi makubwa yote yatabadilishwa kuwa maherufi madogo. Nafasi na herufi maalum haziruhusiwi katika URL; zitabadilishwa kwa madashi

===  Nataka kutaja thamani yangu kwa jina bandia. ===
Ikiwa hupendi jina bandia lililopeanwa na Joomla!, unaweza kuweka thamani unazopendelea katika eneo hili. Wengi wanaamini kuwa kutumia maneno muhimu mazuri yatasaidia uboreshaji kwa mashini ya kutafuta (search engine optimisation, SEO). Unaweza kufanya hivi kwa kuongeza haya maneno muhimu katika kichwa chako na kuruhusu Joomla! kutengeza jina bandia, ama kwa kutengeza jina bandia wewe mwenyewe.

=== How is Alias used in a URL? ===
For a menu item, Joomla! uses the alias as the URL slug. Assume that you use the first two SEF URL options and you create a menu item called Products. Your URL would be example.com/products.

Joomla! pia inatumia mathamani ya msingi ya funguo za data ndani ya URL kwa kusaidia ruta kurambaza katika ukurasa wa sawa. Kuendela na mfano wa yaliopita, ikiwa kitu chako cha menyu cha Mazao kilikuwa kwa makala/blogi ya jamii, kiungo kwa Kichwa cha Makala na/au kiungo cha Soma Zaidi chako kitakuwa na sehemu tatu.

* URL wa kitu cha menyu - mfano.com/mazao;

* Na funguo ya msingi kwa Jamii na Jina Bandia la Jamii - 32-matunda;

* Na funguo ya msingi kwa Makala na Jina Bandia la Makala - 1-tufaha;

URL kamili ni: <code><nowiki>http://mfano.com/mazao/32-tunda/1-tufaha</nowiki></code>

=== Ni vipi naweza kuwachana na nambari ndani ya SEF URL? ===
Nambari ndani ya SEF URL zinahitajika na ruta ya Joomla! kwa kujua ni vipi kuelekeza trafiki ya wavuti. Baadha ya mawazo ya ruta ni utulivu, maplugin rahis ya mkono wa tatu yanaweza kuendelezwa kwa kuongeza uwezo kwa kuruhusi machaguo zaidi. Wakati huo, kuna uwezekano nambari kutolewa kutoka kwa URL.

== Mafomati ya njia na ufudi wa kuruta ==

''Sehemu hii inaeleza utaratibu wa kuruta na kiini cha Joomla! (umejengwa ndani). Ukiruta viendelezo, unaweza kubadilisha namna ya tengeza manjia katika mfumo wako.''

=== Fomati za njia ===

Kueleza undani wa utaratibu wa kuruta wa Joomla!, nilazima kwanza tuelewe ya ndani na ni vipi tunaitisha '''njia'''. Kudhani kuwa Joomla! imesakinishwa katika <code><nowiki>http://mfano.com/wavuti/kwanza/</nowiki></code>.  Njia ya usakinishaji ya kawaida inaitwa '''URL wa kimsingi'''. Mfano unaowezekana kwa URL ni <code><nowiki>http://mfano.com/wavuti/kwanza/mazao/32-tuna/1-tufaha</nowiki></code>. Sehemu ya kwanza ya URL huu ni URL wa kimsingi, na isipokuwa Joomla! haku ruta  komponenti yoyote inaweza kutengeza URL na sehemu ya kwanza tofauti. Sehemu ya pili, <code>mazao/32-tuna/1-tufaha</code>, ni '''njia''' yenye '''vipande''' vitatu.

Kipande cha kwanza cha njia, ya ma URL ya kawaida, ni jina bandia la kitu cha menyu. Inasema kuwa SEF URL '''utarutwa kupitia''' hiki kitu cha menyu. Vipande vyote vinaamuwa na ruta ya komponenti ambayo inapeana aina ya kitu cha menyu. Kwa mfano, aina ya kitu cha menyu ''Jamii - Blogi'' inapeanwa na komponenti ya [[S:MyLanguage/Content|Yaliomo]], na kwa hivyo ruta ya komponenti hii ina mamlaka kwa kutengeza na kupambua vipande vilivyobaki.

Pia inawezekana (kwa viendelezo) kuuliza mfumo kwa kutengeza njia bila ya kuleta kitu cha menyu kwa kupitia njia. Kwa kesi hiyo, kawaida mfumo utaamua kutengeza njia maalum ambayo ina neno <code>komponenti</code> kama kitengwa cha kwanza. njia hizi zinatengezwa kwa kutumia fomati ya kudumu: jina la komponenti (bila <code>com_</code>) linatumika kama kitengwa cha pili na maparamita yoyote kama vitengwa vingine.

=== Mipaka ===

Ni muhimu kukumbuka kuwa kutengeza kitu cha menyu ni njia ''pekee'' wa mtumiaji wa Joomla! kufafanua njia ambayo inafika kwa komponenti maalum. Kwa vyovyote, inavyowezekana kutengeza njia ambayo haionyeshi wavuti (ndani ya menu). Mbinu na kila mara ni kutengeza kitu cha menyu ndani ya menyu hakionekani popote. Kwa kawaida, menyu hii inaitwa [[S:MyLanguage/Menu|menyu ya kujificha]].

Aya ya yaliopita inadokeza kuwa haitawezekana kuweka komponenti moja kuwa na mamlaka ya shuguli ya njia zote. Kwa mfano, haitawezekana kubayana kuwa URL <code><nowiki>http://mfano.com/jinabandia</nowiki></code> utaonyesha kitu cha Yaliomo na jina bandia <code>jinabandia</code>, ambapo <code>jinabandia</code> linaweza kuwa neno lolote. Ikiwa unatakiwa kufanya hivi kwa idadi chache za makala, unaweza kutengeza kwa mkono vitu vya menyu kwa hivi. Vinginevyo, unatakiwa uwe na kiendelezo kinachopitia.

Njia za kiufundi sio  urahisi  wa watumiaji kuwa wakati mwengine wanaweza kuhitaji. Kwa upande mwegine, kuna faida moja kubwa: itapunguza utandu wa nafasi za njia (njia ambazo ungeelekeza kwa kurasa mbili tofauti). Kwa njia ya kitengwa cha kwanza, kila mara kwa kitu cha menyu cha jina bandia, mfumo utajua mara moja kuwa ni makomponenti gani lazima ya changanuliwe kwa kuruta.

== Maelezo ya utekelezaji == 
=== Kushugulika na Njia ===

''Sehemu hii inaeleza utekelezaji wa kupanga njia. Ikiwa wewe ni muendelezaji wa komponenti, angalia [[S:MyLanguage/Supporting SEF URLs in your component|Kusaidizi SEF URL katika komponenti yako]].''

Njia za Joomla zinaongezwa na zinatatuliwa kwa [[S:MyLanguage/JRouter|darasa la JRouter]]. Darasa  hili la komponenti linaonekana katika mzizi wa komponenti inayo fanya kazi hivi sasa (specified in the <code>option</code> parameter in the query string) na pamoja na <code>router.php</code> Saraka ya faili ya mzizi wa komponenti. Na itaita kazi moja kutoka kwa mbili, kazi moji ni ya kutengeza URL wa SEF na nyengine ni kutafsiri URL wa SEF.

Darasa la  JRouter limeandikwa na Joomla CMS katika <code>/includes/router.php</code>. Katika faili hii ni kutengeza na kuchanganua kazi zilizoandikwa kwa makini, na kupambua ma URL ya Joomla ya CMS.

Faili ya <code>router.php</code> katika kila komponenti (kwa mfano, <code>/components/com_content/router.php</code>) lazima ziwe na kazi mbili zifwatazo:
* ContentBuildRoute – hii inatengeza SEF URL
** Maparamita
*** $query – hii ni array (na jina) yenye mageuzo ya querystring
** Marudisho: array ya kitengwa ambacho kila kitengwa kimetengwa kwa herufi '/' ambazo baadaye zitaingilia pamoja na kutengeza URL halisi (vitu katika array si lazima viwe na herufi '/')
* ContentParseRoute – hii itatafsiri SEF URL
** Maparamita
*** $segments - Hii ni array ambayo iwe na kitengwa cha URL ulio ombwa.
** Marudisho: jina => array ya thamani ya mageuzo ya querystring ambapo kiungo kinaelekeza

=== Plugin ya SEF ===
Plugin ya Joomla ya ''Mfumo wa SEF'' unarithi <code>JPlugin</code> na unaelekeza kazi ya <code>onAfterRender()</code>. Katika kazi hii, mwili wa jibu, ambao utatumwa katika kisakuzi, utakachotowa kwa kutumia <code>JResponse::getBody()</code>. Tena mwili wa jibu utatafutwa kwa viungo vyenye <code>/index.php...</code>, na vitabadilishwa na URL ulio sahihi wa SEF kwa kuitwa <code>JRoute::_(''url'')</code>.

JRoute inajenga SEF URL kwa kupeana amri kwa jambo la <code>JRouter</code> na kuomba ijenge kiungo cha sawa cha URL.

=== Kushugulisha SEF URL ===
Kwa difoti, SEF URL zinazoshugulika na kitu cha <code>JRouterSite</code> (kutoka kwa <code>/includes/router.php</code>) na inaita kuito na mwito kwa <code>JApplication::route()</code> ndani ya index.php. Mwito huu unafanya kwa mageuko ya <code>$app</code> mifano ambayo ni ya ukweli ya <code>JSite</code> (kutoka <code>/includes/application.php</code>).

<code>JApplication::route()</code> ina tokeo lisiloharibu katika array ya <code>$_GET</code>. Inamaanisha kuwa <code>JApplication::route()</code> itaweka mageuko ndani ya <code>$_GET</code> kwa  kuita <code>JRequest::set()</code> na kuinandika bendera na kuiweka kiuwongo. Kwa hivyo, ikiwa mabadiliko ya jina yataregeshwa kutoka kwa <code>JRouter::route()</code> ambayo tayari yako ndani ya <code>$_GET</code>, haitaweka thamani hii kwa <code>$_GET</code>. Hii itaruhusu kwa njia za kidesturi.

=== Njia za kidesturi ===
Joomla itakuruhusu kutengeza mwenyewe njia zako za kiufundi. Kwa kutengeza kiufundi huu, nilazima uwe na plugin ambayo inaandika  kazi ya <code>JPlugin::onAfterInitialise()</code>. Tena kazi hii itapambua URL na itatengeza mabadiliko yanayotakiwa katika <code>$_GET</code> kabla ya njia za kawaida za Joomla kufanyika.

''Kwa mfano, angalia [[S:MyLanguage/Creating a System Plugin to augment JRouter|Kutengeza plugin ya mfumo kwa kuongeza JRouter]].''

[[Category:Search Engine Friendly URLs/sw|URL Unaofaa kwa Mashini ya Kutafuta (SEF URLs)]]