Los que hayáis creado webs o blogs con Wordpress sabéis ya que incorpora un potente servicio llamado Akismet para verificar, filtrar y reportar si un mensaje es considerado Spam. Aunque sus comienzos proceden de Wordpress existen ya gran cantidad de plugins para otros CMS (Drupal, Joomla, Expression Engine…), lenguajes y frameworks (PHP, Ruby, Phyton, Java, Ruby on Rails, Coldfusion, Codeigniter….).

Vamos a centrarnos en el plugin para PHP 5.

Lo primero que tenemos que hacer es descargarnos Akismet:
PHP5Akismet.0.4.zip 24K

A continuación descomprimimos el archivo Akismet.class.php y lo archivamos en una carpeta de nuestro proyecto (a efectos de este ejemplo suponemos que lo guardamos en la carpeta “includes”)

Ahora ya estamos listos para usarlo. Hay que tener en cuenta que en nuestro formulario deberíamos tener además un sistema de validación (tanto en Javascript como en PHP) adicionales. Una vez que el formulario enviado pase dichos filtros estaríamos en condiciones de establecer un filtro más, el de Akismet:

Primer paso: obtener la clave (API key)

Para usar Akismet necesitamos antes de nada obtener una clave (API key) para activar y usar Akismet. Esta clave es gratuita y la podemos obtener desde la misma página de Akismet. Debéis tener en cuenta que hay ciertas condiciones de uso para las cuales necesitaríais obtener una clave comercial.

En el formulario se nos pide una dirección de correo electrónico, la enviamos y recibiremos la clave.

Segundo paso: Incluir Akismet en nuestro código

Una vez tengamos la clave ya podemos incluir Akismet. Como vimos más arriban tenemos el archivo Akismet.class.php dentro de la carpeta “includes”. Para incluirlo hacemos símplemente:

1
2

// Incluimos la clase Akismet
include('includes/Akismet.class.php');

Incluir la clave (API key)

El siguiente paso es incluir la clave que nos ha proporcionado Akismet así como la URL de nuestra web

1
2
3

//Introducirmos la API key para nuestra web
$api_key = 'aqui va la clave';
$blog_url = "http://www.miweb.com";

Creamos el objeto Akismet

A continuación creamos el objeto Akismet:

1
2

// Creamos el objeto Akismet
$akismet = new Akismet($blog_url ,$api_key);

Probamos si la clave (API key) es válida

Estas líneas sólo nos serviran para comprobar si la clave que tenemos es válida. Una vez veamos que todo va bien las podemos eliminar. O también podemos incluir todo el código que crearemos a continuación dentro del condicional, para que sólo se ejecute si la clave es válida.

1
2
3
4
5

if($akismet->isKeyValid()) {
echo '<p>La clave es buena</p>';// api key es buena
} else { 
echo '<p>La clave no vale</p>'; // api key no es buena
 }

Definir los campos a filtrar

A continuación establecemos qué campos de nuestro formulario son los que vamos a filtrar contra Spam. En este caso suponemos el nombre, e-mail, el comentario y una url. Las variables proceden del código que deberíamos haber creado previamente para obtener los valores de $_POST enviados por el formulario que una vez validados se asignan a cada variable.

1
2
3
4

$akismet->setCommentAuthor($nombre); 
$akismet->setCommentAuthorEmail($email);
$akismet->setCommentContent($comentarios);
$akismet->setCommentAuthorURL($url);

Establecer el enlace permanente donde el formulario es enviado

1
2

// Enlace permanente donde el formulario es enviado
$akismet->setPermalink('http://www.ejemplo.com/una-url/');

Condicional si se considera spam

Para saber si Akismet considera que es Spam podemos hacer:

1
2
3
4
5

if ( $akismet->isCommentSpam() ) { 
 // Aquí va el código, mensaje de error o lo que queramos, o incluso archivarlos en algún sitio para comprobarlos más adelante
 } else {
// Aquí va el código en el caso de que NO sea Spam
}

