Utilizando códigos cortos de WordPress y campos personalizados para las notas al pie

En términos de diseño y desarrollo web, las cosas que puedes hacer con WordPress son casi ilimitadas. Puede ejecutar un agregador de noticias, crear una plataforma de crowdfunding, vender entradas para el primer concierto de su banda, mostrar su arte en una galería virtual, etc..

También puede hacer un clon de Wikipedia e imitar sus características como una sección de "tabla de contenidos" o referencias cruzadas vinculadas. En este tutorial, usaremos códigos cortos y campos personalizados para crear una sección de "Notas al pie" que funcione..

Introducción de notas al pie

Me contactó un profesor universitario que quería publicar algunos de sus artículos en línea. Tenia este pequeño … Edu.tr/~hisname/ página de inicio y decidió que era hora de mover el contenido a un sitio web "real" y escuchó que WordPress sería la opción correcta para usar como sistema de administración de contenido.

Como saben, los artículos científicos pueden incluir muchos comentarios, citas y referencias externas a las que generalmente nos referimos como notas al pie de página. Cuando dijo que quería que sus artículos fueran más interactivos, inmediatamente pensé en una funcionalidad similar en Wikipedia y comencé a buscar complementos que ofrecieran este tipo de servicio.. 

Aunque encontré uno, entre muchos, pensé que sería un buen ejercicio si intentara crear mi propio complemento para agregar notas al pie. Con ese fin, hice exactamente eso y recorreré el proceso durante el resto de este artículo..

Construyendo nuestro complemento de notas al pie

El proceso de creación de nuestro complemento será relativamente fácil, incluso para los desarrolladores principiantes. Lo haremos:

  • crear nuestro archivo de plugin
  • construye nuestro shortcode,
  • codificar nuestra función de pie de página
  • escriba otra función que agregue las notas al pie de página al contenido de la publicación al engancharlas a el contenido.

Pedazo de pastel, a la derecha? 

Si usted es un principiante y está ansioso por aprender los conceptos básicos del desarrollo de complementos de WordPress, este tutorial tiene la cantidad justa de información para comenzar. Y si estás un poco más avanzado, este tutorial podría darte buenas ideas..

1. Crear el archivo de complemento

Si está familiarizado con los complementos (como en la creación de uno o incluso viendo el código fuente de uno), sabrá que debemos iniciar los archivos principales de nuestro complemento con la siguiente información de encabezado:

Todas las líneas se explican por sí mismas, por lo que no entraré en detalles al decirles que la versión representa el número de versión de su complemento.. 

Aunque, hay algunos consejos que puedo dar:

  • La única línea requerida es la línea "Nombre del complemento"; El resto es opcional (pero muy útil)..
  • Puede usar un código HTML simple en la línea "Descripción".
  • Hay otros "nombres de encabezado" que puede encontrar en la página "Encabezado de archivo" en el Codex.

Ahora que hemos terminado con los encabezados, sigamos con el paso donde construimos nuestro shortcode!

2. Crea el Shortcode

Si lees mis tutoriales más antiguos, recordarás que amor la API de código corto. Como tal, esta es mi parte favorita..

Como se indicó anteriormente, el propósito de nuestro código abreviado será mostrar el número de nuestra nota al pie, que puede especificar como parámetro. Ya que son solo unas pocas líneas de código simples, escribamos el código ahora y revisemos justo después:

 '1',), $ atts)); regreso '['. $ id. ']';  add_shortcode ('ref', 'footnotes_sc'); ?>

Como puedes ver, el código es realmente muy simple. Esto es lo que hace:

  • Creamos una función llamada pie de página_sc,
  • Creamos un solo parámetro llamado carné de identidad (con un valor predeterminado de "1") y lo convirtió en una variable con el extraer() función,
  • Nosotros regreso Una cadena simple con un enlace a la nota al pie correspondiente.,
  • Y finalmente, establecemos un shortcode llamado [árbitro] y enganchamos nuestro footnotes_sc () funcionarlo.

De ahora en adelante; cada vez que usamos el [árbitro] código corto (donde X es el ID de la nota al pie), WordPress imprimirá el número de referencia como [1].

3. Creando la función de nota al pie

Para hacer notas a pie de página, necesitamos utilizar los "campos personalizados" de WordPress. La siguiente función no es el "código avanzado", pero como es un poco largo, también podríamos documentarlo paso a paso. Aquí vamos:

 $ get_post_meta);  // si $ footnotes_array NO está vacío ... if (count ($ footnotes_array)> 0) //… inicia la variable $ output con un DIV ... $ output = '
'; // ... usar los valores predeterminados de los argumentos de nuestra función $ output. = '<' . $titletag . '>'. $ título. ''; $ salida. = '<' . $listtag . '>'; // haga una lista de las notas al pie con los identificadores de referencia correspondientes para cada ($ $ notas al pie como $ pie) para cada ($ pie como $ ref_id => $ pie de nota_contenido) $ output. = '
  • '. $ pie de nota_contenido. '
  • '; // cierra las etiquetas HTML $ output. = ''; $ salida. = '
    '; // y devuelve la variable $ output si es una sola publicación o página si (is_singular ()) return $ output;

    En breve; guardamos nuestro meta meta en una matriz, llenamos el $ salida variable al convertir las notas al pie en una lista HTML, y devuelto $ salida. Fácil como un pastel.

    Usando nuestro plugin de notas al pie

    Usar el complemento es bastante simple: si agrega campos personalizados nombrados ref-1, ref-2, ref-3 y así sucesivamente, aparecerá una sección de "Notas al pie" justo después de su artículo. Y ya cubrimos cómo usar el código corto, así que eso es todo lo que tienes que hacer.

    Terminando

    Ahora que tenemos una función que devuelve una lista HTML de las notas al pie, es hora de agregar esa lista en nuestros artículos.!

     

    Esta es probablemente la parte más fácil de nuestro código, ya que solo llamamos a nuestra función anterior para agregar su salida después del contenido de la publicación, luego conectamos esta nueva función a la el contenido filtrar.

    Si no desea agregar automáticamente la sección "Notas al pie" debajo del contenido, siga adelante y elimine estas líneas. En su lugar, tendrás que usar un poquito de código en tu tema como en el lugar que desee mostrar las notas al pie del artículo. También puedes cambiar los argumentos por defecto de la función..

    Conclusión

    En última instancia, al profesor realmente le gustó lo que hice con la funcionalidad de "notas al pie" y creo que todavía usa el sitio web que construí; usó su página de inicio durante más de 10 años y probablemente usará WordPress por más tiempo. Espero que también te haya gustado. Si quieres acceder al código completo, puedes encontrarlo aquí..

    ¿Tienes algo que añadir? Por favor comparta sus pensamientos con nosotros comentando a continuación. Y si te gustó este tutorial, no olvides compartirlo con tus amigos.!