# Personalización

# Botones

Sprout tiene una regla personalizada para botones virtuales. Donde, el usuario puede aplicar tamaños, colores, estilos e íconos con Font Awesome al crear un botón. Así, es posible, por defecto, adaptarlo al diseño de su sistema.

La regla se define fácilmente aplicando la referencia como prefijo al nombre del botón. Por ejemplo, para crear un botón grande, simplemente prefijo ms_le al nombre del botón: ms_le_btn_copy

Se puede aplicar más de una referencia al mismo botón, estando limitado solo por la cantidad de caracteres que la interfaz de Scriptcase permite para el nombre de un botón.
Por ejemplo, para crear un botón con ícono y clase , simplemente aplique los prefijos ms_del y ms_ldr al nombre del botón: ms_del_ms_ldr_del_user

Borrar usuario

Consulte a continuación la lista con todas las ** referencias ** de botones, disponibles en Sprout:

• Tamaños
• Colores
• Estilos Light
• Estilos Light hover*
• Estilos Light background*
• Font Awesome

*Este estilo tiene una diferencia en el hover.

# Tamaños

# Colores

# Estilos Light

# Estilos Light hover*

*Este estilo tiene una diferencia en el hover.

# Estilos Light background*

*Este estilo tiene una diferencia en el hover.

# Font Awesome

Referencia	Icono	Ejemplo	Referencia	Icono	Ejemplo
ms_close		Ejemplo	ms_rght		Ejemplo
ms_ok		Ejemplo	ms_tab		Ejemplo
ms_clear		Ejemplo	ms_srch		Ejemplo
ms_undo		Ejemplo	ms_chrt		Ejemplo
ms_save		Ejemplo	ms_list		Ejemplo
ms_cancel		Ejemplo	ms_sort		Ejemplo
ms_copy		Ejemplo	ms_tbl		Ejemplo
ms_check		Ejemplo	ms_magic		Ejemplo
ms_add		Ejemplo	ms_cog		Ejemplo
ms_del		Ejemplo	ms_bar		Ejemplo
ms_edit		Ejemplo	ms_line		Ejemplo
ms_first		Ejemplo	ms_pie		Ejemplo
ms_back		Ejemplo	ms_stck		Ejemplo
ms_next		Ejemplo	ms_tach		Ejemplo
ms_last		Ejemplo	ms_pdf		Ejemplo
ms_remove		Ejemplo	ms_wrd		Ejemplo
ms_up		Ejemplo	ms_prnt		Ejemplo
ms_down		Ejemplo	ms_xls		Ejemplo
ms_hide		Ejemplo	ms_xml		Ejemplo
ms_view		Ejemplo	ms_csv		Ejemplo
ms_max		Ejemplo	ms_img		Ejemplo
ms_upl		Ejemplo	ms_mail		Ejemplo
ms_clock		Ejemplo	ms_more		Ejemplo
ms_gear		Ejemplo	ms_dwnl		Ejemplo
ms_data		Ejemplo	ms_warn		Ejemplo
ms_pw		Ejemplo	ms_fb		Ejemplo
ms_exit		Ejemplo	ms_gogl		Ejemplo
ms_event		Ejemplo	ms_papl		Ejemplo
ms_alert		Ejemplo	ms_twtt		Ejemplo
ms_ask		Ejemplo	ms_sad		Ejemplo
ms_bell		Ejemplo	ms_home		Ejemplo
ms_lft		Ejemplo

# Macros

Además de personalizar los botones, Sprout también cuenta con macros exclusivas, diseñadas para brindar más dinamismo al sistema.

# sc_field_group

sc_field_group(text, array_config)

Esta macro permite agrupar varios valores en un solo campo de la consulta. A través de los parámetros, es posible informar los valores que se mostrarán y también una serie de configuraciones de visualización a través de un array.

El uso de esta macro está restringido al evento onRecord de la consulta.

Esta macro requiere el uso de la biblioteca interna fieldGroup.php, que está habilitada por defecto.

# Parámetros

*Este parámetro no es obligatorio para que funcione la macro.

# ms_initial

# ms_list

# Ejemplo

Grids - onRecord

$admin = (isset({set_admin}) && {set_admin} == "Y") ? {lang_sec_user_fld_set_admin} : "";

$set                                = array();
$set["ms_initial"]["img"]["field"]  = {photo};
$set["ms_initial"]["img"]["viewer"] = "Y";
$set["ms_initial"]["text"]          = {first_name};
$set["ms_list"]["title"]            = {first_name} . " " . {last_name};
$set["ms_list"]["note"]["primary"]  = $admin;

{user} = sc_field_group({email}, $set);
 
        Copied!
    

