EDD_HTML_Elements

La classe EDD_HTML_Elements fornisce una serie di metodi di utilità per il rendering di campi HTML comunemente usati con markup, nomi di classe e attributi coerenti.

La classe include metodi per i seguenti tipi di campo:

product_dropdown()

Questo metodo crea un elemento html select con i prodotti al suo interno. I valori sono product_id e il testo sono i titoli dei Download.

Esempio:

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

Questo creerebbe un elenco a discesa di prodotti.  Il metodo accetta un input, un array, e ha questi valori predefiniti:

$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() )
);

Ecco una descrizione di ciò che è presente in ogni opzione:

nome

Questa sarebbe la proprietà "name" html dell'elemento del modulo.  Il valore predefinito è 'products'.

Esempio:

id

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

	Example:

class

Questa sarebbe la proprietà "class" dell'elemento html.  Il valore predefinito è nessuno.

Esempio:

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

Questa sarebbe la proprietà "id" html dell'elemento html.  Il valore predefinito è 'customers'.

Esempio:

class

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

	Example:

multiple

Questo rende il menu di selezione di tipo "multiple". Il valore predefinito è false.

Esempio:

selected

Questo ti permette di fornire un customer_id e farlo pre-selezionare quando il modulo viene caricato.  Il valore predefinito è 0.

chosen

Questo attiva il plugin jquery "chosen" sulla tua select box.  Il valore predefinito è false.

Esempi sia chiusi che aperti:

numero

Questo ti permette di impostare un limite al numero di clienti nella tua lista.  Il valore predefinito è 30.

placeholder

Questo è il testo che va nella prima riga dell'elenco di selezione, di solito qualcosa come un titolo. Il valore predefinito è "Seleziona un cliente".

discount_dropdown()

Questo metodo crea un elemento html select con un elenco di Sconti al suo interno. I valori sono discount_id e il testo è il titolo dello Sconto.

Esempio:

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

Questo creerebbe un elenco a discesa di sconti.

Input

Questo metodo accetta tre valori in input.

nome

Questo è il nome dell'elemento html.  Il valore predefinito è 'edd_discounts'

selected

Questo è l'elemento che dovrebbe essere selezionato quando la select box viene caricata.  Il valore predefinito è non avere nulla impostato come selezionato, e l'elemento predefinito sarà il primo sconto nella lista.

stato

Gli sconti possono essere attivi o inattivi.  L'opzione ‘stato’ permette di scegliere uno dei due.  L'impostazione predefinita è non dichiarare, e tutti gli sconti vengono caricati.

category_dropdown()

Questo metodo crea un elemento html
select con un elenco di categorie di Download al suo interno. I valori sono term_ids e il testo è il titolo della categoria.

Esempio:

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

Questo creerebbe un menu a tendina di categorie di Download.

Input

Questo metodo accetta due valori in input.

nome

Questo è il nome dell'elemento html.  L'impostazione predefinita è ‘edd_categories’

selected

Questo è l'elemento che dovrebbe essere selezionato al caricamento della casella di selezione. L'impostazione predefinita è non avere nulla impostato per essere selezionato, e la casella di selezione avrà un'opzione intitolata “Tutte le categorie”.

year_dropdown()

Questo metodo crea un elemento html
select con un elenco di anni al suo interno. Il testo e il valore dell'opzione sono entrambi un anno a 4 cifre.

Esempio:

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

Questo creerebbe un menu a tendina di 6 anni, con l'anno corrente selezionato per impostazione predefinita.

Input

Questo metodo accetta due valori in input.

nome

Questo è il nome dell'elemento html.  L'impostazione predefinita è ‘year’

selected

Questo è l'elemento che dovrebbe essere selezionato al caricamento della casella di selezione.  Richiede un intero a quattro cifre.

month_dropdown()

Questo metodo crea un elemento html
select con un elenco di mesi al suo interno. I valori sono interi non imbottiti e il testo sono abbreviazioni di tre lettere dei mesi.

Esempio:

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

Questo creerebbe un menu a tendina di 12 mesi, con il mese corrente selezionato per impostazione predefinita.

Input

Questo metodo accetta due valori in input.

nome

Questo è il nome dell'elemento html.  L'impostazione predefinita è ‘month’

selected

Questo è l'elemento che dovrebbe essere selezionato al caricamento della casella di selezione. Richiede un intero a due cifre.

select()

Questo metodo crea un elemento html
select e ti permette di popolarlo con qualsiasi array monodimensionale.

Esempio:

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

Il metodo accetta un input, un array, e ha questi valori predefiniti:

$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' ),
);

Ecco una descrizione di ciò che è presente in ogni opzione:

opzioni

Questo è un array monodimensionale di cose come questa:

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

Le chiavi dell'array vengono utilizzate come valori delle opzioni di selezione e i valori dell'array vengono utilizzati come testo delle opzioni di selezione.

nome

Questa sarebbe la proprietà “name” html dell'elemento del modulo.  Il valore predefinito è null, è richiesto per creare un elemento del modulo utile.

id

Questa sarebbe la proprietà “id” html dell'elemento html.  Il valore predefinito è vuoto.

class

Questa sarebbe la proprietà “class” dell'elemento html.  Il valore predefinito è vuoto.

multiple

Questo rende il menu di selezione di tipo "multiple". Il valore predefinito è false.

Esempio:

selected

Questo ti permette di fornire una chiave dal tuo array e farla pre-selezionare quando il modulo viene caricato.  Il valore predefinito è 0.

chosen

Questo attiva il plugin jquery "chosen" sulla tua select box.  Il valore predefinito è false.