Y eso es todo, como véis es muy sencillo de usar. Todo el código junto:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

// Incluimos la clase Akismet
include('includes/Akismet.class.php');
 
//Introducirmos la API key para nuestra web
$api_key = 'aqui va la clave';
$blog_url = "http://www.miweb.com";
 
// Creamos el objeto Akismet
$akismet = new Akismet($blog_url ,$api_key);
 
// Condicional para ver si la clave es válida
if($akismet->isKeyValid()) {
 
// Campos a filtrar
$akismet->setCommentAuthor($nombre); 
$akismet->setCommentAuthorEmail($email);
$akismet->setCommentContent($comentarios);
$akismet->setCommentAuthorURL($url);
 
// Enlace permanente donde el formulario es enviado
$akismet->setPermalink('http://www.ejemplo.com/una-url/');
 
// Decidimos qué hacer si es Spam y si no lo es
if ( $akismet->isCommentSpam() ) { 
 // Aquí va el código, mensaje de error o lo que queramos, o incluso archivarlos en algún sitio para comprobarlos más adelante.
 } else {
// Aquí va el código en el caso de que NO sea Spam, que normalmente será continuar con cualquier proceso de validación o incluso ya con el envío del formulario.
}
 
} // Fin del condicional si la clave es válida

Documentación adicional

Web de Akismet
Documentación de Akismet
Aching Brain, Akismet para PHP5

Hay ocasiones en las que queremos que cada vez que entre un usuario a nuestra web el fondo de la misma sea elegido aleatoriamente. De esta forma podemos sorprender a nuestros usuarios con distintos diseños, distintos mensajes, etc..

Conseguirlo es muy sencillo combinando PHP y CSS.

Supongamos que tenemos una serie de imágenes para el fondo de nuestra web que se llaman: “fondo_body1.jpg” , “fondo_body2.jpg” , “fondo_body3.jpg” , “fondo_body4.jpg” , “fondo_body5.jpg”, “fondo_body6.jpg” , “fondo_body7.jpg” , “fondo_body8.jpg” , “fondo_body9.jpg” , “fondo_body10.jpg”,”fondo_body11.jpg” , “fondo_body12.jpg” , “fondo_body13.jpg” , “fondo_body14.jpg” y “fondo_body15.jpg”

¡Quince nada menos! De esta manera va a ser dificil que a un usuario le salga dos veces seguidas la misma imagen……

Vamos a ver línea por línea. Como vamos a introducir estilos dentro de Head escribiríamos:

1

<style type="text/css" media="screen">

A continuación abrimos php y creamos un número aleatorio utilizando PHP:

1
2

<?php
$valor = rand(0,14); // Uso de rand(): rand(Valor minimo, Valor maximo);

De esta forma creamos un número aleatorio entre cero y catorce y lo almacenamos en la variable $valor. ¿Por qué empezamos por cero? Porque ahora vamos a almacenar los nombres de nuestras imágenes en una array o matriz, y estas comienzan a contar desde cero. Por lo tanto como tenemos quince imágenes contaríamos desde cero a catorce.

Almacenemos nuestras imágenes en el array:

1

$imagenes = array("fondo_body1.jpg" , "fondo_body2.jpg" , "fondo_body3.jpg" , "fondo_body4.jpg" , "fondo_body5.jpg", "fondo_body6.jpg" , "fondo_body7.jpg" , "fondo_body8.jpg" , "fondo_body9.jpg" , "fondo_body10.jpg","fondo_body11.jpg" , "fondo_body12.jpg" , "fondo_body13.jpg" , "fondo_body14.jpg" , "fondo_body15.jpg");

Como veis hemos creado un array donde hemos almacenado todos los nombres de nuestras imágenes y ese array lo hemos almacenado a su vez en la variable $imagenes.

Ahora vamos a escribir la línea de CSS que va a crear el fondo para nuestra web, es decir, el fondo de body (cerrando a continuación php y style):

1
2
3

