Personalizando la funcionalidad de WordPress con functions.php

Entonces, aquí estamos en la octava y última entrega de nuestra búsqueda para meternos en la piel de un sitio web de WordPress. Espero que ahora te sientas mucho más cómodo jugando con tus propios sitios. Una de las grandes cosas que he encontrado acerca de WordPress es el gran volumen de cosas que puedes hacer una vez que comienzas a familiarizarte con cómo encajan las cosas..

En el tutorial de hoy, abordaremos el último y misterioso archivo de nuestro tema que a menudo verás mencionado alrededor de las trampas; la que puede haber pegado fragmentos de código antes sin saber realmente por qué o por qué. Hoy estaremos jugando con la plantilla de funciones (funciones.php).

Para una discusión en profundidad sobre este misterioso documento, no puede ir más allá de lo que se discute en el Codex, pero en resumen, el archivo de Funciones es el medio por el cual podemos cambiar la funcionalidad predeterminada de algunos de nuestros sitios. Usando este archivo también podemos ampliar la funcionalidad del sitio. Es bastante poderoso, y hoy veremos algunas de las formas en que podemos usarlo para ampliar nuestro sitio web de prueba..


Antes que empecemos

Necesitarás:

  • Acceso FTP a su sitio.
  • Su software de edición de texto
  • Una imagen de favicon 32x32px guardada en formato .ico, llamada favicon.ico

Que vamos a hacer

  • Agregando el código de seguimiento de Google Analytics (puede usar un complemento para hacer esto, pero estamos usando esto como ejemplo)
  • Agregando un favicon a tu sitio

Antes de continuar, deberíamos cubrir un poco sobre cómo se comporta el archivo de funciones en el contexto de su tema secundario. Es un poco diferente a las otras plantillas con las que hemos estado trabajando.

En un tema secundario, en lugar de reemplazar la funcionalidad del archivo correspondiente en el tema principal como lo hicimos en nuestro último tutorial, el funciones.php Agrega o extiende la funcionalidad de los padres. No lo reemplaza, lo cual, si lo recuerda, es cómo se comportan las otras plantillas en un tema secundario..

Entonces, cuando se llama a nuestra página, y el servidor hace su magia al juntar todas las plantillas, busca las funciones en el tema secundario, las ejecuta, y luego mira a los padres y también ejecuta esas funciones..

En segundo lugar, el archivo de funciones también es un archivo PHP, y las funciones que estamos pegando / escribiendo incluirán el código PHP y, potencialmente, algún código HTML. ¡Así que nos están ayudando a mejorar nuestra credibilidad geek! (¡Alto cinco años todo el año!)

Vamos a entrar en eso.


Agregando el código de seguimiento de Google Analytics

Debería decir que desde el principio, no hay nada de malo en agregar un código analítico con un complemento. De hecho, la mayoría de los complementos que ofrecen esta funcionalidad (en lo esencial) no difieren mucho de este proceso, simplemente guardan el código en un archivo de complemento. Dicho esto, es una ilustración útil y no demasiado desafiante para los propósitos de este ejercicio. Entonces, echemos un vistazo.

1.Crear nuestro archivo de funciones

Paso 1. Abra su cliente FTP y navegue a su tema infantil directorio.

Paso 2. En la lista de archivos de su servidor remoto, haga clic derecho y seleccione Crear nuevo archivo.


Paso 3. Ingrese el nombre de su archivo de funciones como funciones.php y golpear DE ACUERDO.


Etapa 4. Abre tu nuevo funciones.php archivo en tu editor de texto.

Paso 5. En este punto, debemos configurar el archivo para que nuestro servidor lo reconozca como un archivo PHP. Así que agregue una etiqueta PHP de apertura, como esta , al comienzo de su archivo.


Paso 6. Ahora estamos listos para pegar algo de código en nuestro funciones.php.

Aquí está el código que pegaremos, y debajo de eso hay una explicación de lo que estamos viendo:

  

Ok vamos a descomponerlo.

// Insertando el código de Google Analytics al pie de página

En la línea 1 tenemos una oración que comienza con dos // marcas. Este es un comentario, que no hace nada programáticamente, y solo está ahí para la información de la persona que edita el archivo. Formatearlo con las marcas de barra es una forma rápida de comentar un linea sola de código PHP. Si estamos comentando un bloque completo que cruza más de una línea, usaríamos el habitual / * comenta aquí * / Marcas que también usamos en CSS. Es una buena práctica agregar comentarios como notas cuando esté programando para que pueda mantenerse al tanto de dónde está y lo que ha hecho..

add_action ('wp_footer', 'mytheme_add_googleanalytics');

En la línea 4 tenemos un código de aspecto ligeramente complicado que comienza con add_action.

add_action Es una función de PHP que conecta acciones con lugares en el código llamado ganchos. Podemos encontrar una gran cantidad de fragmentos de código en la web que son funciones de PHP para agregar o eliminar funcionalidades a diferentes enlaces en nuestro código. En este caso estamos usando esto. añadir acción para agregar el mytheme_add_google_analytics función a la wp_footer gancho.

función mytheme_add_googleanalytics () 

La línea 5 realmente define y abre el mytheme_add_google_analytics función:

