Erweiterungen an die Upstream-Projekte zurückgeben
Diese Seite ist für Entwickler bei Partnern, die bestehende Erweiterungen nutzen, korrigieren oder erweitern. Das Ziel ist gemeinsames Wachstum: Verbessern Sie die Erweiterung dort, wo sie zu Hause ist, damit alle profitieren und der ursprüngliche Autor genannt wird.
1. Das Upstream-Projekt finden
ezinfo.phpundextension.xmlder Erweiterung nennen ihre Info-URL und Lizenz (Erweiterungen).- Der Composer-Paketname (
vendor/name) führt zu ihrem Repository auf Packagist. - Viele Erweiterungen im Ökosystem werden von se7enxweb als Fortführung früherer Arbeit gepflegt; andere liegen bei ihren ursprünglichen Autoren oder auf https://projects.exponential.earth.
2. Eine Erweiterung auf aktuelles Exponential bringen
Die meisten Upgrades sind klein: PHP-8-Kompatibilität, umbenannte Einstellungen, Anpassungen an Templates. Arbeiten Sie
in einem Branch, halten Sie jede Änderung in einem eigenen Commit und beschreiben Sie in der Nachricht, warum
(Fixed: ..., Updated: ...). Testen Sie auf den PHP-Versionen, die der Kernel unterstützt (8.0 bis 8.5 für 6.0.15,
doc/eng-us/install/02-requirements.md).
3. Zurückschicken
| Zustand des Upstream-Projekts | Tun Sie |
|---|---|
| Aktiv | Eröffnen Sie einen Pull Request; folgen Sie den Regeln des Projekts |
| Langsam, aber lebendig | Eröffnen Sie den Pull Request und ein Issue, das ihn erklärt; warten Sie eine angemessene Zeit |
| Verwaist (lange keine Antwort) | Fragen Sie öffentlich, ob Sie übernehmen dürfen; sonst forken Sie |
Übertragung des Urheberrechts (CLA). Eine Änderung am Kernel (se7enxweb/exponential), in welcher Form auch
immer eingereicht, wird erst gemergt, nachdem Sie das Contributor Licensing Agreement unterzeichnet haben, das 7x und
die Exponential Foundation verlangen. Mit Unterschrift und Einreichung übertragen Sie das Urheberrecht an Ihrem
Beitrag an 7x, das damit sein Eigentümer wird, und geben die Kontrolle darüber ab: 7x darf ihn auf jede Weise
verwenden, ändern, neu lizenzieren und verbreiten, auch unter anderen Lizenzen und in kommerziellen Produkten, ohne Sie
zu fragen oder zu bezahlen, und Sie können ihn nicht zurückziehen und keine Bedingungen daran knüpfen. Ihre eigenen
individuellen Erweiterungen und Korrekturen, die Sie für Ihre Kunden behalten, sind nicht betroffen. Siehe
Übertragung des Urheberrechts (CLA).
4. Forks und Umbenennungen, mit Respekt
- Behalten Sie die vollständige Git-Historie, das ursprüngliche Copyright und die Lizenz.
- Nennen Sie den ursprünglichen Autor in der README („basiert auf [Name] von [Autor]“).
- Benennen Sie nur um, wenn nötig (zum Beispiel, um unter Ihrem Vendor auf Packagist zu veröffentlichen), und sagen Sie, woher es stammt.
- Bieten Sie die Verbesserungen Ihres Forks zurück an, wenn das Original wieder auflebt.
Das Projekt hält es ebenso: Exponential Layouts „bringt das Konzept der Upstream-Layouts-Pakete in den Kernel von Exponential“ (README), und die Verbesserungen von LoveStack wurden „mit voller Nennung von Mugo Web“ neu gebaut (README).
5. Die Pflege übernehmen
Wenn Sie Betreuer werden:
- Veröffentlichen Sie Releases nach den Regeln: Version in
ezinfo.phpundextension.xml, Tag nach dem Anheben, nie ein Tag verschieben (Erweiterungen, „Release it“). - Beantworten Sie Issues, oder sagen Sie in der README, dass Sie sie nur für Ihre eigenen Bedürfnisse pflegen.
- Informieren Sie die Community in den Foren.
Verwandte Seiten
- Partner für Erweiterungen und Themes
- Eine Erweiterung als Partner veröffentlichen
- Code zurückgeben
- Erweiterungen zurückgeben: eine Erweiterung veröffentlichen und was die GPL verlangt, wenn Sie sie verbreiten
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.