Lo que está permitido como argumento id en register_sidebar ($ args)

13

Quiero registrar una barra lateral pero estoy un poco confundido acerca de los usos del idargumento en la register_sidebarfunción.

El códice dice: id - Identificación de la barra lateral - Debe estar todo en minúsculas, sin espacios (el valor predeterminado es una identificación numérica con incremento automático).

¿De qué sirve el idargumento y debe ser siempre en forma numérica?

register-sidebar Gandalf
fuente

Respuestas:

10

La ID de la barra lateral se utiliza para identificar de forma exclusiva esta barra lateral específica. Si no lo configura y algo crea otro, ¡podría descubrir que su barra lateral se mueve inesperadamente!

No necesita ser numérico; también puede usar cadenas.

John Landells
fuente
32

La respuesta de John Landells es buena y correcta.

Quiero agregar una lista de ID prohibidas o reservadas ; estas ID pueden aparecer en la página de configuración del widget /wp-admin/widgets.php. Si usa uno de estos ... sucederán cosas extrañas debido a identificaciones duplicadas. Arrastrar y soltar probablemente ya no funcione. Ver Ticket # 14466 para el caso más obvio: #footer.

Actualización, 17 de septiembre: #footer se permitirá en WP 3.5 .
Actualización, 6 de noviembre: por boleto 14466, todas las ID de widget widgets.phptienen el prefijo sidebar-ahora. La siguiente lista quedará obsoleta con WordPress 3.5. Probablemente.

Además, una identificación no debe comenzar con un número, eso es HTML no válido.

Complementos instalados que afectan a esta lista: Debug Bar , Debug Bar Cron , Monster Widget .

#_wpnonce_widgets
#ab-awaiting-mod
#access-off
#access-on
#adminmenu
#adminmenuback
#adminmenushadow
#adminmenuwrap
#adv-settings
#available-widgets
#collapse-button
#collapse-menu
#colors-css
#contextual-help-back
#contextual-help-columns
#contextual-help-link
#contextual-help-link-wrap
#contextual-help-wrap
#debug-bar-actions
#debug-bar-cron
#debug-bar-css
#debug-bar-info
#debug-bar-menu
#debug-bar-wp-query
#debug-menu-link-Debug_Bar_Object_Cache
#debug-menu-link-Debug_Bar_Queries
#debug-menu-link-Debug_Bar_WP_Query
#debug-menu-link-ZT_Debug_Bar_Cron
#debug-menu-links
#debug-menu-target-Debug_Bar_Object_Cache
#debug-menu-target-Debug_Bar_Queries
#debug-menu-target-Debug_Bar_WP_Query
#debug-menu-target-ZT_Debug_Bar_Cron
#debug-menu-targets
#debug-status
#debug-status-db
#debug-status-memory
#debug-status-php
#debug-status-site
#footer
#footer-left
#footer-thankyou
#footer-upgrade
#icon-themes
#menu-appearance
#menu-comments
#menu-dashboard
#menu-links
#menu-media
#menu-pages
#menu-plugins
#menu-posts
#menu-posts-domicile
#menu-settings
#menu-tools
#menu-users
#object-cache-stats
#querylist
#removing-widget
#rss-items-2
#rss-items-__i__
#rss-show-author-2
#rss-show-author-__i__
#rss-show-date-2
#rss-show-date-__i__
#rss-show-summary-2
#rss-show-summary-__i__
#rss-title-2
#rss-title-__i__
#rss-url-2
#rss-url-__i__
#screen-meta
#screen-meta-links
#screen-options-link-wrap
#screen-options-wrap
#screenoptionnonce
#show-settings-link
#tab-link-missing-widgets
#tab-link-overview
#tab-link-removing-reusing
#tab-panel-missing-widgets
#tab-panel-overview
#tab-panel-removing-reusing
#widget-10_recent-posts-__i__
#widget-11_rss-__i__
#widget-12_search-__i__
#widget-13_tag_cloud-__i__
#widget-14_text-__i__
#widget-15_widget_twentyeleven_ephemera-__i__
#widget-16_rss-2
#widget-1_archives-__i__
#widget-2_calendar-__i__
#widget-3_categories-__i__
#widget-4_nav_menu-__i__
#widget-5_links-__i__
#widget-6_meta-__i__
#widget-7_monster-__i__
#widget-8_pages-__i__
#widget-9_recent-comments-__i__
#widget-archives-__i__-count
#widget-archives-__i__-dropdown
#widget-archives-__i__-savewidget
#widget-archives-__i__-title
#widget-calendar-__i__-savewidget
#widget-calendar-__i__-title
#widget-categories-__i__-count
#widget-categories-__i__-dropdown
#widget-categories-__i__-hierarchical
#widget-categories-__i__-savewidget
#widget-categories-__i__-title
#widget-links-__i__-category
#widget-links-__i__-description
#widget-links-__i__-images
#widget-links-__i__-limit
#widget-links-__i__-name
#widget-links-__i__-orderby
#widget-links-__i__-rating
#widget-links-__i__-savewidget
#widget-list
#widget-meta-__i__-savewidget
#widget-meta-__i__-title
#widget-monster-__i__-savewidget
#widget-nav_menu-__i__-nav_menu
#widget-nav_menu-__i__-savewidget
#widget-nav_menu-__i__-title
#widget-pages-__i__-exclude
#widget-pages-__i__-savewidget
#widget-pages-__i__-sortby
#widget-pages-__i__-title
#widget-recent-comments-__i__-number
#widget-recent-comments-__i__-savewidget
#widget-recent-comments-__i__-title
#widget-recent-posts-__i__-number
#widget-recent-posts-__i__-savewidget
#widget-recent-posts-__i__-title
#widget-rss-2-savewidget
#widget-rss-__i__-savewidget
#widget-search-__i__-savewidget
#widget-search-__i__-title
#widget-tag_cloud-__i__-savewidget
#widget-tag_cloud-__i__-taxonomy
#widget-tag_cloud-__i__-title
#widget-text-__i__-filter
#widget-text-__i__-savewidget
#widget-text-__i__-text
#widget-text-__i__-title
#widget-widget_twentyeleven_ephemera-__i__-number
#widget-widget_twentyeleven_ephemera-__i__-savewidget
#widget-widget_twentyeleven_ephemera-__i__-title
#widgets-left
#widgets-right
#wp-admin-bar-a8c_developer
#wp-admin-bar-comments
#wp-admin-bar-debug-bar
#wp-admin-bar-edit-profile
#wp-admin-bar-logout
#wp-admin-bar-my-account
#wp-admin-bar-new-content
#wp-admin-bar-new-content-default
#wp-admin-bar-new-domicile
#wp-admin-bar-new-link
#wp-admin-bar-new-media
#wp-admin-bar-new-page
#wp-admin-bar-new-post
#wp-admin-bar-new-user
#wp-admin-bar-root-default
#wp-admin-bar-site-name
#wp-admin-bar-site-name-default
#wp-admin-bar-top-secondary
#wp-admin-bar-updates
#wp-admin-bar-user-actions
#wp-admin-bar-user-info
#wp-admin-bar-view-site
#wp_inactive_widgets
#wpadminbar
#wpbody
#wpbody-content
#wpcontent
#wpwrap
#zt-debug-bar-cron-css

