PDF de programación - WordPress: Introducción al Desarrollo de Plugins

Tabla de contenido

Acerca de este libro
Parte 1: Introducción

A quién está dirigido este libro
Presentación y objetivos de este libro
Qué es un plugin y para qué sirve
Cómo crear un plugin básico

Parte 2: Plugin API

Programación orientada a eventos
Acciones
Filtros
Uso de clases y objetos en eventos
Remover eventos del registro

Parte 3: Personalización de contenidos
Internacionalización y localización
Post Types predefinidos
Custom Fields y Meta Boxes
Custom Post Types
Taxonomías

Parte 4: Personalización de opciones

Menús de administración
Options API
Settings API

Parte 5: Prácticas recomendadas

Estilos y scripts en menús de administración
Pluggable functions
By-Passing
Must-Use Plugins
Recomendaciones finales

1.1
1.2
1.2.1
1.2.2
1.2.3
1.2.4
1.3
1.3.1
1.3.2
1.3.3
1.3.4
1.3.5
1.4
1.4.1
1.4.2
1.4.3
1.4.4
1.4.5
1.5
1.5.1
1.5.2
1.5.3
1.6
1.6.1
1.6.2
1.6.3
1.6.4
1.6.5

2

3

Acerca de este libro

WordPress: Introducción al Desarrollo de
Plugins

Por Andrés Villarreal

Este libro presenta una serie de herramientas básicas para la construcción de plugins
propios para WordPress, combinadas con sugerencias acerca de optimización y buenas
prácticas de desarrollo. Consiste en capítulos cortos que intentan explicar de la manera más
directa posible un conjunto de conceptos importantes a la hora de desarrollar plugins.

Los contenidos presentados están destinados a un perfil bastante específico:
desarrolladores web con experiencia en WordPress, con conocimientos de instalación y
configuración de la plataforma (incluyendo plugins y themes), nociones fuertes de HTML y
CSS, y nociones al menos básicas de PHP y programación en general. Como punto de
partida se asume que el lector ha desarrollado previamente sitios web con WordPress, ya
sea para clientes o proyectos personales.

Si bien el libro apunta a desarrolladores con poca experiencia en las partes más técnicas de
WordPress, está estructurado y pensado para que programadores más experimentados
también puedan utilizar sus contenidos como punto de referencia para sus propios
desarrollos.

Propósito

Existen muchos libros acerca de desarrollo de plugins para WordPress, varios de ellos
excelentes. Sin embargo, aquellos que considero buenos fueron escritos en inglés. Muy
pocos se tradujeron al español, e inicialmente no estuvieron pensados para el público de
habla hispana. Salvo por unas pocas fuentes confiables, se cuenta con muy poco material
de consulta en español dedicado a WordPress, y solo una parte ínfima consiste en material
técnico. Con eso en mente, el presente libro es al menos un intento inicial de resolver ese
problema.

Estado actual: Beta

El libro está en etapa de revisión. Los ejemplos de código son 100% funcionales, aunque
pueden ser modificados en el futuro para una mejor comprensión. Tengo planeado agregar
imágenes ilustrativas para algunos conceptos, y realizar algunas modificaciones de estilo
para facilitar la lectura.

4

Acerca de este libro

Licencias

Los contenidos textuales de este libro están publicados bajo la licencia BY-NC-ND 4.0 de
Creative Commons, la cual indica que no pueden ser reproducidos sin autorización expresa
del autor, ni utilizados con fines comerciales. Tampoco se permite la redistribución de
trabajos derivados del original.

Los ejemplos de código PHP, JavaScript, HTML y CSS presentados se publican bajo la
licencia GPL2, por lo cual pueden ser reutilizados, redistribuidos y modificados libremente,
cualquiera sea su fin.

5

Parte 1: Introducción

Parte 1: Introducción

Contenidos:

A quién está dirigido este libro
Presentación y objetivos de este libro
Qué es un plugin y para qué sirve
Cómo crear un plugin básico

6

A quién está dirigido este libro

A quién está dirigido este libro

Los contenidos de este libro están destinados a un perfil bastante específico:
desarrolladores web con experiencia en WordPress, con conocimientos de instalación y
configuración de la plataforma (incluyendo themes y plugins), nociones fuertes de HTML y
CSS, y nociones al menos básicas de PHP y programación en general.

Se presupone que el lector ya trabajó con WordPress para la creación de sitios web
destinados a clientes o para fines personales, y que es capaz de investigar por su cuenta
acerca de los conceptos estudiados en el libro, los cuales de ninguna manera se presentan
como una manera definitiva de desarrollar plugins, sino como introductorios a un gran
número de diferentes posibilidades.

Por otra parte, si bien no es el foco principal, este libro también está pensado y estructurado
de forma tal que programadores más experimentados puedan utilizar los contenidos
presentados como punto de referencia para sus propios desarrollos.

7

Presentación y objetivos de este libro

Presentación y objetivos de este libro

