View source for Adding changelog to your manifest file/de

<noinclude><languages /></noinclude>
{{Joomla version|version=4.x|comment=>Tutorial}}

Seit Joomla 4.0 können Extension-Entwickler die Fähigkeit von Joomla nutzen, eine Changelog-Datei zu lesen und eine visuelle Darstellung des Changelogs zu geben. Wenn eine bestimmte Version nicht im Changelog gefunden wird, wird die Schaltfläche Changelog nicht angezeigt.

Die Änderungen in einer Version werden so dargestellt:

[[File:Changelog modal-en.png|700px|Changelog modal]]

Das Changelog wird an zwei verschiedenen Stellen verwendet.

=== Update Ansicht ===
Das Installationsprogramm zeigt das Changelog der Version an, die installiert werden kann, falls verfügbar.

[[File:Update view changelog button-en.png|700px|Changelog button on the Update View]]

Durch klicken auf die AAAA-Schaltfläche wird das Änderungsprotokoll der neu verfügbaren Version angezeigt.

=== Manager-Ansicht  ===
Der Erweiterungs-Manager zeigt das Änderungsprotokoll der aktuell installierten Erweiterung an, falls verfügbar.

[[File:Manage view changelog link-en.png|700px|Version number is a link to the changelog modal]]

Durch klicken auf die Versionsnummer wird das Änderungsprotokoll der aktuell installierten Version angezeigt.

== Ein Changelog-URL-Tag in Manifest-Dateien einfügen ==
Der erste Schritt besteht darin, Ihre Manifestdateien zu aktualisieren, die Joomla mitteilen, wo die Changelog-Details zu finden sind. Fügen Sie Ihren Manifest-XML-Dateien den folgenden Node hinzu:
<source lang="xml">
<changelogurl>https://example.com/updates/changelog.xml</changelogurl>
</source>
<div class="mw-translate-fuzzy">
Bitte beachten: Die im <code>changelogurl<code>-Tag eingetragene URL darf davor und danach keine Leerzeichen oder Zeilenumbrüche enthalten. Siehe Code-Beispiele.
</div>
=== Update-Server Manifest-Datei === 
Dieses Beispiel zeigt eine Manifestdatei für den Update-Server, die Joomla über ein Update einer Komponente namens "com_lists" informiert. Dadurch sehen Sie in der Update-Ansicht die Schaltfläche Changelog.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<updates>
 <update>
  <name>Student List</name>
  <description>List of students</description>
  <element>com_lists</element>
  <type>component</type>
  <version>4.0.0</version>

  <changelogurl>https://example.com/updates/changelog.xml</changelogurl>

  <tags>
   <tag>stable</tag>
  </tags>
  <maintainer>Example Miller</maintainer>
  <maintainerurl>https://example.com/</maintainerurl>
  <section>Updates</section>
  <targetplatform name="joomla" version="4.?" />
  <client>1</client>
  <folder></folder>
 </update>
</updates>
</source>

=== Erweiterung-Manifest-Datei === 
Fügen Sie zusätzlich das Changelog-URL-Tag zur „Extension Manifest XML“ hinzu. Somit wird die Erweiterungsversion mit den Änderungsprotokollen in der Manager-Ansicht verknüpft.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" method="upgrade">
	<name>COM_LISTS</name>

... Other stuff ...

	<changelogurl>https://example.com/updates/changelog.xml</changelogurl>

	<updateservers>
        <server type="extension" name="My Extension's Updates">https://example.com/lists-updates.xml</server>
	</updateservers>
</extension>
</source>

== Changelog-Datei erstellen ==
Die Changelog-Datei muss die folgenden 3 Nodes enthalten:
* element
* type
* version

Diese Informationen werden verwendet, um das richtige Changelog für eine bestimmte Erweiterung zu identifizieren.

Ein <code>version</code>-Node innerhalb eines  <code>changelog</code>-Node ist immer erforderlich. Andernfalls erhalten Sie eine Fehlermeldung wie ''SyntaxError: JSON.parse: unerwartetes Zeichen in Zeile 1, Spalte 1 der JSON-Daten''.

<source lang="xml">
<element>com_lists</element>
<type>component</type>
<version>4.0.0</version>   
</source>

Weiter wird das Changelog mit einer oder mehreren Änderungsarten gefüllt. Die folgenden Änderungs-Typen werden unterstützt:
* '''security''': Etwaige Sicherheitsprobleme, die behoben wurden
* '''fix''': Fehler, die behoben wurden
* '''language''': Dieser gilt für Sprachänderungen
* '''addition''': Neu hinzugefügte Features
* '''change''': Andere Änderungen
* '''remove''': Aus der Erweiterung entfernte Features
* '''note''': Ergänzende Informationen für den Benutzer

Jeder Node kann mehrfach verwendet werden, falls notwendig.

Das Format des Texts kann reiner Text oder HTML sein. Bei HTML muss der Text, wie im Beispiel gezeigt, in CDATA-Tags eingeschlossen sein.

<source lang="xml">
<changelogs>
    <changelog>
        <element>com_lists</element>
        <type>component</type>
        <version>4.0.0</version>
        <security>
            <item>Item A</item>
            <item><![CDATA[<h2>You MUST replace this file</h2>]]></item>
        </security>
        <fix>
            <item>Item A</item>
            <item>Item b</item>
        </fix>
        <language>
            <item>Item A</item>
            <item>Item b</item>
        </language>
        <addition>
            <item>Item A</item>
            <item>Item b</item>
        </addition>
        <change>
            <item>Item A</item>
            <item>Item b</item>
        </change>
        <remove>
            <item>Item A</item>
            <item>Item b</item>
        </remove>
        <note>
            <item>Item A</item>
            <item>Item b</item>
        </note>
</changelog>
<changelog>
	<element>com_lists</element>
	<type>component</type>
	<version>0.0.2</version>
	<security>
		<item>Big issue</item>
	</security>
</changelog>
</changelogs>
</source>

Diese Datei enthält 2 Changelogs:
* Version 0.0.2 (zum Testen der Manager-Ansicht)
* Version 4.0.0 (zum Testen der Update-Ansicht)

Ein Changelog kann beliebig viele Versionen enthalten.


<noinclude>
[[Category:Beginner Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Development{{#translation:}}]]
[[Category:Joomla! 4.x{{#translation:}}]]
[[Category:Joomla! 4.0{{#translation:}}]]
</noinclude>