Ejemplo de llamada a una función “callback”

En el siguiente ejemplo se define una función “hola()” que imprime el texto “Hola, mundo!”.

A continuación se define una variable “$nombre_funcion” cuyo valor es el nombre de la función.

Despues se utiliza la función intrínseca “call_user_func()” para ejecutar la función “hola()” pasandole como argumento la variable que contiene el nombre de la función a ejecutar:

<?php

function hola() {
    echo "Hola, mundo!\n";
}

$nombre_funcion = "hola";

call_user_func($nombre_funcion);

Paso de argumentos a una función “callback”

Para pasar argumentos a la función callback, basta como añadirlos como argumentos adicionales en la llamada a “call_user_func()”.

Ejemplo:

function imprime_argumentos($argumento1, $argumento2) {
    echo "El primer argumento es $argumento1, el segundo es $argumento2\n";
}

call_user_func("imprime_argumentos","Londres", "New York");

Si los argumentos que se desea pasar a la función callback están contenidos en un array, podemos llamar en su lugar a la función intrínseca “call_user_func_array()”, pasándole como segundo argumentos el array de argumentos a pasar a la función callback:

function imprime_argumentos($argumento1, $argumento2) {
    echo "El primer argumento es $argumento1, el segundo es $argumento2\n";
}
// Creamos un array con los argumentos
$argumentos = array("Londres","New York");
// Llamamos a call_user_func_array con el array de argumentos como segundo argumento
call_user_func_array("imprime_argumentos", $argumentos);

Otro tipo de callbacks: métodos de clase y métodos de objeto

Además de una función, es posible ejecutar como callback un método estático de una clase.

Para ello, en la llamada a call_user_func() podemos pasar como primer argumento:

• un array que contiene el nombre de la clase y el nombre del método.
• o bien un string de la forma NOMBRE_CLASE::NOMBRE_METODO.

Ejemplo:

class miclase {
    static function hola()
    {
        echo "Hola mundo!\n";
    }
}

call_user_func(array("miclase", 'hola'));
call_user_func("miclase::hola");

También podemos llamar a un método de una instancia de la clase, pasando como argumento a call_user_func() un array con el objeto y el nombre del método:

// Creamos una instancia de la clase "miclase"
$mi_objeto = new miclase();
// Llamamos al método "hola" de la instancia
call_user_func(array($mi_objeto,"hola"));

Referencias:

• Documentación de referencia de call_user_func()
• Documentación de referencia de llamadas de retorno en PHP

—

En este artículo utilizamos y explicamos el procedimiento presentado originalemente en jsfiddle.net, para incluir esta funcionalidad en nuestra instalación de wordpress.

Resultado

El resultado final que obtenemos es el siguiente:

Como vemos, hemos incluido un reproductor de vídeo en el artículo, y bajo el mismo hemos incluido tres botones que permiten seleccionar el vídeo que queremos reproducir.

La librería javascript video.js

El ejemplo de jsfiddle.net utiliza la librería “video.js” de www.videojs.com.

En nuestro blog de wordpress, instalamos el plugin “Video.js – HTML5 Video Player for WordPress”, que nos permite utilizar dicha librería.

Insertar el tag “<video>”

En el ejemplo de jsfiddle.net se indica que para incluir el reproductor de vídeo en la página utilicemos un tag “<video>” de html5 de la forma:

<video id="mi_video" class="video-js vjs-default-skin" controls preload="auto" 
       width="511" height="382" poster="/test-video/testvid_01.jpg" data-setup="{}">  
    <source src="" type="video/mp4" />
    <source src="" type="video/webm" />
    <source src="" type="video/ogg" />
</video>

En wordpress, en lugar de insertar directamente el tag “<video>”, se utiliza un “shortcode” [video]:
[video mp4="" webm="" ogg="" id="mi_video" controls preload="auto" width="511" height="382" poster="/test-video/testvid_01.jpg" data-setup="{}"]

El código HTML de los botones

El código HTML que se utiliza para los botones es:

<div class="wrap">
  <input rel="01" type="button" value="cargar video 1">
  <input rel="02" type="button" value="cargar video 2">
  <input rel="03" type="button" value="cargar video 3">
</div>

Como se puede ver, se añade un atributo “rel” a cada botón. Este atributo se utiliza en le código javascript para identificar el vídeo que se quiere cargar en el video player.

El código javascript

El código javascript que aparece en jsfiddle.net utiliza la librería jQuery.

Para que el código funcione sin problemas en nuestra instalación de wordpress, sustituimos la llamadas a jQuery que utilizan la sintaxis abreviada “$()” por la sintaxis standard “jQuery()”:

jQuery("input[type=button]").click(function() {
    var $target         = "testvid_"+jQuery(this).attr("rel");
    var $content_path   = "/test-video/";
    var $vid_obj        = _V_("mi_video");

    // oculta el poster actualmente cargado
    jQuery("img.vjs-poster").hide();

    $vid_obj.ready(function() {
      // Parar el vídeo que se estaba reproduciendo
      $vid_obj.pause();

      // asigna los nuevos vídeos a los nodos correspondientes del reproductor
      jQuery("video:nth-child(1)").attr("src",$content_path+$target+".mp4");
      jQuery("video:nth-child(1)").attr("src",$content_path+$target+".ogv");
      jQuery("video:nth-child(1)").attr("src",$content_path+$target+".webm");

      // sustituye la fuente del poster
      jQuery("img.vjs-poster").attr("src",$content_path+$target+".jpg").show();
      // reset the UI states
      jQuery(".vjs-big-play-button").show();

      // carga las nuevas fuentes
      $vid_obj.load();

    });
});