Al trabajar con WordPress es posible buscar un plugin tanto a través de nuestro propio sitio
como desde el directorio oficial, entre varias otras opciones. Dependiendo de cómo lo
hayamos encontrado, un plugin puede instalarse desde la sección de administración de
WordPress, o descomprimiendo un archivo zip (o similar) dentro del directorio wp-
content/plugins . Sin embargo, con solo instalar plugins no necesariamente podemos saber
cómo estos funcionan internamente, cómo se construyen, cómo llegan a hacer lo que
hacen. Por esa razón, en este libro vamos a sumergirnos en lo que es el funcionamiento y
la arquitectura de un plugin desde un punto de vista técnico, trabajando directamente sobre
código y estudiando las herramientas que ofrece WordPress para construir nuestras propias
extensiones.

A grandes rasgos, la definición más sencilla que se puede dar de un plugin es que sirve
para agregar funcionalidad adicional a una instalación de WordPress, algo que no está
disponible a partir del momento en el que WordPress se instala. Es común encontrarnos
con un requisito que no se puede cumplir con los plugins disponibles en algún directorio, y
vernos obligados a hacerlo nosotros mismos, o pedirle a un programador que lo haga.
Debido a esto, si estamos interesados en profesionalizar nuestro trabajo con WordPress,
necesitamos tener ciertas nociones básicas acerca de cómo se constituye un plugin.

Como diferentes plugins suelen responder a diferentes necesidades, no se usan
exactamente las mismas herramientas para construir cada uno, sino que muchas de ellas
van a variar de un plugin a otro. Sin embargo, podría decirse que hay un núcleo de
herramientas que van a ser usadas en una cantidad enorme de plugins, y en este libro
vamos a detenernos principalmente en ellas.

Las más importantes de estas herramientas van a ser las diferentes APIs que WordPress
nos ofrece para extender su funcionalidad básica. La API predominante para desarrollo de
plugins es la Plugin API, y también vamos a revisar otras muy importantes como la

8

Presentación y objetivos de este libro

Options API y la Settings API.

Como vamos a estar trabajando continuamente con código, algo que va a ser necesario
para poder seguir eficientemente los contenidos de este libro es contar con un conocimiento
al menos básico de PHP. Un excelente punto de partida para quienes necesiten aprender
acerca del lenguaje o reforzar sus conocimientos es el curso interactivo de PHP de
Codecademy. También es conveniente tener cerca la documentación oficial de PHP.

Durante el transcurso de varios capítulos, además, vamos a revisar ciertas prácticas de
optimización de código, y a estudiar diferentes métodos para que nuestros plugins sean
extensibles, es decir dejarlos listos para que otros desarrolladores puedan seguir
construyendo sus propias extensiones a partir de nuestro código.

9

Qué es un plugin y para qué sirve

Qué es un plugin y para qué sirve

En un sentido conceptual, podríamos decir que todo sitio o aplicación web se divide en tres
partes: contenido, presentación y funcionalidad. El contenido es aquella información
variable que nuestro sitio o aplicación le muestra al usuario final, y que alguien con los
permisos adecuados puede agregar, modificar o eliminar. En la mayoría de las aplicaciones
modernas es provisto de manera externa por un usuario, sin necesidad de modificar de
manera manual los archivos que constituyen a la aplicación, y normalmente queda
guardado en algún tipo de base de datos. La presentación es la forma en la que esa
información se le muestra al usuario, y tiene que ver con la implementación de algún tipo
de diseño gráfico sobre una interfaz; es básicamente cómo se ve nuestro proyecto. La
funcionalidad tiene que ver con todos los procesos internos que manejan el
contenido (por ejemplo la carga, edición y eliminación) y lo dejan preparado para ser
presentado al usuario.

WordPress, como todo CMS (por Content Management System) o sistema de gestión de
contenidos, se encarga por su cuenta de gran parte de las cuestiones técnicas relacionadas
con la manipulación de información. Sin embargo, muchas veces vamos a encontrarnos con
que necesitamos poder manejar algún tipo de información que no está disponible desde la
instalación, o que se ejecuten ciertos procesos internos invisibles al usuario, o que
necesitamos mostrar algo de una manera que no estaba prevista por las opciones de
presentación que tenemos a nuestro alcance. Ese es el momento en el cual entran en
acción los plugins y themes.

Lo que se dice más típicamente en el ámbito de los desarrolladores que trabajan con
WordPress es que, mientras los themes están pensados para manejar cuestiones de
presentación, los plugins apuntan exclusivamente a agregar nueva funcionalidad. Sin
embargo, en este libro vamos a ser un poco más específicos acerca de estas definiciones, y
a decir que eso no siempre es tan así. Eso pasa porque la funcionalidad y la
presentación no siempre son dos conceptos inseparables, sino que a veces están muy
entrelazados. Y si bien siempre es una excelente práctica intentar separarlos cuanto sea
posible, a veces se presentan algunas situaciones problemáticas en las que es complicado