EDD_HTML_Elements

Clasa EDD_HTML_Elements oferă o serie de metode ajutătoare pentru randarea câmpurilor HTML utilizate frecvent, cu marcaje, nume de clasă și atribute consistente.

Clasa include metode pentru următoarele tipuri de câmpuri:

product_dropdown()

Această metodă creează un element html select cu produse în el. Valorile sunt product_ids și textul este titlul descărcării.

Exemplu:

echo EDD()->html->product_dropdown();

Aceasta ar crea o listă derulantă de produse.  Metoda acceptă o intrare, un array, și are aceste valori implicite:

$defaults = array(
	'name'        => 'products',
	'id'          => 'products',
	'class'       => '', 
	'multiple'    => false,
	'selected'    => 0,
	'chosen'      => false,
	'number'      => 30, 
	'bundles'     => true,
	'placeholder' => sprintf( __( 'Select a %s', 'easy-digital-downloads' ), edd_get_label_singular() )
);

Iată o descriere a ceea ce se află în fiecare opțiune:

nume

Aceasta ar fi proprietatea “name” html a elementului formular.  Implicit este ‘products’.

Exemplu:

id

	This would be the html “id” property of the html element.  Defaults to ‘products’.

	Example:

class

Aceasta ar fi proprietatea “class” a elementului html.  Implicit este nimic.

Exemplu:

multiple

	This makes the select menu be of the “multiple” type. Defaults to false.

	Example:
	
selected

	This allows you to provide the product_id of a Download and have that one be pre-selected when the form loads.  Defaults to 0.
chosen

	This activated the “chosen” jquery plugin on your select box.  Defaults to false.

	Examples both closed and open:

	

	Below is chosen with ‘multiple’ set to true:
number

	This allows you to set a limit to the number of products in your list.  Defaults to 30.
bundles

	This allows you to decide if bundles should be included in your product list.  Defaults to true.
placeholder

	This is the text that goes in the first line of the select list, usually something like a title. The default is

	sprintf( __( ‘Select a %s’, ‘easy-digital-downloads’ ), edd_get_label_singular() )

	The above string has some plain English that says “Select a ” and then looks for a string with %s.  That string is provided by the function edd_get_label_singular().  edd_get_label_singular() gets the name of your product type in singular form.  edd_get_label_singular() defaults to “Download”.
customer_dropdown()

	This method creates a
	select html element with products in it.  Values are customer_ids and the text is Firstname Lastname .

	Example:
echo EDD()->html->customer_dropdown();


	This would create a drop down list of customers.  The method takes one input, an array, and has these defaults:
$defaults = array(
    'name'        => 'customers',
    'id'          => 'customers',
    'class'       => '',  
    'multiple'    => false,
    'selected'    => 0,   
    'chosen'      => true,
    'placeholder' => __( 'Select a Customer', 'easy-digital-downloads' ),
    'number'      => 30
);


	Here’s a description of what’s in each option:
name

	This would be the html “name” property of the form element.  Defaults to ‘customers’.

	Example:

id

Aceasta ar fi proprietatea “id” html a elementului html.  Implicit este ‘customers’.

Exemplu:

class

	This would be the “class” property of the html element.  Defaults to nothing.

	Example:

multiple

Aceasta face ca meniul select să fie de tip “multiple”. Implicit este false.

Exemplu:

selected

Aceasta vă permite să furnizați un customer_id și să îl aveți pe acesta pre-selectat atunci când formularul este încărcat.  Implicit este 0.

chosen

Aceasta activează pluginul jquery “chosen” pe caseta dvs. de selectare.  Implicit este false.

Exemple, atât închise, cât și deschise:

number

Aceasta vă permite să setați o limită pentru numărul de clienți din lista dvs.  Implicit este 30.

placeholder

Acesta este textul care apare în prima linie a listei de selecție, de obicei ceva de genul unui titlu. Implicit este „Selectați un client”.

discount_dropdown()

Această metodă creează un element html select cu o listă de reduceri în el. Valorile sunt discount_ids și textul este titlul reducerii.

Exemplu:

echo EDD()->html->discount_dropdown();

Aceasta ar crea o listă derulantă de reduceri.

Intrare

Această metodă acceptă trei valori ca intrare.

nume

Acesta este numele elementului html.  Implicit este ‘edd_discounts’

selected

Acesta este elementul care ar trebui selectat atunci când caseta de selecție este încărcată.  Implicit este să nu fie selectat nimic, iar elementul implicit va fi prima reducere din listă.

status

Reducerile pot fi active sau inactive.  Opțiunea „status” permite alegerea uneia dintre ele.  Implicit, nu se declară și toate reducerile sunt încărcate.

category_dropdown()

Această metodă creează un element html
select cu o listă de categorii de descărcare în el. Valorile sunt term_ids, iar textul este titlul categoriei.

Exemplu:

echo EDD()->html->category_dropdown();

Aceasta ar crea o listă derulantă de categorii de descărcare.

Intrare

Această metodă acceptă două valori ca intrare.

nume

Acesta este numele elementului html.  Implicit este „edd_categories”

selected

Acesta este elementul care ar trebui selectat atunci când caseta de selectare este încărcată. Implicit, nimic nu este setat pentru a fi selectat, iar caseta de selectare va avea o opțiune intitulată „Toate categoriile”.

year_dropdown()

Această metodă creează un element html
select cu o listă de ani în el. Textul și valoarea opțiunii sunt ambele un an de 4 cifre.

Exemplu:

echo EDD()->html->year_dropdown();

Aceasta ar crea o listă derulantă de 6 ani, anul curent selectat implicit.

Intrare

Această metodă acceptă două valori ca intrare.

nume

Acesta este numele elementului html.  Implicit este „year”

selected

Acesta este elementul care ar trebui selectat atunci când caseta de selectare este încărcată.  Necesită un întreg de patru cifre.

month_dropdown()

Această metodă creează un element html
select cu o listă de luni în el. Valorile sunt întregi necompletate, iar textul sunt abrevieri de trei litere ale lunilor.

Exemplu:

echo EDD()->html->year_dropdown();

Aceasta ar crea o listă derulantă de 12 luni, luna curentă selectată implicit.

Intrare

Această metodă acceptă două valori ca intrare.

nume

Acesta este numele elementului html.  Implicit este „month”

selected

Acesta este elementul care ar trebui selectat atunci când caseta de selectare este încărcată. Necesită un întreg de două cifre.

select()

Această metodă creează un element html
select și vă permite să-l populați cu orice matrice unidimensională.

Exemplu:

echo EDD()->html->select( $args );

Metoda acceptă o intrare, o matrice, și are aceste valori implicite:

$args = array(
    'options'          => array(),
    'name'             => null,
    'class'            => '',
    'id'               => '',
    'selected'         => 0,
    'chosen'           => false,
    'placeholder'      => null,
    'multiple'         => false,
    'show_option_all'  => _x( 'All', 'all dropdown items', 'easy-digital-downloads' ),
    'show_option_none' => _x( 'None', 'no dropdown items', 'easy-digital-downloads' ),
);

Iată o descriere a ceea ce se află în fiecare opțiune:

options

Aceasta este o matrice unidimensională de lucruri de genul acesta:

$args['options'] = array(
    '1' => 'Thing 1',
    '2' => 'Thing 2',
    '3' => 'Thing 3',
    '4' => 'Thing 4',
);

Cheile matricei sunt folosite ca valori ale opțiunii de selectare, iar valorile matricei sunt folosite ca text al opțiunii de selectare.

nume

Aceasta ar fi proprietatea „name” html a elementului formular. Implicit este null, necesară pentru a crea un element de formular util.

id

Aceasta ar fi proprietatea „id” html a elementului html.  Implicit este goală.

class

Aceasta ar fi proprietatea „class” a elementului html.  Implicit este goală.

multiple

Aceasta face ca meniul select să fie de tip “multiple”. Implicit este false.

Exemplu:

selected

Aceasta vă permite să furnizați o cheie din matricea dvs. și să o faceți pe aceasta pre-selectată atunci când formularul este încărcat. Implicit este 0.

