Accentsconagua

Una guía para principiantes de Titan Framework agregar una opción de tipo de habilitación

Código
Share

Proporcionar a los usuarios finales la opción de habilitar o deshabilitar ciertas funciones de un complemento premium o un tema es bastante común. Titan Framework ha incorporado recientemente una nueva opción a su núcleo que hace exactamente eso. Veamos cómo puede agregar un botón de activación / desactivación dentro de un panel de administración, un metabox o una sección del personalizador de temas con Titan Framework (TF).

La opción Habilitar tipo en Titan Framework

Hay un habilitar Escriba la opción en Titan Framework para crear habilitar / deshabilitar los botones de alternar. En el salpicadero, el habilitar La opción de tipo aparece así: 

Aquí están sus parámetros:

  • nombre: Asigna el nombre de visualización de un habilitar opción de tipo.
  • carné de identidad: Este parámetro especifica un nombre único que obtiene los valores de las opciones guardadas.
  • desc: Se agrega una breve descripción con el nombre de la opción..
  • defecto: (Opcional) Asigna el valor por defecto..
  • habilitado: (Opcional) Es la etiqueta para el botón de la habilitado estado. El valor predeterminado está establecido en Habilitado.
  • discapacitado: (Opcional) Es la etiqueta para el botón de la discapacitado estado. El valor predeterminado está establecido en Discapacitado.
  • vista previa en vivo: (Opcional) Cada vez que agregue un habilitar escriba la opción en una sección de personalizador de tema, este parámetro le permite ver en vivo los cambios que realiza.

Todos los parametros son cuerda por tipo, excepto por defecto que es booleano.

Contenedores disponibles para la opción Habilitar tipo

Puedes agregar esta opción dentro de:

  • Panel de administrador
  • Pestaña admin
  • Metabox
  • Sección de personalización de temas

Para agregar un habilitar Escriba la opción en estos contenedores, siga estos pasos:

  • Obtener una instancia a través de la obtener Instancia() función.
  • Crear una opción a través de createOption () función.
  • Obtener valores guardados a través de la getOption () función.

Si está interesado en aprender a crear estos contenedores con TF, lea los artículos anteriores de esta serie..

Creación de una opción de tipo de habilitación dentro de un panel de administración

Ejemplo de Declaración

Vamos a crear esta opción en un panel de administración primero.

