Cómo agregar de forma segura código personalizado a los sitios web de WordPress

Los usuarios a menudo buscan formas de modificar sus sitios web, complementos y temas, o de agregar algunas modificaciones a una funcionalidad existente. En la mayoría de estos casos, puede hacerlo agregando un código personalizado a su sitio web de WordPress.

No hay nada de malo en agregar un código personalizado a su sitio web. Sin embargo, hay algunas cosas que debe tener en cuenta al realizar estos cambios en su sitio web de WordPress.

Este artículo destaca qué buscar y las mejores prácticas para agregar código personalizado a su sitio web de WordPress.

Qué buscar antes de agregar fragmentos de código personalizados en WordPress

La forma más fácil de agregar fragmentos de código que los autores sugieren en sus tutoriales es agregar el fragmento de código al archivo functions.php del tema. Sin embargo, hay una serie de restricciones y desventajas cuando agrega fragmentos de código al archivo functions.php del tema.

Cada vez que actualice su tema, los fragmentos de código personalizados que agregó a su archivo functions.php se sobrescribirán, a menos que actualice manualmente el tema o copie manualmente los fragmentos de código de un archivo functions.php a otro. Teniendo en cuenta que la mayoría de los desarrolladores lanzan actualizaciones con bastante frecuencia, especialmente cuando usan temas premium, agregar fragmentos de código al archivo functions.php del tema se vuelve muy difícil de mantener.

Además, si desea cambiar el tema, también debe migrar el código, lo que definitivamente no es bueno a largo plazo.

Otra desventaja es que los archivos del tema se ejecutan en cada página y al agregar los fragmentos de código al archivo functions.php del tema, los riesgos de romper todo su sitio web son mucho mayores.

Veamos las mejores prácticas sobre cómo agregar fragmentos de código personalizados a su sitio de WordPress, para que no tenga que volver a preocuparse por perder algún fragmento de código, olvidarse de migrarlo o romper una funcionalidad al actualizar su tema.

Agregar fragmentos de código personalizados a los sitios de WordPress

El código personalizado se puede agregar usando uno de los siguientes métodos:

• Usar un complemento (consulte nuestra introducción a los complementos de WordPress para obtener más información sobre qué son los complementos de WordPress)
• Creación de un complemento personalizado
• Crear un tema hijo

Ahora, analicemos cada uno de los métodos en detalle.

1. Usando el complemento de fragmentos de código

Los fragmentos de código ¹ El complemento es una excelente manera de agregar código personalizado al sitio de WordPress, y si no eres fanático de escribir código tú mismo, esta forma es más fácil que crear tu propio complemento.

Después de instalar el complemento, se agrega una nueva sección de Fragmentos a su menú de WordPress, que le permite agregar nuevos fragmentos. Cada fragmento tendrá espacio para el código y una descripción para obtener información adicional sobre lo que hace el código.

Sugerencia: si está utilizando un fragmento de código útil de un sitio, agregue la URL en la descripción, para que recuerde de dónde proviene el código.

Al igual que los complementos, puede habilitar y deshabilitar sus fragmentos de código personalizados, así como exportarlos a archivos PHP. En algunos casos, los fragmentos personalizados provocan conflictos con otros complementos o temas, por lo que es útil desactivar todo el código personalizado para solucionar problemas.

2. Crear su propio complemento específico del sitio

Crear su propio complemento personalizado específico del sitio es la mejor manera de agregar código personalizado a los sitios de WordPress, porque tiene el control total del código.

¿Qué es un complemento de WordPress específico del sitio?

Se utiliza un complemento de WordPress específico del sitio para agregar un código de personalización a un sitio web que no depende del tema. Esto significa que no importa qué tema use, o si cambia de tema, el código personalizado de su complemento siempre se ejecutará, por supuesto, siempre que el complemento esté activado.

¿Por qué es mejor crear un complemento de WordPress específico para el sitio?

Si agrega el código personalizado al archivo de funciones de su tema, desaparecerá si actualiza o cambia su tema.