chosen

Aceasta activează pluginul jquery “chosen” pe caseta dvs. de selectare.  Implicit este false.

Exemple, atât închise, cât și deschise:

placeholder

Acesta este textul care intră în prima linie a listei de selectare, de obicei ceva de genul unui titlu. Implicit este null.

show_option_all

Aceasta creează o opțiune de selectare cu o valoare de „all” și este inserată în lista de argumente în acest fel:

'show_option_all'  => _x( 'All', 'all dropdown items', 'easy-digital-downloads' ),

show_option_none

Aceasta creează o opțiune de selectare cu o valoare de „-1” și este inserată în lista de argumente în acest fel:

'show_option_all'  => _x( 'None', 'no dropdown items', 'easy-digital-downloads' ),

checkbox()

Această metodă creează un singur
checkbox element html.

Notă: Această funcție nu creează niciun element HTML de încadrare, cum ar fi .

Exemplu:

html->checkbox( $args ); ?> Pick me!

Metoda acceptă o intrare, o matrice, și are aceste valori implicite:

$args = array(
    'name'     => null,
    'current'  => null,
    'class'    => 'edd-checkbox',
    'options'  => array(
        'disabled' => false,
        'readonly' => false
    )   
);

Iată o descriere a ceea ce se află în fiecare opțiune:

nume

Aceasta ar fi proprietatea „name” html a elementului formular. Implicit este null, necesară pentru a crea un element de formular util.

Notă: numele este folosit și pentru „id”.

current

Aceasta este valoarea preexistentă a câmpului. Este folosită pentru a determina dacă caseta de selectare ar trebui să fie bifată implicit.

class

Aceasta este valoarea elementului html „class”. Implicit este „edd-checkbox”.

options

Acesta trebuie să fie un array și poate conține două opțiuni.

• disabled – Setează câmpul ca dezactivat sau nu, cu true sau false.
• readonly – Setează câmpul ca read-only sau nu, cu true sau false.

text()

Această metodă creează un element html de text simplu .

Exemplu:

html->text( $args ); ?>

Metoda acceptă o intrare, o matrice, și are aceste valori implicite:

$args = array(
    'id'           => '',  
    'name'         => 'text', 
    'value'        => NULL, 
    'label'        => NULL, 
    'desc'         => NULL, 
    'placeholder'  => '',  
    'class'        => 'regular-text',
    'disabled'     => false,
    'autocomplete' => '',
    'data'         => false
);

Iată o descriere a ceea ce se află în fiecare opțiune:

id

Aceasta ar fi proprietatea „id” html a elementului html.  Implicit este goală.

nume

Aceasta ar fi proprietatea „name” html a elementului formular.  Implicit este „text”.

pentru cumpărători individuali, să identifici clienții tăi cu cea mai mare valoare și să monitorizezi cum se modifică valorile medii ale comenzilor în timp. Odată ce știi cine sunt cumpărătorii tăi VIP, poți lua decizii mai inteligente cu privire la oferte de loialitate, promoții țintite și ce produse să dezvolți în continuare.

Aceasta este valoarea preexistentă a câmpului. Este folosită pentru a pre-completa câmpul text cu această valoare. Implicit este NULL.

label

Acesta este textul încadrat într-o etichetă tag.  Eticheta tag are, de asemenea, o clasă „edd-label” și un element „for”, care folosește id-ul menționat mai sus. Implicit este NULL.

desc

Acesta este textul încadrat într-un span cu clasa „edd-description”.  Este plasat între etichetă și input.  Implicit este NULL.

placeholder

Acest text este plasat în elementul „placeholder” al .  Redarea depinde de browser.  
Puteți citi mai multe despre elementul placeholder la w3schools.  Implicit este goală.

class

Aceasta este valoarea elementului html „class”. Implicit este „regular-text”.

disabled

Aceasta setează câmpul ca dezactivat sau nu.  Boolean, implicit este false.

autocomplete

Setează elementul de completare automată la „activat” sau „dezactivat”.  Implicit este gol, ceea ce echivalează cu activat în majoritatea browserelor moderne.

