Recursos

N�cleo

El n�cleo de WordPress es la base del CMS, que nos aporta la mayor parte de la
l�gica y las funcionalidades. No debemos modificarlo, ya que podr�amos causar un
funcionamiento inesperado. Adem�s, cualquier modificaci�n podr�a perderse al
instalar una nueva actualizaci�n.

Sin embargo, conviene acceder a �l para comprender su funcionamiento y con �l, la

forma en la que podemos modificarlo mediante nuestro propio c�digo en los temas y
plugins. Casi todo el c�digo est� comentado. Muchos archivos incluyen al inicio un
bloque de comentario aportando una descripci�n de lo que hacen y otra informaci�n
�til. Tambi�n la mayor�a de funciones cuenta con una descripci�n de lo que hacen,
as� como de los par�metros que esperan y que devuelven o la versi�n de Wordpress en
la que fueron incluidas.

Veamos un par de ejemplos de comentarios en diferentes archivos:

El Codex

La web es una wiki mantenida por la comunidad y traducida, al menos parcialmente, a

diversos idiomas. Sin embargo, hay que tener en cuenta que a veces la documentaci�n
no est� todo lo actualizada que debiera. Pese a eso, sigue siendo una referencia
ineludible a la hora de trabajar con WordPress.

Referencia a funciones

Como has visto al comienzo de este m�dulo, en esta p�gina podremos buscar
f�cilmente una funci�n y consultar su descripci�n, los par�metros, el valor
devuelto, el changelog y la propia definici�n de la funci�n. Esta es la misma
informaci�n que vemos en los archivos PHP, y no es casualidad.

Esta referencia est� construida a partir de la informaci�n del propio c�digo,

haciendo uso de PHPDoc, lo que nos asegura que est� siempre actualizada. En ese
sentido, ser� cuesti�n de comodidad acudir seg�n el caso a esta referencia o al
propio c�digo de los archivos.

Coding Standards

Con el objetivo de que WordPress siga siendo un CMS de c�digo legible y sencillo,
nacen los Coding Standards.

A continuaci�n, te mostramos algunos ejemplos de las reglas de PHP en WordPress:

Convenciones sobre nombres:

Los nombres de las variables se escriben en letras min�sculas.

Las clases comienzan las palabras en may�sculas.
Las constantes est�n escritas �ntegramente en may�sculas.
En los tres casos anteriores, las palabras se separan mediante guiones bajos
("snake_case").
En los nombres de archivo las palabras se separan con guiones medios.
Uso de espacios

Se deben usar espacios a ambos lados de los par�ntesis de los condicionales y

bucles.
En los lados interiores de los par�ntesis al definir y llamar a funciones.
A ambos lados de los comparadores.
Condiciones "Yoda"

En las comparaciones l�gicas se deben poner las variables en la parte izquierda y

las constantes, literales o funciones en el lado derecho. As�, por ejemplo, en caso
de que olvidemos un signo de igual (=) al ir a hacer una comparaci�n de igualdad
(==), se lanzar� un error en lugar de asignarse un valor de forma err�nea.