Erweiterungen aus einem Bundle veröffentlichen
Diese Seite richtet sich an Bündler, deren Bundle Erweiterungen enthält, die auch andere nutzen könnten. Die Checkliste für Partner ist Eine Erweiterung als Partner veröffentlichen; diese Seite folgt ihr und ergänzt, was ein Bündler bedenken sollte.
Inhalt
- Welche Erweiterungen Sie veröffentlichen
- Die Schritte
- Releases, die sich nie bewegen
- Nach der Veröffentlichung
Welche Erweiterungen Sie veröffentlichen
| Erweiterung in Ihrem Bundle | Veröffentlichen? |
|---|---|
| Eine allgemeine Funktion (ein Operator, ein Datentyp, eine Integration) | ja, sie hilft anderen und bringt Ihnen deren Korrekturen |
| Bindeglieder des Bundles (Ihre Installer-Hooks, Ihr Branding) | meist nein; behalten Sie sie im Repository des Bundles |
| Kundenspezifischer Code | nein, es sei denn, der Kunde stimmt zu und Sie entfernen alles Kundenspezifische |
| Ein Fork der Erweiterung eines anderen | schicken Sie Änderungen zuerst an das Upstream-Projekt (Erweiterungen zurückgeben) |
Die Schritte
Aus Eine Erweiterung als Partner veröffentlichen:
- Trennen Sie sie vom Kundenprojekt: keine Kundennamen, URLs, Zugangsdaten, Inhalte oder Geschäftsregeln; kundenspezifisches Verhalten wird zu einer Einstellung mit neutralem Standardwert.
- Metadaten:
ezinfo.phpmit'Version'(ohne Präfixv), Name, Urheberrecht, Lizenz und Info-URL;extension.xmlmit derselben<version>,<license>und<info_url>;composer.json, wenn Sie auf Packagist veröffentlichen;php -l ezinfo.phpundxmllint --noout extension.xmllaufen fehlerfrei. - Lizenz und Hinweise: eine Datei
LICENSE; "für Code, der auf Exponential aufbaut, eine GPL-kompatible Lizenz (das Projekt verwendet GPL v2 oder später)"; Code Dritter mit seiner Lizenz aufgeführt. - README: was sie tut, Voraussetzungen, Installation, Aktivierung, Konfiguration, Support, Lizenz.
- Repository und Paket: ein öffentliches Git-Repository mit aktivierten Issues, auf Packagist registriert "mit dem Webhook, damit neue Tags erscheinen".
- Release (siehe unten).
- Kündigen Sie sie an: Forumsbeitrag, Projektseite.
Benennen Sie sie mit Ihrem eigenen Präfix, nie mit exp
(Ein Bundle benennen und gestalten).
Releases, die sich nie bewegen
- "Wählen Sie die Version aus den veröffentlichten Tags, nach Version sortiert
(
git tag -l 'v*' --sort=version:refname)." - "Committen Sie zuerst die Versionserhöhung und taggen Sie dann diesen Commit."
- "Verschieben oder löschen Sie nie einen veröffentlichten Tag; veröffentlichen Sie stattdessen die nächste Version."
Packagist liest einen Tag einmal; ein verschobener Tag ergibt zwei verschiedene Pakete mit derselben Versionsnummer. Ihr Bundle legt die veröffentlichte Version dann wie jede andere fest (Versionen, Tags und Pinning).
Nach der Veröffentlichung
- Verlangen Sie in Ihrem Bundle das veröffentlichte Paket statt einer privaten Kopie.
- "Testen Sie sie gegen jedes neue Exponential-Release"; "Beantworten Sie Issues; übernehmen Sie nützliche Pull Requests"; "Wenn Sie die Pflege einstellen, sagen Sie das in der README."
- Erfassen Sie sie beim Partnerteam, wenn Sie Partner sind (Ihre Partneraktivität erfassen).
Verwandte Seiten
- Erweiterungs-Bundles
- Erweiterungen (Entwicklerhandbuch)
- Partner für Erweiterungen und Themes
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.