Git Download Updater – Setup-Dokumentation

Die Git Download Updater-Erweiterung unterstützt sowohl GitHub als auch BitBucket.

Verbindung mit BitBucket herstellen

Um Ihre Easy Digital Downloads-Website mit Ihrem Bitbucket-Konto zu verbinden, müssen Sie eine APP in Ihrem Bitbucket-Konto erstellen und dann das APP-Passwort und Ihren Bitbucket-Benutzernamen in den Einstellungen der Erweiterung eingeben.

Befolgen Sie die nachstehenden Schritte, um ein App-Passwort zu erstellen:

1. Wählen Sie im Zahnrad-Symbol oben rechts die Option Persönliche Bitbucket-Einstellungen.
2. Wählen Sie unter Zugriffsverwaltung App-Passwörter.
3. Wählen Sie App-Passwort erstellen.
4. Geben Sie dem App-Passwort einen Namen, der Ihnen hilft, sich daran zu erinnern, wofür es verwendet wird.
5. In the Permissions section check the boxes for:
   • Konto > E-Mail und Lesen
   • Workspace-Mitgliedschaft > Lesen
   • Projekte > Lesen
   • Repositories > Lesen
6. Kopieren Sie das generierte Passwort vorerst an einen sicheren Ort.  Das Passwort wird nur einmal angezeigt.

Hier ist ein Bild aller erforderlichen Berechtigungen, die in Schritt 5 oben beschrieben sind:

Weitere Details zu App-Passwörtern (einschließlich Verwendung und Widerruf) finden Sie in der Bitbucket Dokumentation.

Sobald Sie das neue App-Passwort haben, fügen Sie es auf der Seite Downloads > Einstellungen > Erweiterungen > Git Updater hinzu.

Das Feld Benutzername ist Ihr tatsächlicher Bitbucket-Benutzername (verwechseln Sie ihn nicht mit der E-Mail-Adresse des Kontos). Sie finden ihn ganz einfach auf dieser Seite: https://bitbucket.org/account/settings/ im Abschnitt „Bitbucket-Profil-Einstellungen“.

Verbindung mit GitHub herstellen

Um GitHub zu verwenden, navigieren Sie zu Downloads > Einstellungen > Erweiterungen > Git Updater. Befolgen Sie die dortigen Anweisungen, um eine Verbindung mit GitHub herzustellen.

Konfigurieren eines Downloads mit dem Git Updater

Festlegen Ihrer Download-Dateien

Nachdem Sie Ihre Website mit GitHub oder Bitbucket verbunden haben, können Sie Ihrer Download-Produkte Dateien hinzufügen.

1. Im Metabox „Download-Dateien“ auf dem Download-Bearbeitungsbildschirm befindet sich nun eine Checkbox mit der Bezeichnung „Download aus einem Git-Repository abrufen.“

2. Nach ein oder zwei Momenten erscheinen neue Felder, in denen Sie ein Repository auswählen können.

3. Suchen Sie nach dem Repository-Namen und wählen Sie dann das Tag aus, das Sie verwenden möchten.

Hinweis: Das im Git Updater verwendete Versionstag muss ein natives Git-Tag sein. Es werden keine Versionen aus Ihrer Readme-Datei geparst. Um mehr über die Verwendung der Tag-Funktion in Git zu erfahren, können Sie diesen Leitfaden besuchen.

4. Klicken Sie auf „Jetzt abrufen“. Wenn Ihr Download erfolgreich aus dem Git-Repository importiert wurde, steht auf der Schaltfläche „Abgerufen“.

5. Sie können nun den Dateinamen und/oder ZIP-Namen nach Wunsch bearbeiten oder die Standardwerte beibehalten. Ihre ZIP-Datei ist fertig!

Wenn Sie bereit sind, eine neue Version zu veröffentlichen, wählen Sie einfach das Tag aus, das Sie verwenden möchten, und klicken Sie auf „Abrufen“. Nachdem der Abruf abgeschlossen ist, aktualisieren Sie Ihr Produkt.

FAQs & Fehlerbehebung

Wie schließe oder entferne ich Dateien, bevor das ZIP-Archiv generiert wird?

Der Git Download Updater verwendet die „export“-Funktion von Git, um die zu liefernde Datei zu erstellen. Sie können die `.gitattributes`-Datei verwenden, um festzulegen, welche Dateien Sie beim Export ignorieren möchten. Hier ist ein Beispiel, wie wir es für EDD Core verwenden.

Weitere Details zur Verwendung von Git-Attributen zum Ausschließen von Dateien finden Sie in diesem Tutorial.

Update-Konflikt zwischen kostenloser und kostenpflichtiger Version

Es gibt zwei verschiedene Möglichkeiten, dieses Problem zu lösen:

1. Ändern Sie den Namen und/oder Slug der Pro-Version. Aufgrund einer Besonderheit der WordPress-Update-API kann WordPress sie nicht als separate Plugins unterscheiden.
2. Fügen Sie „wp_override“ zum dritten Parameter der EDD_SL_PLugin_Updater-Klasse hinzu, wenn diese instanziiert wird, wie folgt:

// set up the updater
$edd_updater = new EDD_SL_Plugin_Updater( EDD_SAMPLE_STORE_URL, __FILE__, array(
		'version'     => '1.0', 				// current version number
		'license'     => $license_key, 		// license key (used get_option above to retrieve from DB)
		'item_id'   => EDD_SAMPLE_ITEM_ID, 	// name of this plugin
		'author'      => 'Easy Digital Downloads',  // author of this plugin,
		'wp_override' => true
	)
);

Hinweis: Dies erfordert v1.6.4 der Plugin-Updater-Klasse.