Ayuda contextual modificada

En WordPress 2.7 se añadió un nuevo elemento al Panel de Administración: la pestaña de ayuda / ayuda contextual. Esta pestaña ofrece algo de información en las páginas de edición de artículos o en el escritorio, pero no sirve de mucho en las páginas de los plugins. Esto se debe a que para poder dar ayuda sobre nuestro plugin debemos recurrir a los filtros, sin embargo el filtro que afecta a la ayuda contextual no aparece en la documentación.

No obstante, una vez conocemos el nombre del filtro, que por cierto es contextual_help, es realmente fácil modificar el contenido, aunque debemos tener cuidado y prestar atención a las ocasiones en las que añadimos nuestra función al filtro, ya que nos descuidamos podemos hacer que la ayuda de nuestro plugin aparezca en todas las páginas, y esto no es lo que queremos.

Para añadir nuestra función sólo cuando se accede a la página de nuestro plugin debemos recurrir a una acción, llamada load-X, donde X es la página de nuestro plugin (en realidad puede ser cualquier página del Panel de Administración). El valor de X debe ser el que devuelve la función add_submenu_page (o add_N_page) para que se aplique correctamente la función.

Dicha la teoría, pasemos a la práctica:

// Añadimos un enlace al menú
$pagina = add_submenu_page('wp-carousel', 'Carousel Z', 'Carousel Z', 'administrator', 'edit-carousel', 'wp_carousel_carousel_options_page');

// Modificamos la pestaña de ayuda
add_action('load-'.$pagina, 'wp_carousel_custom_help_tab'); 

// Esta función añade la segunda función al filtro
function wp_carousel_custom_help_tab() {
// Añadimos al filtro
add_filter('contextual_help', 'wp_carousel_custom_help_tab_filter');
}

// Esta función cambia el contenido que se muestra
function wp_carousel_custom_help_tab_filter($help) {
echo "<h5>".__('WP Carousel\'s Quick Help', 'wp_carousel')."</h5>"; // Nuevo contenido
echo "<p>".__('You can find help here, here and here', 'wp_carousel').".</p>"; // Nuevo contenido
printf ("<p>".__('Please, fill up <a href="%s">this survey</a> in order to improve WP Carousel', 'wp_carousel').".</p>", WP_CAROUSEL_SURVEY); // Nuevo contenido
echo $help; // Imprimos también el contenido que hay por defecto
}

Como podéis ver, el funcionamiento es bastante sencillo.

PD: Sí, este código es parte de WP Carousel 0.5. Hacer uso de la pestaña de ayuda contextual es una de las novedades de la próxima versión, aunque es una de las novedades menos interesantes…

Este fallo está arreglado en la versión 0.4.0.2 de WP Carousel, que en las próximas horas estará disponible en el servidor de WordPress (lo que tarde en actualizar los datos sobre la última versión, ya que ésta ya está en el repositorio), sin embargo este bug no es el único que se arregla en esta versión, sino que hay otros 4 más que no han sido reportados pero sí arreglados.

Para comenzar, se ha actualizado la traducción de WP Carousel, que ahora también traduce el texto que precede al código que se debe poner para mostrar el carrusel (antes siempre estaba en inglés, ahora la traducción española está disponible), por otro lado se ha arreglado un error en el código HTML del theme default-sidebar que consistía en que una capa (div) estaba abierta pero no se cerraba. Ahora WP Carousel y WP Main Menu son compatibles. Anteriormente no lo eran porque olvidé renombrar la variable $path, que indicaba rutas a ciertas carpetas y archivos. Realmente sólo he visto que afecta al gestor de themes, pero realmente podría afectar a muchas más cosas así que he renombrado esta variable a $wp_carousel_path, eliminado posibles repeticiones (en la próxima versión de WP Main Menu renombraré también la variable). Por último se ha arreglado un fallo en el gestor de themes que hacía que en los datos de la versión theme activado siempre se mostrase el valor 1.1, en lugar del valor correspondiente.

