Ganchos: Acciones y filtros
Tenga en cuenta que este es un documento para desarrolladores. Si no estás familiarizado con el código/plantillas y la resolución de posibles conflictos, selecciona un WooExpert o Desarrollador para obtener ayuda.
Sensei viene con varios ganchos que se pueden utilizar para cambiar la forma en que se comporta. Estos ganchos pueden a su vez separarse en dos categorías:
- Acciones
- Filtros
Si no estás familiarizado con el funcionamiento de las acciones y los filtros en WordPress, esta guía puede ponerte al día.
Puede encontrar una lista actualizada de todos los ganchos de acción y filtro en nuestros documentos de referencia para desarrolladores de Sensei.
Ejemplos de códigos
Estos son algunos ejemplos de código que utilizan algunos de los ganchos de filtro Sensei. El código de estos ejemplos puede añadirse al archivo functions. php de su tema o cargarse a través de un complemento de terceros como Functionality.
Desactivar los estilos Sensei por defecto
| add_filter( 'sensei_disable_styles', '__return_true' ); |
view rawfunctions.php hosted with ❤ by GitHub
Estructura CSS
Dentro del directorio assets/css/ encontrarás las hojas de estilo responsables de los estilos por defecto del frontend de Sensei. Los archivos a buscar son frontend.scss y frontend.css.
frontend.css es la hoja de estilos minificada. Este archivo es referenciado por el plugin y declara todos los estilos Sensei. frontend.scss no es utilizado por el plugin. Contiene el CSS en bruto y puede ser compilado usando Sass, un preprocesador de CSS. Usamos este archivo para crear el CSS del plugin.
El CSS está escrito para que los estilos por defecto sean compatibles con el mayor número posible de temas. Sin embargo, es más que probable que quieras hacer tus propios ajustes.
Modificaciones
Para evitar problemas de actualización, se aconseja no editar estos archivos directamente. Utilícelos como punto de referencia.
Si sólo desea realizar algunos cambios, le recomendamos que añada algunos estilos a la hoja de estilos de su tema. Por ejemplo, añada lo siguiente a la hoja de estilos de su tema para que las barras de progreso de Sensei sean negras en lugar del color predeterminado:
.meter > span {background: #000;}
Sensei también emite "sensei" como clase en la etiqueta body de las páginas Sensei, lo que puede ser útil para anular estilos sólo en páginas Sensei.
Desactivación de los estilos Sensei
Si planea hacer cambios importantes, puede que prefiera que su tema no haga referencia a la hoja de estilos frontend de Sensei. Puede decirle a Sensei que no use frontend.css en Sensei > Configuración. Pero una mejor solución es simplemente añadir la siguiente línea de código al archivo functions.php de su tema:
add_filter( 'sensei_disable_styles', '__return_true' );
Con esta definición en su lugar su tema ya no utilizará la hoja de estilos frontend Sensei, dándole un lienzo en blanco sobre el que puede construir su propio diseño / estilo deseado.