y de la línea 7, que sigue, es la parte de trabajo pesado que es en realidad donde proporcionaremos la funcionalidad. Por el momento esto es solo un comentario HTML (<-- comment here -->), lo arreglaremos en breve.

Finalmente, en la Línea 9 cerramos la función con los corchetes (observe cómo tuvimos que reafirmar la etiqueta. Esto se debe a que el código que estamos pegando es, en efecto, HTML, y los dos idiomas funcionan en tándem en lugar de combinados. Entonces, tuvimos que cerrar la etiqueta PHP con el ?> después de la corchetes en la línea 5, luego pegue nuestro código (lo haremos en el siguiente paso) y luego volveremos a abrir la etiqueta PHP en la línea 8 antes de escribir más funciones en nuestro archivo.

 

Paso 7. Ahora es el momento de iniciar sesión en su cuenta de Google Analytics y obtener su código de inserción. Esperaré aquí mientras haces eso ...

...

Paso 8. Ahora ve y pégalo en la línea 7 sobre nuestro comentario HTML.


Paso 9. Ahora guarda tu archivo y cárgalo a tu servidor.

Debería poder inspeccionar el código de su página y ver el código que se encuentra felizmente en la parte inferior de su código fuente:



Agregue un Favicon a su sitio

¿Sabes lo que es un favicon, verdad? Si necesita una actualización, diríjase al Codex para obtener más información. Pero en resumen, es el pequeño icono que a menudo se ve mostrando un logotipo o imagen personalizada en las pestañas de su navegador, o cuando se guarda un enlace a su sitio como un marcador..

Paso 1. Crea tu favicon.ico en su software favorito de edición de imágenes.

Paso 2. Suba su favicon a su directorio de temas (el tema de su hijo) a través de FTP.

Paso 3. Pegue el siguiente código en su funciones.php expediente:

// Agregar un Favicon al sitio add_action ('wp_head', 'mytheme_add_favicon'); function mytheme_add_favicon () echo ''; 

Etapa 4. Guarda el archivo y vuelve a subirlo a tu servidor..

Habiendo descrito lo que está sucediendo en una función de WordPress anteriormente, debería encontrar bastante sencillo entender qué está pasando en la siguiente función. Primero, echemos un vistazo al código ...

Para empezar, en la línea 4 podemos ver que estamos creando otra. add_action función. El gancho en el que estamos poniendo nuestro código es wp_head (así, al contrario del enlace anterior, estamos agregando esto al encabezado de nuestro sitio, en lugar del pie de página) y el nombre de nuestra función es mytheme_add_favicon.

Una nota sobre las funciones de nombres:

Es posible que haya notado que en ambos casos he nombrado las funciones al comenzar con nuestro nombre de tema personalizado mi tema_ y terminando con una descripción de lo que hace nuestra función, por ejemplo,. add_favicon. La razón detrás de esto es doble:

  1. Hace que sea fácil ver de un vistazo lo que se supone que nuestro código debe lograr, y ...
  2. Elimina el riesgo de usar nombres de funciones que ya existen en nuestro tema principal o en WordPress, y por lo tanto reduce el riesgo de que nuestro tema rompa cosas.

De todos modos, asumiendo que tienes un favicon.ico archivo en su directorio de temas, el código anterior debería funcionar fuera de la caja, pero a modo de explicación:

  1. En la línea 8 le decimos a nuestro tema que inserte una cadena de HTML en el cabeza de nuestro sitio web. Esto le indica al navegador dónde encontrar el favicon.ico.
  2. El poco de PHP en esa cadena (get_stylesheet_directory_uri () inserta la ruta a nuestro archivo en el directorio de temas.

Suponiendo que todo el código es correcto y que el archivo está en el directorio de temas, el navegador, a su vez, mostrará este ícono de nuestro sitio en la esquina de nuestras pestañas y en otros lugares similares donde se suele ver un icono.


Es posible que haya notado que en este ejemplo no tuvimos que cerrar y volver a abrir el PHP Etiquetas como hicimos en los pasos 7 y 8 del ejemplo anterior. Esto se debe a que en este segundo ejemplo, el código que hemos usado es PHP de punta a punta, y aunque incluye bits de HTML, no es HTML independiente porque hay una parte de compilación de PHP de la cadena de URL. A medida que se familiarice con funciones como esta, y cuando aprenda a construir funciones usted mismo, obtendrá una idea más clara de la diferencia, pero este pensamiento solo sirve para hacerle saber que el código es correcto, en caso de que desee agregar en y / o ?> etiquetas en este ejemplo alrededor de los corchetes también!


Conclusión

Una vez que empieces a entender el poder del funciones.php El archivo será imparable, es el medio para hacer todo tipo de cosas y agregar algunas funciones excelentes y poderosas a su sitio. Así que la próxima vez que sea necesario agregar un tutorial que estés siguiendo o un fragmento de código que hayas encontrado en tu funciones.php Ahora debe poder agregar y tomar control de todas las áreas de su sitio con confianza.!

¡Recuerda! Antes de realizar nuevos cambios en su archivo, para guardar una copia en su escritorio y guardarlos antes de cargar nuevos cambios. Obtener el código incorrecto en funciones.php puede causar problemas, por lo que tener una versión de trabajo guardada en su escritorio significa que si las cosas van mal, simplemente puede cargar su archivo de seguridad y comenzar de nuevo.