Disculpad la cantidad de bugs de estas versiones. Las prisas por liberarlo han acabado haciendo que no revisase bien los fallos. Al menos son fallos fáciles de arreglar y a las pocas horas ya hay una nueva versión disponible, pero disculpadme de nuevo.

Edito: He encontrado un bug más, que hacía que no se mostrase la lista desplegable para seleccionar el contenido que se debe añadir al carrusel. Este error es el único que arregla la versión 0.4.0.3.

Como de costumbre, podéis actualizar desde el Panel de Administración o descargando y subiendo los archivos de esta nueva versión, que ya está disponible tanto en inglés como en español.

• Papelera de artículos y comentarios
• Editor de imágenes
• Actualización en lote de los plugins
• Incrustación simple de vídeos con oEmbed
• Minituras de los artículos

Podéis ver un repaso a las novedades de esta versión en el vídeo que tenéis a continuación.

Podeis descargar WordPress 2.9 desde aquí o ver el anuncio oficial.

Las novedades (muy resumidas) de la versión 2.9 de WordPress son:

• Papelera de artículos, páginas, comentarios y adjuntos
• Editor de imágenes
• oEmbed

Podéis descargar WordPress 2.9 RC1 desde aquí o ver el anuncio oficial en esta página.

Las novedades que recalcan en AyudaWordPress son oEmbed (nos permitirá añadir todo tipo de contenido en nuestra web), miniaturas de artículos y una nueva interfaz para gestión de media (que incluye el editor de imágenes). Aunque éstas no serán las únicas noveades, y es que revisando el Codex de WordPress podemos ver una lista mucho más larga, de la cual destacaría algunas novedades muy interesantes.

Para comenzar, la papelera de artículos, páginas, comentarios y adjuntos; que nos permitirá almacenar el contenido que borremos antes de ser eliminado permanentemente, dándonos una última oportunidad para recapacitar sobre si realmente queremos borrar el contenido que estamos a punto de eliminar.

Las galerías tendrán la opción de excluir o incluir imágenes en ellas, de forma que podremos mostrar una galería de imágenes que tenga alguna que no hayamos subido en ese artículo o que excluya alguna que realmente hayamos subido.

Se reducirá el CSS del Panel de Administración y el theme Kubrick (theme por defecto) recibirá varias mejoras.

La primera es algo que ya se había comentado varias veces en diversos blogs, y es la posibilidad de editar las imágenes que subimos a nuestros blogs desde el navegador. Básicamente se trata de un editor muy simple que nos permite recortar la imagen, voltearla y girarla 90º. Como podéis ver no es gran cosa y está muy lejos de lo que podríamos hacer un editor de imágenes o con Imaset.

La segunda es la posibilidad de reparar las tablas de la Base de Datos de WordPress en caso de que tengan algún error. Para poder usar esta función tendremos que añadir una línea en wp-config.php con el siguiente contenido: define('WP_ALLOW_REPAIR', true); . Después nos basta con ir a wp-admin/maint/repair.php para comenzar el análisis y la reparación de la Base de Datos.

Además de estas dos novedades, desde hace unas semanas sabemos que WordPress 2.9 incluirá una papelera de reciclaje.

Dejando de lado el tema de las novedades, revisando el Códex de WordPress podemos ver que WordPress 2.9 será la última versión de la rama 2.x (aunque supongo que seguirán con la rama 2.9.x durante una temporada). La siguiente versión será WordPress 3.0.

Actualizado: La versión 2.9 de WordPress se liberará el 31 de Octubre si no hay ningún contratiempo, mientras que la versión 3.0 no tiene ninguna fecha específica, sólo sabemos que estará disponible en algún momento de 2010. Fuente.

Las novedades que incluirá WordPress 2.8 ya las comenté en otro artículo, aunque también podéis encontrarlas en el Codex de WordPress.

Aunque dejando de lado la fecha de lanzamiento, en el artículo también añaden que el actualizador de WordPress (no deja claro si el de la versión 2.8 o la 2.9) nos aconsejará actualizar nuestra versión de PHP a la versión 5 y, esta vez sí, el actulizador de WordPress 2.9 no nos dejará actualizar el blog si no usamos MySQL 4.1.2 o superior.