EDD_Download

Klasa EDD_Download służy do pobierania danych o konkretnym pobraniu, tworzenia nowych pobrań i edycji istniejących pobrań.  Publiczne właściwości, którymi można zarządzać za pomocą tej klasy, to:

• $ID = 0;
• $post_author = 0;
• $post_date = ‘0000-00-00 00:00:00’; 
• $post_date_gmt = ‘0000-00-00 00:00:00’; 
• $post_content = ”;
• $post_title = ”;
• $post_excerpt = ”;
• $post_status = ‘publish’; 
• $comment_status = ‘open’;
• $ping_status = ‘open’;
• $post_password = ”;
• $post_name = ”;
• $to_ping = ”;
• $pinged = ”;
• $post_modified = ‘0000-00-00 00:00:00’; 
• $post_modified_gmt = ‘0000-00-00 00:00:00’; 
• $post_content_filtered = ”;
• $post_parent = 0;
• $guid = ”;
• $menu_order = 0;
• $post_mime_type = ”;
• $comment_count = 0;
• $filter;

Uwaga: Powyższe właściwości są dziedziczone i identyczne z właściwościami w WP_Post.

Tworzenie pobrania

Aby utworzyć nowe pobranie, najpierw tworzysz instancję klasy, a następnie uruchamiasz metodę create().

$new_download = new EDD_Download;
$new_download->create();

Spowoduje to utworzenie pojedynczego pobrania z domyślnymi ustawieniami, które są wersją roboczą (Draft) z tytułem „Nowy produkt do pobrania”.

Metoda create używa 
wp_insert_post(), więc możesz przekazać do create() dowolne argumenty, które wp_insert_post() może zaakceptować.  Coś takiego zadziałałoby dobrze:

$new_download = new EDD_Download;

$download_args = array(
	'post_title'    => 'My eBook',
	'post_content'  => 'This is my eBook. Nice long description.',
	'post_status'   => 'publish',
)
$new_download->create( $download_args );

Ładowanie istniejącego pliku do pobrania

Osiąga się to po prostu, przekazując identyfikator pliku do pobrania do nazwy klasy podczas tworzenia instancji.

Przykład:

$my_download = new EDD_Download( 1492 );

Metody pobierania danych

EDD_Download ma szereg metod do pobierania danych o pliku do pobrania, manipulowania metadanymi i testowania różnych rzeczy.

get_ID()

Ta metoda po prostu zwraca identyfikator pliku do pobrania.

Przykład:

$download_id = $my_download->get_ID();

Zwraca: liczbę całkowitą, np. 1492.

get_price()

Ta metoda zwraca cenę pliku do pobrania w formacie double, bez symbolu waluty.

$download_price = $my_download->get_price();

Zwraca: liczbę zmiennoprzecinkową, np. 9,99. Na tym wyniku można wykonywać obliczenia.

get_prices()

Ta metoda zwraca tablicę zmiennych cen pliku do pobrania w formacie double, bez symbolu waluty.

$variable_prices = $my_download->get_prices();

Zwraca tablicę cen, na przykład:

Array
(
    [1] => Array
        (
            [index] => 1
            [name] => Regular
            [amount] => 9.99
        )

    [2] => Array
        (
            [index] => 
            [name] => Unleaded
            [amount] => 19.99
        )

is_single_price_mode()

Określa, czy tryb pojedynczej ceny jest włączony, czy wyłączony.  Tryb pojedynczej ceny odnosi się do tego, czy można kupić wiele opcji cenowych jednocześnie.  W interfejsie użytkownika Easy Digital Downloads pole wyboru dla tej opcji znajduje się w sekcji Ceny zmienne.

$is_single_price_mode = $my_download->is_single_price_mode();

Zwraca: true lub false

has_variable_prices()

Określa, czy ceny zmienne są włączone, czy wyłączone dla konkretnego pliku do pobrania.

$download_price = $my_download->has_variable_prices();

Zwraca: true lub false

get_files()

Ta metoda zwraca tablicę plików dołączonych do pliku do pobrania

$my_files = $my_download->get_files();

Zwraca tablicę cen, na przykład:

Array
(
    [0] => Array
        (
            [attachment_id] => 10
            [name] => Be Kind To Your Web Footed Friends
            [file] => https://example.com/wp-content/uploads/edd/2015/05/be_kind_to_your_web_footed_friend.mp3
            [condition] => all
        )

)

get_file_download_limit()

Ta metoda pobiera liczbę razy, ile ten plik może zostać pobrany.

Przykład:

$download_limit = $my_download->get_file_download_limit();

Zwraca: liczbę całkowitą, np. 100.

get_file_price_condition()

Gdy produkt ma ceny zmienne, jeden lub więcej plików może być dostępnych do zakupu. W sekcji Przypisanie ceny, pliki mogą być powiązane ze wszystkimi opcjami cenowymi lub tylko z niektórymi.  W poniższym przykładzie plik jest powiązany z Utworami 1, 2, 3 i Pełnym albumem.

Przykład:

$price_condition = $my_download->get_file_price_condition();

Zwraca: liczbę całkowitą, np. 2.

get_type()

Zwraca wartość wskazującą, czy plik do pobrania jest pakietem, czy domyślnym.

Przykład:

$download_type = $my_download->get_type();

Zwraca: 'default' lub 'bundle'

is_bundled_download()

Określ, czy jest to pobieranie w pakiecie.

Przykład:

$is_bundled_download = $my_download->is_bundled_download();

Zwraca: true lub false

get_bundled_downloads()

Pobiera identyfikatory pobierania elementów w pobieraniu w pakiecie.

Przykład:

$bundled_downloads = $my_download->get_bundled_downloads();

Zwraca: Tablicę identyfikatorów pobierania, taką jak:

Array
(
    [0] => 68
    [1] => 114
)

Uwaga: get_bundled_downloads() zwróci pustą tablicę, jeśli produkt nie jest pakietem, więc rozważ zrobienie czegoś takiego:

if ( $my_download->is_bundled_download() ) {
	$bundled_downloads = $my_download->get_bundled_downloads();
}

get_notes()

Zwraca notatki dla pobierania jako ciąg znaków.

Przykład:

$download_notes = $my_download->get_notes();

Zwraca: Notatki jako ciąg znaków, zachowując podziały wierszy.

get_sku()

Zwraca SKU dla pobierania jako ciąg znaków.

Przykład:

$download_sku = $my_download->get_sku();

Zwraca: SKU jako ciąg znaków

get_button_behavior()

Zwraca, co się dzieje, gdy ktoś kliknie przycisk zakupu

Przykład:

$download_button_behavior = $my_download->get_button_behavior();

Zwraca: albo „direct” dla Kup teraz, albo „add_to_cart” dla Dodaj do koszyka.

get_sales()

Zwraca liczbę zakończonych sprzedaży tego przedmiotu

Przykład:

$download_sales = $my_download->get_sales();

Zwraca: liczbę całkowitą, taką jak 42

increase_sales()

Zwiększa liczbę sprzedaży o 1. Nie można wprowadzać danych, nie można zwiększyć o więcej niż 1.

Przykład:

$increase_sales = $my_download->increase_sales();

Zwraca: albo fałsz w przypadku niepowodzenia, albo liczbę całkowitą nowej liczby sprzedaży.

decrease_sales()

Zmniejsza liczbę sprzedaży o 1. Nie można wprowadzać danych, nie można zwiększyć o więcej niż 1.

Przykład:

$decrease_sales = $my_download->decrease_sales();

Zwraca: albo fałsz w przypadku niepowodzenia, albo liczbę całkowitą nowej liczby sprzedaży.

get_earnings()

Zwraca całkowity dochód z tego pobierania.

Przykład:

$download_earnings = $my_download->get_earnings();

Zwraca: liczbę zmiennoprzecinkową, taką jak 152,69

increase_earnings( mixed $amount = 0 )

Zwiększa całkowite zarobki dla pobierania o podaną kwotę.

Przykład:

$increase_earnings = $my_download->increase_earnings();

Zwraca: albo fałsz w przypadku niepowodzenia, albo liczbę zmiennoprzecinkową nowej kwoty, taką jak 247,39

decrease_earnings( mixed $amount = 0 )

Zmniejsza całkowite zarobki dla pobierania o podaną kwotę.

Przykład:

$decrease_earnings = $my_download->decrease_earnings();

Zwroty: false w przypadku błędu lub liczba zmiennoprzecinkowa nowej kwoty, np. 147,39

is_free( mixed $price_id = false )

Sprawdza, czy produkt jest darmowy LUB czy podany identyfikator ceny jest darmowy.

Przykład:

$is_free = $my_download->is_free();

Zwraca: true lub false