createOption (array ('id' => 'aa_enable_opt', // El ID que se usará para obtener el valor de esta opción 'type' => 'enable', // Tipo de opción que estamos creando 'name' => 'Permitir CSS personalizado', // Nombre de la opción que se mostrará en el panel de administración 'desc' => 'Habilitar / Deshabilitar CSS personalizado', // Descripción de la opción que se mostrará en el panel de administración 'predeterminado' => verdadero // Valor predeterminado de la opción));

En la línea # 8, agregué un habilitar opción de tipo a través de la createOption () función en un panel de administración $ aa_panel. Como esta función ocupa una matriz, he definido los valores de los parámetros nombre, tipo, id, desc y defecto. El valor del ID debe ser único, es decir,. aa_enable_opt. El valor de defecto se establece en cierto, lo que significa que el estado de la opción se establece en 'habilitado' por defecto.

En la captura de pantalla anterior, hay un habilitar tipo de opción llamada Permitir CSS personalizado en un panel de administración Opciones aseadas.

Ejemplo de uso

Consigamos los valores guardados..

getOption ('aa_enable_opt'); / ** * * Imprimir el valor guardado * * / if (1 == $ aa_enable_opt_val) echo "CSS personalizado en la pestaña de administración está activado.";  else echo "CSS personalizado en la pestaña de administrador está desactivado"; ?>

Para obtener el valor guardado, primero obtenga una instancia a través de obtener Instancia() función (línea # 3). Luego en la línea # 6, la getOption () La función recupera el valor guardado registrando la ID de opción aa_enable_opt como su parametro. Guardé el resultado dentro de una nueva variable $ aa_enable_opt_val. Entonces utilicé un si-si no cheque que imprime el valor guardado en el front-end.  

Ahora el habilitar opción de tipo puede contener dos valores: 1/0 o verdadero Falso. El valor es '1' (estado habilitado) o '0' (estado deshabilitado). Teniendo en cuenta este hecho, escribí las líneas 15 a 20 del código, que verifica el valor de la variable $ aa_enable_opt_val. Si es '1' entonces imprime 'CSS personalizado en el panel de administración está habilitado ' en la parte delantera. Si el valor de la variable es '0' entonces se imprime 'CSS personalizado en el panel de administración está deshabilitado'.

Viendo el resultado en el front-end

Supongamos que habilité la opción y la guardé.

Aquí hay una captura de pantalla del resultado final que apareció en la parte delantera.

Creación de una opción de tipo de habilitación dentro de una pestaña de administrador

Ejemplo de Declaración

A continuación crearé esta opción en una pestaña de administración..

createOption (array ('id' => 'aa_enable_opt_in_tab', // El ID que se usará para obtener el valor de esta opción 'type' => 'enable', // Tipo de opción que estamos creando 'name' => 'Permitir CSS personalizado', // Nombre de la opción que se mostrará en el panel de administración 'desc' => 'Habilitar / Deshabilitar CSS personalizado', // Descripción de la opción que se mostrará en el panel de administración 'habilitado' => 'On', // Etiqueta para la opción habilitada 'disabled' => 'Off' // Etiqueta para la opción deshabilitada));

Aquí, agregué esta opción en una pestaña de administrador $ aa_tab1. El valor del ID es aa_enable_opt_in_tab. Esta vez, también he definido nuevas etiquetas para el habilitado y discapacitado parámetros. 

En la imagen, hay un habilitar escriba la opción dentro Pestaña 1 de panel Opciones aseadas 2. También tenga en cuenta las etiquetas recién definidas 'En'para habilitar y'Apagado'para deshabilitar.

Ejemplo de uso

Ahora obtendré valores guardados.

getOption ('aa_enable_opt_in_tab'); / ** * * Imprimir el valor guardado * * / if (1 == $ aa_enable_opt_in_tab_val) echo "CSS personalizado en la pestaña de administración está activado.";  else echo "CSS personalizado en la pestaña de administrador está desactivado"; ?>

El código es bastante similar a lo que escribí anteriormente. Entonces, déjame resumir todos los pasos:

  • Consigue una instancia única a través de obtener Instancia() funciona en la línea # 4.
  • Obtenga el valor guardado a través de getOption () funciona en la línea # 7.
  • Imprima el valor guardado en el front-end a través de si-si no Compruebe el estado de cuenta en las líneas 15 a 20.

Viendo el resultado en el front-end

Esta vez cambié la opción de Apagado. El front-end imprime la siguiente línea:

Creando una opción de tipo de habilitación dentro de un Metabox

Ejemplo de Declaración

Ahora voy a crear un habilitar opción de tipo en un metabox.

createOption (array ('id' => 'aa_enable_opt_in_metabox', // El ID que se usará para obtener el valor de esta opción 'type' => 'enable', // Tipo de opción que estamos creando 'name' => 'Permitir CSS personalizado', // Nombre de la opción que se mostrará 'desc' => 'Habilitar / Deshabilitar CSS personalizado', // Descripción de la opción que se mostrará 'predeterminado' => falso // Valor predeterminado de la opción ) );

Aquí he añadido otra habilitar opción de tipo en un metabox $ aa_metbox. Su ID es aa_enable_opt_in_metabox. El valor de defecto se establece en falso.

En la captura de pantalla anterior, puedes encontrar esta opción en un metabox. Aparece en todas las pantallas de edición de página y post..

Ejemplo de uso

Vamos a obtener el valor guardado para esta opción.

getOption ('aa_enable_opt_in_metabox', get_the_ID ()); / ** * Imprimir el valor guardado * * / if (1 == $ aa_enable_opt_in_metabox_val) echo "CSS personalizado en un metabox está habilitado.";  else echo "CSS personalizado en un metabox está deshabilitado."; ?>

He escrito casi el mismo código de nuevo. La única diferencia puede ser vista en la línea # 6. Existe un nuevo parámetro dentro del getOption () función. Este es el get_the_ID () Función que se utiliza para recuperar una página específica o ID de publicación.

Viendo el resultado en el front-end

Vamos de nuevo habilitar La opción y guardarla. El front-end aparece así:

Creación de una opción de tipo de habilitación dentro de una sección del personalizador de temas

Ejemplo de Declaración

Finalmente, crearé esta opción en una sección de personalizador de tema..

createOption (array ('id' => 'aa_enable_opt_in_sec', // El ID que se usará para obtener el valor de esta opción 'type' => 'enable', // Tipo de opción que estamos creando 'name' => 'Permitir CSS personalizado', // Nombre de la opción que se mostrará 'desc' => 'Habilitar / Deshabilitar CSS personalizado', // Descripción de la opción que se mostrará 'predeterminado' => falso // Valor predeterminado de la opción ) );

Aquí creé esta opción en una sección de personalizador de tema. $ aa_section1. Su ID única es aa_enable_opt_in_sec. El resto de los parámetros son los mismos..

En la imagen de arriba, hay un habilitar Escriba la opción en una sección del personalizador de tema llamada Mi seccion.

Ejemplo de uso

Usa el siguiente código para obtener los valores guardados.

getOption ('aa_enable_opt_in_sec'); / ** * * Imprimir el valor guardado * * / if (1 == $ aa_enable_opt_in_sec_val) echo "CSS personalizado en una sección del personalizador está habilitado.";  else echo "CSS personalizado en una sección de personalizador está deshabilitado."; ?>

Una vez más, el código es exactamente el mismo. Solo los nombres de ID y variables son diferentes.

Viendo el resultado en el front-end

Aquí está la captura de pantalla, que muestra los cambios en el modo de vista previa en vivo.

Conclusión

Desde el punto de vista del usuario final, el habilitar La opción de tipo es bastante útil, ya que puede habilitar o deshabilitar cualquiera de las funciones con un solo clic. Vaya a este tutorial y comparta sus opiniones al respecto en la sección de comentarios.

En este punto, hemos cubierto todo lo que hay que cubrir sobre Titan Framework. Por favor, recuerde revisar la página de la serie si tiene alguna pregunta o comentario sobre alguno de los temas que hemos cubierto. O siéntete libre de contactarme en Twitter.

Código
×