jQuery("input[rel='01']").click();

como vemos, el código javascript define una función click() que es asignada a todos los elementos de la página del tipo “button”

La función comienza por identificar el video a cargar, utilizando para ello el valor del atributo “rel” del botón que ha sido pulsado.

A continuación, obtiene un objeto de tipo vídeo haciendo una llamada a la función “_V_()” definida en la librería video.js

Por último, asigna al objeto una función “ready()” que sustituye las fuentes del vídeo en los distintos formatos mp4, ogv y web, por las correspondientes al nuevo vídeo a reproducir.

Y eso es todo !

—

Introducción

Normalmente, un servidor linux consta de uno o varios discos físicos. Cada uno de ellos contiene una serie de particiones, y cada partición contiene un filesystem de determinado tipo (excluyendo las particiones dedicadas a swap).

En un sistema en producción, puede ocurrir que no tengamos posibilidad de modificar la configuración de discos, particiones y filesystems, por limitaciones impuestas por nuestro proveedor de hosting, u otras razones. Pero creando discos virtuales sobre ficheros, tenemos completa libertad para crear en ellos filesystems de última generación como zfs o btrfs, con funcionalidades avanzadas como encriptación, compresión de datos, etc.

Además, la portabilidad de un filesystem de este tipo a otro sistema es máxima, porque basta con copiar al sistema de destino el fichero que contiene el filesystem

Crear el fichero contenedor

1. Creamos un fichero llamado “linux.ex2″ de 1 GB:

dd if=/dev/zero of=linux.ex2 bs=1024 count=1048576

2. Creamos el filesystem en el fichero con el comando mke2fs:

Utilizando distintas opciones de mke2fs, podemos crear un filesystem con journaling, cambiar el número de inodos, etc:

# mke2fs -i 8192 -j linux.ex2
mke2fs 1.41.12 (17-May-2010)
linux.ex2 is not a block special device.
Proceed anyway? (y,n) y
Filesystem label=
OS type: Linux
Block size=4096 (log=2)
Fragment size=4096 (log=2)
Stride=0 blocks, Stripe width=0 blocks
131072 inodes, 262144 blocks
13107 blocks (5.00%) reserved for the super user
First data block=0
Maximum filesystem blocks=268435456
8 block groups
32768 blocks per group, 32768 fragments per group
16384 inodes per group
Superblock backups stored on blocks:
        32768, 98304, 163840, 229376

Writing inode tables: done
Creating journal (8192 blocks): done
Writing superblocks and filesystem accounting information: done

This filesystem will be automatically checked every 35 mounts or
180 days, whichever comes first.  Use tune2fs -c or -i to override.
sh-4.1#

En el ejemplo, se han creado 8 grupos de bloques de 16384 inodos, para obtener un total de 131072 inodos. Además, la opción “-j” hace que se cree un filesystem con journaling.

Montar el filesystem

Para ello, utilizamos el mismo comando mount que se utiliza para montar filesystems creados en particiones de un disco físico, pasándole la opción “-o loop=/dev/loop0″:

# mount linux.ex2 /mnt -o loop=/dev/loop0

El dispositivo ‘loop’

El dispositivo loop es el que permite que el sistema acceda a un fichero como si se tratase de un disco físico. En un sistema Debian, el módulo loop está normalmente compilado como parte del kernel. Si no es así, deberemos compilarlo a partir del código fuente.

—

En éste vamos a ver paso a paso cómo montar una tienda internet utilizando PrestaShop, una de las plataformas más extendidas.

Prerequisitos

