Letöltés Kipróbálás
  1. Fórum
  3. Joomla!
  5. Nyelvkezelés és lokalizáció
  7. Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma?

question-circle Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma?

Több
2016 nov. 23 12:11 #1 Írta: Zotius
Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma? téma létrehozva Zotius által
Régóta próbálkozom egyes komponensek, beépülők, stb nyelvi fájljainak önálló telepítőjét elkészíteni, sajnos sikertelenül.
Az ugyebár elég snassz, hogy leírom a kedves júzernek, hogy pl. a Phoca Guestbook, Phoca Gallery, Phoca Download magyar nyelvi fájljait, ha utólag akarja azokat "magyarítani", akkor töltse fel az alábbi két fájlt
hu-HU.com_phocaguestbook.ini
hu-HU.com_phocaguestbook.sys.ini
a [gyökér]/languages és az administrator/languages mappába.
Sokkal elegánsabb lenne a két-két nyelvi fájl mellé egy install.xml fájlt tenni, amellyel a Joomla tudhatná, mit keztjen a két fájllal.
Az install.xml tartalmát sajnos eddig nem sikerült elkészítenem, feltöltéskor/telepítéskor mindig valami gondja van, hol ilyen, hol olyan hibaüzeneteket ír ki.

Szeretném már végre tudni, hogyan kell egy "szabványos" install.xml fájlt elkészíteni?

Itt van például a Phoca Guestbook magyar nyelvi fájljaihoz készített xml:
<extension method="upgrade" type="language" version="3">
<files folder="site">
	<filename>hu-HU.com_phocaguestbook.ini</filename>
	<filename>hu-HU.com_phocaguestbook.sys.ini</filename>
</files>
<languages>
	<language tag="hu-HU" client="site">language/hu-HU/hu-HU.com_phocaguestbook.ini</language>
	<language tag="hu-HU" client="site">language/hu-HU/hu-HU.com_phocaguestbook.sys.ini</language>
</languages>
<administration>
	<files folder="admin">
		<filename>hu-HU.com_phocaguestbook.ini</filename>
		<filename>hu-HU.com_phocaguestbook.sys.ini</filename>
	</files>
	<languages>
		<language tag="hu-HU">language/hu-HU/hu-HU.com_phocaguestbook.ini</language>
		<language tag="hu-HU">language/hu-HU/hu-HU.com_phocaguestbook.sys.ini</language>
	</languages>
</administration>
Tesztelve a telepítést, az alábbi hibaüzenet jön:


A Phoca oldaláról letöltve egy nyelvi fájl készletet - alábbi példában épp az ukrán nyelvet -, abban például így volt kódolva:
<?xml version="1.0" encoding="UTF-8" ?>
<extension type="file" method="upgrade" version="3.0">
	<name>Phoca Guestbook component - Український переклад</name>
	<version>2.0.7</version>
	<creationDate>02.05.2014</creationDate>
	<author>surrge</author>		
	<authorUrl>madsurrge[at]maildotru</authorUrl>
	<license>GNU/GPL version 2</license>
	<description>
		<![CDATA[
			<div class="alert alert-info left" style="text-align: left;">
			<p><strong>Український переклад </strong>для Phoca Guestbook 2.0.7 (uk-UA.com_phocaguestbook)</p>
			<p><strong>Мова:</strong> Українська</p>
			<p><strong>Автор:</strong> surrge</p>
			<p><strong>Версія Joomla:</strong> 2.5</p></div>
        ]]>
        </description>
	<fileset>
		<files target="language/uk-UA">
			<filename>uk-UA.com_phocaguestbook.ini</filename>
			<filename>uk-UA.com_phocaguestbook.sys.ini</filename>
		</files>
		<files target="administrator/language/uk-UA">
			<filename>uk-UA.com_phocaguestbook.ini</filename>
			<filename>uk-UA.com_phocaguestbook.sys.ini</filename>
		</files>
	</fileset>
</extension>
Mondanom sem kell, az ebben lévő <fileset></fileset> tag közötti szakaszban megadottak szerint sem volt jó. Igaz, ez elég régi, 2014-es.
Újabbat meg nem találtam a Joomla 3.6.x-hez.
Ha hasznos volt a hozzászólásom számodra, nyugodtan megnyomhatod lent a „Köszönet” gombot :)
Skype: zotius
Mellékletek:

Jelentkezz be, hogy te is részt vehess beszélgetésben!

Több
2016 nov. 23 23:09 #2 Írta: Balázs
Balázs válaszolt a következő témában: Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma?
A Joomla! magyar nyelvi csomag telepítő xml-jének tanulmányozását javaslom elsőként. :)
Ha bizalmas információt szeretnél közölni az adminokkal, akkor tedd az üzeneted tartalmát a [ confidential ][ /confidential ] címkék közé (szóközök nélkül).

Joomla! tanácsadás, oktatás, fejlesztés - joomlabs.hu

Jelentkezz be, hogy te is részt vehess beszélgetésben!

