Kérdés 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
Zotius létrehozta a témát: Nyelvi fájlok telepítéséhez mi az install.xml fájl megfelelő tartalma?
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 témára: 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 témára: 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 Írta: Zotius. 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 témára: 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 témára: 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!