Consejo rápido: Escribir código modular simple

Spanish (Español) translation by Steven (you can also view the original English article)

En mi último artículo, aprendimos una nueva forma de usar URL Bitly en WordPress. En la mayoría de estos casos, generalmente editamos nuestro archivo functions.php. Hoy aprenderemos un nuevo método sobre cómo podemos mantener nuestro archivo functions.php limpio y agradable utilizando un enfoque modular.

En este tutorial aprenderás cómo puedes crear un código modular muy simple. Será un código simple, y debido a que es modular, debes implementarlo manualmente. ¿Por qué usar código modular de todos modos? Básicamente, el código modular es una parte de los archivos de tu tema de WordPress que puedes instalar y desinstalar y puedes trabajar con muchos temas. Entonces, si cambias tu tema pero aún deseas tus funciones personalizadas con tu nuevo tema, este método será útil.

Motivación

Inicialmente, es probable que pienses: "¿por qué debería molestarme en hacer esto?" Y "¿qué bien hará?". Esto es lo que aleja a la mayoría de las personas de adoptar este enfoque modular, pero ten paciencia, los resultados se obtendrán en el futuro. Si desarrollas temas, es posible que ya conozcas este método, pero si estás comenzando, este truco te ayudará a ahorrar tiempo copiando y pegando funciones una y otra vez.

Ejemplo 1

Vamos a escribir una función simple y veremos cómo podemos incorporar este archivo en functions.php de nuestro tema

Paso 1.1

Entonces vamos a escribir una nueva función. Este código está en PHP, por lo que lo incluiremos de la forma en que lo hacemos habitualmente para una función PHP estándar.

<?php
// Register WordPress 3.0 Menus
add_action( 'init', 'register_my_menus' );
function register_my_menus() {
	register_nav_menus(
		array(
			'primary-menu' => __( 'Primary Menu' ),
			'secondary-menu' => __( 'Secondary Menu' )
		)
	);
}
?>

Como puedes ver, esta es solo una función estándar para registrar los menús. Copia el código anterior y pégalo en el editor de texto de tu elección y guárdalo como my-modular-code.php

Paso 1.2

Guarda este archivo junto con tus archivos de tema de WordPress, o puedes guardarlo en una subcarpeta si lo deseas. Sugeriría guardar este archivo en una subcarpeta, de modo que cuando cambies tu tema puedas copiar la carpeta con todas tus funciones personalizadas, lo que ayudará a la portabilidad.

Continúa y abre el archivo de funciones de tu tema, generalmente llamado functions.php, y pega esta línea de código justo después de la etiqueta PHP de apertura:

1	include_once('path/to/my-modular-code.php');

Esta línea de código accederá a tu archivo my-modular-code.php y ejecutará el código dentro cuando se ejecute este comando. Este truco ayuda a mantener tu archivo functions.php limpio y fácil de navegar.

Ejemplo 2

Hagamos un ejemplo similar. Supongamos que deseas agregar la funcionalidad de shortcode a tu blog. Para esto, generalmente tendemos a copiar todo el código en nuestro archivo functions.php, que no es necesariamente malo. Pero a medida que pasa el tiempo, tendrás un archivo de funciones desbordante. Entonces, para evitar eso, usaremos el mismo enfoque modular.

Paso 2.1

Copia el siguiente código, que es simple y directo, y guárdalo como my-shortcode.php en la misma subcarpeta que el archivo anterior.

function bold( $atts, $content = null )
{
	return '<span style="font-weight:bold;">'.$content.'</span>';
}
add_shortcode('bold', 'bold');

El código es muy simple y solo pondrá en negrita los caracteres cuando el texto esté encerrado dentro de las etiquetas [bold][/bold].

Paso 2.2 Llamar al archivo `my-shortcode.php` en `functions.php`

Ahora abre tu archivo functions.php y pega el mismo código que hicimos en nuestro primer ejemplo, solo reemplazando el nombre del archivo:

1	include_once('path/to/my-shortcode.php');

Cuando el archivo de la función alcanza esta línea de código, irá al archivo my-shortcode.php e incluirá todo el código que hay en él.

Conclusión

Como aprendimos anteriormente, este método ayuda a mantener nuestro archivo de funciones agradable y limpio. Aparte de eso, ayudará a la portabilidad al cambiar de tema. Podrías cambiar fácilmente tu tema sin buscar en tu antiguo archivo de funciones para encontrar tus shortcodes y fragmentos personalizados. ¡Esto ahorra mucho tiempo y evita dolores de cabeza! Recuerdo que cuando hice un tema para mi propio blog, el archivo de funciones alcanzó las 1500 líneas, y si quieres encontrar un pequeño código es casi seguro que terminarás cometiendo un error.

Esta es también una buena introducción para hacer un complemento. En otras palabras, esto es como el complemento más simple que podrías hacer. Esto te ayudará a comprender y escribir tus propios complementos en el futuro. Espero que hayas aumentado tu conocimiento. En el próximo tutorial usaremos el mismo enfoque modular y escribiremos un genial widget similar a Facebook.

Diviértete probando el código y avísanos si necesitas algún tipo de asistencia, solo deja tus comentarios a continuación e intentaremos ayudarte o solucionar tus problemas. ¡Gracias por leer!