Esempi sia chiusi che aperti:

placeholder

Questo è il testo che va nella prima riga dell'elenco di selezione, di solito qualcosa come un titolo. Il valore predefinito è null.

show_option_all

Questo crea un'opzione di selezione con un valore di "all" e viene inserita nell'elenco degli argomenti in questo modo:

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

show_option_none

Questo crea un'opzione di selezione con un valore di "-1" e viene inserita nell'elenco degli argomenti in questo modo:

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

checkbox()

Questo metodo crea un singolo
checkbox elemento html.

Nota: Questa funzione non crea alcun HTML di wrapping come .

Esempio:

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

Il metodo accetta un input, un array, e ha questi valori predefiniti:

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

Ecco una descrizione di ciò che è presente in ogni opzione:

nome

Questa sarebbe la proprietà “name” html dell'elemento del modulo.  Il valore predefinito è null, è richiesto per creare un elemento del modulo utile.

Nota: il nome viene utilizzato anche per l'"id".

current

Questo è il valore preesistente del campo. Viene utilizzato per determinare se la casella di controllo deve essere selezionata per impostazione predefinita.

class

Questo è il valore dell'elemento html 'class'. Predefinito su 'edd-checkbox'.

opzioni

Questo deve essere un array e può contenere due opzioni.

• disabled – Imposta il campo su disabilitato o meno con true o false.
• readonly – Imposta il campo su di sola lettura o meno con true o false.

text()

Questo metodo crea un elemento html di testo semplice .

Esempio:

html->text( $args ); ?>

Il metodo accetta un input, un array, e ha questi valori predefiniti:

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

Ecco una descrizione di ciò che è presente in ogni opzione:

id

Questa sarebbe la proprietà html "id" dell'elemento html.  Predefinito su vuoto.

nome

Questa sarebbe la proprietà html "name" dell'elemento del modulo.  Predefinito su "text".

valore

Questo è il valore preesistente del campo. Viene utilizzato per precompilare il campo di testo con questo valore. Predefinito su NULL.

label

Questo è il testo racchiuso in un tag.  Il tag ha anche una classe "edd-label" e un elemento "for" che utilizza l'id menzionato sopra. Predefinito su NULL.

desc

Questo è testo racchiuso in uno span con una classe "edd-description".  Viene posizionato tra l'etichetta e l'input.  Predefinito su NULL.

placeholder

Questo testo viene inserito nell'elemento "placeholder" dell'.  Il rendering dipende dal browser.  
Puoi leggere di più sull'elemento placeholder su w3schools.  Il predefinito è vuoto.

class

Questo è il valore dell'elemento html 'class'. Predefinito su 'regular-text'.

disabled

Questo imposta il campo su disabilitato o meno.  Booleano, predefinito su false.

autocomplete

Imposta l'elemento di completamento automatico su "on" o "off".  Il valore predefinito è vuoto, che equivale a "on" nella maggior parte dei browser moderni.

dati

Accetta un array e crea elementi html di dati dall'array. Esempio:

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

L'array sopra risulterebbe in questo html inserito nell'input:

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

Il valore predefinito è false.

textarea()

Crea un'area di testo HTML standard multilinea.

Esempio:

html->textarea( $args ); ?>

Il metodo accetta un input, un array, e ha questi valori predefiniti:

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

Ecco una descrizione di ciò che è presente in ogni opzione.

nome

Questa sarebbe la proprietà "name" html dell'elemento del modulo.  Il valore predefinito è "textarea".

valore

Questo è il valore preesistente del campo. Viene utilizzato per precompilare il campo di testo con questo valore. Il valore predefinito è NULL.

label

Questo è il testo racchiuso in un tag.  Il tag ha anche una classe "edd-label" e un elemento "for" che utilizza l'id menzionato sopra. Predefinito su NULL.

desc

Questo è testo racchiuso in uno span con una classe "edd-description".  Viene posizionato dopo il tag textarea.  Il valore predefinito è NULL.

class

Questo è il valore dell'elemento html 'class'. Il valore predefinito è 'large-text'.

disabled

Questo imposta il campo su disabilitato o meno.  Booleano, predefinito su false.

ajax_user_search()

Questo metodo crea un campo di testo per la ricerca di utenti EDD.  Utilizza ajax per cercare mentre digiti e ti consente di fare clic per scegliere un risultato per popolare il campo.

Nota: questo campo funziona solo nelle pagine di amministrazione EDD.  Non nel front-end di WordPress, né in altre aree di amministrazione di WordPress.

Esempio:

html->ajax_user_search( $args ); ?>

Il metodo accetta un input, un array, e ha questi valori predefiniti:

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

Ecco una descrizione di ciò che è presente in ogni opzione.

nome

Questa sarebbe la proprietà "name" html dell'elemento del modulo.  Il valore predefinito è "user_id".

valore

Questo è il valore preesistente del campo. Viene utilizzato per precompilare il campo di testo con questo valore. Il valore predefinito è NULL.

placeholder

Questo testo viene visualizzato nella casella di input nella maggior parte dei browser. Il valore predefinito è:

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

label

Questo testo non appare sul front-end del sito, ma viene utilizzato con aria per gli screen reader. Il valore predefinito è NULL.

class

Questo è il valore dell'elemento html 'class'. Il valore predefinito è vuoto.

disabled

Questo imposta il campo su disabilitato o meno.  Booleano, predefinito su false.

autocomplete

Imposta l'elemento di completamento automatico su "on" o "off".  Il valore predefinito è vuoto, che equivale a "on" nella maggior parte dei browser moderni.