Este es el tercer artículo de la serie y hasta ahora, he discutido la importancia y las características de Titan Framework junto con la configuración básica. En el primer artículo, hablé de la configuración en tres pasos de Titan Framework, que es la siguiente: 

1. Configura tu proyecto.
2. Crear opciones.
3. Obtener valores.

Le expliqué el primer paso del artículo anterior, en el que aprendimos que Titan Framework es un marco plug and play, es decir, se trata de un complemento, aunque también puede integrarse incrustándolo en su proyecto de desarrollo web. Entonces, continuemos desde donde lo dejé y continuemos con los siguientes dos pasos.

Aquí, explicaré cómo y en qué capacidad trabaja Titan Framework en su proyecto de desarrollo web. Entonces saltaré al concepto de crear. Instancias y Opciones de donde saldré el salvado Valores en la parte delantera. Vamos a empezar! 

1. Configura tu proyecto

En primer lugar, averigüemos qué necesitará para implementar el tutorial de hoy. Vamos a crear un tema simple de WordPress con el que usaremos Titan Framework para explorar el conjunto de opciones que puede crear. Necesitarás:

1. Configuración de WordPress local, por ejemplo Yo uso DesktopServer (créeme, es increíble!).
2. Un tema básico de WordPress: voy a usar Neat para ese propósito. He creado una nueva rama llamada Neat: TitanFramework para este tutorial.

Mi configuración

Como voy a utilizar el tema de Neat WordPress, es importante que explique primero su estructura. Abra la carpeta de temas en su editor de texto donde se encuentra dentro del bienes directorio he creado una nueva carpeta llamada administración. Su propósito es manejar todo el código relevante para las opciones de administración. Dentro hay otro directorio., trabajo de titanio,y un archivo PHP, admin-init.php.

admin-init.php Expediente

Este archivo PHP manejará toda la actividad relacionada con la administración. Si recorres su código, descubrirás que he usado el get_template_directory () función para incluir cuatro archivos de la trabajo de titanio directorio. El siguiente código es bastante autoexplicativo, pero explicaré el propósito de cada uno de estos archivos en breve.

Aquí está el código para admin-init.php:

Directorio llamado trabajo de titanio 
He discutido previamente que Titan Framework te ayuda a crear Paneles y pestañas de administración, Metaboxes y Personalizador de temas Secciones y paneles. Así que he creado archivos separados para cada uno de ellos. Obviamente se pueden crear con líneas de código separadas. Discutiré cada uno de estos en mis próximos artículos, pero por ahora, todo lo que necesita entender es para qué sirven estos archivos..
 
 titan-framework-checker.php: es responsable de incluir Titan Framework en tu tema.
 
 adminpanel-options-init.php: contiene el código para crear el panel de administración y las pestañas con un conjunto de opciones.
 
 metabox-options-init.php: Contiene el código para crear metaboxes para tipos de publicación con un conjunto de opciones en ellos.
 
 personalizador-opciones-init.php: Contiene el código para crear paneles y secciones de personalizador de temas con un conjunto de opciones.
 
Incluyendo el admin-init.php Expediente
Hasta ahora debes preguntarte por qué he creado tantos archivos nuevos. ¿Por qué no acabo de agregar todo el código en el funciones.php ¿expediente? Bueno, no considero que sea un buen enfoque de diseño de arquitectura. Para construir un producto mantenible, necesita definir un buen patrón de diseño. 
¿Cuál es el punto de arruinar tu funciones.php ¿Archivo con tantas líneas de código? Yo mismo lo he experimentado: hacia el final de cualquier proyecto de desarrollo, el código se vuelve tan masivo que se vuelve difícil manejarlo todo en un solo archivo, especialmente cuando se trata de depurar y corregir cualquier error. Siempre es mejor crear archivos separados, así que piensa en estos archivos como módulos.
Vamos a incluir admin-init.php en nuestro funciones.php expediente.
Aquí he añadido el admin-init.php archivo a través del mismo get_template_directory () y requerir una vez() funciones.
En este punto, hemos echado un vistazo a la configuración básica de un tema que voy a utilizar para explicar cómo funciona Titan Framework. Hemos completado la configuración e incrustado Titan Framework en nuestro tema de WordPress. Vamos a crear un panel de administración con opciones y obtener los valores para el front-end..
Trabajando con Titan Framework
Para trabajar con Titan Framework, debe seguir un flujo de trabajo determinado que es:
 
Crear una instancia de Titan Framework por archivo.
 
Crear paneles / pestañas de administración, cuadros de colores o personalizadores de temas Secciones / paneles.
 
Crea opciones en ellos.
 
Obtener los valores.
 
Permítanme primero escribir el código que voy a usar para este propósito. Este es el código para el adminpanels-options-init.php archivo que está presente dentro de la activos / admin / titanframwork / directorio.
createAdminPanel (array ('name' => 'Neat Options' // Asigne un nombre al menú de opciones)); / ** * Crea las opciones. * * Ahora crearemos opciones para nuestro panel que acabamos de crear, llamadas '$ aa_panel'. * / $ aa_panel-> createOption (array ('id' => 'aa_txt', // El ID que se usará para obtener el valor de esta opción. 'type' => 'text', // Type of option we están creando. 'nombre' => '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.)); / ** * Guardar botón para opciones. * * Al crear las opciones del panel de administración, use este código para agregar el botón "Guardar" de la opción * ya que el usuario no tiene otra forma de guardar las opciones. Sus usuarios ahora pueden guardar * (y restablecer) las opciones que acabamos de crear. * / $ aa_panel-> createOption (array ('type' => 'save')); 
Al principio, he agregado algunos enlaces de ayuda de la documentación de Titan Framework. Ahora voy a explicar este código línea por línea..
Línea 17
Aquí tenemos un gancho llamado tf_create_options, que se utiliza para crear opciones a través de Titan Framework utilizando el aa_options_creating_function () función. 
Lineas 19
Hemos creado una función llamada aa_options_creating_function (), El cual será el responsable de crear estas opciones..
Línea 22
En la línea 22, he creado un ejemplo para Titan Framework. Crear una instancia es una parte integral de este marco, y debe crearse en cada archivo donde sea necesario para interactuar con Titan Framework. Para hacer que su instancia sea única, puede agregar el nombre de su producto en ella. Por ejemplo, he añadido 'neat' como parámetro. 
Consigue una instancia de Titan Framework
Crear una instancia de Titan Framework es bastante simple. Obtenemos una instancia única para evitar cualquier confusión, en caso de que otro complemento use Titan Framework para crear opciones. El autor afirma que: 
La función getInstance crea / obtiene una instancia única de Titan Framework específica para "mytheme". Este es el espacio de nombres Lo usaremos para asegurarnos de que nuestra configuración no entrará en conflicto con otros complementos que usan Titan Framework. Asegúrese de cambiarlo a su tema o nombre de complemento.
Aquí hay un ejemplo de código para obtener una instancia con Titan. 
$ titan = TitanFramework :: getInstance ('my-theme');
En el caso de mi Neat.Tema usaré el parámetro de ordenadoen lugar demi tema para hacer mi código único, es decir. 
$ titan = TitanFramework :: getInstance ('neat');
Creación de un panel de administración; Lineas 33-35
Estas líneas crearán un panel de administración que he nombrado como "$ aa_panel". Titan Framework ayuda a crear secciones como el panel de administración, las pestañas de administración, los metaboxes y los paneles de personalización de temas dentro de su proyecto. Pero por ahora solo crearé un panel de administración como ejemplo para explicar las cosas.. 
Estas líneas de código están llamando a nuestro createAdminPanel () Funciona en Titan Framework que forma una matriz. Esta función agregará una nueva sección en su panel de control de WordPress llamada Opciones aseadas.
La imagen de arriba es una captura de pantalla del panel de WordPress donde puede encontrar una nueva sección que se agrega en el Panel de administración..
Solo para resumir lo que he hecho hasta ahora: he configurado mi proyecto de desarrollo web y luego le agregué una instancia, después de lo cual creé un Panel de administración.. 
Justo en este punto, si hago clic en el botón Opciones aseadasbotón, entonces esta sección está vacía. Entonces, ahora crearé opciones dentro de este Panel de administración recién creado.. 
Creando Opciones en Titan Framework
Se prefieren los temas personalizables de WordPress porque la mayoría de los usuarios finales desean configurar los temas sin escribir una sola línea de código. Esto es posible mediante la adición de opciones flexibles durante el desarrollo del tema. 
Podemos agregar dichas opciones en un panel de administración separado, o en forma de metaboxes o también paneles de opciones dentro del personalizador de temas. Las opciones sirven para almacenar los valores que luego se recuperan en el front-end.
Líneas 42-47
Ahora eche un vistazo a estas líneas de código. Se utilizarán para crear opciones dentro de un panel o pestaña de administración. La línea 42 define la createOption () función para el $ aa_panel. Esta función es una vez más una matriz que soporta ciertos parámetros como ID, tipo, nombre, descripción, De acuerdo con estas líneas, he creado una opción que es un campo de texto y se llama Mi opción de texto. 
Esta es la captura de pantalla que muestra la opción creada dentro del Opciones aseadas panel.  
Líneas 56-58
Las dos últimas líneas del código crean otra opción dentro de este panel. Pero su propósito es guardar la configuración. Por ejemplo, en el Mi opción de texto campo, el usuario lo llena John Doe. Esto significa que el usuario desea cambiar la configuración predeterminada, que solo es posible si el usuario guarda la configuración personalizada.
Así que, de nuevo usé el createOption () función y asignado el valor del parámetro "tipo = guardar". 
Esta es la captura de pantalla final del desarrollo que he hecho hasta ahora.. 
En este punto, ya tiene configurado Titan Framework, ha creado algunas opciones para obtener resultados dinámicos, y ahora todo lo que queda por hacer es obtener los valores de las opciones que configuró en primer lugar. Del lema de tres pasos, he discutido los dos primeros en los dos artículos anteriores. Entonces, ahora vamos a la última y más importante parte de cómo funciona Titan Framework..
Obtención de valores
La creación de opciones se realiza en el back-end, y ahora necesitamos recuperar los valores de esas opciones, establecidos por un usuario final, para usarlos en el front-end. Podemos recuperar los valores establecidos contra las opciones a través de una función simple, es decir,. getOption ().
La siguiente es la estructura básica del código para recuperar los valores guardados:
getOption ('my_text_option'); // Hacer cosas aquí. 
Entonces, creé una función llamada mi función donde registré por primera vez una instancia de titán. Registrar una instancia es un paso importante, porque obtiene el objeto creado por Titan Framework para su configuración registrada en una variable, es decir,. $ titan. Puede ver que nuestra instancia es específica de nuestro tema, es decir,. mi tema, que se supone que es nuestro nombre tema o algo único. 
Recuperando valores en el front-end
Vamos a usar los valores establecidos contra las opciones en el front-end. He creado una plantilla de página personalizada en blanco. Si te refieres a la ordenado carpeta de temas, encontrarás un archivo llamado aa_titanframework.php en la raiz Puedes hacer lo mismo con tu tema también..
Crear un archivo nuevo en su editor de texto y copie y pegue las siguientes líneas de código.
getOption ('aa_txt'); ?> 
 
 
  
 
 
 
Antes de explicar el código mencionado anteriormente, refiérase al código de mi artículo anterior en el que creé un Panel de administración y sus opciones, porque también estoy usando los mismos nombres, ID, etc..
Las primeras cuatro líneas del código son para que WordPress registre esta plantilla de página personalizada, que es bastante estándar, no hay ciencia espacial allí.
Obtención de valores de opción
Obtendré los valores de las opciones que creé en el adminpanel-options-init.php archivo (refiérase para su código a mi artículo anterior) aquí. Se necesitan dos pasos para lograr esto:
 
Obtenga una instancia única de Titan Framework y guárdela en una variable.
 
Obtenga el valor a través de ID usando el getOption () función.
 
Línea 12
Siguiendo el primer paso, inicialicé una instancia única contra la variable $ titan, Solo una vez por cada archivo en el que lo use. Mi instancia es única ya que la he nombrado ordenado, es decir, el nombre del paquete para mi tema, puedes nombrarlo como único. Es necesario para que si un complemento está utilizando Titan y su tema también lo esté usando, entonces debería haber una manera de diferenciar entre las opciones establecidas por ese complemento y su tema..
$ titan = TitanFramework :: getInstance ('neat');
Línea 14
El segundo paso es hacer uso de la ID y obtener el valor guardado para esa opción. El código para esta línea es:
$ aa_txt_val = $ titan-> getOption ('aa_txt'); 
Recuperé el valor para aa_txt que se guarda contra la variable $ aa_txt_val. los aa_txt parámetro se refiere al ID de la opción que creé en mi primer Panel de administración (consulte mi artículo anterior).
Por lo tanto, hasta ahora he configurado la estructura básica para obtener los valores guardados. Ahora vamos a usar los valores guardados en el front-end.
Lineas 22-35
Estas líneas de código se utilizan para mostrar los valores guardados en el front-end. Eche un vistazo a la línea 29 donde usé el eco comando para obtener la salida. Lo mismo se hace en la línea 35, pero esta vez estoy mostrando la salida para $ aa_txt_val En un formato H3 (encabezado 3). Entonces, sea cual sea el valor que el usuario final establezca para esta opción, se mostrará en la parte delantera.
Resultados
Para mostrar los resultados del código que he explicado anteriormente, siga estos pasos:
 
Ve a tu WordPress tablero 
 
Crear un Nueva pagina vía Páginas> Añadir Nuevo.
 
Nombra la pagina Marco Titan (opcional, lo sabrías)
 
La captura de pantalla de arriba muestra la página que he creado. Al mismo tiempo, también puede encontrar el nuevo menú del panel de administración, es decir,. Opciones aseadas, donde creamos las opciones.
A continuación, elija la plantilla de página, es decir,. Marco Titan, para esta página antes de publicarla.
los aa_titanframework.php archivo agrega una nueva página Modelo llamado "Marco de Titan" que aparece en la lista desplegable. Elige esa plantilla.
 
Publica la pagina.
 
A continuación vaya a la Opciones aseadas menú y añadir algún valor en contra de la opción nombrada Mi opción de texto. 
 
La imagen muestra que he llenado este campo con Opción de texto AA y luego hice clic Guardar cambios.
Vuelve a la página de Titan Framework y ver la página.
La imagen de arriba muestra el resultado final. Este es elMarco Titan página. El valor de la opción guardada (es decir, opción de texto AA) para aa_txt se está mostrando en dos formas diferentes. El primero esta en párrafo formato mientras que el segundo está en h3 formato.
Conclusión
A estas alturas, debe tener un poco de comprensión de Titan Framework y su funcionamiento. Esta es la configuración básica que debe seguirse cada vez que desarrolle algo con Titan Framework. 
Ahora que ya sabe cómo configurarlo, cree algunas opciones y obtenga los valores guardados; pruébelo y hágamelo saber en caso de cualquier consulta a través de comentarios o comuníquese conmigo en Twitter. 
A continuación en esta serie, exploraremos el conjunto de opciones que podemos crear con Titan Framework y cómo usarlas.. 



		
			
	   
	




Código