WP-PostRatings

FAQ

¿Cómo se cambia el tipo de schema?

<?php  
add_filter( 'wp_postratings_schema_itemtype', 'wp_postratings_schema_itemtype' );  
function wp_postratings_schema_itemtype( $itemtype ) {  
    return 'itemscope itemtype="http://schema.org/Recipe"';  
}  
?>

El tipo de schema por defecto es ‘Article’, si quieres cambiarlo a ‘Recipe’ tienes que usar el filtro wp_postratings_schema_itemtype como se muestra en el código de ejemplo anterior.

Cómo añadir el logotipo de tu sitio a los Google Rich Snippets

<?php  
add_filter( 'wp_postratings_site_logo', 'wp_postratings_site_logo' );  
function wp_postratings_site_logo( $url ) {  
    return 'http://placehold.it/350/150.png';  
}  
?>

Por defecto, el plugin usará la URL de la imagen de cabecera de tu sitio como logotipo del sitio. Si quieres cambiarlo tienes que usar el filtro wp_postratings_site_logo como se muestra en el código de ejemplo anterior.

¿Cómo quitar el texto alt y title de la imagen de las valoraciones?

<?php  
add_filter( 'wp_postratings_ratings_image_alt', 'wp_postratings_ratings_image_alt' );  
function wp_postratings_ratings_image_alt( $alt_title_text ) {  
    return '';  
}  
?>

¿Cómo se muestran las valoraciones de autores de comentarios?

add_filter( 'wp_postratings_display_comment_author_ratings', '__return_true' );

Por defecto no se muestran las valoraciones del autor del comentario. Si quieres mostrar las valoraciones tienes que usar el filtro wp_postratings_display_comment_author_ratings como se muestra en el código de ejemplo anterior.

¿Cómo usar imágenes PNG en vez de GIF?

function custom_rating_image_extension() {
    return 'png';
}
add_filter( 'wp_postratings_image_extension', 'custom_rating_image_extension' );

La extensión de imagen por defecto es ‘gif’, si quieres cambiarla a ‘png’ tienes que usar el filtro wp_postratings_image_extension como se muestra en el código de ejemplo anterior.

¿Cómo cambiar el tiempo de caducidad de la cookie?

function custom_rating_cookie_expiration() {
    return strtotime( 'tomorrow' ) ;
}
add_filter( 'wp_postratings_cookie_expiration', 'custom_rating_cookie_expiration', 10, 0 );

La caducidad de la cookie por defecto es ‘time() + 30000000’, si quieres cambiar la duración de la caducidad tienes que usar el filtro wp_postratings_cookie_expiration como se muestra en el código de ejemplo anterior.

¿Cómo carga WP-PostRatings el CSS?

• WP-PostRatings cargará postratings-css.css del directorio de CSS de tu tema si existe.
• Si no existe simplemente carga el CSS por defecto de ‘postratings-css.css’ que viene con WP-PostRatings.
• Esto te permitirá actualizar WP-PostRatings sin preocuparte de que sobreescriba los estilos de valoraciones que hayas creado.

¿Cómo usan las estadísticas de valoraciones en los widgets?

1. Ve a WP-Admin -> Apariencia -> Widgets
2. El nombre del widget es Valoraciones.

Para mostrar la entrada menos valorada

<?php if (function_exists('get_lowest_rated')): ?>
    <ul>
        <?php get_lowest_rated(); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_lowest_rated(‘both’, 0, 10)
• El valor ‘both’ mostrará las entradas y las páginas menos valoradas.
• Si quieres mostrar solo las entradas con menos puntuación reemplaza ‘both’ con ‘post’.
• Si quieres mostrar solo las páginas con menos puntuación reemplaza ‘both’ con ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas peor valoradas.

Para mostrar la entrada peor valorada por etiqueta

<?php if (function_exists('get_lowest_rated_tag')): ?>
    <ul>
        <?php get_lowest_rated_tag(TAG_ID); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_lowest_rated_tag(TAG_ID, ‘both’, 0, 10)