Több
2016 nov. 24 10:51 - 2016 nov. 24 10:53 #3 Írta: Zotius
Zotius válaszolt a következő témában: Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma?

Balázs írta: A Joomla! magyar nyelvi csomag telepítő xml-jének tanulmányozását javaslom elsőként. :)

Megtörtént. Hát, mit mondjak, az egy kissé túl van bonyolítva, és végül mégis hibára futott... :D
A magyar nyelvi csomag felépítésének megfelelően elkészítve az alábbiak szerint raktam össze a zip fájlt:

pkg_hu-HU.xml
<?xml version="1.0" encoding="UTF-8" ?>
<extension type="language" version="3.6" method="upgrade">
	<name>Phoca Vendégkönyv magyar nyelvi fájlok</name>
	<packagename>pkg_hu-HU</packagename>
	<tag>hu-HU</tag>
	<version>3.0.5</version>
	<creationDate>2016-11-22</creationDate>
	<author>Balázs Zoltán</author>
	<authorEmail />
	<authorurl />
	<copyright />
	<license />
	<packager>Balázs Zoltán</packager>
	<packagerurl />
	<description>
	<![CDATA[ ... ]]>
	</description>
	<files>
		<folder type="language" client="site" id="hu-HU">site</folder>
		<folder type="language" client="administrator" id="hu-HU">admin</folder>
	</files>
</extension>

benne 2 mappa:
/admin_hu-HU
/site_hu-HU

a mappákban a fájlok nincsenek tömörítve.
admin mappában:
install.xml
<?xml version="1.0" encoding="UTF-8" ?>
<extension type="language" version="3.6" method="upgrade">
	<name>Phoca Vendégkönyv magyar nyelvi fájlok</name>
	<packagename>pkg_hu-HU</packagename>
	<tag>hu-HU</tag>
	<version>3.0.5</version>
	<creationDate>2016-11-22</creationDate>
	<author />
	<authorEmail />
	<authorurl />
	<copyright />
	<license />
	<packager>Balázs Zoltán</packager>
	<packagerurl />
	<description>
	<![CDATA[ ... ]]>
	</description>
	<files target="administrator/language/hu-HU">
		<filename>hu-HU.com_phocaguestbook.ini</filename>
		<filename>hu-HU.com_phocaguestbook.sys.ini</filename>
	</files>
</extension>

hu-HU.xml
<?xml version="1.0" encoding="utf-8"?>
<metafile version="3.6" client="administrator">
	<name>Hungarian</name>
	<version>3.0.5</version>
	<creationDate>2016-11-22</creationDate>
	<author />
	<authorEmail />
	<authorurl />
	<copyright />
	<license />
	<description>
	<![CDATA[ ... ]]>
	</description>
	<metadata>
		<name>Magyar</name>
		<tag>hu-HU</tag>
		<rtl>0</rtl>
		<locale>hu_HU.utf8, hu_HU.UTF8, hu_HU.utf-8, hu_HU.UTF-8, hun_HU.utf8, hun_HU.UTF8, hu, hungarian, hungary</locale>
		<firstDay>1</firstDay>
		<weekEnd>0,6</weekEnd>
	</metadata>
	<params />
</metafile>
a két telepítendő fájl:
hu-HU.com_phocaguestbook.sys.ini
hu-HU.com_phocaguestbook.ini

A site mappában:

install.xml
<?xml version="1.0" encoding="UTF-8" ?>
<extension type="language" version="3.6" method="upgrade">
	<name>Phoca Vendégkönyv magyar nyelvi fájlok</name>
	<packagename>pkg_hu-HU</packagename>
	<tag>hu-HU</tag>
	<version>3.0.5</version>
	<creationDate>22/11/2016</creationDate>
	<author>Balázs Zoltán</author>
	<authorEmail>zotius@t-online.hu</authorEmail>
	<authorurl>http://zotius.hu</authorurl>
	<copyright>Copyright (C) 2005 - 2016 Open Source Matters, Inc. All rights reserved.</copyright>
	<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
	<packager>Balázs Zoltán</packager>
	<packagerurl>http://zotius.hu</packagerurl>
	<description>
	<![CDATA[ ... ]]>
	</description>
	<files target="language/hu-HU">
		<filename>hu-HU.com_phocaguestbook.ini</filename>
		<filename>hu-HU.com_phocaguestbook.sys.ini</filename>
	</files>
</extension>

hu-HU.xml
<?xml version="1.0" encoding="utf-8"?>
<metafile version="3.6" client="site">
	<name>Hungarian (hu-HU)</name>
	<version>3.0.5</version>
	<creationDate>2016-11-22</creationDate>
	<author />
	<authorEmail />
	<authorurl />
	<copyright />
	<license />
	<description>
	<![CDATA[ ...	]]>
	</description>
	<metadata>
		<name>Magyar</name>
		<tag>hu-HU</tag>
		<rtl>0</rtl>
		<locale>hu_HU.utf8, hu_HU.UTF8, hu_HU.utf-8, hu_HU.UTF-8, hun_HU.utf8, hun_HU.UTF8, hu, hungarian, hungary</locale>
		<firstDay>0</firstDay>
		<weekEnd>0,6</weekEnd>
	</metadata>
	<params />