# sc_input_group

sc_input_group(array_fields, sc_seq_vert)

Esta macro permite crear grupos de texto y Icono en las entradas del formulario. A través de los parámetros es posible informar un array multidimensional que recibirá los campos, contenidos y tipos que pueden ser textos o iconos Font Awesome (opens new window).

El uso de esta macro está restringido a eventos onLoad y onLoadRecord de aplicaciones formulario, ** control** y calendario.

Esta macro requiere el uso de la biblioteca interna inputGroup.php, que está habilitada de forma predeterminada.

Desactive la opción Mostrar salida Ajax en la configuración de la aplicación.

# Parámetros

*Este parámetro debe recibir la variable $ sc_seq_vert y solo es obligatorio para múltiples registros orientaciones, grid editable y grid editable (ver).

# Array Multidimensional

*Ver tipos de campos admitidos.
**Para Iconos é necessário informar o atributo class do Font Awesome (opens new window). Ejemplo: fas fa-user.

# Tipos de campos admitidos

# Ejemplos

Formularios de registro único, controles y calendarios - onLoad

$arr_fields = [
	['smtp_server', 'icon', 'fas fa-server', 'left'],
	['smtp_email', 'icon', 'fas fa-at', 'left'],
	['smtp_user', 'icon', 'fas fa-user', 'left'],
	['smtp_pswd', 'icon', 'fas fa-key', 'left']
];

sc_input_group($arr_fields);
 
        Copied!
    

Formularios de Múltiples registro, grid editable y grid editable (view) - onLoadRecord

$arr_fields = [
	['mod', 'icon', 'fas fa-bars', 'left']
];

sc_input_group($arr_fields, $sc_seq_vert);
 
        Copied!
    

# sc_float_label

sc_float_label(array_fields, sc_seq_vert)

Esta [macro] (# macros) permite transformar el placeholder como una etiqueta flotante en las entradas de formularios. A través de los Parámetros es posible informar una array que recibirá todos los campos en los que se aplicará el recurso.

El uso de esta macro requiere que el campo utilizado contenga un placeholder (marca de agua).

El uso de esta macro está restringido a eventos onLoad y onLoadRecord de aplicaciones formulario, control y calendario.

Esta macro requiere el uso de la biblioteca interna floatLabel.php, que está habilitada por defecto.

Desactive la opción Mostrar salida Ajax en la configuración de la aplicación.

# Parámetros

*Este parámetro debe recibir la variable $ sc_seq_vert y solo es obligatorio para múltiples registros orientaciones, grid editable y grid editable (view).

# Array

*Ver tipos de campos admitidos.

# Tipos de Campos Admitidos

# Ejemplos

Formularios de registro único, controles y calendarios - onLoad

$arr_fields = ['smtp_server', 'smtp_email', 'smtp_user', 'smtp_pswd'];

sc_float_label($arr_fields);
 
        Copied!
    

Formularios de Múltiples registro, grid editable y grid editable (view) - onLoadRecord

$arr_fields = ['mod', 'icon'];

sc_float_label($arr_fields, $sc_seq_vert);
 
        Copied!
    

# sc_back_to_top

sc_back_to_top(position)

Esta macro crea un botón, en el margen inferior mientras se desplaza por la página, redirigiendo a la parte superior. A través del parámetro, es posible definir la posición del botón como izquierda o derecha.

El uso de esta macro es aplicable a eventos de carga de página como onExecute, onLoad y onScriptInit.

Esta macro requiere el uso de la biblioteca interna backTop.php, que está habilitada por defecto.

Desactive la opción Mostrar salida Ajax en la configuración de la aplicación.

# Parámetros

# Ejemplos

Grid - onScriptInit

sc_back_to_top();
 
        Copied!
    

Form - onLoad

sc_back_to_top("left");
 
        Copied!
    

# sc_add_notification

sc_add_notification(type, rec_type, receiver, text, link, sender)

Esta macro permite el envío de mensajes de alerta o eventos del sistema. A través de los Parámetros es posible determinar para qué usuarios y departamentos se mostrará el mensaje.

Esta macro requiere el uso de la biblioteca interna notification.php, que está habilitada por defecto.

# Parámetros

# Ejemplo

switch ({receiver_type}) {
    case "all_users":
        $receiver = null;
    break;
    case "group":
        $receiver = {receiver_group};
    break;
    case "user":
    break;
    default:
        $receiver = null;
    break;
}

$sender = null;

if (isset([usr_login])) {
    $sender = [usr_login];
}

sc_add_notification({type}, {receiver_type}, $receiver, {text}, {link_app}, $sender);
 
        Copied!