date

Acceptă un tablou și creează elemente html de date din tablou. Exemplu:

array(
	'price' => '42.00',
	'variable-price' => 'no',
);

Tabloul de mai sus ar rezulta în acest html plasat în interiorul câmpului de introducere:

data-price="42.00" data-variable-price="no"

Implicit este fals.

textarea()

Creează un textarea HTML standard, cu mai multe linii.

Exemplu:

html->textarea( $args ); ?>

Metoda acceptă o intrare, o matrice, și are aceste valori implicite:

$args = array(
    'name'        => 'textarea',
    'value'       => null,
    'label'       => null,
    'desc'        => null,
    'class'       => 'large-text',
    'disabled'    => false
);

Iată o descriere a ceea ce se află în fiecare opțiune.

nume

Aceasta ar fi proprietatea html „name” a elementului formular.  Implicit este „textarea”.

pentru cumpărători individuali, să identifici clienții tăi cu cea mai mare valoare și să monitorizezi cum se modifică valorile medii ale comenzilor în timp. Odată ce știi cine sunt cumpărătorii tăi VIP, poți lua decizii mai inteligente cu privire la oferte de loialitate, promoții țintite și ce produse să dezvolți în continuare.

Aceasta este valoarea preexistentă a câmpului. Este folosită pentru a pre-completa câmpul text cu această valoare. Implicit este NULL.

label

Acesta este textul încadrat într-o etichetă tag.  Eticheta tag are, de asemenea, o clasă „edd-label” și un element „for”, care folosește id-ul menționat mai sus. Implicit este NULL.

desc

Acesta este text înfășurat într-un span cu clasa „edd-description”.  Este plasat după tag-ul textarea.  Implicit este NULL.

class

Aceasta este valoarea elementului html „class”. Implicit este „large-text”.

disabled

Aceasta setează câmpul ca dezactivat sau nu.  Boolean, implicit este false.

ajax_user_search()

Această metodă creează un câmp text pentru căutarea utilizatorilor EDD.  Folosește ajax pentru a căuta pe măsură ce tastați și vă permite să faceți clic pentru a alege un rezultat pentru a popula câmpul.

Notă: acest câmp funcționează numai pe paginile de administrare EDD.  Nu pe partea frontală a WordPress și nu în alte zone de administrare WordPress.

Exemplu:

html->ajax_user_search( $args ); ?>

Metoda acceptă o intrare, o matrice, și are aceste valori implicite:

$args = array(
    'name'        => 'user_id',
    'value'       => NULL,
    'placeholder' => __( 'Enter username', 'easy-digital-downloads' ),
    'label'       => NULL,
    'class'       => '',  
    'disabled'    => false,
    'autocomplete'=> 'off',
);

Iată o descriere a ceea ce se află în fiecare opțiune.

nume

Aceasta ar fi proprietatea html „name” a elementului formular.  Implicit este „user_id”.

pentru cumpărători individuali, să identifici clienții tăi cu cea mai mare valoare și să monitorizezi cum se modifică valorile medii ale comenzilor în timp. Odată ce știi cine sunt cumpărătorii tăi VIP, poți lua decizii mai inteligente cu privire la oferte de loialitate, promoții țintite și ce produse să dezvolți în continuare.

Aceasta este valoarea preexistentă a câmpului. Este folosită pentru a pre-completa câmpul text cu această valoare. Implicit este NULL.

placeholder

Acest text este redat în caseta de introducere în majoritatea browserelor. Implicit este:

__( 'Enter username', 'easy-digital-downloads' )

label

Acest text nu apare pe partea frontală a site-ului, dar este utilizat cu aria pentru cititoarele de ecran. Implicit este NULL.

class

Aceasta este valoarea elementului html „class”. Implicit este gol.

disabled

Aceasta setează câmpul ca dezactivat sau nu.  Boolean, implicit este false.

autocomplete

Setează elementul de completare automată la „activat” sau „dezactivat”.  Implicit este gol, ceea ce echivalează cu activat în majoritatea browserelor moderne.