echo "body{ background: #000 url('images/".$imagenes[$valor]."') no-repeat top right fixed;}";
?> 
</style>

Como estamos aún con PHP la manera que utilizamos en PHP para escribir algo es a través de echo. A continuación sigue la instrucción de CSS que da el fondo a body pero con una peculiaridad: el nombre de la imagen que va a estar ocupando el fondo vendrá dado por las dos variables que hemos creado con anterioridad. Por ejemplo, si el número aleatorio es 3 tendremos $imagenes[3], es decir, escogerá el tercer valor del array comenzando por cero, que es fondo_body4.jpg. Hay que tener cuidado con las comillas. Añadimos la variable con un punto (que es la manera de añadir con PHP) después de interrumpir con dobles comillas la instrucción normal de CSS para introducir PHP. Si seguimos con nuestro ejemplo el resultado será:

1
2
3

<style type="text/css" media="screen">
body{ background: #000 url('images/fondo_body4.jpg') no-repeat top right fixed;}
</style>

Vamos a ver ahora todas las líneas que escribiríamos dentro de head:

1
2
3
4
5
6
7

<style type="text/css" media="screen">
<?php 
  $valor = rand(0,14); // Uso de rand(): rand(Valor minimo, Valor maximo);
  $imagenes = array("fondo_body1.jpg" , "fondo_body2.jpg" , "fondo_body3.jpg" , "fondo_body4.jpg" , "fondo_body5.jpg", "fondo_body6.jpg" , "fondo_body7.jpg" , "fondo_body8.jpg" , "fondo_body9.jpg" , "fondo_body10.jpg","fondo_body11.jpg" , "fondo_body12.jpg" , "fondo_body13.jpg" , "fondo_body14.jpg" , "fondo_body15.jpg");
  echo "body{ background: #000 url('images/".$imagenes[$valor]."') no-repeat top right fixed;}";
?> 
</style>

Podemos refinar aún más nuestro código. ¿Qué pasa si de repente en vez de tener 15 imágenes queremos que sean 16? Que tenemos que cambiar el número en rand. ¿No podemos hacer que se cuente de manera automática el número de imágenes que hay en el array? Pues sí se puede. Lo haríamos así:

1

count($imagenes)

En nuestro caso nos dará un valor de 15, ya que hay 15 imágenes en el array. Para llevar esto a la función que crea el número aleatorio haríamos:

1

 $valor = rand(0, count($imagenes)-1); // Uso de rand(): rand(Valor minimo, Valor maximo);

Vemos que a la función que nos cuenta el número de imágenes del array le hemos restado uno ¿Por qué? Recordad que se comienza siempre contando desde cero. Si hay una sola imagen $valor tendría que ser cero (un número aleatorio entre cero y cero, saldría cero, que es la primera imagen).

Ahora quedaría todo así:

1
2
3
4
5
6
7

<style type="text/css" media="screen">
  <?php 
	$imagenes = array("fondo_body1.jpg" , "fondo_body2.jpg" , "fondo_body3.jpg" , "fondo_body4.jpg" , "fondo_body5.jpg", "fondo_body6.jpg" , "fondo_body7.jpg" , "fondo_body8.jpg" , "fondo_body9.jpg" , "fondo_body10.jpg","fondo_body11.jpg" , "fondo_body12.jpg" , "fondo_body13.jpg" , "fondo_body14.jpg" , "fondo_body15.jpg");
       $valor = rand(0, count($imagenes)-1); // Uso de rand(): rand(Valor minimo, Valor maximo);
	echo "body{ background: #000 url('images/".$imagenes[$valor]."') no-repeat top right fixed;}";
?> 
</style>

Fijaros en la instrucción que he incluído en body. Por supuesto que podéis cambiar como queráis lo que he puesto yo (fondo negro -#000-, situado en la parte superior de la pantalla -top- en la parte derecha -right- y que no se desplace cuando nos desplazamos hacia abajo en la página -fixed-)

Más lecturas recomendadas

PHP.net – Arrays in PHP
Desarrolloweb.com – Creación de tablas por medio de variables tipo array. Utilidad y funciones útiles relacionadas.

Normalmente al pie de una página web ponemos siempre la frase de rigor en cuanto al copyright de la web (muchas veces sin haber realizado los papeleos legales, pero esa es otra historia…), como por ejemplo:

¿Pero qué sucede si en la frase pone 2009 y estamos ya en el año 2010 o en el 2011? Pues que si no hemos actualizado la fecha podríamos dar una impresión de web antigua. Vamos a ver cómo podemos actualizar el año de manera automática gracias a unas pocas líneas de PHP para que aparezca algo así:

Este código lo podemos incluir también en Wordpress, si así lo deseamos. El código a incluir es símplemente este:

1
2
3
4
5
6
7
8
9
10
11
12

<?php
  date_default_timezone_set("Europe/Madrid");
  setlocale (LC_TIME,"spanish", "es_ES@euro", "es_ES", "es");
  $inicio=2009;
  $actual=date('Y');
  if ($inicio==$actual){
	echo '<p >' . $inicio;
  } else {
	echo "<p>{$inicio}-{$actual}";
  }
?> 
 &copy; Copyright Emenia S.L. Todos los derechos reservados. </p>

Como veis lo primero que hacemos es situarnos en la zona horaria peninsular y eso lo hacemos con las dos primeras líneas. Luego creamos dos variables: una $inicio que será el año desde el que comenzamos, en este caso 2009. La otra variable, $actual, obtiene el año actual de date(‘Y’). Luego comparamos ambas variables. Si son iguales, sólo mostraremos una. Si son distintas (es decir, ya no estamos en el 2009) mostraremos las dos. Una vez dejamos ya php terminamos con el resto de la frase.

Más lecturas recomendadas:

Sobre date-default-timezone-set: http://es.php.net/manual/en/function.date-default-timezone-set.php
Sobre setlocale: http://es.php.net/manual/en/function.setlocale.php
Sobre date(‘Y’): http://es.php.net/manual/en/function.date.php
En el blog Digging into Wordpress aparece una solución alternativa utilizando los recursos que proporciona Wordpress: http://digwp.com/2009/08/range-copyright-dates/

Vamos a ver una forma de limitar el número de palabras del contenido o del resumen de un artículo en Wordpress sólo cuando y donde queramos y sin alterar el código principal ni el número de caracteres en el administrador, lo cual puede ser muy útil para que todo se mantenga tal cual al actualizar nuestra versión de Wordpress o a la hora de mostrar los resúmenes en la página principal del blog.

Esto lo he hecho en la portada de Emenia, que como podéis ver es una página en principio estática, donde no se publican los artículos del blog (este se hace seleccionando en el administrador de Wordpress dentro de Opciones/Lectura La página inicial mostrará una página estática). Si os fijáis veréis que en su lado derecho hay un cuadro con los dos últimos artículos del blog. Necesitaba incluír un número muy limitado de palabras en este resumen, pero sin afectar al número de caracteres que por defecto muestra Wordpress cuando escribimos the_excerpt() – 55 caracteres – que quería que funcionara con normalidad en el blog.

Voy a dividir el código en varias partes para explicarlo con más facilidad y al final incluiré el código completo.

Las primeras líneas lo que hacen es limitar el número de entradas que se van a mostrar a dos. Por supuesto que cambiando el número de ‘numberposts=2′ podremos publicar más (o menos) entradas. Se crea un bucle foreach que lo envuelve todo y que finaliza con endforeach;

1
2
3
4
5
6
7
8
9
10
11

<ul>
  <?php
    $recentposts = get_posts('numberposts=2');
    foreach ($recentposts as $post) :
	setup_postdata($post);
  ?>
 
 Aquí escribiremos el código que se aplicará a cada artículo
 
<?php endforeach; ?>
</ul>

A continuación con the_title() obtendremos el título del artículo en forma de enlace al artículo completo gracias a the_permalink(), que escribe en enlace al artículo.

Y ahora necesitamos obtener el contenido del artículo y almacenarlo en una variable. No podemos usar the_content() o the_excerpt() porque ejecutan el script y muestran el contenido completo, pero sí podemos utilizar get_the content() o get_the_excerpt(). Lo almacenaremos en una variable que llamaremos $textoLargo. También vamos a almacenar el enlace correspondiente a cada artículo en una variable. Eso lo logramos con get_permalink($post->ID)

Vamos a verlo:

1
2
3
4

<p><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></p>
<?php  
  $textoLargo= get_the_excerpt();
  $permalink = get_permalink($post->ID);

Ahora viene quizás la parte más compleja. Necesitamos crear una función que haga todo el trabajo cada vez que necesitemos reducir el tamaño del texto incluído en la variable $textoLargo.

Para ello vamos a utilizar PHP. Abrimos el archivo functions.php que se encuentra normalmente en el directorio de nuestro template, junto a todos los demás archivos, y escribimos:

1
2
3
4
5
6
7
8

function limitar_palabras( $str, $num, $append_str='' ) {
  $palabras = preg_split( '/[\s]+/', $str, -1, PREG_SPLIT_OFFSET_CAPTURE );
  if( isset($palabras[$num][1]) ){
    $str = substr( $str, 0, $palabras[$num][1] ) . $append_str;
  }
  unset( $palabras, $num );
  return trim( $str );
}

Esta función es la que va a realizar todo el trabajo. Como vemos acepta tres parámetros: $str que es la cadena de texto que vamos a acortar, $num que es el número de palabras que se mostrarán y por último cualquier cadena de texto o código que queramos unir al nuevo texto ya cortado (por defecto este parámetro será una cadena de texto vacía, de ahí las dos comillas en $append_str=”). Dentro ya de la función utilizamos preg_split que lo que hace es cortar una cadena de texto utilizando una regular expression. Podemos ver la descripción y uso de preg_split en el manual de funciones de PHP.

Seguimos donde lo habíamos dejado más arriba una vez hemos guardado functions.php con la nueva función incorporada.
Ahora vamos a crear una nueva variable que llamaremos $textoCorto que almacenará el texto ya cortado y que invocará la función limitar_palabras pasando estos parámetros:
El texto a cortar (que está en la variable $textoLargo), el número de caracteres del nuevo texto (en este caso 13) y el texto adicional que vamos a incluir tras el texto cortado (en este caso unos corchetes con dos puntos en su interior para mostrar que hay más texto y la palabra Más con el enlace al artículo, que habíamos guardado en la variable $permalink). Para finalizar mostramos ya en la página el texto ya cortado con un echo:

1
2
3

  $textoCorto=limitar_palabras($textoLargo, 13,'&#91;...&#93;&nbsp;&nbsp;<a href="'. $permalink . '" title="Ir al art&iacute;culo">M&aacute;s&raquo;</a>' );
  echo '<p>' . $textoCorto . '</p>';
?>

¡Y eso sería todo! Ya tendríamos los dos últimos artículos con su título y en enlace al artículo, con su contenido limitado a 13 palabras y con un Más>> también enlazado al artículo completo.

Este sería el código completo:

1
2
3
4
5
6
7

<p><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></p>
<?php 	
   $textoLargo= get_the_excerpt();
   $permalink = get_permalink($post->ID);
   $textoCorto=limitar_palabras($textoLargo, 13,'&#91;...&#93;&nbsp;&nbsp;<a href=" '. $permalink . ' " title="Ir al art&iacute;culo">M&aacute;s&raquo;</a>' );
   echo '<p>' . $textoCorto . '</p>';
?>

Más lecturas recomendadas:

CJD Blog – Muestra cómo crear resúmenes personalizados creando una función en Wordpress, una solución más pura de Wordpress, aunque algo más compleja: http://www.chrisjdavis.org/custom-excerpts-for-wordpress