• Reemplaza TAG_ID por la que sea tu ID de etiqueta. Si quieres mostrar varias etiquetas reemplaza TAG_ID con array(1, 2) donde 1 y 2 son los ID de tus etiquetas.
• El valor ‘both’ mostrará las entradas y las páginas menos valoradas.
• Si quieres mostrar solo las entradas con menos puntuación reemplaza ‘both’ con ‘post’.
• Si quieres mostrar solo las páginas con menos puntuación reemplaza ‘both’ con ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas peor valoradas.

Para mostrar la entrada peor valorada de una categoría

<?php if (function_exists('get_lowest_rated_category')): ?>
    <ul>
        <?php get_lowest_rated_category(CATEGORY_ID); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_lowest_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Reemplaza CATEGORY_ID por el que será el ID de tu categoría. Si quieres mostrar varias categorías reemplaza CATEGORY_ID con array(1, 2) donde 1 y 2 los los ID de tus categorías.
• El valor ‘both’ mostrará las entradas y las páginas menos valoradas.
• Si quieres mostrar solo las entradas con menos puntuación reemplaza ‘both’ con ‘post’.
• Si quieres mostrar solo las páginas con menos puntuación reemplaza ‘both’ con ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas peor valoradas.

Para mostrar la entrada mejor valorada

<?php if (function_exists('get_highest_rated')): ?>
    <ul>
        <?php get_highest_rated(); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_highest_rated(‘both’, 0, 10)
• El valor ‘both’ mostrará tanto las entradas mejor valoradas como las páginas.
• Si quieres mostrar solo las entradas mejor valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas mejor valoradas reemplaza ‘both’ por ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas mejor valoradas.

Para mostrar la entrada mejor valorada por etiqueta

<?php if (function_exists('get_highest_rated_tag')): ?>
    <ul>
        <?php get_highest_rated_tag(TAG_ID); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_highest_rated_tag(TAG_ID, ‘both’, 0, 10)
• Reemplaza TAG_ID por la que sea tu ID de etiqueta. Si quieres mostrar varias etiquetas reemplaza TAG_ID con array(1, 2) donde 1 y 2 son los ID de tus etiquetas.
• El valor ‘both’ mostrará tanto las entradas mejor valoradas como las páginas.
• Si quieres mostrar solo las entradas mejor valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas mejor valoradas reemplaza ‘both’ por ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas mejor valoradas.

Para mostrar la entrada mejor valorada de una categoría

<?php if (function_exists('get_highest_rated_category')): ?>
    <ul>
        <?php get_highest_rated_category(CATEGORY_ID); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_highest_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Reemplaza CATEGORY_ID por el que será el ID de tu categoría. Si quieres mostrar varias categorías reemplaza CATEGORY_ID con array(1, 2) donde 1 y 2 los los ID de tus categorías.
• El valor ‘both’ mostrará tanto las entradas mejor valoradas como las páginas.
• Si quieres mostrar solo las entradas mejor valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas mejor valoradas reemplaza ‘both’ por ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas mejor valoradas.

Para mostrar la entrada mejor valorada durante un periodo dado

<?php if (function_exists('get_highest_rated_range')): ?>
    <ul>
        <?php get_highest_rated_range('1 day'); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_highest_rated_range(‘1 day’, ‘both’, 10)
• El valor ‘1 day’ puede ser el rango que quieras. Puedes usar ‘2 days’, ‘1 month’, etc.
• El valor ‘both’ mostrará tanto las entradas más valoradas como las páginas.
• Si quieres mostrar solo las entradas más valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas más valoradas reemplaza ‘both’ por ‘page’.
• El valor 10 mostrará solo las 10 entradas/páginas más valoradas.

Para mostrar una entrada más valorada

<?php if (function_exists('get_most_rated')): ?>
    <ul>
        <?php get_most_rated(); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_most_rated(‘both’, 0, 10)
• El valor ‘both’ mostrará tanto las entradas más valoradas como las páginas.
• Si quieres mostrar solo las entradas más valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas más valoradas reemplaza ‘both’ por ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas más valoradas.

Para mostrar una entrada más valorada de una categoría

