WordPress Inclusivo 18: Ordenar alfabeticamente el menú de administración

WordPress es a veces una plataforma llena de contradicciones, una de ellas, es el galimatías en que se convierte el menú de administración cuando nuestra web está en producción con algunos plugins, hoy solucionaremos esto.

Para lograrlo estuve buscando en la red como se hacía para modificar el orden de elementos del menú y uniendo lo encontrado con código propio he creado lo siguiente, que agrego a functions.php:

/* 
===================================================
  Mejoras al entorno de administración 
===================================================
*/

function sort_admin_menu() {

  global $menu;
  global $submenu;

  // Ordena los menús
  // Ordena elementos iniciales (1)
  $default = array_slice( $menu, 0, 1, true );
  usort( $default, 'sort_arra_asc_so_1597736' );

  // Ordena el resto de elementos
  $length = count( $menu );
  $extra = array_slice( $menu,1, $length, true );
  usort( $extra, 'sort_arra_asc_so_1597736' );
		
  // Mantener un solo separador si los hay.
  $cleaned = array();
  foreach($extra as $review) {
    if($review[0]!="" || count($cleaned)==0) {
      array_push($cleaned,$review);
    }	
  }
  $extra = $cleaned;
  unset($cleaned);

  // Apply
  $menu = array_merge( $default, $extra );

  // Ordena los submenús.
  foreach ($submenu as &$token) {
    // Ordena elementos iniciales (1)
    $default = array_slice( $token, 0, 1, true );
    usort( $default, 'sort_arra_asc_so_1597736' );

    // Ordena el resto de elementos
    $length = count( $token );
    $extra = array_slice( $token,1, $length, true );
    usort( $extra, 'sort_arra_asc_so_1597736' );

    // Mantener un solo separador si los hay.
    $cleaned = array();
    foreach($extra as $review) {
      if($review[0]!="" || count($cleaned)==0) {
        array_push($cleaned,$review);
      }	
    }
    $extra = $cleaned;
    unset($cleaned);

    // Apply
    $token = array_merge( $default, $extra );
  }
  unset($token);
}

//http://stackoverflow.com/a/1597788/1287812
function sort_arra_asc_so_1597736( $item1, $item2 ) {
  if ($item1[0] == $item2[0]) return 0;
  return ( $item1[0] > $item2[0] ) ? 1 : -1;
}

/* Se usa admin_head y no admin_menu para evitar que plugins 
  como Site Kit mantengan su menu arriba a pesar de la 
  reordenacion.
		
  No usamos admin_init porque causa error de whitespace 
  extra en algunos entornos.
*/
add_action( 'admin_head', 'sort_admin_menu', 999 );

Comprendiendo este código paso a paso

Lo primero que hemos de saber es que se ordena por un lado el grupo de opciones principales del menú y por otro los elementos de cada uno de los submenús asociados a cada opción principal.

Cabe destacar que en en ambos casos se respeta la opción por defecto, que queda en la parte superior. Esto ocurre tanto con el Dashboard, como con , por ejemplo, “Entradas > Todas las Entradas”.

¿Porqué? porque las primeras opciones representan las opciones que se cargan por defecto al entrar al administrador en primer caso, o al pulsar el menú padre en el caso del resto. Quería respetar esa funcionalidad, pero únicamente en esa primera opción, el resto se ordenan alfabéticamente.

Estructura General

En esencia el código tiene tres elementos:

  1. La función que se encarga del proceso “sort_admin_menu”
  2. La función de comparación creada para ordenar los elementos “sort_arra_asc_so_1597736”
  3. Finalmente la instrucción “add_action” que vincula el hook “admin_head” a la función de ordenación.

sort_admin_menu()

Veamos como funciona esta parte, que es llamada en el momento establecido.

Lo primero que hace es obtener acceso a los arrays de menús principales y de submenús, que son variables globales.

Una vez obtenido acceso, comienza trabajando con las opciones principales, como hemos dicho, por un lado se sitúa el primer elemento y a continuación se ordenan el resto de elementos alfabéticamente.

Esto se realiza básicamente obteniendo en dos array diferentes dos slices del array completo, y ordenando cada uno por separado, usando la función de comparación personalizada “sort_arra_asc_so_1597736” quedando asegurado que el orden es el deseado.

Tras esto se vuelven a unir ambas partes y con un bucle sencillo, nos aseguramos de eliminar todos salvo un separador de menú, dejando separadas primera opción y resto.

Una vez completado el proceso con las opciones principales, se hace exactamente lo mismo para cada lista de submenús, iterando con un foreach.

E voilá, menú ordenado. Soy consciente de que se puede refactorizar este código, de momento la idea era que funcionara y explicarlo, en el próximo capítulo nos encargaremos precisamente de esto, dejarlo compacto y bonito.

¡Compártelo!

Ayudame a difundir este contenido a todo aquel que pueda sacarle partido, difundelo en redes, cuéntaselo a tus amigos, coméntalo en la cola del supermercado, además de aportar, ¡seguro que conoces a gente interesante y acabas uniéndose al bando rebelde!

Sígueme en Redes

Acelera mi progreso de la materia que te interesa.

El calendario y ritmo de publicaciones actualmente responde a mis necesidades de estudio y desarrollo de proyectos personales, si quieres invertir en que acelere alguna materia concreta, te ofrezco una posibilidad:

Puedes donar en mi paypal (paypal at metsuke.com), indicando la materia, por cada 25 euros donados, priorizaré un capítulo de la materia que me indiques que ya tenga escrito para que salga el proximo dia viable y disponible de lunes a viernes (en orden de llegada y a un post diario).

En caso de que el capítulo aún no exista, centraré mi atención en escribirlos y publicarlos con prioridad, pero no puedo prometer inmediatez.

De nuevo priorizaré las donaciones por orden de llegada pero cuando coincidan varias, iré rotando cada dia una para evitar la monopolización de mi foco de tareas.

Me reservo el fin de semana para priorizar lo que considere pertinente en el caso de que haya cola de entrega. Si te gusta el proyecto, ¡es un buen modo de apoyarme!

¿Te interesan mis servicios como consultor?

En ese caso, pudedes contactarme en mi correo r.carrillo@metsuke.com y cuéntame que necesitas, si lo que leo me gusta, te pongo en contacto con el comercial de mi empresa de consultoría.

Si quieres que sea yo expresamente quien te atienda, puedes indicármelo y llegamos a un acuerdo.

Advierto que esta última posibilidad te saldrá bastante más cara que hablar con mi equipo, pero si es lo que deseas, a tu disposición.

Un Abrazo.

Sobre las traducciones

Por el momento me he visto obligado a detener la traducción del contenido, apenas doy abasto a escribirlo (que es mi objetivo, ya que son mis apuntes de estudio), por lo que no parece tener sentido mantener activas unas traducciones que no doy abasto a crear.

En caso de que más adelante el flujo de caja me lo permita, es mi intención contratar servicios de traducción y editores que realicen la tarea, pero por ahora lo dejo desactivado.

Quizá te interese leer más sobre Wordpress Inclusivo

2 Respuestas a “WordPress Inclusivo 18: Ordenar alfabeticamente el menú de administración”

Dejar una Respuesta

XHTML: Usted puede usar las siguientes etiquetas: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>