Описание пунктов меню? Пользовательский ходунок для wp_nav_menu ()
-
16-10-2019 - |
Вопрос
Нормальное меню WordPress выглядит как:
Главная | Блог | О нас | Контакт
Но я видел много страниц с описаниями по этим ссылкам:
Домашняя страница | Наши блоги | О нас | Контакт
.... встретить нас ... | Читать дальше | Основная информация | Форма обратной связи
Как это достичь?
(Я хочу, чтобы это было основной функцией для всех моих тем, так что никаких плагинов, пожалуйста, я просто хочу знать, как это делается)
Решение
Вам нужен индивидуальный ходунок для меню NAV.
В основном вы добавляете параметр 'walker'
в wp_nav_menu()
Параметры и вызовите экземпляр расширенного класса:
wp_nav_menu(
array (
'menu' => 'main-menu',
'container' => FALSE,
'container_id' => FALSE,
'menu_class' => '',
'menu_id' => FALSE,
'depth' => 1,
'walker' => new Description_Walker
)
);
Класс Description_Walker
расширяется Walker_Nav_Menu
и меняет функцию start_el( &$output, $item, $depth, $args )
искать $item->description
.
Основной пример:
/**
* Create HTML list of nav menu items.
* Replacement for the native Walker, using the description.
*
* @see https://wordpress.stackexchange.com/q/14037/
* @author fuxia
*/
class Description_Walker extends Walker_Nav_Menu
{
/**
* Start the element output.
*
* @param string $output Passed by reference. Used to append additional content.
* @param object $item Menu item data object.
* @param int $depth Depth of menu item. May be used for padding.
* @param array|object $args Additional strings. Actually always an
instance of stdClass. But this is WordPress.
* @return void
*/
function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 )
{
$classes = empty ( $item->classes ) ? array () : (array) $item->classes;
$class_names = join(
' '
, apply_filters(
'nav_menu_css_class'
, array_filter( $classes ), $item
)
);
! empty ( $class_names )
and $class_names = ' class="'. esc_attr( $class_names ) . '"';
$output .= "<li id='menu-item-$item->ID' $class_names>";
$attributes = '';
! empty( $item->attr_title )
and $attributes .= ' title="' . esc_attr( $item->attr_title ) .'"';
! empty( $item->target )
and $attributes .= ' target="' . esc_attr( $item->target ) .'"';
! empty( $item->xfn )
and $attributes .= ' rel="' . esc_attr( $item->xfn ) .'"';
! empty( $item->url )
and $attributes .= ' href="' . esc_attr( $item->url ) .'"';
// insert description for top level elements only
// you may change this
$description = ( ! empty ( $item->description ) and 0 == $depth )
? '<small class="nav_desc">' . esc_attr( $item->description ) . '</small>' : '';
$title = apply_filters( 'the_title', $item->title, $item->ID );
$item_output = $args->before
. "<a $attributes>"
. $args->link_before
. $title
. '</a> '
. $args->link_after
. $description
. $args->after;
// Since $output is called by reference we don't need to return anything.
$output .= apply_filters(
'walker_nav_menu_start_el'
, $item_output
, $item
, $depth
, $args
);
}
}
Или, в качестве альтернативы как прокомментировал @Nevvermind, ты мог наследовать Все функциональные возможности родительского start_el
функция и справедливо добавлять Описание $output
:
function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 )
{
parent::start_el( $output, $item, $depth, $args );
$output .= sprintf(
'<i>%s</i>',
esc_html( $item->description )
);
}
Вывод образца:
Теперь включите поле описания в wp-admin/nav-menus.php
Чтобы получить возможность редактировать это поле. Если вы не WP просто разбивает свой полный пост -контент в него.
Дальнейшее чтение:
- Связанные ошибки
- Подобный пример с различной наценкой и форматированием
- Включить окно описания в экране управления меню программно.
- Соберите описание предмета для последующего использования
Вот и все.
Другие советы
С WordPress 3.0, ты не Уже на заказ ходунку!
Здесь walker_nav_menu_start_el
Фильтр, см https://developer.wordpress.org/reference/hooks/walker_nav_menu_start_el/
Пример:
function add_description_to_menu($item_output, $item, $depth, $args) {
if (strlen($item->description) > 0 ) {
// append description after link
$item_output .= sprintf('<span class="description">%s</span>', esc_html($item->description));
// insert description as last item *in* link ($input_output ends with "</a>{$args->after}")
//$item_output = substr($item_output, 0, -strlen("</a>{$args->after}")) . sprintf('<span class="description">%s</span >', esc_html($item->description)) . "</a>{$args->after}";
}
return $item_output;
}
add_filter('walker_nav_menu_start_el', 'add_description_to_menu', 10, 4);
Это не лучше или хуже, чем другие предложения; Это просто по -другому. Это короткое и сладкое.
Вместо использования поля описания как @toscho Предлагает, вы можете заполнить поле «заголовок» в каждом элементе меню с помощью текста, который вы хотите, а затем использовать этот CSS:
.menu-item a:after { content: attr(title); }
Это также будет легко использовать jQuery Чтобы добавить его, но текст достаточно декоративный, чтобы CSS кажется подходящим.
Вы также можете написать <span>
элемент после навигационной метки в меню и используйте следующее правило CSS, чтобы изменить его display
настройка (это inline
по умолчанию):
span {display:block}