EDD_HTML_Elements

De EDD_HTML_Elements klasse biedt een reeks hulpmethoden voor het weergeven van veelgebruikte HTML-velden met consistente markup, class namen en attributen.

De klasse bevat methoden voor de volgende veldtypen:

product_dropdown()

Deze methode maakt een
select html-element met producten erin. Waarden zijn product_ids en de tekst is de Download titel.

Voorbeeld:

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

Dit zou een keuzelijst met producten maken.  De methode neemt één invoer, een array, en heeft deze standaardwaarden:

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

Hier is een beschrijving van wat er in elke optie staat:

naam

Dit zou de html “name” eigenschap van het formulierelement zijn.  Standaard is dit ‘products’.

Voorbeeld:

id

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

	Example:

class

Dit zou de “class” eigenschap van het html-element zijn.  Standaard is dit niets.

Voorbeeld:

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

Dit zou de html “id” eigenschap van het html-element zijn.  Standaard is dit ‘customers’.

Voorbeeld:

class

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

	Example:

multiple

Dit maakt het selectiemenu van het type “multiple”. Standaard is dit false.

Voorbeeld:

selected

Hiermee kunt u een customer_id opgeven en deze vooraf laten selecteren wanneer het formulier wordt geladen.  Standaard is dit 0.

chosen

Dit activeert de “chosen” jquery plugin op uw selectiebox.  Standaard is dit false.

Voorbeelden zowel gesloten als open:

aantal

Hiermee kunt u een limiet instellen voor het aantal klanten in uw lijst.  Standaard is dit 30.

placeholder

Dit is de tekst die in de eerste regel van de selectielijst staat, meestal iets als een titel. De standaard is “Select a Customer”.

discount_dropdown()

Deze methode maakt een
select html-element met een lijst van Kortingen erin. Waarden zijn discount_ids en de tekst is de titel van de Korting.

Voorbeeld:

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

Dit zou een keuzelijst met kortingen maken.

Invoer

Deze methode neemt drie waarden als invoer.

naam

Dit is de naam van het html-element.  De standaard is ‘edd_discounts’

selected

Dit is het item dat geselecteerd moet worden wanneer de selectiebox wordt geladen.  De standaard is dat er niets is ingesteld om te selecteren, en het standaarditem is de eerste korting in de lijst.

status

Kortingen kunnen actief of inactief zijn.  De optie ‘status’ maakt de keuze tussen een van beide mogelijk.  De standaardinstelling is om niets te specificeren, en alle kortingen worden geladen.

category_dropdown()

Deze methode creëert een
select html-element met daarin een lijst van Download-categorieën. Waarden zijn term_ids en de tekst is de titel van de categorie.

Voorbeeld:

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

Dit zou een keuzelijst met Download-categorieën creëren.

Invoer

Deze methode neemt twee waarden als invoer.

naam

Dit is de naam van het html-element.  De standaardinstelling is ‘edd_categories’

selected

Dit is het item dat moet worden geselecteerd wanneer de keuzelijst wordt geladen.  De standaardinstelling is om niets ingesteld te hebben om te selecteren, en de keuzelijst zal een optie hebben met de titel “Alle categorieën”.

year_dropdown()

Deze methode creëert een
select html-element met daarin een lijst van jaren. Tekst en optiewaarde zijn beide een 4-cijferig jaar.

Voorbeeld:

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

Dit zou een keuzelijst met 6 jaar creëren, met het huidige jaar standaard geselecteerd.

Invoer

Deze methode neemt twee waarden als invoer.

naam

Dit is de naam van het html-element.  De standaardinstelling is ‘year’

selected

Dit is het item dat moet worden geselecteerd wanneer de keuzelijst wordt geladen.  Vereist een viercijferig geheel getal.

month_dropdown()

Deze methode creëert een
select html-element met daarin een lijst van maanden. Waarden zijn niet-opgevulde gehele getallen en de tekst zijn drieletterige afkortingen van maanden.

Voorbeeld:

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

Dit zou een keuzelijst met 12 maanden creëren, met de huidige maand standaard geselecteerd.

Invoer

Deze methode neemt twee waarden als invoer.

naam

Dit is de naam van het html-element.  De standaardinstelling is ‘month’

selected

Dit is het item dat moet worden geselecteerd wanneer de keuzelijst wordt geladen.  Vereist een tweecijferig geheel getal.

select()

Deze methode creëert een
select html-element en stelt u in staat deze te vullen met elke eendimensionale array.

Voorbeeld:

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

De methode neemt één invoer, een array, en heeft deze standaardwaarden:

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

Hier is een beschrijving van wat er in elke optie staat:

options

Dit is een eendimensionale array van dingen zoals deze:

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

De array-sleutels worden gebruikt als de selectie-optiewaarden, en de array-waarden worden gebruikt als de selectie-optietekst.

naam

Dit zou het html “name” attribuut van het formulierelement zijn.  Standaard is null, vereist om een nuttig formulierelement te maken.

id

Dit zou het html “id” attribuut van het html-element zijn.  Standaard is leeg.

class

Dit zou de “class” eigenschap van het html-element zijn.  Standaard is leeg.

multiple

Dit maakt het selectiemenu van het type “multiple”. Standaard is dit false.

Voorbeeld:

selected

Dit stelt u in staat om een sleutel uit uw array op te geven en die als eerste te laten selecteren wanneer het formulier wordt geladen.  Standaard is 0.

chosen

Dit activeert de “chosen” jquery plugin op uw selectiebox.  Standaard is dit false.

Voorbeelden, zowel gesloten als open:

placeholder