Recopilé las ID con un pequeño complemento que se puede usar en cualquier página:

<?php # -*- coding: utf-8 -*-
/* Plugin Name: T5 List IDs */
add_action( 'shutdown', function()
{ ?>
<script>
jQuery( function( $ )
{
    var els = []
    $( '[id]' ).each( function() { els.push( this.id ) } )
    els.sort()
    var pre = $( '<pre/>' ).css( 'margin','10px' ).html( '#'+els.join( '<br>#' ) )
    $( document.documentElement ).append( pre )
})
</script><?php
}
);
fuxia
fuente
8
+1 (Editar) Agregado al Codexregister_sidebar() .
kaiser
Por alguna razón, las áreas de widgets cuya identificación comienza con headtienden a no mostrarse correctamente en la página de administración, al menos para mí
Manny Fleurmond
En WP 4.1 me encontré con otro fenómeno, al registrar una barra lateral con una identificación en notación BEM, como widgets--aside(doble guión), el área de widgets aparece en la página de administración de widgets, pero los widgets agregados no permanecen después de salir de la página.
Volker E.
Excelente recurso Me pregunto por qué no resuelven los conflictos de nombres con un postfix, prefijo de algún tipo para los widgets ... IE _widget_${id}etc.
Eddie B
0

Tienes que evitar varios -personajes, comotest1---test2

Nickyro
fuente
0

Aparentemente, también debe evitar los ID que incluyen prefijos de la lista anterior:

p.ej:

#footer-xxx
#footer-yyy

La siguiente configuración funcionó inicialmente, pero resultó en errores (usando el tema del monzón):

register_sidebar( array(
    'name'          => esc_html__( 'Footer Area', 'monsoon' ),
    'id'            => 'footer-area',
    'description'   => esc_html__( 'Appears above the footer.', 'monsoon' ),
    'before_widget' => '<div class="col-sm-3 footer-area widget %2$s">',
    'after_widget'  => '</div>',
    'before_title'  => '<h3>',
    'after_title'   => '</h3>',
) );

Al renombrar la barra lateral, los errores desaparecieron. Sin embargo, no he probado otros temas. Por lo tanto, esto solo podría ser aplicable a mi configuración.

Sin embargo, este hilo realmente me ayudó en mi búsqueda de una solución :)

mathiasmadsen
fuente
Proporcione algún contexto (horneado por ejemplos de código, por ejemplo).
Kaiser
Se agregaron algunas líneas más para aclaraciones.
mathiasmadsen