Szukaj…


Składnia

  • register_sidebar ($ args)
  • get_sidebar (string $ name = null)

Parametry

Parametr Detale
$ args (string | array) (Opcjonalnie) Buduje pasek boczny na podstawie wartości vvalues o name i id
$ nazwa * (ciąg) (opcjonalnie) Nazwa specjalistycznego paska bocznego. Wartość domyślna: null

Uwagi

Dostępne są następujące argumenty:

  • name - nazwa paska bocznego (domyślnie: zlokalizowany „pasek boczny” i identyfikator numeryczny) .
  • id - identyfikator paska bocznego - wszystkie muszą być pisane małymi literami, bez spacji (domyślnie: automatyczny inkrementowany identyfikator numeryczny) . Jeśli nie ustawisz wartości argumentu id, otrzymasz komunikaty E_USER_NOTICE w trybie debugowania, począwszy od wersji 4.2.
  • opis - tekstowy opis tego, co / gdzie znajduje się pasek boczny. Pokazane na ekranie zarządzania widgetami. (Od 2.9) (domyślnie: pusty)
  • class - klasa CSS do przypisania do paska bocznego na stronie Wygląd -> Administrator widgetu. Ta klasa pojawi się tylko w źródle strony administratora Widżetu WordPress. Nie zostanie uwzględniony w interfejsie Twojej witryny. Uwaga : sidebar wartości zostanie dodany do wartości klasy. Na przykład klasa tal spowoduje wartość klasy sidebar-tal . (domyślnie: pusty) .
  • before_widget - HTML do umieszczenia przed każdym widgetem (domyślnie: <li id="%1$s" class="widget %2$s"> ) Uwaga : używa sprintf do podstawiania zmiennych
  • after_widget - HTML do umieszczenia po każdym widżecie (domyślnie: </li>\n ) .
  • before_title - HTML do umieszczenia przed każdym tytułem (domyślnie: <h2 class="widgettitle"> ) .
  • after_title - HTML do umieszczenia po każdym tytule (domyślnie: </h2>\n ) .

Rejestracja pasków bocznych

W pliku functions.php możesz zarejestrować nowe paski boczne za pomocą tego kodu

/**
 * Registers sidebars
 *
 * @param array Array with default or specified array values
 * @since       1.0.0
 */
if ( function_exists( 'register_sidebar' ) ) {
    register_sidebar( array (
        'name'          => esc_html__( 'Primary Sidebar', 'mytheme'),
        'id'            => 'primary-widget-area',
        'description'   => esc_html__( 'The Primary Widget Area', 'mytheme'),
        'before_widget' => '<div id="%1$s" class="widget %2$s">',
        'after_widget'  => '</div>',
        'before_title'  => '<div class="sidebar-widget-heading"><h3>',
        'after_title'   => '</h3></div>',
    ) );

    register_sidebar( array (
        'name'          => esc_html__( 'Secondary Sidebar', 'mytheme'),
        'id'            => 'secondary-widget-area',
        'description'   => esc_html__( 'The Secondary Widget Area', 'mytheme'),
        'before_widget' => '<div id="%1$s" class="widget %2$s">',
        'after_widget'  => '</div>',
        'before_title'  => '<div class="sidebar-widget-heading"><h3>',
        'after_title'   => '</h3></div>',
    ) );
}

Możesz dodać tyle pasków bocznych, ile chcesz.

Uzyskaj pasek boczny

Możesz również utworzyć własny plik paska bocznego w kompozycji, aby wywołać go w różnych szablonach. Skopiuj i wklej sidebar.php bieżącego motywu i zmień nazwę (np. Sidebar-book.php)

W szablonie możesz wywołać ten pasek boczny za pomocą get_sidebar('book') . Za pomocą tego możesz wywoływać różne paski boczne na różnych stronach.



Modified text is an extract of the original Stack Overflow Documentation
Licencjonowany na podstawie CC BY-SA 3.0
Nie związany z Stack Overflow