Dit is de tekst die in de eerste regel van de selectielijst komt, meestal iets als een titel. De standaardinstelling is null.

show_option_all

Dit creëert een selectoptie met een waarde van "all" en wordt op deze manier aan de argumentenlijst toegevoegd:

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

show_option_none

Dit creëert een selectoptie met een waarde van "-1" en wordt op deze manier aan de argumentenlijst toegevoegd:

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

checkbox()

Deze methode creëert een enkel
checkbox html-element.

Opmerking: Deze functie creëert geen omringende HTML zoals .

Voorbeeld:

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

De methode neemt één invoer, een array, en heeft deze standaardwaarden:

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

Hier is een beschrijving van wat er in elke optie staat:

naam

Dit zou het html “name” attribuut van het formulierelement zijn.  Standaard is null, vereist om een nuttig formulierelement te maken.

Opmerking: de naam wordt ook gebruikt voor de 'id'.

current

Dit is de vooraf bestaande waarde van het veld. Het wordt gebruikt om te bepalen of de checkbox standaard aangevinkt moet zijn.

class

Dit is de waarde van het 'class' html-element. Standaard is dit 'edd-checkbox'.

options

Dit moet een array zijn en kan twee opties bevatten.

• disabled – Stelt het veld in op uitgeschakeld of niet met true of false.
• readonly – Stelt het veld in op alleen-lezen of niet met true of false.

text()

Deze methode creëert een platte tekst html-element.

Voorbeeld:

html->text( $args ); ?>

De methode neemt één invoer, een array, en heeft deze standaardwaarden:

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

Hier is een beschrijving van wat er in elke optie staat:

id

Dit zou de html "id" eigenschap van het html-element zijn. Standaard is dit leeg.

naam

Dit zou de html "name" eigenschap van het formulier-element zijn. Standaard is dit "text".

waarde

Dit is de vooraf bestaande waarde van het veld. Het wordt gebruikt om het tekstveld vooraf in te vullen met deze waarde. Standaard is dit NULL.

label

Dit is de tekst die is verpakt in een tag. De tag heeft ook een klasse van "edd-label" en een "for" element dat de bovengenoemde id gebruikt. Standaard is dit NULL.

desc

Dit is tekst die is verpakt in een span met een klasse van "edd-description". Het wordt tussen het label en de invoer geplaatst. Standaard is dit NULL.

placeholder

Deze tekst wordt geplaatst in het "placeholder" element van de . De weergave is afhankelijk van de browser.
U kunt meer lezen over het placeholder-element op w3schools. Standaard is dit leeg.

class

Dit is de waarde van het 'class' html-element. Standaard is dit 'regular-text'.

disabled

Dit stelt het veld in op uitgeschakeld of niet. Boolean, standaard is false.

autocomplete

Dit stelt het autocomplete-element in op "aan" of "uit".  Standaard leeg, wat in de meeste moderne browsers gelijk staat aan "aan".

data

Dit accepteert een array en maakt data html-elementen van de array. Voorbeeld:

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

De bovenstaande array zou resulteren in deze html die in de input wordt geplaatst:

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

Standaard onwaar.

textarea()

Dit maakt een standaard HTML-tekstgebied met meerdere regels.

Voorbeeld:

html->textarea( $args ); ?>

De methode neemt één invoer, een array, en heeft deze standaardwaarden:

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

Hier is een beschrijving van wat er in elke optie staat.

naam

Dit zou de html "name"-eigenschap van het formulierelement zijn.  Standaard "textarea".

waarde

Dit is de vooraf bestaande waarde van het veld. Het wordt gebruikt om het tekstveld vooraf te vullen met deze waarde. Standaard NULL.

label

Dit is de tekst die is verpakt in een tag. De tag heeft ook een klasse van "edd-label" en een "for" element dat de bovengenoemde id gebruikt. Standaard is dit NULL.

desc

Dit is tekst die is omwikkeld met een span met een klasse van "edd-description".  Het wordt na de textarea-tag geplaatst.  Standaard NULL.

class

Dit is de waarde van het 'class' html-element. Standaard 'large-text'.

disabled

Dit stelt het veld in op uitgeschakeld of niet. Boolean, standaard is false.

ajax_user_search()

Deze methode maakt een tekstveld voor het zoeken naar EDD-gebruikers.  Het gebruikt ajax om te zoeken terwijl u typt, en stelt u in staat om op een resultaat te klikken om het veld te vullen.

Opmerking: dit veld werkt alleen op EDD admin-pagina's.  Niet op de voorkant van WordPress, en niet op andere WordPress admin-gebieden.

Voorbeeld:

html->ajax_user_search( $args ); ?>

De methode neemt één invoer, een array, en heeft deze standaardwaarden:

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

Hier is een beschrijving van wat er in elke optie staat.

naam

Dit zou de html "name"-eigenschap van het formulierelement zijn.  Standaard "user_id".

waarde

Dit is de vooraf bestaande waarde van het veld. Het wordt gebruikt om het tekstveld vooraf te vullen met deze waarde. Standaard NULL.

placeholder

Deze tekst wordt in de meeste browsers in het invoerveld weergegeven. Standaard:

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

label

Deze tekst verschijnt niet aan de voorkant van de site, maar wordt gebruikt met aria voor schermlezers. Standaard NULL.

class

Dit is de waarde van het 'class' html-element. Standaard leeg.

disabled

Dit stelt het veld in op uitgeschakeld of niet. Boolean, standaard is false.

autocomplete

Dit stelt het autocomplete-element in op "aan" of "uit".  Standaard leeg, wat in de meeste moderne browsers gelijk staat aan "aan".