El sistema en donde vamos a realizar la instalación es un servidor Linux que ya dispone de una instalación de Apache, MySQL y PHP (normalmente conocido como LAMP, por las siglas de estas aplicaciones.

Instalación

Comenzamos por descargar de www.prestashop.com el paquete de instalación de la versión 1.5.4. Al pulsar en el botón “Download” aparece un formulario en el que podemos seleccionar los idiomas a incluir en el paquete. En nuestro caso, seleccionamos “English” (por defecto), y Español. El fichero descargado se llama prestashop_1.5.4.1.zip, y ocupa 17 MB.

Configuración del virtual host

En el fichero de configuración “/etc/apache2/sites-enabled” de nuestro servidor Apache, creamos un fichero “tienda-prestashop” con la definición del VirtualHost que va a contener la instalación de PrestaShop:

<VirtualHost *:80>
ServerName tienda.openalfa.com
DocumentRoot "/web/tienda"
</VirtualHost>

Instalación del sofware

A continuación, creamos el directorio /web/tienda, y descomprimimos en él el contenido del fichero zip descargado. Al descomprimirlo, se crea un directorio “prestashop” y un fichero “Install_Prestashop.html”:

/web/tienda$ ls -l
total 17236
-rw-r--r--  1 root     root          308 Mar 26 18:10 Install_PrestaShop.html
drwxr-xr-x 24 root     root         4096 May 14 14:10 prestashop

Registro y configuración del dominio

Si no disponemos de un dominio, debemos proceder a registrarlo en alguno de los registradores que trabajan con el tipo de dominio que deseamos (por ejemplo, euroDNS, goDaddy o Nominalia). Casi todos los registradores permiten registrar un dominio “.com”, pero no todos trabajan con dominios de un determinado país, como por ejemplo dominios “.es”.

También debemos añadir un registro de tipo “A” o “CN” a la configuración DNS de nuestro dominio, para que el nombre del subdominio “tienda.openalfa.com” se resuelva en la dirección IP de nuestro servidor.

Creación de la base de datos

Por último, debemos crear una base de datos para contener la información de nuestra tienda. Para ello, se puede utilizar phpMyAdmin si lo tenemos instalado en nuestro servidor. En caso contrario, podemos hacerlo directamente desde la línea de comandos:

$ mysql -u root -pCLAVE
mysql> create database tienda;
Query OK, 1 row affected (0.02 sec)

mysql>

Configuración de prestashop

Con esto, ya podemos apuntar nuestro navegador a la url “http://tienda.openalfa.com/prestashop/install”. La primera página que aparece nos permite seleccionar el idioma en el que queremos realizar la instalación. Seleccionamos “Español”, y pulsamos “Siguiente”:

La siguiente pantalla solicita que aceptemos la licencia de uso del software.

A continuación aparece una pantalla en la que se presenta el resultado de la comprobación de la compatibilidad del sistema. En nuestro caso, la pantalla indica que:

• Hay un problema con los permisos de usuario.
• La extensión Mcrypt de PHP no está habilitada.

Para solucionar el primer problema, ponemos el usuario con el que se ejecuta apache como propietario de todos los ficheros de la instalación:

$ sudo chown -R www-data:www-data prestashop

El segundo problema se soluciona instalando el paquete que contiene la extensión Mcrypt de PHP. en un sistema Debian o Ubuntu, esto se hace fácilmente con la utilidad apt-get:

$ sudo apt-get install php5-mcrypt
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
  libmcrypt4
...
$

y a continuación reiniciamos el servidor web:

$ sudo /etc/init.d/apache2 restart

Con esto, al hacer click sobre “Actualizar esta información” ya no aparece ningún error, y podemos hacer click en “Siguiente” para continuar.

La siguiente pantalla contiene el formulario en donde introducimos la información de conexión a la base de datos que hemos creado previamente. Normalmente, sólo tenemos que introducir el nombre de la base de datos (en nuestro caso, “tienda”)  y la contraseña de la misma, y dejar los demás campos con sus valores por defecto:

El primer bloque del formulario que aparece en la siguiente pantalla nos permite darle un nombre a la tienda, establecer la actividad principal, asignarle un logo, etc. En el segundo bloque, establecemos el usuario, dirección de correo y contraseña de acceso como administrador de la tienda.

Al pulsar en “Siguiente”, el script de instalación procede a crear las tablas de la base de datos y cargarlas con datos de demo.

Cuando nos indica que ya ha finalizado, ya podemos acceder a la url de inicio de la tienda para ver el aspecto que tiene:

Por último, sólo nos queda eliminar el directorio “install” y cambiar de nombre al directorio “admin” para poder acceder al interfaz de administración de la tienda:

Y con esto ya tenemos nuestra instalación de PrestaShop plenamente operativa!

En el siguiente artículo de esta serie examinaremos la tareas que todavía nos quedan pendientes antes de tener una tienda “de verdad”:

- Configuración y mantenimiento del catálogo de productos

- Configuración de medios de pago

- Gestión de inventario

- etc.

—

Shortcodes documentados para la inserción de audio y vídeo

En la documentación de jetpack hay una relación de los “shortcodes” disponibles en un blog de wordpress.com para la inserción de referencias a vídeo o audio existente en distintos servicios (flickr, vimeo, youtube).

El problema es que el shortcode documentado para la inserción de vídeo de youtube no permite especificar la opción “autostart”, para que comience a reproducirse de manera automática.

Shortcode gigya

La solución para conseguir un vídeo que se reproduzca automáticamente es utilizar el shortcode “gigya”. Este shortcode también está disponible en un blog gratuito de wordpress.com, aunque no se hace referencia al mismo en la documentación oficial.

Inserción de un vídeo de youtube con autoplay

Supongamos que hemos localizado un vídeo en youtube que queremos insertar en nuestro blog. En la barra de direcciones del navegador, tomamos nota de la url que aparece, por ejemplo:

http://www.youtube.com/watch?v=1SuXOnBmDm8

En esta url, el valor 1SuXOnBmDm8 es el identificador del vídeo.
Ahora, insertamos en nuestro blog el shortcode gigya de la siguiente forma:

[gigya src="http://www.youtube.com/v/VIDEO-ID" flashvars="autoplay=1" 
      type="application/x-shockwave-flash" allowscriptaccess="always"
      allowfullscreen="true"
      width="425" height="350"]

En donde simplemente sustituimos VIDEO-ID por el identificador del vídeo que hemos anotado más arriba.

Como vemos, en el shortcode hemos incluido la variable “autoplay=1″, con la cual el vídeo comienza a ejecutarse automáticamente.

Inserción de música de fondo

De la misma forma, podemos incluir un vídeo de youtube que sólo contenga música, para que se escuche como música de fondo cuando visitamos una página.

Para evitar que se vean en pantalla los controles del reproductor, podemos editar la página en el editor HTML, para hacer invisible el shortcode poniéndolo en el interior de un elemento <div> con el adecuado estilo CSS:

<div style="display:none">
    [gigya src="http://www.youtube.com/v/VIDEO-ID" flashvars="autoplay=1" 
                                   type="application/x-shockwave-flash" width="425" height="350"]
</div>

Para que la música se reproduzca en todas las páginas del blog, en lugar de poner el shortcode en cada página, podemos ponerlo en el interior de un widget de tipo “Texto o HTML arbitrario”, en la barra lateral.

Referencias:

• http://jetpack.me/support/shortcode-embeds/
• Enable Youtube autoplay for wordpress.com – a workaround
• http://wpbtips.wordpress.com/category/gigya/
• The gigya shortcode 1 – inserting videos

—

Diferencias entre InnoDB y MyISAM

InnoDB es actualmente el motor de almacenamiento por defecto en las últimas versiones de MySQL. Las funcionalidades que ofrece son más adecuadas que las de MyISAM en general, pero en casos particulares puede ser preferible utilizar este último para aprovechar algunas de sus características.

Funcionalidades específicas de InnoDB

• transacciones ACID
• bloqueo a nivel de registro (MyISAM sólo ofrece bloqueo a nivel de tabla)
• restricciones de clave externa (foreign key constraints)
• recuperación automática en caso de crash
• compresión de tablas con posibilidad de lectura/escritura
• tipos de datos espaciales(pero no índices espaciales)
• Los datos son guardados en páginas en orden de clave primaria

Funcionalidades específicas de MyISAM

• ejecución rápida de COUNT(*)s (cuando no se utilizan WHERE, GROUP BY, o JOIN)
• indexación “full text”
• ocupan menos espacio en disco que las tablas InnoDB
• compresión elevada de tablas, pero las tablas comprimidas son de sólo lectura
• tipos de datos e índices espaciales (R-tree)

A continuación detallamos en qué consiste cada una de estas funcionalidades. Con ello, el DBA puede tomar una decisión adecuada sobre el tipo de tabla que conviene en cada caso.

Transacciones ACID

ACID son las siglas en inglés de las propiedades ( (Atomicity, Consistency, Isolation, Durability) que debe tener una transacción para ser fiable.

El cumplimiento de estas propiedades realizar un conjunto de operaciones sucesivas sobre los datos, y validarlas todas ellas como un bloque mediante una sentencia COMMIT, o bien deshacerlas con una sentencia ROLLBACK, volviendo a dejar el contenido de la tabla como estaba.

Bloqueo a nivel de registro y bloqueo a nivel de tabla

En InnoDB, si varios usuarios o aplicaciones intentan acceder simultáneamente a la información contenida en una tabla para modificarla, el bloqueo a nivel de registro hace que sólo deban quedar a la espera aquellos que intentan modificar los datos de un mismo registro. En MyISAM, cualquier proceso que intenta modificar la información de una tabla queda a la espera hasta que no hay ningún otro proceso accediendo a la misma.

Restricciones de clave externa

A menudo, los datos de una tabla están relacionados con los de otras. Las restricciones de clave externa aseguran la integridad de estas relaciones.

Esta integridad referencial está implementada en el motor de almacenamiento InnoDB, pero no en MyISAM

Ejemplo:

En una aplicación de comercio electrónico podemos tener una tabla ‘clientes’, otra tabla ‘productos’ y una tercera tabla ‘pedidos’. Para cada cliente, hay un registro en la tabla ‘clientes’. En esta tabla hay un campo ‘id_cliente’ que identifica al cliente de forma única, y que constituye la clave primaria de la misma.

De la misma forma, en la tabla ‘productos’ hay un campo ‘id_producto’ que identifica cada producto de forma única, y es la clave primaria de dicha tabla.

Por último, la tabla ‘pedidos’ guarda una relación de los productos que han sido solicitados por cada cliente. Para ello incluye, entre otros, un campo ‘id_cliente’ y un campo ‘id_producto’ .

Para que los datos sean consistentes, no debe ser posible insertar en la tabla ‘pedidos’ un id de cliente que no exista en la tabla de clientes, o un id de producto que no exista en la tabla de productos. Esto lo podemos conseguir definiendo dos claves externas en la tabla de pedidos:

CREATE TABLE pedidos (
    id_pedido int NOT NULL primary key,
    id_cliente integer NOT NULL,
    id_producto integer not null,
    FOREIGN KEY (id_cliente) REFERENCES clientes(id_cliente),
    FOREIGN KEY (id_producto) REFERENCES productos(id_producto)
) ENGINE=InnoDB;

Notas:

1. Para crear las claves externas, las tablas referenciadas también deben utilizar el motor de almacenamiento InnoDB.

Recuperación en caso de caída

Si el servidor sufre una avería, o por alguna otra razón finaliza abruptamente la ejecución de mysql, es necesario recuperar las tablas MyISAM mediante una reparación completa de las tablas e índices. Si las tablas contienen un gran volumen de datos, el tiempo necesario para recuperar las tablas puede ser muy elevado.

Por el contrario, las tablas InnoDB  se recuperan automáticamente volviendo a ejecutar las transacciones grabadas en el fichero de log de transacciones, haciendo rollback de las que estén incompletas.

Compresión de tablas

InnoDB permite trabajar con tablas comprimidas. Aunque la compresión que se obtiene no es muy grande, sigue siendo posible modificar el contenido con sentencias INSERT, UPDATE y DELETE.

Permite realizar (con myisampack) una compresión mucho mayor, pero a cambio las tablas comprimidas pasan a ser de sólo lectura.

 Tipos de datos espaciales

En MySQL, se pueden definir columna de una tabla que contengan tipos de datos geométricos.

Las columnas cuyo tipo de datos se define como POINT, LINESTRING y POLYGON pueden contener datos del tipo indicado. Por otra parte, también se puede utiliizar el tipo de datos genérico GEOMETRY para definir una columna que puede contener datos de cualquiera de los tipos anteriormente indicados.

También existen los correspondientes tipos de datos para contener colecciones de datos geométricos: MULTIPOINT, MULTILINESTRING, MULTIPOLYGON y GEOMETRYCOLLECTION.

Tanto InnoDB como MySQL soportan estos tipos de datos. Pero mientras que en InnoDB no es posible definir índices que utilizen columnas con este tipo de datos, en MyISAM sí es posible.

Indexación “Full Text”

A partir de la versión 5.6 de MySQL, es posible crear índices “Full Text” tanto en tablas MyISAM como InnoDB. Sin embargo, si la versión de MySQL con la que se está trabajando es 5.5 o anterior, este tipo de índices no está soportado en tablas InnoDB.

Referencias:

• Innodb Storage Engine: http://dev.mysql.com/doc/refman/5.0/en/innodb-storage-engine.html
• MyISAM Storage Engine: http://dev.mysql.com/doc/refman/5.0/en/myisam-storage-engine.html

—

El resultado final

Con el procedimiento explicado en este artículo, obtenemos el siguiente resultado:

El código HTML

En primer lugar, utilizamos los tags “<ul>” y “<li>” para crear una lista con los títulos de las pestañas.

Cada título es un enlace al correspondiente contenido.

        <ul class="nav">
            <li class="nav-one"><a href="#contenido1" class="current">Pestaña 1</a></li>
            <li class="nav-two"><a href="#contenido2">Pestaña 2</a></li>
            <li class="nav-three"><a href="#contenido3">Pestaña 3</a></li>
        </ul>

A continuación ponemos los contenidos, en forma de elementos <div> o de otro tipo.

Todos los contenidos se incluyen dentro de un elemento <div> con id “list-wrap”.

Cada contenido tiene un identificador único indicado por la etiqueta “id”. Además, asignamos la clase css “oculto” a todos los contenidos excepto el primero

    <div class="ejemplo">
        <div class="list-wrap">
            <div id="contenido1">
                Este es el contenido uno
            </div>
            <div id="contenido2" class="oculto">
                Este es el contenido dos
            </div>
            <div id="contenido3" class="oculto">
                Este es el contenido tres
            </div>
        </div>
    </div>

El código CSS

En el código CSS añadimos la definición de la clase “oculto”, para que los contenidos no seleccionados estén fuera del área visible en pantalla:

.oculto { position: absolute; top: -9999px; left: -9999px; }

Por lo demás, podemos utilizar el código CSS que queramos, para adaptar el estilo del área de contenido al estilo general de la página.

El código Javascript

El plugin jQuery a incluir es:

(function($) {
    $.organicTabs = function(el, options) {
        var base = this;
        base.$el = $(el);
        base.$nav = base.$el.find(".nav");

        base.init = function() {
            base.options = $.extend({},$.organicTabs.defaultOptions, options);
            // Accessible hiding fix
            $(".oculto").css({
                "position": "relative",
                "top": 0,
                "left": 0,
                "display": "none"
            }); 
            base.$nav.delegate("li > a", "click", function() {
                // Determinar el nombre del bloque que va a quedar oculto
                var curList = base.$el.find("a.current").attr("href").substring(1),
                    // Determinar el nombre del nuevo bloque 
                    $newList = $(this),
                    listID = $newList.attr("href").substring(1),
                    // Set outer wrapper height to (static) height of current inner list
                    $allListWrap = base.$el.find(".list-wrap"),
                    curListHeight = $allListWrap.height();
                $allListWrap.height(curListHeight);

                if ((listID != curList) && ( base.$el.find(":animated").length == 0)) {
                    // Ocultar progresivamente el bloque previo
                    base.$el.find("#"+curList).fadeOut(base.options.speed, function() {
                        // En la funcion callback, presentar progresivamente (Fade in) el
                        // nuevo bloque
                        base.$el.find("#"+listID).fadeIn(base.options.speed);
                        // Ajustar la altura del div envolvente a la altura del nuevo bloque
                        var newHeight = base.$el.find("#"+listID).height();
                        $allListWrap.animate({
                            height: newHeight
                        });

                        // Marcar la nueva pestaña como pestaña activa
                        base.$el.find(".nav li a").removeClass("current");
                        $newList.addClass("current");
                    });
                }   

                // Evitar la propagación del evento click
                return false;
            });

        };
        base.init();
    };

    $.organicTabs.defaultOptions = {
        "speed": 300
    };

    $.fn.organicTabs = function(options) {
        return this.each(function() {
            (new $.organicTabs(this, options));
        });
    };

})(jQuery);

jQuery("#ejemplo").organicTabs();

Referencias:

http://css-tricks.com/organic-tabs/

—

Cómo listar los paquetes instalados

El comando dpkg -l produce un listado de los paquetes instalados en el sistema, con indicación de su estado, nombre, versión, arquitectura y una breve descripción:

$ dpkg -l|more
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
||/ Name               Version    Arch.  Description
+++-==================-==========-======-=========================================================
ii  abiword            2.8.6-0.3  amd64  efficient, featureful word processor with collaboration
ii  accountsservice    0.6.21-8   amd64  query and manipulate user account information
ii  acl                2.2.51-8   amd64  Access control list utilities

En las tres primeras columas se codifica el status del paquete, de la siguiente forma:

• Columna 1 – Acción deseada
  • u = Desconocido
  • i = Instalar
  • h = Mantener
  • r = Borrar
  • p = Eliminar
• Columna 2 – Status del paquete
  • n = No-instalado
  • c = Sólo están los ficheros de configuración del paquete
  • H = Semi-instalado
  • U = Desempaquetado
  • F = Semi-configurado
  • W = Esperando triggers
  • t = Pendiente de triggers
  • i = Instalado
• Columna 3 – Indicador de error
  • <vacio> = (ningun error)
  • R = Necesita ser reinstalado

Normalmente, Las tres primeras columnas contendrán los caracters “ii “, indicando que:

- El estado deseado para el paquete es “instalado”

- El paquete está  instalado

- no hay ningún error, y el paquete no necesita ser reinstalado

Podemos filtrar la lista con un comando “grep”, para obtener los paquetes que no se encuentran en dicha situación:

$ dpkg -l | grep -v "^ii "                                                                                    
Desired=Unknown/Install/Remove/Purge/Hold                                                                     
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend                                
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)                                                    
||/ Name                 Version            Description                                                       
+++-====================-==================-================================================================  
rc  libapache2-mod-php5  5.3.3-7+squeeze15  server-side, HTML-embedded scripting language (Apache 2 module)

En el ejemplo, el status “rc ” que el paquete libapache2-mod-php5 debería estar borrado del sistema (“r”), pero todavía están presentes los ficheros de configuración (“c”). Por lo demás, no hay ningún error relacionado con el paquete (el tercer carácter es un espacio en blanco).

Como instalar y desinstalar paquetes

Normalmente, en un sistema debian se utiliza el comando “apt-get” para realizar estas tareas

• Instalar los paquetes paquete1 y paquete2:

  $ apt-get install paquete1 paquete2

• Instalar la versión 2.3 de paquete1:

  $ apt-get install paquete1=2.3

• Desinstalar paquete1 y paquete2:

  $ apt-get remove paquete1 paquete2

• Desinstalar y eliminar paquete1 y paquete2:

  $ apt-get purge paquete1 paquete2

  “purge” desinstala el paquete igual que “remove”, pero además borra también los ficheros de configuración

Cómo actualizar paquetes

Antes de actualizar un paquete, se debe ejecutar el comando “apt-get update” para actualizar la lista de paquetes disponibles:

$ sudo apt-get update
Get:1 http://security.debian.org squeeze/updates Release.gpg [836 B]
Ign http://security.debian.org/ squeeze/updates/contrib Translation-en         
Ign http://security.debian.org/ squeeze/updates/contrib Translation-en_GB
Ign http://security.debian.org/ squeeze/updates/main Translation-en

A continuación, si queremos actualizar a la última versión un determinado paquete, utilizamos “apt-get install paquete”, como si se fuera a instalar por primera vez

Si queremos actualizar todos los paquetes instalados, utilizamos “apt-get upgrade”. Este comando no instala ni desinstala ningún paquete, simplemente actualiza los paquetes ya instalados. Si para actualizar un paquete a la última versión fuera necesario instalar o desinstalar otro paquete, el comando “apt-get upgrade” no realizaría ninguna acción con dicho paquete.

Ejemplo:

$ sudo apt-get upgrade
Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following packages have been kept back:
  abiword abiword-plugin-grammar abiword-plugin-mathview alsa-base alsa-utils apt
  apt-utils at-spi bind9-host binfmt-support bluez browser-plugin-gnash cpp cpp-4.4
  cpp-4.6 dasher dnsmasq-base dnsutils dvd+rw-tools eclipse-jdt eclipse-pde
   ...
The following packages will be upgraded:
  acpid comerr-dev cups-bsd cups-client cups-common cups-ppdc curl dmsetup doc-debian
  docbook-xml dpkg dpkg-dev e2fslibs e2fsprogs evolution evolution-common
  evolution-plugins foomatic-db foomatic-db-engine gdm3 gir1.2-cogl-1.0
  ... 
185 upgraded, 0 newly installed, 0 to remove and 184 not upgraded.
Need to get 201 MB of archives.
After this operation, 17.4 MB disk space will be freed.
Do you want to continue [Y/n]?

Como podemos ver en las últimas líneas de la salida generada, en el ejemplo se descargarán 201 MB de archivos, pero el resultado final será que se liberan 17,4 MB, porque alguna de las actualizaciones ocupan menos espacio que las versiones antiguas a las que sustituyen.

Cómo instalar una versión anterior de un paquete instalado (downgrade)

En ocasiones, la versión más reciente de un determinado paquete puede causar problemas en algunas aplicaciones que esperan una versión anterior de dicho paquete. En estos casos es posible reinstalar la versión previa.

Para ello, desinstalamos la versión actual del paquete con “apt-get remove” o “apt-get purge”, y procedemos a instalar la otra versión:

$ sudo apt-get remove paquete
$ sudo apt-get install paquete=version

A continuación, utilizamos “dpkg –set-selections” para marcar el paquete, para impedir que la versión instalada se actualice si se ejecuta un “apt-get upgrade” u otro comando que intente actualizar paquetes:

echo “paquete hold” | dpkg --set-selections

Cómo averiguar de qué ficheros consta un paquete

el comando “dpkg -L paquete” permite saber de qué ficheros consta un paquete instalado. Ejemplo:

$ sudo dpkg -L abiword
/.
/usr
/usr/share
/usr/share/man
/usr/share/man/man1
/usr/share/man/man1/abiword.1.gz
/usr/share/doc
/usr/share/doc/abiword
/usr/share/doc/abiword/changelog.Debian.gz
...

Si el paquete no está instalado, se puede utilizar “apt-file list paquete”. Previamente, es necesario ejecutar “apt-file update” para cargar la cache utilizada por este comando:

$ sudo apt-file update
$ apt-file list abiword
abiword: /usr/bin/abiword
abiword: /usr/lib/mime/packages/abiword
abiword: /usr/lib/x86_64-linux-gnu/abiword-2.9/plugins/aiksaurus.so
abiword: /usr/lib/x86_64-linux-gnu/abiword-2.9/plugins/applix.so
abiword: /usr/lib/x86_64-linux-gnu/abiword-2.9/plugins/babelfish.so
...

Como vemos, “apt-file list” devuelve la información de la versión más reciente que existe en el repositorio (en el ejemplo, la versión 2.9 de abiword), mientras que el comando “dpkg -L” devuelve la información correspondiente a la versión instalada (abiword 2.8 en el ejemplo).

Cómo averiguar a qué paquete pertenece un fichero

Si el fichero está instalado en el sistema, podemos utilizar “dpkg -S”. Ejemplo

$ dpkg -S /bin/ls
coreutils: /bin/ls

En el ejemplo, vemos que el comando “ls” se encuentra en el paquete “coreutils”

Si el fichero no está en el sistema, utilizamos “apt-file search” para buscarlo en el repositorio de paquetes. Ejemplo:

$ apt-file search /bin/ls
9base: /usr/lib/plan9/bin/ls
canna-utils: /usr/bin/lsdic
cgroup-bin: /usr/bin/lscgroup
cgroup-bin: /usr/bin/lssubsys
cmtk: /usr/lib/cmtk/bin/lsba
coreutils: /bin/ls
cwiid-dbg: /usr/lib/debug/usr/bin/lswm
distcc: /usr/bin/lsdistcc
dracut: /usr/bin/lsinitrd
...

Como podemos ver, el comando busca cualquier línea del contenido de un paquete que incluya el string “/bin/ls” que le hemos pasado como argumento. Por esta razón devuelve muchos resultados, entre los cuales se encuentra el que nos interesa: “coreutils: /bin/ls”.

—

Para ver la manera de enviar un correo electrónico de texto simple o HTML, o un correo electrónico con ficheros adjuntos, consultar: Cómo enviar emails desde un script PHP

Si el cuerpo del mensaje está codificado en UTF-8, basta con añadir una línea al header indicando este hecho, y codificar adecuadamente el cuerpo del mensaje. Así, podemos definir una función “mail_utf8″ que añade el header y envía el mensaje de la siguiente forma:

<?php

function mail_utf8($to, $subject = '(No subject)', $message = '', $header = '') {
  $header_ = 'MIME-Version: 1.0' . "\r\n" . 'Content-type: text/plain; charset=UTF-8' . "\r\n";
  mail($to, '=?UTF-8?B?'.base64_encode($subject).'?=', $message, $header_ . $header);
}

?>

Si también los campos From o Cc contienen caracteres utf-8, se pueden codificar de la misma manera. En el caso del campo From, los caracteres utf-8 pueden encontrarse en el nombre del remitente, entre “<” y “>”

    if (ereg("(.*)<(.*)>", $from, $regs)) {
       // El campo From contiene el nombre del remitente
       $from = '=?UTF-8?B?'.base64_encode($regs[1]).'?= <'.$regs[2].'>';
    } else {
       // No hay nombre del remitente, sólo su email. No hay necesidad de
       // codificar el campo
    }

    // Después, añadimos al header la línea "From:"
    $header = 'From: ' . $from . "\n";

—

En este artículo se explica cómo automatizar el proceso de login y la descarga de dicho informe, utilizando un script perl.

0. Prerequisitos

El procedimiento que se explica en este artículo requiere que se hayan instalado previamente los módulos CPAN:

• WWW::Mechanize::GZip
• LWP::Protocol::https

Para ello, en un sistema debian o ubuntu debemos haber instalado también las librerías SSL requeridas:

$ sudo apt-get install libnet-ssleay-perl libcrypt-ssleay-perl

1. Proceso de login

Cuando accedemos a la url http://adwords.google.com desde un navegador en el que no nos hemos validado previamente, somos redirigidos al formulario de login, que se encuentra en una url de la forma:

https://accounts.google.com/ServiceLogin
    ?service=adwords
    &hl=en_GB
    &ltmpl=jfk
    &continue=https://adwords.google.com/um/gaiaauth?apt%3DNone%26ltmpl%3Djfk
    &passive=86400
    &sacu=1&sarp=1

Una vez introducido el usuario y la contraseña, al hacer el submit el navegador accede a la url de proceso del formulario (https://accounts.google.com/ServiceLoginAuth). A continuación, pasa por varias urls mediante una serie de redirecciones 302, hasta que carga la página de inicio de adwords.

En este proceso, el navegador recibe los cookies que necesita para el acceso como usuario autentificado.

Todo este proceso se puede automatizar en perl utilizando el módulo WWW::Mechanize::GZip disponible en CPAN. El código es el siguiente:

#!/usr/bin/perl

use strict;
use warnings;
use WWW::Mechanize::GZip;
use HTTP::Cookies;
use Encode qw(from_to);

my $outfile = "spend.txt";
my $url = 'https://accounts.google.com/ServiceLogin' .
          '?service=adwords&hl=en_GB&ltmpl=jfk' .
          '&continue=https://adwords.google.com/um/gaiaauth?apt%3DNone%26ltmpl%3Djfk' .
          '&passive=86400&sacu=1&sarp=1';

my $username = 'NOMBRE-DE-USUARIO';
my $password = 'CONTRASEÑA';
my $mech = WWW::Mechanize::GZip->new();
$mech->agent( 'Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_4; en-us) ' .
              'AppleWebKit/533.17.8 (KHTML, like Gecko) Version/5.0.1 Safari/533.17.8' );
$mech->cookie_jar(HTTP::Cookies->new());
$mech->get($url);
$mech->form_id('gaia_loginform');
$mech->field("Email", $username);
$mech->field("Passwd", $password);
$mech->submit;

En la página de inicio de adwords, se incluye un token que necesitaremos más tarde para realizar la descarga del informe. También se encuentran en ella los valores de ‘effectiveUserId’ y ‘customerId’ (que son utilizados a menudo en forma de argumentos ‘__u’ y ‘__c’). Utilizando expresiones regulares es sencillo extraer estos valores.

my $output_page = $mech->content();

my $token = "";
my $customerId = "";
my $effectiveUserId = "";
if ($output_page =~ m/token:'([^']+)'/) {
    $token = $1; 
}   
if ($output_page =~ m/effectiveUserId:'([^']+)'/) {
    $effectiveUserId = $1; 
}   
if ($output_page =~ m/customerId:'([^']+)'/) {
    $customerId = $1; 
}

