Örökölt mód eltávolítása 3. rész

A JoomlaWiki wikiből

Elérkeztünk annak a sorozatnak a 3. részéhez, amelyben bemutatjuk, hogyan kell egy meglévő komponenst átírni natív Joomla! 1.5-ös módra az örökölt mód engedélyezése nélkül. Legutóbbi alkalommal megnéztük a konfigurációs beállításokat, a JRequest osztályt és még pár egyéb dolgot. Ezúttal az adminisztrációs felületet vizsgáljuk meg.

Az eszköztár

A hibaüzenetben azt olvashatjuk, hogy a 'mosMenuBar' osztály nem található a toolbar.letterman.html.php fájlban. Ez könnyen javítható, ugyanis csak egy névváltoztatás JToolBarHelper-re. Törölhetjük a régi mosMenuBar::startTable() és mosMenuBar::endTable() metódusokat, nincs többé szükség ezekre.

Újdonság, hogy az oldalnak címet adhatunk a JToolBarHelper::title metódussal. Most az összes eszköztárnak ugyanazt a címet adjuk a következő kód használatával:

Az alapértelmezett eszköztár most így néz ki:

Elválasztókat már nem használunk többé az új stílus miatt. Ezeket eltávolíthatjuk az eszköztár metódusából. Frissítés... és... végre működik az adminisztrációs felület, ugyan sok hiányzó konstanssal, de ilyen a kezdet.

Többé nem tehetjük meg, hogy kézzel szúrunk be tábla cellákat. Sok fejlesztő ehhez hasonló kódot készített az egyedi eszköztár gombhoz:

A LetterMan tartalmaz ilyeneket, és ezeket le kell cserélni a következő kódra:

A user.png-n alapuló egyedi gomb beillesztéséhez a komponensben néhány új könyvtárat kell létrehozni:

/com_letterman
 /media
   /css
     default.css
   /images
     logo.png
     user.png</code>

A default.cssfájl a következő stílusinformációt tartalmazza:

Az icon-48-logo stílust a az eszköztár címsorában használjuk. A két icon-32 stílus az eszköztárban alkalmazódik. A stílus beépítéséhez egy helper metódust használunk, a JTHML osztály stylesheet metódusát. Ezt helyezzük az admin.letterman.php fájlba, egészen a tetejére:

Fordítások

A fordítások már nem PHP konstansokként történnek és ezért látunk sok nem definiált konstant hibát. Létezik egy JText nevű helper osztály számos statikus metódussal a fordításokhoz, mint a _ (aláhúzás) és sprintf. A JText sokkal természetesebb karaktereket is megenged, mint például a szóköz, amely különösen hasznos rövid mondatok esetén. Hosszabb szövegekhez viszont még mindig a rövidítések használata ajánlott, amely megadja a teljes leírást.

A JText használata a következőképpen néz ki:

Ennek a metódusnak az előnye, hogy a globális beállításoknál van egy hibakereső mód. Amikor engedélyezzük a "Hibakeresés a nyelvben" opciót, a rendszer egy különleges karakter közé helyezi a szavakat és mondatokat, amelyek segítenek meghatározni, hogy egy szöveghez tartozik-e fordítás vagy nem.

Ugyan eltart egy ideig, de a következő lépés, hogy megkeressük és lecseréljük az összes konstansot a JText osztály használatával, beleértve a természetesebb kifejezések használatát (hacsak nem egy hosszú leírás).

Például az eszköztárban cseréljük le az _E_SAVE-ot 'Save'-re, az _E_CANCEL-t 'Cancel-re és így tovább. Az admin.letterman.html.php-ben cseréljük le a <?php echo _SEARCH_TITLE; ?> kódot a <?php echo JText::_('Search'); ?> kódra és így tovább.

Ahogy korábban említésre került, néhány kifejezés valóban nagyon hosszú. Néhány ilyen található a LetterMan-ban is:

define( 'LM_ADD_CONTENT_TOOLTIP', 'If you select a content item from the list, a tag will be inserted into the textarea. This tag will be rendered to the full article (Into Text only with images) when clicking on Save.' );

Ebben az esetben azt tehetjük, hogy azt a jelet használjuk, mint a szerző, csak elhelyezzük egy JText hívásba:

Az utolsó lépés a nyelvi konstansokat tartalmazó fájlok eltávolítása, és lecserélése az új formátummal. A következő fájlt kell létrehoznunk:

/administator/language/eb-GB/en-GB.com_letterman.ini

Észrevehetjük, hogy ez egy ini fáj, ami azt jelenti, hogy PHP konstansok helyett az "azonosító" egyenlőségjel "leírás" formát használjuk, mint például:

Bizonyosodjunk meg, hogy az azonosítók csupa nagybetűből állnak, és hogy egyik oldal sem tartalmaz sortörést. Ezzel be is fejeződött ez a rész. Következő alkalommal az adminisztrációs felület megjelenési hibáinak javításáról lesz szó.

A cikk forrása: The Art of Joomla!