Entwickler: Code-Schnipsel und Ressourcen

Derzeit ist keine ausführliche Dokumentation für Entwickler verfügbar, aber hier finden Sie einige nützliche Codeschnipsel und Ressourcen für Entwickler.

Datenbank-Tabellen

Das Plugin hat seine eigenen Datenbanktabellen, aus denen Sie bestimmte Daten abrufen können:

wcusage_activity - Aktivitätsprotokoll.

wcusage_campaigns - Empfehlungs-URL-Kampagnen.

wcusage_clicks - Protokoll der Klicks auf Verweis-URLs.

wcusage_directlinks - Domains mit direkter Linkverfolgung.

wcusage_mlainvites - Einladungen für Multi-Level-Partner.

wcusage_payouts - Provisionsausschüttungen

wcusage_register - Anwendungen zur Registrierung von Partnern.

Affiliate-Bestellungen

Ermittelt alle Partnerbestellungen für einen Coupon, ohne bestimmten Datenbereich. Dies gibt ein Array von Daten zurück, das die Gesamtberechnungen für alle Bestellungen und alle einzelnen Bestellungen enthält.

$orders = wcusage_wh_getOrderbyCouponCode( $coupon_code, $start_date, $end_date, '', 1 );

Daten bestellen

Mit dieser Funktion können Sie ein Array von Partnerdaten für eine bestimmte Bestellung abrufen. Diese Funktion gibt ein Array von Daten einschließlich der Provisionseinnahmen zurück.

$order_data = wcusage_calculate_order_data( $order_id, $coupon_code, 0, 1 );

Zum Beispiel, um die Provision für die Bestellung zu erhalten:

$commission = $order_data['totalcommission'];

Partner-URL

Holen Sie sich die Partner-URL für einen Coupon mit der folgenden Funktion:

$coupon_code = ""; // Legen Sie hier den Namen des Coupon-Codes fest.
$affiliate_url = wcusage_get_affiliate_url($coupon_code);

Wenn Sie Ihre eigene benutzerdefinierte URL erstellen möchten, finden Sie hier ein Beispiel:

$coupon_code = ""; // Legen Sie hier den Namen des Coupon-Codes fest.
$prefix = wcusage_get_setting_value('wcusage_field_urls_prefix', 'coupon');
$affiliate_url = get_home_url() . "?" . $prefix . "=" . $coupon_code;

Gesamtumsatz und Provision

Ermitteln Sie den Gesamtumsatz und die Provisionen, die mit einem bestimmten Coupon erzielt wurden, ohne einen bestimmten Datumsbereich. Lassen Sie $start_date leer, um alle Verkäufe zu erhalten.

$orders = wcusage_wh_getOrderbyCouponCode( $coupon_code, $start_date, $end_date, '', 1 );
$otal_orders = $orders['total_orders']; // Gesamtumsatz
$otal_discounts = $orders['full_discount']; // Gesamtrabatte
$otal_commission = $orders['total_commission']; // Gesamtprovision
$order_count = $orders['total_count']; // Anzahl der Bestellungen

Unbezahlte Kommission

Ermitteln Sie die gesamte unbezahlte Provision für einen Affiliate-Gutschein.

$coupon_id = ""; // Legen Sie hier die Gutscheincode-ID fest.
$unpaid_commission = get_post_meta( $coupon_id, 'wcu_text_unpaid_commission', true );

Haken (Aktion): Registrierung neuer Mitglieder

Bei einer neuen Partnerregistrierung wird der Hook "wcusage_hook_registration_new" ausgeführt, der die Registrierungs-ID, die Benutzer-ID und den Gutscheincode übergibt.

Sie können daher diesen Hook aufrufen, um die Registrierung unter bestimmten Bedingungen mit der Funktion "wcusage_set_registration_status" automatisch zu akzeptieren. Zum Beispiel wird die Registrierung automatisch akzeptiert, wenn der Benutzer die Rolle "Beispiel" hat:

add_action( 'wcusage_hook_registration_new', 'trigger_wcusage_hook_registration_new', 10, 3 );
function trigger_wcusage_hook_registration_new( $registration_id, $user_id, $coupon_code ) {
    $user_info = get_userdata( $user_id );
    $roles = $user_info->roles;

    if ( in_array( 'example', $roles ) ) {
        wcusage_set_registration_status( 'accepted', $registration_id, $user_id, $coupon_code, '', '' );
    }
}

Haken (Aktion): Neue Mitgliedsorganisation Akzeptiert

Wenn ein neuer Partner akzeptiert und zu Ihrem Programm hinzugefügt wird, wird die Funktion "wcusage_hook_affiliate_register_accepted" ausgeführt, die Folgendes übermittelt:

• $id - Registrierungs-ID.
• $userid - Benutzer-ID.
• $coupon_code - Gutscheincode.
• $message - Die Nachricht über die Annahme der Registrierung.
• $status - Der Status der Registrierung.

add_action( 'wcusage_hook_affiliate_register_accepted', 'trigger_wcusage_hook_registration_accepted', 10, 5 );
function trigger_wcusage_hook_registration_accepted( $id, $userid, $coupon_code, $message, $status ) {
// Ihr Code hier.
}

API-Endpunkt: Kupon-Infos

Die Kupon-Infos API-Endpunkt ermöglicht es Ihnen, Details zu einem bestimmten Coupon anhand seiner ID abzurufen. Dazu gehören der Name des Coupons, die nicht gezahlte Provision und ausstehende Auszahlungen, was ihn zu einem wichtigen Werkzeug für die Verfolgung der Couponleistung und des Auszahlungsstatus macht. Nur Administratoren können auf diesen Endpunkt zugreifen.

Um die API zu verwenden, senden Sie eine GET Anfrage an /wp-json/woo-coupon-usage/v1/coupon-info mit dem erforderlichen Parameter coupon_id (die ID des Gutscheins, den Sie abfragen möchten). Die Antwort enthält ein Array mit den gutschein_name, unbezahlte_Kommissionund ausstehende_Auszahlungen.

API-Endpunkt: Benutzer Gutscheine

Die Gutscheine für Benutzer Mit diesem API-Endpunkt können Sie eine Liste der Gutschein-IDs abrufen, die einem bestimmten Benutzer zugewiesen wurden, zusammen mit der zugehörigen unbezahlten Provision. Diese Funktion ist nützlich für die Überwachung und Verwaltung von benutzerspezifischen Gutscheinzuweisungen und Provisionen. Der Zugriff auf diesen Endpunkt ist auf Administratoren beschränkt.

Um die API zu verwenden, senden Sie eine GET Anfrage an /wp-json/woo-coupon-usage/v1/benutzer-coupons mit dem erforderlichen Parameter Benutzer (der Anmeldename des Benutzers, dessen Gutscheine Sie abrufen möchten). Die API gibt ein Array von Coupon-IDs zusammen mit ihrer unbezahlten Provision zurück und bietet so einen Überblick über die Coupon-Aktivität des Nutzers.

API-Endpunkt: Auszahlung anfordern

Die Auszahlung beantragen Der API-Endpunkt ermöglicht es Ihnen, Auszahlungsanfragen für einen bestimmten Coupon auszulösen. Er verifiziert den Benutzer, der die Auszahlung anfordert, und prüft, ob die unbezahlte Provision des Coupons gültig und bereit zur Verarbeitung ist.

Um die API zu verwenden, erstellen Sie eine POST Anfrage an /wp-json/woo-coupon-usage/v1/anforderung-auszahlung mit zwei erforderlichen Parametern: coupon_id (die ID des Kupons) und Benutzer (der Anmeldename des Benutzers, der die Auszahlung beantragt). Stellen Sie sicher, dass der aufrufende Benutzer über Administratorrechte verfügt. Nach erfolgreicher Validierung bearbeitet das System den Auszahlungsantrag und gibt 1 für den Erfolg oder 0 für das Scheitern.

—

Benötigen Sie Hilfe bei einer benutzerdefinierten Funktion? Wenden Sie sich an uns, vielleicht können wir Ihnen den richtigen Weg weisen.