2. Descarga del informe resumen de presupuesto

Desde la página de inicio, la pestaña “Budget” permite acceder al informe resumen del presupuesto de los clientes gestionados por la cuenta MCM.

También hay un botón para realizar la descarga del informe en formato csv.

Analizando con Firebug los accesos que realiza el navegador cuando se pulsa el botón de descarga del informe, comprobamos que realiza una solicitud POST a la url: “https://adwords.google.com/mcm/file/ClientSummary”. En la solicitud se envía un parámetro “token”, cuyo valor es el que hemos obtenido previamente, y un parámetro “mcsSelector”, con un valor que representa el formato del informe a descargar.

De nuevo, utilizando Mechanize, es sencillo reproducir por programa este acceso:

    my $report_url = "https://adwords.google.com/mcm/file/ClientSummary";
    my $report;
    $report = $mech->post($report_url,
            [  'token' => $token,
              'mcsSelector' => '7|0|46|https://adwords.google.com/mcm/gwt/|D3843BD1D93572
6A9B903EB8AB9B8B64|com.google.ads.api.services.common.selector.Selector/3608467785|com.go
ogle.ads.api.services.common.date.DateRange/1118087507|com.google.ads.api.services.common
.date.Date/373224763|java.util.ArrayList/4159755760|java.lang.String/2004016611|ClientNam
e|ExternalCustomerId|PrimaryUserLogin|PrimaryCompanyName|IsManager|SalesChannel|Tier|Acco
untSettingTypes|Labels|CostWithCurrency|CostUsd|Clicks|Impressions|Ctr|Conversions|Conver
sionRate|BudgetAmount|BudgetStartDate|BudgetEndDate|BudgetPercentSpent|BudgetType|Remaini
ngBudget|ClientDateTimeZoneId|com.google.ads.api.services.common.selector.OrderBy/5243884
50|SearchableData|com.google.ads.api.services.common.sorting.SortOrder/2037387810|com.goo
gle.ads.api.services.common.pagination.Paging/363399854|com.google.ads.api.services.commo
n.selector.Predicate/451365360|SeedObfuscatedCustomerId|com.google.ads.api.services.commo
n.selector.Predicate$Operator/2293561107|java.util.Arrays$ArrayList/2507071751|[Ljava.lan
g.String;/2600011424|1222574392|ExcludeSeeds|true|ClientTraversal|DIRECT|com.google.ads.a
pi.services.common.selector.Summary/3224078220|included|1|2|3|4|5|2|10|2012|5|2|10|2012|6
|23|7|8|7|9|7|10|7|11|7|12|7|13|7|14|7|15|7|16|7|17|7|18|7|19|7|20|7|21|7|22|7|23|7|24|7|
25|7|26|7|27|7|28|7|29|7|30|6|0|0|0|6|2|31|32|33|0|31|9|-32|34|50|0|6|0|6|3|35|36|37|2|38
|39|1|40|35|41|37|0|38|39|1|42|35|43|-42|38|39|1|44|0|0|6|0|6|1|45|6|0|46|6|0|0|6|0|'
            ]);

my $data = $report->content();
from_to($data, 'UTF-16le', 'UTF-8');

Como podemos ver, en la última línea realizamos la conversión a “UTF-8″ desde el formato “UTF-16 little endian” con el que el servidor entrega los datos.

3. Proceso del informe

Ya sólo queda procesar el informe. Dado que está en formato TSV (Valores separados por tabuladores), tenemos en perl muchas maneras de procesarlo. Por ejemplo:

# Campos en el informe:
# Client Name | Company Name | Login | Customer ID | Labels | Budget |
# Start Date | End Date | Time Zone | % Spent | Remaining Budget | Amount Spent |
# Impr. | Clicks | Search CTR | Content CTR | Conversions | Conv. Rate
#
my %spend;
my @lines = split("\n",$data);
my $nlines = scalar(@lines);
for (my $iline = 0; $iline < $nlines; $iline++) {
    my @fields = split("\t",$lines[$iline]);
    my $nfields = scalar(@fields);
    if ($nfields == 18) {
       $spend{$fields[0]} = { "spent" => $fields[9] , "remaining" => $fields[10] };
    } else {
        print "Ignorando la línea: " . $lines[$iline] . "\n";
    }
}

# Imprimir los datos obtenidos
foreach my $account (keys %spend) {
    print "cuenta: " . $account . ", gastado: " . $spend{$account}{"spent"} .
          ", disponible: " . $spend{$account}{"remaining"} . "\n";
}

Referencias:

http://stackoverflow.com/questions/15071327/no-content-disposition-header-in-response-from-mechanize

—