</metafile>

a két telepítendő fájl:
hu-HU.com_phocaguestbook.sys.ini
hu-HU.com_phocaguestbook.ini

Telepítés után a hibaüzenet:




És íme, a legegyszerűbb, de mégis sikeres módszer:

A két telepítendő fájl mellé elég volt csak egy (!) aprócska install.xml fájlt tenni, az alábbi tartalommal. A lényeg talán az extension type="file" sorban van elrejtve, így nem kellettek tovább mappák, xml fájlok, semmi hókusz-pókusz, és a files target="language/hu-HU" tag-ben meg van adva a telepítési útvonal is.
<?xml version="1.0" encoding="UTF-8" ?>
<extension type="file" version="3.6" method="upgrade">
	<name>Phoca Vendégkönyv magyar nyelvi fájlok</name>
	<version>3.0.5</version>
	<creationDate>2016.11.22</creationDate>
	<author>Balázs Zoltán</author>
	<authorEmail>zotius@t-online.hu</authorEmail>
	<authorurl>http://zotius.hu</authorurl>
	<copyright />
	<license />
	<description>
	<![CDATA[
	<div style="text-align:left;">
	<p>Magyar nyelvi fájlok a <strong>Phoca Vendégkönyv</strong> komponenshez</p>
	<p>Fordította: <strong>Balázs Zoltán </strong><a target="_blank" href="http://zotius.hu">zotius.hu</a> a <a target="_blank" href="http://phoca.cz">Phoca.CZ</a> részére.</p>
	]]>
	</description>
	<fileset>
		<files target="language/hu-HU">
			<filename>hu-HU.com_phocaguestbook.ini</filename>
			<filename>hu-HU.com_phocaguestbook.sys.ini</filename>
		</files>
		<files target="administrator/language/hu-HU">
			<filename>hu-HU.com_phocaguestbook.ini</filename>
			<filename>hu-HU.com_phocaguestbook.sys.ini</filename>
		</files>
	</fileset>
</extension>
Ha hasznos volt a hozzászólásom számodra, nyugodtan megnyomhatod lent a „Köszönet” gombot :)
Skype: zotius
Mellékletek:
Utolsó szerkesztés: 2016 nov. 24 10:53 Zotius által. Indoklás: egy kis elírás javítása

Jelentkezz be, hogy te is részt vehess beszélgetésben!

Több
2016 nov. 25 00:14 #4 Írta: Balázs
Balázs válaszolt a következő témában: Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma?
Végül is úgy strukturálod, ahogy jól esik :) De, most működik, nem?
Ha bizalmas információt szeretnél közölni az adminokkal, akkor tedd az üzeneted tartalmát a [ confidential ][ /confidential ] címkék közé (szóközök nélkül).

Joomla! tanácsadás, oktatás, fejlesztés - joomlabs.hu

Jelentkezz be, hogy te is részt vehess beszélgetésben!

Több
2016 nov. 25 10:37 #5 Írta: Zotius
Zotius válaszolt a következő témában: Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma?
Igen, most működik. De azért a struktúrálás nem egészen úgy megy, "ahogy jólesik".
Nyilván másként működik a cucc, ha az <extension type="" ... > sorban a típus "file", vagy "language" vagy "plugin" stb.
A további tag-ek megléte/hiánya már csak "jólneveltség" kérdése, hogy kitöltöm vagy sem:
<name> ... </name>
<version> ... </version>
<creationDate> ... </creationDate>
<author> ... </author>
<authorEmail />
<authorurl />
<copyright />
<license />
<description>
<![CDATA[ ... ]]>
</description>
<fileset>
	<files target="mappa/utvonal">
		<filename> ... </filename>
		<filename> ... </filename>
	</files>
	<files target="mappa/utvonal">
		<filename> ... </filename>
		<filename> ... </filename>
	</files>
</fileset>
A lényegi tartalomnál van döntési lehetőség, hogy a telepítőben külön alkönyvtárakba szervezem-e a fájlokat vagy nem.
Csupán két nyelvi fájl esetén, ha ráadásul ugyanaz kerül a site és az admin felület languages mappájába, akkor meg pláne teljesen felesleges.
Nekem végül is sikerült rájönnöm, de ettől fügetlenül egy tisztességes how-to leírást megérdemelne, mások okulására is.
Ha hasznos volt a hozzászólásom számodra, nyugodtan megnyomhatod lent a „Köszönet” gombot :)
Skype: zotius

Jelentkezz be, hogy te is részt vehess beszélgetésben!

  1. Fórum
  3. Joomla!
  5. Nyelvkezelés és lokalizáció
  7. Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma?