Una guía para principiantes de Titan Framework cómo crear un Metabox con Titan

Titan Framework realmente ha aliviado la tediosa tarea de crear metaboxes en su proyecto de desarrollo web. Antes de Titan Framework, tuve que escribir un fragmento de código muy largo para mostrar metaboxes dentro de las pantallas de publicación y / o edición de páginas. Ahora hace que el proceso sea realmente fácil, y eso es lo que voy a discutir hoy. Entonces, aprendamos a crear un metabox con Titan Framework.

Creando un Metabox en Titán

Antes de profundizar en este tema, supongamos que tiene:

  • un sitio web de demostración de trabajo con WordPress instalado 
  • El complemento de Titan Framework instalado y activado o integrado en este sitio web de demostración 
  • la titan-framework-checker.php archivo incluido en tu proyecto

Una vez más me refiero a mi tema llamado Neat para el código que usaré aquí. En artículos anteriores, expliqué que los archivos de plantilla del tema se han organizado de tal manera que hay una carpeta separada para cosas relacionadas con la administración dentro de la bienes carpeta. Esto contiene además un archivo para el código de metaboxes, es decir,. metabox-options-init.php, que se encuentra aquí: activos / admin /trabajo de titanio/metabox-options-init.php.

Entonces, aquí está el código que agregará un metabox en las pantallas de edición de todos los tipos de publicaciones que mencionamos, que fueron:

  • página
  • enviar
  • my_custom_post_type, que se supone que es el nombre de cualquier tipo de mensaje personalizado
createMetaBox (array ('name' => 'Metabox Options', // Nombra el menú de opciones. 'post_type' => array ('page', 'post', 'my_custom_post_type') // Puede ser una cadena o un array.) ); 

Justo al principio hay algunas líneas comentadas que le brindan algunos de los enlaces de ayuda que puede utilizar en relación con el desarrollo de metaboxes. Debajo hay un add_action () función que asume la tf_create_options gancho que registra el aa_metabox_options Función para añadir opciones dentro del metabox..

Siguiente (línea 14) He definido una función para envolver nuestro código metabox, es decir,. aa_metabox_options. Esto contiene toda la funcionalidad necesaria para crear nuestro metabox.. 

El proceso comienza al obtener una instancia única de Titan Framework y registrarla en el $ titan variable (en la línea 17). Llamando a la obtener Instancia() La función es una parte integral de Titan y se necesita en cada nueva rutina o archivo en el que utilice Titan Framework. Esta función lleva un parámetro único, idealmente el nombre de su tema para inicializar Titan en su proyecto. Es por eso que he usado 'ordenado' como mi nombre único. Lo he explicado en detalle en un artículo anterior también.

La línea 23 de este código es donde creé el metabox. Con Titan Framework, puedes usar el crearMetaBox () Función para agregar metaboxes en tus temas / plugins. Entonces, de acuerdo con esta línea de código estoy creando un $ aa_metbox metabox en Titan Framework.

Note otra cosa: la crearMetaBox () La función obtiene una serie de parámetros que pueden tomar parámetros como nombre, desc, tipo de mensaje, Entonces, haciendo uso de estos, he llamado a este metabox 'Opciones de Metabox'(línea 24). Por lo tanto, aparecerá con este nombre en mi página y en la pantalla de edición posterior..

La última línea (línea 25) de este código adjunta este metabox recién creado a todos los tipos de publicaciones que menciono. tipo de mensaje es nuevamente un parámetro que especifica en qué tipo de publicación (s) se mostrará este metabox. En el caso de mi código, lo estoy mostrando en todas las páginas y publicaciones, y en my_custom_post_type. También tenga en cuenta que este parámetro ocupa una matriz si necesita usar el metabox en varios tipos de publicaciones. Pero también puede ser una cadena para cuando necesite usar el metabox solo para un tipo de publicación, por ejemplo. 'post_type' => 'página'.

Ahora ve a tu panel de WordPress y haz clic Agregar nuevo menú en Mensajes. Desplázate hacia abajo y encontrarás un metabox llamado Opciones de Metabox. Aquí está la captura de pantalla para ello:

Haga lo mismo para cualquier página o tipo de publicación personalizada de su sitio web, y también encontrará el mismo metabox allí..

Este metabox está vacío en este momento. Entonces, vamos a agregar opciones en ella.

Agregar opciones dentro de un Metabox

Simplemente copie y pegue estas líneas justo debajo del código escrito arriba.  

createOption (array ('id' => 'aa_mb_txt', // El id que se usará para obtener el valor de esta opción. 'type' => 'text', // Tipo de opción que estamos creando. 'name' => 'Mi opción de texto', // Nombre de la opción que se mostrará en el panel de administración. 'Desc' => 'Esta es nuestra opción' // Descripción de la opción que se mostrará en el panel de administración.) ); 

Crear opciones en Titán no es algo nuevo para ti. Una vez más he usado el createOption () Función para añadir opciones. Pero lo que debe tener en cuenta es la línea 9, que también especifica dónde crear esta opción, es decir, dentro de $ aa_metbox. Entonces, he creado un texto escribe el campo dentro del metabox llamado 'Mi opción de texto'cuyo ID es aa_mb_txt

La captura de pantalla anterior es el resultado de mi desarrollo hasta ahora. Pero esta vez, es de una página. Usted puede encontrar claramente el Opciones de Metabox caja que tiene una Mi opción de texto campo en el.

Entonces, ¿qué queda? Imprimiendo la salida en el front-end después de recuperar el valor. Hagamos eso ahora!

Obtención de los valores guardados

Ahora, recuperaré los valores guardados en el extremo delantero de la página en la captura de pantalla anterior. Aqui tienes:

getOption ('aa_mb_txt', get_the_ID ()); / ** * Primera opción de metabox. * / // Vamos a utilizar este valor en HTML. ?> 

El valor de la opción metabox txt para esta página es:

Aquí el getOption () La función (línea 10) lleva dos parámetros. Uno es el ID único de la opción, es decir,. aa_mb_txt, y el segundo es el get_the_ID_ () función. he usado get_the_ID () porque el metabox fue creado para todos los tipos de publicaciones que definimos. Si necesita obtener el valor de una opción metabox para una página / publicación específica, entonces le dará la getOptions () funciona el ID de esa publicación / página específica. El resultado se guarda en. $ aa_mb_txt_val.

A continuación se crea un párrafo (línea 19) dentro del cual he usado el eco comando para imprimir la salida a través de aa_mb_txt_val

Supongamos que entré Opción de texto AA En el metabox ya publicamos la página..

Y listo, todo funciona a la perfección..

Conclusión

Ahora ya sabes cómo crear meta boxes con Titan Framework. Te das cuenta de lo simple que es. En los próximos artículos de esta serie, escribiré sobre cómo crear un tipo de opción particular con Titan Framework en una caja meta. Ahí asumiré el hecho de que ya sabe cómo crear la meta box en sí. Por lo tanto, es vital para usted probar esto.

En el siguiente artículo, crearé secciones de personalizador de temas y paneles con opciones. ¿Qué tan bueno es eso? Hasta entonces, si tiene alguna pregunta, hágamelo saber a través de comentarios o comuníquese conmigo en Twitter..