Un complemento de WordPress específico del sitio le permite agregar fácilmente fragmentos de código personalizados a su sitio de WordPress y asegurarse de que sean independientes del tema. Es un complemento de WordPress independiente, lo que significa que no depende de su tema, lo que significa que puede actualizar o cambiar libremente su tema sin perder el código personalizado.

No necesita ser un gurú de PHP para crear un complemento de WordPress específico del sitio. Simplemente siga los sencillos pasos a continuación.

1. Crea el directorio de complementos

Primero, deberá crear un directorio para el complemento y nombrarlo. Puede ser cualquier nombre, como el sitio web del sitio. El directorio del complemento debe crearse en el directorio /wp-content/plugins/ de su sitio web. Para este ejemplo, estamos llamando al complemento wpwhitesecurity-shortcodes . Nota: utilice siempre guiones y no espacios en los nombres de los directorios.

2. Cree el archivo del complemento

A continuación, necesitará un archivo principal para su complemento. Aunque no hay reglas con respecto a cuál debe ser el nombre del archivo, la mejor práctica es que el nombre del archivo sea el mismo que el nombre del complemento. Entonces, en nuestro ejemplo, el nombre de archivo del complemento es wpwhitesecurity-shortcodes.php .

Este archivo debe incluir al menos un título y una descripción.

Cree este archivo con un editor de texto, como NotePad ++ o TextEdit. No use Microsoft Word o editores similares, ya que agrega datos de formato al texto y puede estropear su archivo. Todos los editores mencionados anteriormente son gratuitos.

Esto es todo lo que necesita agregar al archivo:

<?php
/*
* Plugin Name: WP White Security Shortcodes
* Plugin URL: https://www.wpwhitesecurity.com
* Description: Site-specific plugin for custom code snippets in wpwhitesecurity.com
*/

Eso es todo. Ahora es el momento de agregar el código personalizado.

3. Agregue los fragmentos de código personalizados

Ahora puede copiar y pegar fragmentos de código de tutoriales, etc. en este archivo. Si ha creado el archivo del complemento sin conexión, comprima la carpeta del complemento como un archivo .zip y cárguelo en su sitio web desde el panel de control de WordPress.

De ahora en adelante, no necesita preocuparse por perder algún fragmento de código, olvidarse de migrarlo o romper alguna funcionalidad al actualizar su tema o su WordPress. La próxima vez que encuentre un fragmento de código de WordPress y desee agregarlo a su sitio web, agréguelo al archivo de complemento específico del sitio.

4. Agregue un archivo index.php (opcional)

Este es un paso opcional. Para evitar la lista de directorios, debe agregar un archivo de índice en el directorio de complementos. Todo lo que necesitas hacer es:

Crea un archivo llamado index.php
Añádele el siguiente contenido:

<?php
/**
* Nothing to see here.

3. Usa funciones de tema infantil.php

Anteriormente, dijimos que no use el archivo functions.php de su tema. Sin embargo, esta es una buena alternativa para ciertos cambios, por ejemplo, para cambios específicos del tema. De esta manera, el código personalizado específico del tema estará disponible cuando esté tu tema, ya que ya no será necesario.

Sin embargo, los cambios de tema siempre deben agregarse al tema secundario, y no al principal, por lo que es seguro actualizarlo.

Si agrega código a su functions.php , siempre asegúrese de buscar las etiquetas PHP de cierre. Así es como se ven: ?> . Si su archivo de tema termina en uno de estos, debe colocar el código personalizado encima.

Conclusión

Como acabamos de ver, hay algunas formas diferentes de agregar código personalizado a su sitio web de WordPress, pero no todas son buenas a largo plazo. Sin embargo, algunos de ellos son mejores que otros en cosas específicas. Por ejemplo, para cambios específicos del tema (apariencia del sitio web), agregue un código personalizado al archivo functions.php . Para cualquier otro cambio, idealmente debe crear su complemento personalizado específico del sitio

Solo asegúrese de agregar código personalizado a WordPress de una manera que sea segura y que facilite la depuración si algo sale mal.
Esperamos que este artículo lo haya ayudado a aprender cómo agregar fácilmente fragmentos de código personalizados en sus sitios de WordPress.