Softwarelizenzierung – Updater-Implementierung für WordPress-Plugins

Im Lieferumfang Ihrer Software Licensing-Erweiterung ist ein Beispiel-Plugin enthalten, das sich im Verzeichnis „samples“ innerhalb der ZIP-Datei von Software Licensing befindet. Laden Sie die Erweiterung von Ihrer Konto-Seite auf unserer Website herunter. Es wird dringend empfohlen, diese zu öffnen und vollständig zu prüfen.

Das Beispiel besteht aus zwei Komponenten:

1. Die Datei composer.json, die alles einrichtet, was Sie benötigen, um mit der Software Licensing API in Ihrem WordPress-Plugin zu arbeiten.
2. Die Haupt-Plugin-Datei, die den Code zum Einbinden in das EDD Software Licensing SDK enthält, eine Drop-in-Lösung für Entwickler von WordPress-Plugins und -Themes, um Easy Digital Downloads Software Licensing schnell in ihre Produkte zu integrieren, ohne komplexe Einrichtung oder benutzerdefinierte Admin-Oberflächen.

Schritt 1: Installieren Sie das Composer-Paket

Aktualisieren Sie (oder erstellen Sie) die Datei composer.json für Ihr Plugin im Hauptverzeichnis Ihres Plugins. Führen Sie composer install aus, um das Software Licensing SDK zu Ihrem Plugin hinzuzufügen (beachten Sie, dass dieser Link auch die neuesten Anweisungen und Beispiele enthält).

Schritt 2: Aktualisieren Sie Ihr Plugin, um das SDK zu verwenden

Dieser Ausschnitt bietet einen Ausgangspunkt für den Code, der in Ihrem Plugin benötigt wird, um sich in das SDK zu integrieren:

/**
 * Plugin Name: AAA Sample Plugin
 * Plugin URI: https://easydigitaldownloads.com
 * Description: Illustrates how to include an updater in your plugin for EDD Software Licensing.
 * Author: Sandhills Development, LLC
 * Author URI: https://easydigitaldownloads.com
 * Version: 1.0.0
 * License: GNU General Public License v2.0 or later
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 */

add_action(
	'edd_sl_sdk_registry',
	function ( $init ) {
		$init->register(
			array(
				'id'      => 'edd-sample-plugin', // The plugin slug.
				'url'     => 'https://edd.local', // The URL of the site with EDD installed.
				'item_id' => 83, // The download ID of the product in Easy Digital Downloads.
				'version' => '1.0.0', // The version of the product.
				'file'    => __FILE__, // The path to the main plugin file.
			)
		);
	}
);

// Load the SDK from the vendor directory. The SDK handles autoloader setup automatically.
if ( file_exists( __DIR__ . '/vendor/easy-digital-downloads/edd-sl-sdk/edd-sl-sdk.php' ) ) {
	require_once __DIR__ . '/vendor/easy-digital-downloads/edd-sl-sdk/edd-sl-sdk.php';
}

Ändern Sie die Informationen, damit sie zu Ihrem Shop passen:

• id – Plugin/Theme-Slug.
• url – Die Shop-URL.
• item_id – Die Artikel-ID (in Ihrem Shop).
• version – Die aktuelle Versionsnummer.
• file – Die Haupt-Plugin-Datei. Nicht für Themes erforderlich.
• type – plugin oder theme. Nicht für Plugins erforderlich.
• weekly_check – Optional: Ob eine wöchentliche Anfrage zur Bestätigung des Lizenzstatus erfolgen soll. Standardmäßig auf true gesetzt.

Sobald Ihr Plugin aktiviert ist, können Ihre Kunden ihren Lizenzschlüssel hinzufügen und zustimmen, dass Ihr Shop ihre PHP- und WordPress-Versionen zu ihren Aktivierungsdaten hinzufügt:

Das ist alles!

Wichtige Hinweise

• Wenn Sie Probleme mit der SSL-Überprüfung bei Update-Anfragen haben, können Sie den Filter edd_sl_api_request_verify_ssl verwenden, um die SSL-Überprüfungsflagge zu deaktivieren.
• Wenn Sie verhindern möchten, dass Ihre Benutzer automatische Updates für Ihr Theme oder Plugin aktivieren, können Sie einen Codeausschnitt zu Ihrem verteilten Code hinzufügen, um automatische Updates zu deaktivieren:

add_filter( 'auto_update_plugin', 'edd_sample_disable_plugin_autoupdates', 10, 2 );
function edd_sample_disable_plugin_autoupdates( $update, $plugin ) {
	if ( 'my-plugin/my-plugin.php' === $plugin->plugin ) {
		return false;
	}

	return $update;
}

add_filter( 'auto_update_theme', 'edd_sample_disable_theme_autoupdates', 10, 2 );
function edd_sample_disable_theme_autoupdates( $update, $theme ) {
	if ( 'my-theme' === $theme->theme ) {
		return false;
	}

	return $update;
}