Clasa EDD_Download este utilizată pentru a obține date despre un anumit Download, pentru a crea noi Download-uri și pentru a edita Download-uri existente. Proprietățile publice care pot fi gestionate cu această clasă sunt:
- $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;
Notă: Proprietățile de mai sus sunt moștenite și identice cu proprietățile din WP_Post.
Crearea unui Download
Pentru a crea un nou download, mai întâi instanțiați clasa și apoi rulați metoda create().
$new_download = new EDD_Download; $new_download->create();
Aceasta va crea un singur Download cu setări implicite, care sunt un Draft cu titlul „New Download Product”.
Metoda create folosește
wp_insert_post(), deci puteți transmite orice argumente către create() pe care wp_insert_post() le poate accepta. Ceva de genul acesta ar funcționa bine:
$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 );
Încărcarea unui produs descărcabil existent
Acest lucru se realizează pur și simplu prin transmiterea unui ID de produs descărcabil numelui clasei în timpul instanțierii.
Exemplu:
$my_download = new EDD_Download( 1492 );
Metode de preluare a datelor
EDD_Download are o varietate de metode pentru obținerea datelor despre produsul descărcabil, manipularea metadatelor și testarea diverselor aspecte.
get_ID()
Această metodă returnează pur și simplu ID-ul produsului descărcabil.
Exemplu:
$download_id = $my_download->get_ID();
Returnează: un întreg, cum ar fi 1492.
get_price()
Această metodă returnează prețul produsului descărcabil în format dublu, fără simbolul monedei.
$download_price = $my_download->get_price();
Returnează: un dublu, cum ar fi 9.99. Se pot efectua operații matematice pe acest rezultat.
get_prices()
Această metodă returnează un tablou cu prețurile variabile ale produsului descărcabil în format dublu, fără simbolul monedei.
$variable_prices = $my_download->get_prices();
Returnează un tablou de prețuri de genul acesta:
Array
(
[1] => Array
(
[index] => 1
[name] => Regular
[amount] => 9.99
)
[2] => Array
(
[index] =>
[name] => Unleaded
[amount] => 19.99
)
is_single_price_mode()
Determină dacă modul de preț unic este activat sau dezactivat. Modul de preț unic se referă la posibilitatea de a achiziționa simultan mai multe opțiuni de preț. În interfața utilizatorului Easy Digital Downloads, căsuța de selectare pentru acesta se află sub Prețuri variabile.
$is_single_price_mode = $my_download->is_single_price_mode();
Returnează: true sau false
has_variable_prices()
Determină dacă Prețurile variabile sunt activate sau dezactivate pentru un produs descărcabil specific.
$download_price = $my_download->has_variable_prices();
Returnează: true sau false
get_files()
Această metodă returnează un tablou cu fișierele atașate produsului descărcabil
$my_files = $my_download->get_files();
Returnează un tablou de prețuri de genul acesta:
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()
Această metodă obține numărul de ori în care acest fișier poate fi descărcat.
Exemplu:
$download_limit = $my_download->get_file_download_limit();
Returnează: un întreg, cum ar fi 100.
get_file_price_condition()
Când un produs are prețuri variabile, unul sau mai multe fișiere pot fi disponibile pentru achiziție. Sub Atribuirea prețului, Fișierele pot fi asociate cu Toate opțiunile de preț sau doar cu cele specifice. În exemplul de mai jos, fișierul este asociat cu Piste 1, 2, 3 și Album complet.
Exemplu:
$price_condition = $my_download->get_file_price_condition();
Returnează: un întreg, cum ar fi 2.
get_type()
Returnează valoarea care arată dacă produsul descărcabil este un Pachet sau Implicit.
Exemplu:
$download_type = $my_download->get_type();
Returnează: fie 'implicit', fie 'pachet'
is_bundled_download()
Determinați dacă acesta este un download grupat.
Exemplu:
$is_bundled_download = $my_download->is_bundled_download();
Returnează: true sau false
get_bundled_downloads()
Obține ID-urile de Download ale articolelor dintr-un Download grupat.
Exemplu:
$bundled_downloads = $my_download->get_bundled_downloads();
Returnează: Un array de ID-uri de Download de acest fel:
Array
(
[0] => 68
[1] => 114
)
Notă: get_bundled_downloads() va returna un array gol dacă produsul nu este un pachet, așa că uitați-vă la ceva de genul acesta:
if ( $my_download->is_bundled_download() ) {
$bundled_downloads = $my_download->get_bundled_downloads();
}
get_notes()
Returnează notele pentru un Download ca șir de caractere.
Exemplu:
$download_notes = $my_download->get_notes();
Returnează: Notele ca șir de caractere și menține întreruperile de linie.
get_sku()
Returnează SKU-ul pentru un Download ca șir de caractere.
Exemplu:
$download_sku = $my_download->get_sku();
Returnează: SKU-ul ca șir de caractere
get_button_behavior()
Returnează ce se întâmplă când cineva face clic pe butonul de cumpărare
Exemplu:
$download_button_behavior = $my_download->get_button_behavior();
Returnează: fie „direct” pentru Cumpără Acum, fie „add_to_cart” pentru Adaugă în Coș.
get_sales()
Returnează numărul de vânzări finalizate pentru acest articol
Exemplu:
$download_sales = $my_download->get_sales();
Returnează: un întreg de genul 42
increase_sales()
Incrementează numărul de vânzări cu 1. Nu poate primi intrare, nu poate crește cu mai mult de 1.
Exemplu:
$increase_sales = $my_download->increase_sales();
Returnează: fie false la eșec, fie un întreg al noului număr de vânzări.
decrease_sales()
Decrementează numărul de vânzări cu 1. Nu poate primi intrare, nu poate crește cu mai mult de 1.
Exemplu:
$decrease_sales = $my_download->decrease_sales();
Returnează: fie false la eșec, fie un întreg al noului număr de vânzări.
get_earnings()
Returnează câștigul total pentru acest download.
Exemplu:
$download_earnings = $my_download->get_earnings();
Returnează: un număr zecimal de genul 152.69
increase_earnings( mixed $amount = 0 )
Crește câștigurile totale pentru un Download cu suma introdusă.
Exemplu:
$increase_earnings = $my_download->increase_earnings();
Returnează: fie false la eșec, fie un număr zecimal al noii sume, de genul 247.39
decrease_earnings( mixed $amount = 0 )
Scade câștigurile totale pentru un Download cu suma introdusă.
Exemplu:
$decrease_earnings = $my_download->decrease_earnings();
Returnează: fie false la eșec, fie un număr flotant al noii sume, cum ar fi 147.39
este_gratuit( mixt $id_pret = false )
Verifică dacă descărcarea este gratuită SAU dacă ID-ul de preț dat este gratuit.
Exemplu:
$is_free = $my_download->is_free();
Returnează: true sau false
