El core (I) Documentacion y funciones
Para comenzar a tocar WordPress es necesario conocer su estructura, saber como esta hecho, de que se compone y por donde podemos o no podemos andar sin riesgo…
El núcleo de WordPress esta formado por todos aquellos archivos (en esencia PHP), que se encargan de generar páginas de contenido, cargar plugins y temas, las opciones y parámetros necesarios para le web… encontrándose diferentes tipos de funciones.
- Entradas, páginas y contenido personalizado
- Metadatos
- Temas
- Acciones, filtros y plugins
- Usuarios y autores
- …
Los archivos del núcleo estan comentados introduciendo información sobre su funcionamiento tanto en general como en sus funciones, por ejemplo aquí se puede ver como es la documentación inicial de nuestro archivo wp-config:
/** * Configuración básica de WordPress. * * Este archivo contiene las siguientes configuraciones: ajustes de MySQL, prefijo de tablas, * claves secretas, idioma de WordPress y ABSPATH. Para obtener más información, * visita la página del Codex{@link http://codex.wordpress.org/Editing_wp-config.php Editing * wp-config.php} . Los ajustes de MySQL te los proporcionará tu proveedor de alojamiento web. * * This file is used by the wp-config.php creation script during the * installation. You don't have to use the web site, you can just copy this file * to "wp-config.php" and fill in the values. * * @package WordPress */
Esta documentación es realmente útil para entender como funciona el archivo y la función, diciéndonos los parámetros que necesita, una descripción, los valores que devuelve…, además introduce alguna información adicional como desde que versión esta esa función en uso.
En la siguiente lista se exponen algunos archivos del núcleo (todos en el directorio wp-includes) que contienen elementos de gran importancia para trabajar con WP.
- Functions.php: Contiene las principales funcionalidades de WP creando un metodo estandarizado y funciona tanto para plugins, como temas o el núcleo.
- Option.php: Contiene funciones de la API de php que se utilizan para opciones de creacion, publicación, eliminación… en una fecha dada.
- Formatting.php: Contiene las funciones de formato de la API, por ejemplo comprueba la validez de los correos electrónicos
- Pluggable.php: Permite reemplazar funcionalidades de wordpress, cargándose solo una vez se han leído todos los plugins y siguen sin estar definidas.
- Plugin.php: Contiene todas las funciones necesarias para que funcionen los plugins, desde su conexion, a la lectura de directorios, URLs…
- User.php: Contiene todas las funciones referentes a los usuarios de la API de WP, como por ejemplo, crear, eliminar, obtener, comprobar mails…
- Post.php: Contiene las funciones de postprocesamiento de una entrada, desde su publicación, metadatos, imagen thumbnail (imagen mostrada en la entrada)…
- Taxonomy.php: En su interior se encuentran las funciones que controlan la taxonomia de WP, desde categorias, etiquetas…
Naturalmente existen muchos otros archivos dentro del núcleo de WP, cada una con su documentación y su forma de trabajar, de modo que no es malo el ir viendo como funcionan y utilizar un tiempo en ello.
Funciones obsoletas
Al desarrollarse una nueva versión de WP, se suelen descartar algunas funciones.
Las funciones descartadas no se eliminan (al menos de momento), pero tampoco es recomendable que se sigan utilizando en plugins o temas ya que es bastante certero que haya alguna otra función que ahora realice su trabajo. Estos descartes no son aleatorios, si no que tienen una finalidad, que puede ser de seguridad, optimización…
Existe el archivo deprecated.php donde se encuentran todas estas funciones, y debe de ser tenido muy en cuenta a la hora de desarrollar, ya que en el podemos observar si una función esta descartada y desde que versión dentro de su documentación.
Por ejemplo, observemos la siguiente documentación de la función, next_post()
/** * Prints link to the next post. * * @since 0.71 * @deprecated 2.0.0 * @deprecated Use next_post_link() * @see next_post_link() * * @param string $format * @param string $next * @param string $title * @param string $in_same_cat * @param int $limitnext * @param string $excluded_categories */
En ella vemos que fue utilizada desde la version 0.71 hasta la 2.0.0 y que actualmente se debe de utilizar la función next_post_link()
Bueno de momento es todo, en la próxima entrada hablaremos del codex de WP y las razones de por que no se debe de modificar el núcleo de WP, que por hoy ya se ha hecho muy larga la entrada.