Hook del mes: personalizar el widget Entradas y Páginas Populares

¡Comencemos 2016 con una nueva serie: bienvenidos a la primera entrega de Hook del mes! Los hooks son puntos del código de WordPress donde puedes añadir tu propio código o cambiar el comportamiento predeterminado de WordPress. Jetpack incluye muchos de ellos —430 en el momento de escribir esto—. En esta serie, te presentaré un nuevo hook cada mes. Hoy veremos cómo los hooks te ayudan a personalizar uno de nuestros widgets más populares, el widget Entradas y Páginas Populares.

El widget Entradas y Páginas Populares de Jetpack muestra una lista de las entradas y páginas más populares de tu sitio. Estas son sus opciones de personalización predeterminadas: La configuración del widget ofrece bastantes opciones de personalización, pero también hemos añadido filtros y acciones al código: estos son los hooks. Los hooks te permiten personalizar aún más el widget para adaptarlo a tus necesidades específicas. En esta entrada, exploraremos un filtro y dos acciones.

Filtrar el número de días utilizado para calcular las entradas más visitadas

De forma predeterminada, el widget calcula las entradas más populares de los últimos dos días. Este breve periodo de tiempo suele ser más relevante, especialmente si publicas mucho. Sin embargo, si publicas un poco menos o todavía no has creado una audiencia grande, quizá quieras incluir datos de más días o semanas. Con un filtro, puedes cambiar esto. Vamos a actualizar el widget para mostrar una lista de las entradas más populares del último mes. Para hacerlo, usaremos el filtro jetpack_top_posts_days. Para empezar, añade el siguiente fragmento de código a un plugin de funcionalidad:

function jetpackme_top_posts_timeframe() {
    return '30';
}
add_filter( 'jetpack_top_posts_days', 'jetpackme_top_posts_timeframe' );

Hemos introducido «30» como el número de días cuyos datos se devolverán, pero puedes introducir cualquier cantidad. «-1» significa que no hay límite.

Añadir datos antes o después de cada entrada en el widget

El widget Entradas y Páginas Populares incluye dos acciones: jetpack_widget_top_posts_before_post jetpack_widget_top_posts_after_post Estas acciones te permitirán insertar datos antes o después de cada entrada que aparezca en el widget. En el ejemplo siguiente, he usado la acción jetpack_widget_top_posts_after_post para insertar la fecha debajo de cada entrada:

/**
 * Top Posts Widget: add post date below each post.
 */
function jetpackme_add_date_top_posts( $post_id ) {
        $post_date = get_post_time(
                get_option( 'date_format' ),
                true,
                $post_id,
                true
        );
        printf( '<div class="top_posts_date">%s</div>', $post_date );
}
add_action( 'jetpack_widget_top_posts_after_post', 'jetpackme_add_date_top_posts' );

El widget incluye otros seis filtros y otras cinco acciones. ¿Quieres saber más? Consulta el código aquí. ¿Hay algún filtro o módulo específico que te gustaría que cubriéramos en nuestro próximo artículo de Hook del mes? ¡Cuéntanoslo en los comentarios!