Añadir seguimiento de nuevos comentarios en eggBlog

Otro de los pequeños fallos de EggBlog es su sistema de comentarios. El problema no es como se deja un nuevo comentario, que por lo que he podido probar funciona bastante bien. El problema es que no hay manera de saber si alguien ha dejado un nuevo comentario en un artículo antiguo.

Los artículos de portada no tienen tanto problema, ya que puede que te des cuenta al moverte por la página, pero si alguien deja un comentario en un artículo de hace unos meses, no hay un buen sistema para enterarse. O compruebas todos los artículos para ver si hay un comentario nuevo o lo miras en la base de datos, que es más rápido, pero tampoco es una buena solución.

Mi primera idea fue que cuando alguien deja un nuevo comentario, se enviara un correo al administrador que le avisara. Esta idea es bastante buena, ya que te mantiene informado rápidamente sobre comentarios nuevos. El problema es el posible aluvión de correos en un futuro, aunque siempre se puede poner un filtro o algo.

Me puse a investigar como enviar correos desde PHP y resulta ser bastante sencillo. En la página oficial de PHP está toda la información. Sin embargo, al realizar algunas pruebas descubrí que mi servidor actual, al ser gratuito, no soporta el envío de correos desde PHP, por lo que no me quedó otra opción que buscar una alternativa.

Empecé a pensar en otra solución. Si no podía realizar un aviso externo, tendría que añadir algún elemento visual a la página que me indicara que hay comentarios nuevos. Decidía añadir una nueva entrada en la barra lateral que indique el número de comentarios nuevos y te lleve a una página desde donde poder revisarlos.

El número a la derecha de “Moderar Comentarios” indica el número de comentarios nuevos desde la última vez que se limpió el listado.

Si pulsamos el enlace llegamos a una nueva página donde aparece un listado con todos los comentarios nuevos, y donde cada comentario es un enlace al artículo donde ha sido publicado. De esta manera tenemos una forma sencilla de revisarlos todos, y que no se quede alguno perdido entre artículos viejos. Por último tenemos un botón que limpia el listado y devuelve el contador a cero.

Las modificaciones al código para implementar esto son las siguientes:

Primero añadimos las traducciones a es.php:

$lang['author'] = "Autor/a";
$lang['clear_list'] = "Limpiar Listado";
$lang['comment'] = "Comentario";
$lang['date'] = "Fecha";
$lang['hiding_comments'] = "Ocultando comentarios anteriores a la fecha";

Lo siguiente es crear una función que devuelva una fecha formateada. Podríamos añadir esta función a _lib/global.php, pero yo he decidido crear un fichero PHP con funciones útiles llamado _lib/util.php. La función devuelve la fecha en el mismo formato que se ve en los artículos, y su código es:

function getNiceDate($date){
    global $lang;

    return date("g:ia",$date) . ", " . ucwords( $lang['day' . date( "w", $date )] ) ." "
    .date( "j", $date ) . " " . ucwords( $lang['month' . date( "n", $date )] )
    ." " . date( "Y", $date );    
}

Si creáis el fichero nuevo, habrá que incluirlo en _lib/global.php:

require_once '_lib/util.php';

A continuación ya podemos crear la página desde donde moderar los comentarios. La he llamado moderate-comments.php y su código es:

<?php

require_once '_lib/global.php';
global $config;

eb_pre();