<?php if (function_exists('get_most_rated_category')): ?>
    <ul>
        <?php get_most_rated_category(CATEGORY_ID); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_most_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Reemplaza CATEGORY_ID por el que será el ID de tu categoría. Si quieres mostrar varias categorías reemplaza CATEGORY_ID con array(1, 2) donde 1 y 2 los los ID de tus categorías.
• El valor ‘both’ mostrará tanto las entradas más valoradas como las páginas.
• Si quieres mostrar solo las entradas más valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas más valoradas reemplaza ‘both’ por ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas más valoradas.

Para mostrar una entrada más valorada durante un periodo concreto

<?php if (function_exists('get_most_rated_range')): ?>
    <ul>
        <?php get_most_rated_range('1 day'); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_most_rated_range(‘1 day’, ‘both’, 10)
• El valor ‘1 day’ puede ser el rango que quieras. Puedes usar ‘2 days’, ‘1 month’, etc.
• El valor ‘both’ mostrará tanto las entradas más valoradas como las páginas.
• Si quieres mostrar solo las entradas más valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas más valoradas reemplaza ‘both’ por ‘page’.
• El valor 10 mostrará solo las 10 entradas/páginas más valoradas.

Para mostrar la entrada mejor valorada

<?php if (function_exists('get_highest_score')): ?>
    <ul>
        <?php get_highest_score(); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_highest_score(‘both’, 0, 10)
• El valor ‘both’ mostrará tanto las entradas más valoradas como las páginas.
• Si quieres mostrar solo las entradas más valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas más valoradas reemplaza ‘both’ por ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas más valoradas.

Para mostrar la entrada con mayor valoración de una categoría

<?php if (function_exists('get_highest_score_category')): ?>
    <ul>
        <?php get_highest_score_category(CATEGORY_ID); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_highest_score_category(CATEGORY_ID, ‘both’, 0, 10)
• Reemplaza CATEGORY_ID por el que será el ID de tu categoría. Si quieres mostrar varias categorías reemplaza CATEGORY_ID con array(1, 2) donde 1 y 2 los los ID de tus categorías.
• El valor ‘both’ mostrará tanto las entradas más valoradas como las páginas.
• Si quieres mostrar solo las entradas más valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas más valoradas reemplaza ‘both’ por ‘page’.
• El valor 0 se refiere al mínimo de votos requerido antes de que se muestre la entrada.
• El valor 10 mostrará solo las 10 entradas/páginas más valoradas.

Para mostrar la entrada con mayor valoración durante un periodo concreto

<?php if (function_exists('get_highest_score_range')): ?>
    <ul>
        <?php get_highest_score_range('1 day'); ?>
    </ul>
<?php endif; ?>

• Por defecto: get_highest_score_range(‘1 day’, ‘both’, 10)
• El valor ‘1 day’ puede ser el rango que quieras. Puedes usar ‘2 days’, ‘1 month’, etc.
• El valor ‘both’ mostrará tanto las entradas más valoradas como las páginas.
• Si quieres mostrar solo las entradas más valoradas reemplaza ‘both’ por ‘post’.
• Si quieres mostrar solo las páginas más valoradas reemplaza ‘both’ por ‘page’.
• El valor 10 mostrará solo las 10 entradas/páginas más valoradas.

Para ordenar las entradas más/menos valoradas

• Puedes usar: <?php query_posts( array( 'meta_key' => 'ratings_average', 'orderby' => 'meta_value_num', 'order' => 'DESC' ) ); ?>
• O pasa las variables a la URL: http://tusitio.com/?r_sortby=highest_rated&r_orderby=desc
• Puedes reemplazar desc con asc si quieres mostrar las entradas con valoraciones más bajas.

Para ordenar entradas menos/más valoradas

• Puedes usar: <?php query_posts( array( 'meta_key' => 'ratings_users', 'orderby' => 'meta_value_num', 'order' => 'DESC' ) ); ?>
• O pasa las variables a la URL: http://tusitio.com/?r_sortby=most_rated&r_orderby=desc
• Puedes reemplazar desc con asc si quieres las entradas menos valoradas.