Klasa EDD_HTML_Elements udostępnia serię metod pomocniczych do renderowania często używanych pól HTML ze spójną strukturą znaczników, nazwami klas i atrybutami.
Klasa zawiera metody dla następujących typów pól:
product_dropdown()
Ta metoda tworzy
select element html z produktami. Wartości to product_ids, a tekst to tytuły pobrań.
Przykład:
echo EDD()->html->product_dropdown();
Stworzyłoby to listę rozwijaną produktów. Metoda przyjmuje jeden argument, tablicę, i ma następujące wartości domyślne:
$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() ) );
Oto opis tego, co znajduje się w każdej opcji:
name
To byłaby właściwość „name” elementu formularza w html. Domyślnie „products”.
Przykład:
class
To byłaby właściwość „class” elementu html. Domyślnie brak.
Przykład:
id
To byłaby właściwość „id” elementu html w html. Domyślnie „customers”.
Przykład:
multiple
To sprawia, że menu wyboru jest typu „multiple”. Domyślnie false.
Przykład:
selected
Pozwala to na podanie customer_id i wybranie go po załadowaniu formularza. Domyślnie 0.
chosen
To aktywuje wtyczkę „chosen” jquery w twoim polu wyboru. Domyślnie false.
Przykłady zarówno zamknięte, jak i otwarte:
liczba
Pozwala to na ustawienie limitu liczby klientów na liście. Domyślnie 30.
placeholder
To jest tekst, który znajduje się w pierwszej linii listy wyboru, zazwyczaj coś w rodzaju tytułu. Domyślnie jest to „Select a Customer”.
discount_dropdown()
Ta metoda tworzy
select element html z listą zniżek. Wartości to discount_ids, a tekst to tytuł zniżki.
Przykład:
echo EDD()->html->discount_dropdown();
Stworzyłoby to listę rozwijaną zniżek.
Wejście
Ta metoda przyjmuje trzy wartości jako dane wejściowe.
name
To jest nazwa elementu html. Domyślnie „edd_discounts”
selected
To jest element, który powinien być wybrany po załadowaniu pola wyboru. Domyślnie nic nie jest ustawione jako wybrane, a domyślnym elementem będzie pierwsza zniżka na liście.
status
Rabaty mogą być aktywne lub nieaktywne. Opcja „status” pozwala wybrać jedno z nich. Domyślnie nie jest zadeklarowany, a wszystkie rabaty są ładowane.
category_dropdown()
Ta metoda tworzy element html
select z listą kategorii pobrań. Wartości to term_ids, a tekst to tytuł kategorii.
Przykład:
echo EDD()->html->category_dropdown();
Stworzyłoby to listę rozwijaną kategorii pobrań.
Wejście
Ta metoda przyjmuje dwie wartości jako dane wejściowe.
name
To jest nazwa elementu html. Domyślnie jest to „edd_categories”
selected
To jest element, który powinien być zaznaczony po załadowaniu pola wyboru. Domyślnie nic nie jest ustawione jako zaznaczone, a pole wyboru będzie miało opcję zatytułowaną „Wszystkie kategorie”.
year_dropdown()
Ta metoda tworzy element html
select z listą lat. Wartość tekstu i opcji to 4-cyfrowy rok.
Przykład:
echo EDD()->html->year_dropdown();
Stworzyłoby to listę rozwijaną 6 lat, z domyślnie zaznaczonym bieżącym rokiem.
Wejście
Ta metoda przyjmuje dwie wartości jako dane wejściowe.
name
To jest nazwa elementu html. Domyślnie jest to „year”
selected
To jest element, który powinien być zaznaczony po załadowaniu pola wyboru. Wymaga czterocyfrowej liczby całkowitej.
month_dropdown()
Ta metoda tworzy element html
select z listą miesięcy. Wartości to nieuzupełnione liczby całkowite, a tekst to trzyliterowe skróty miesięcy.
Przykład:
echo EDD()->html->year_dropdown();
Stworzyłoby to listę rozwijaną 12 miesięcy, z domyślnie zaznaczonym bieżącym miesiącem.
Wejście
Ta metoda przyjmuje dwie wartości jako dane wejściowe.
name
To jest nazwa elementu html. Domyślnie jest to „month”
selected
To jest element, który powinien być zaznaczony po załadowaniu pola wyboru. Wymaga dwucyfrowej liczby całkowitej.
select()
Ta metoda tworzy element html
select i pozwala na wypełnienie go dowolną jednowymiarową tablicą.
Przykład:
echo EDD()->html->select( $args );
Metoda przyjmuje jeden argument, tablicę, i ma następujące domyślne ustawienia:
$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' ),
);
Oto opis tego, co znajduje się w każdej opcji:
options
To jest jednowymiarowa tablica rzeczy takich jak ta:
$args['options'] = array(
'1' => 'Thing 1',
'2' => 'Thing 2',
'3' => 'Thing 3',
'4' => 'Thing 4',
);
Klucze tablicy są używane jako wartości opcji wyboru, a wartości tablicy jako tekst opcji wyboru.
name
To byłaby właściwość „name” elementu formularza html. Domyślnie null, wymagane do stworzenia użytecznego elementu formularza.
id
To byłaby właściwość „id” elementu html. Domyślnie pusta.
class
To byłaby właściwość „class” elementu html. Domyślnie pusta.
multiple
To sprawia, że menu wyboru jest typu „multiple”. Domyślnie false.
Przykład:
selected
Pozwala to na podanie klucza z Twojej tablicy i wybranie go po załadowaniu formularza. Domyślnie 0.
chosen
To aktywuje wtyczkę „chosen” jquery w twoim polu wyboru. Domyślnie false.
Przykłady zamknięte i otwarte:
placeholder
To jest tekst, który znajduje się w pierwszej linii listy wyboru, zazwyczaj coś w rodzaju tytułu. Domyślnie null.
pokaż_opcję_wszystko
Tworzy to opcję wyboru o wartości „all” i jest wstawiana do listy argumentów w następujący sposób:
'show_option_all' => _x( 'All', 'all dropdown items', 'easy-digital-downloads' ),
pokaż_opcję_żadne
Tworzy to opcję wyboru o wartości „-1” i jest wstawiana do listy argumentów w następujący sposób:
'show_option_all' => _x( 'None', 'no dropdown items', 'easy-digital-downloads' ),
checkbox()
Ta metoda tworzy pojedynczy
checkbox element html.
Uwaga: Ta funkcja nie tworzy żadnego otaczającego kodu HTML, takiego jak .
Przykład:
Metoda przyjmuje jeden argument, tablicę, i ma następujące domyślne ustawienia:
$args = array(
'name' => null,
'current' => null,
'class' => 'edd-checkbox',
'options' => array(
'disabled' => false,
'readonly' => false
)
);
Oto opis tego, co znajduje się w każdej opcji:
name
To byłaby właściwość „name” elementu formularza html. Domyślnie null, wymagane do stworzenia użytecznego elementu formularza.
Uwaga: nazwa jest również używana jako „id”.
aktualny
Jest to istniejąca wartość pola. Służy do określenia, czy pole wyboru powinno być domyślnie zaznaczone.
class
Jest to wartość elementu html „class”. Domyślnie „edd-checkbox”.
options
To musi być tablica i może zawierać dwie opcje.
- wyłączony – Ustawia pole na wyłączone lub nie za pomocą true lub false.
- tylko do odczytu – Ustawia pole na tylko do odczytu lub nie za pomocą true lub false.
text()
Ta metoda tworzy zwykły tekst element html.
Przykład:
html->text( $args ); ?>
Metoda przyjmuje jeden argument, tablicę, i ma następujące domyślne ustawienia:
$args = array(
'id' => '',
'name' => 'text',
'value' => NULL,
'label' => NULL,
'desc' => NULL,
'placeholder' => '',
'class' => 'regular-text',
'disabled' => false,
'autocomplete' => '',
'data' => false
);
Oto opis tego, co znajduje się w każdej opcji:
id
Byłaby to właściwość html „id” elementu html. Domyślnie pusta.
name
Byłaby to właściwość html „name” elementu formularza. Domyślnie „text”.
wartość
Jest to istniejąca wartość pola. Służy do wstępnego wypełnienia pola tekstowego tą wartością. Domyślnie NULL.
etykieta
Jest to tekst zawarty w
opis
Jest to tekst zawarty w elemencie span z klasą „edd-description”. Jest umieszczany między etykietą a polem wejściowym. Domyślnie NULL.
placeholder
Ten tekst jest umieszczany w elemencie „placeholder” . Renderowanie zależy od przeglądarki.
Możesz dowiedzieć się więcej o elemencie placeholder na w3schools. Domyślnie pusty.
class
Jest to wartość elementu html „class”. Domyślnie „regular-text”.
wyłączony
Ustawia pole na wyłączone lub nie. Wartość logiczna, domyślnie false.
autouzupełnianie
Ustawia to element autouzupełniania na „włącz” lub „wyłącz”. Domyślnie jest pusty, co w większości nowoczesnych przeglądarek jest równoznaczne z włączeniem.
dane
Akceptuje tablicę i tworzy elementy html danych z tablicy. Przykład:
array( 'price' => '42.00', 'variable-price' => 'no', );
Powyższa tablica spowoduje umieszczenie następującego kodu HTML wewnątrz pola:
data-price="42.00" data-variable-price="no"
Domyślnie fałsz.
textarea()
Tworzy standardowy wieloliniowy obszar tekstowy HTML.
Przykład:
html->textarea( $args ); ?>
Metoda przyjmuje jeden argument, tablicę, i ma następujące domyślne ustawienia:
$args = array(
'name' => 'textarea',
'value' => null,
'label' => null,
'desc' => null,
'class' => 'large-text',
'disabled' => false
);
Oto opis tego, co znajduje się w każdej opcji.
name
To będzie właściwość „name” elementu formularza w kodzie HTML. Domyślnie „textarea”.
wartość
To jest istniejąca wartość pola. Służy do wstępnego wypełnienia pola tekstowego tą wartością. Domyślnie NULL.
etykieta
Jest to tekst zawarty w
opis
Jest to tekst zawarty w elemencie span z klasą „edd-description”. Umieszczany jest po znaczniku textarea. Domyślnie NULL.
class
To jest wartość elementu HTML „class”. Domyślnie „large-text”.
wyłączony
Ustawia pole na wyłączone lub nie. Wartość logiczna, domyślnie false.
ajax_user_search()
Ta metoda tworzy pole tekstowe do wyszukiwania użytkowników EDD. Wykorzystuje ajax do wyszukiwania podczas pisania i pozwala kliknąć, aby wybrać wynik, który wypełni pole.
Uwaga: to pole działa tylko na stronach administracyjnych EDD. Nie na froncie WordPress ani w innych obszarach administracyjnych WordPress.
Przykład:
html->ajax_user_search( $args ); ?>
Metoda przyjmuje jeden argument, tablicę, i ma następujące domyślne ustawienia:
$args = array(
'name' => 'user_id',
'value' => NULL,
'placeholder' => __( 'Enter username', 'easy-digital-downloads' ),
'label' => NULL,
'class' => '',
'disabled' => false,
'autocomplete'=> 'off',
);
Oto opis tego, co znajduje się w każdej opcji.
name
To będzie właściwość „name” elementu formularza w kodzie HTML. Domyślnie „user_id”.
wartość
To jest istniejąca wartość pola. Służy do wstępnego wypełnienia pola tekstowego tą wartością. Domyślnie NULL.
placeholder
Ten tekst jest renderowany w polu wprowadzania tekstu w większości przeglądarek. Domyślnie:
__( 'Enter username', 'easy-digital-downloads' )
etykieta
Ten tekst nie pojawia się na froncie witryny, ale jest używany z aria dla czytników ekranu. Domyślnie NULL.
class
To jest wartość elementu HTML „class”. Domyślnie puste.
wyłączony
Ustawia pole na wyłączone lub nie. Wartość logiczna, domyślnie false.
autouzupełnianie
Ustawia to element autouzupełniania na „włącz” lub „wyłącz”. Domyślnie jest pusty, co w większości nowoczesnych przeglądarek jest równoznaczne z włączeniem.