if( empty( $_SESSION['user_id-' . $_SERVER['SERVER_NAME']] ) ) {
    header( "Location: index.php" );
}
elseif( !eb_checkadmin( $_SESSION['user_id-' . $_SERVER['SERVER_NAME']] ) ) {
    header( "Location: index.php" );
}
else {
    eb_head('');

    $commentsList = "";

    $currentTime = time();
    $showForm = true;

    if( !empty( $_POST['viewTime'] ) ) {
        $viewTime = $_POST['viewTime'];
        $showForm = false;

        $sql = "UPDATE eb_comments SET comment_date = " . $viewTime
        ." WHERE comment_id = 0";

        mysql_query( $sql );

        $commentsList = "<p>" . $lang['hiding_comments'] . ": "
        .getNiceDate( $viewTime ) . "</p>";
    }
    else{
        $sql = "SELECT u.user_name, c.comment_id, c.article_id,"
        ." c.comment_body, c.comment_date, a.article_title"
        ." FROM eb_comments c, eb_users u, eb_articles a"
        ." WHERE c.comment_date > ("
        ."    SELECT comment_date FROM eb_comments"
        ."    WHERE comment_id = 0 )"
        ." AND u.user_id = c.author_id"
        ." AND a.article_id = c.article_id"
        ." AND c.author_id <> " . $_SESSION["user_id-" . $_SERVER['SERVER_NAME']]
        ." ORDER BY c.comment_id";
        $query = mysql_query( $sql );

        while( $row = mysql_fetch_array( $query ) ) {
            $commentBody = $row[3];
            if( strlen( $commentBody ) > 70 ) {
                $commentBody = substr( $commentBody, 0, 70 ) . "...";
            }

            $commentsList .= "<p><b>" . $lang['author'] . ": " . $row[0] . "<br />"
            ."<b>" . $lang['date'] . ": " . getNiceDate( $row[4] ) . "<br />"
            ."<b>" . $lang['comment'] . ":</b> <a href=""
            .eb_links_article( $row[5], $row[2] )
            ."#comment" . $row[1] . "">" . $commentBody . "</a></p> ";
        }
    }
?>

<h3><?php echo ucwords( $lang['moderate_comments'] ) ?></h3>

<?php
    echo $commentsList;
    if( $showForm == true ) {
?>

<form name="resetCommentsTime" action="moderate-comments.php" method="post">
    <input type="hidden" name="viewTime" value="<?php echo $currentTime; ?>" />
    <input type="submit" name="submit" value="<?php echo $lang['clear_list']; ?>" />
</form>

<?php
    }
    eb_foot();
}
?>

Como se pude observar en el código, los enlaces no solo llevan al artículo, sí no también al propio comentario. Para ello debemos añadir el ancla correspondiente para cada artículo. Esto se realiza en el método eb_article() del fichero _lib/news.php, donde:

<p class="comment">

Pasa a ser:

<p class="comment"><a name="comment" . $comment[3] . ""></a>"

Ahora necesitamos añadir en la barra lateral el enlace a la página y mostrar el número de comentarios nuevos. Para ello, en _lib/global.php, en el método eb_foot(), sustituimos el if que comprueba si el usuario es el administrador, por esto:

if( eb_checkadmin( $_SESSION['user_id-' . $_SERVER['SERVER_NAME']] ) ) {
    echo " <li><a href="admin.php">" . ucwords( $lang['admin'] ) . "</a></li> ";

    $sql = "SELECT u.user_name, c.comment_id, c.article_id,"
    ." c.comment_body, a.article_title, c.comment_date"
    ." FROM eb_comments c, eb_users u, eb_articles a"
    ." WHERE c.comment_date > ( SELECT comment_date FROM eb_comments"
    ." WHERE comment_id = 0 ) AND u.user_id = c.author_id"
    ." AND a.article_id = c.article_id"
    ." AND c.author_id <> " . $_SESSION["user_id-" . $_SERVER['SERVER_NAME']];
    $numOfComments = mysql_num_rows( mysql_query( $sql ) );

    echo " <li><a href="moderate-comments.php">"
    .ucwords( $lang['moderate_comments'] ) . " (" . $numOfComments . ")</a></li> ";
}

Por último necesitamos introducir en la base de datos un comentario de referencia. Este comentario no será visto, ni pertenece a ningún artículo. Simplemente utilizaremos su campo de fecha como el momento a partir del cual un comentario se considera nuevo, y será este comentario el que se actualizará al pulsar el botón en la página de moderar comentarios. Podemos añadir el comentario con la siguiente sentencia SQL:

INSERT INTO eb_comments ( comment_id, author_id, article_id, comment_ip, comment_date, comment_body )
VALUES ( 0, 0, 0, 0, 0, 'comentario de referencia' );

Los únicos valores importantes son que el comment_id, article_id y comment_date sean cero.

Y con esto ya tenemos en marcha el sistema de seguimiento de nuevos comentarios. Para cualquier duda podéis usar los comentarios, que ahora estoy seguro de no dejarme ninguno sin leer 😀