Share
Los avisos de administración de WordPress proporcionan una manera conveniente de mostrar mensajes a los usuarios en el área de administración, por ejemplo. después de que se haya actualizado una publicación o se haya activado un complemento. También son utilizados por muchos temas y complementos para mostrar notificaciones sobre cualquier cosa, desde nuevas funciones o advertencias de seguridad hasta detalles sobre promociones en curso o avisos de actualización..
El núcleo de WordPress proporciona cuatro avisos de administración diferentes que pueden usarse de manera contextual para alertar a un usuario sobre un tipo específico de aviso. Esto se logra mostrando un color de acento único para cada tipo de aviso de administrador.
Los avisos de administrador generalmente se muestran en la parte superior de cada página de administrador para destacar del contenido de la página principal y ser claramente notorios. Están elegantemente diseñados para no distraer demasiado la vista..
WordPress también reutiliza los avisos de administración en otras ubicaciones a través de la interfaz de administración, como cuando hay una actualización de tema o complemento disponible. El uso principal de los avisos de administración no se limita a que solo se muestre en la parte superior de la pantalla de administración.
Mostrar un aviso de administrador en un complemento o tema personalizado es relativamente fácil, ya que solo se requieren unas pocas líneas de código, como veremos en breve. Sin embargo, WordPress no proporciona una forma predeterminada para rechazar un aviso de administrador persistente.
Aunque puede agregar un botón de descartar a cualquier aviso de administrador, esto no impide que reaparezca cuando se recarga la página. Además, los avisos de administración aparecen en cada página de administración, lo que dista mucho de ser ideal..
Si desea tener un control granular sobre cuándo y dónde se muestran los avisos de administración y poder descartarlos de manera efectiva, deberá agregar un código personalizado para modificar el comportamiento predeterminado..
Comenzaremos por el principio y exploraremos los aspectos básicos de la implementación de avisos de administración a través de un complemento personalizado, que incluye mostrarlos solo en páginas específicas en el administrador de WordPress..
Los avisos de administrador aparecen en cada página de forma predeterminada, lo que no siempre es lo que desea. Por ejemplo, es posible que solo desee mostrar una notificación en una página de opciones de complemento. Por lo tanto, nuestro próximo puerto de llamada será mostrar condicionalmente notificaciones de administración según la pantalla de administración actual..
A partir de esto, presentaremos formas de administrar aún más los avisos de administración controlando cuando ellos tambien aparecen En lugar de aparecer tan pronto como se carga la página, solo aparecerán si se cumplen ciertas condiciones de activación. Esto podría ser útil, por ejemplo, si desea mostrar un aviso de administrador en una página de opciones de complemento, pero solamente después de haber guardado los ajustes.
Como se mencionó anteriormente, no hay una manera fácil de descartar los avisos de administración persistentes entre cargas de página. Por lo tanto, el resto de la serie de tutoriales se centrará principalmente en varios métodos que puede utilizar para descartar los avisos de administración para que no vuelvan a aparecer inesperadamente..
Finalmente, para un poco de diversión, veremos cómo puede crear sus propios tipos de aviso de administrador personalizados y agregar una decoración adicional, como iconos a sus avisos de administrador..
Al final de esta serie de tutoriales, podrá mostrar cualquier tipo de aviso de administrador en cualquier lugar dentro del administrador de WordPress. Además, podrá decidir si desea mostrarlos en la carga de la página o mediante una acción personalizada, y también podrá descartarlos de varias formas diferentes, según sus necesidades..
Obtendrá el máximo provecho de esta serie de tutoriales si sigue adelante a medida que desarrollamos cada ejemplo de notificación de administrador. El código se presenta paso a paso para permitirle crear un complemento de trabajo por su cuenta a medida que avanzamos en el tutorial. Sin embargo, si no desea escribir todo el código usted mismo, el complemento terminado estará disponible para su descarga en la parte cuatro..
Se asume que usted tiene al menos un conocimiento práctico rudimentario del desarrollo del complemento de WordPress, incluido cómo funcionan los enganches. Si no es así, entonces recomiendo leer sobre estos temas a través de la documentación oficial de WordPress antes de continuar:
Para probar el código del complemento para cada ejemplo, necesitará un sitio de WordPress que funcione. La forma más sencilla de hacerlo es instalar WordPress localmente para que tenga fácil acceso para editar archivos..
Hay muchas opciones para desarrollar localmente con WordPress, incluyendo:
Si eres nuevo en el desarrollo de WordPress, entonces Local o DesktopServer son probablemente los más fáciles de configurar. Local es de uso gratuito (tienen una versión premium en las obras), y DesktopServer tiene una versión limitada (gratuita) más una versión premium disponible.
Además, se recomienda cierta experiencia previa de PHP y JavaScript, al igual que cierta experiencia en la implementación de solicitudes Ajax. Sin embargo, todo se explicará en el camino, por lo que no se requiere un conocimiento profundo.
Echemos un vistazo a la implementación más básica de un aviso de administrador y el código requerido para emitir un aviso de tipo de éxito.
función display_admin_notice () ?>El secreto del éxito es saber algo que nadie más sabe ~ Aristóteles Onassis
Todo lo que hicimos aquí fue registrar el
display_admin_notice ()función que se ejecutará cuando eladmin_noticeslos fuegos de gancho. No importa cómo se llame la función registrada, no afectará a la manera en que se presenta el aviso del administrador..No te preocupes por ingresar el código que tienes encima ahora mismo; solo concéntrese en cómo se genera el aviso de administrador ya que estaremos construyendo sobre esto en tutoriales posteriores.
Puede utilizar cualquier marca que desee para mostrar un aviso de administrador; Sin embargo, el formato recomendado es el siguiente:
mensaje
Reemplazar
clasecon una lista de nombres de clase CSS. Debes incluir la clasedarse cuentaademás de cualquiera de las siguientes clases para determinar el tipo de aviso de administrador:
Accentsconagua
aviso-error (rojo)aviso-advertencia (Amarillo naranja)aviso-éxito (verde)aviso-información (azul)
los mensaje El bloque puede ser cualquier texto o HTML válido que se mostrará en el aviso de administración..
El ejemplo anterior muestra avisos de administración en todas las páginas de administración, lo que no siempre es ideal, así que en la segunda parte veremos cómo puede controlar exactamente en qué páginas aparecen..
Hay otra clase de CSS incorporada que puedes agregar a aviso div. Eso agrega un botón de despedir al aviso de administrador. Veamos qué sucede cuando el mismo aviso de administrador de éxito tiene el es-descartable clase añadida a ella.
función display_admin_notice () ?>El secreto del éxito es saber algo que nadie más sabe ~ Aristóteles Onassis
Ahora tenemos una manera fácil de descartar un aviso de administrador. Sin embargo, antes de que te emociones demasiado, hay un problema con el uso de este método. ¡Si actualizas la página, vuelve a aparecer el aviso de administrador! Por lo tanto, aunque puede configurar un aviso de administrador para que sea descartable, es persistente y el estado de despido se olvida entre cargas de página.
Cubriremos los avisos de administración persistentes en detalle más adelante y exploraremos varias formas en que puede descartarlos sin que vuelvan a aparecer..
Pero los avisos de administrador son malos! No son ellos?
Si está familiarizado con los avisos de administración en WordPress y / o se mantiene al tanto de las noticias de WordPress en general, entonces puede estar al tanto de cierta negatividad con respecto al uso de avisos de administración en complementos y temas personalizados..
Esto se debe a que algunos complementos sobreutilizan los avisos de administración en un intento de hacer llegar sus mensajes "importantes". Si tiene muchos complementos instalados y solo algunos de ellos abusan del sistema de avisos de administración, puede terminar rápidamente con el aviso de administrador 'sopa', donde se muestra una maraña de avisos en la parte superior de cada página de administradores..
La sobrecarga de pantallas de administración con avisos innecesarios puede causar caos (y dolores de cabeza) y es comprensiblemente molesto para los usuarios, ya que dificulta la administración de un sitio.
Lo ideal es que solo se muestren avisos de administración importantes, como actualizaciones de seguridad críticas, en cada carga de página. Si está mostrando avisos de administración global para indicar a los usuarios que se acaba de actualizar un complemento y le solicita que haga clic en un enlace para obtener más información, entonces realmente debería preguntarse si esto debe estar en todas las páginas de administración..
Además, un favorito típico es mostrar un aviso de administrador no crítico que no se puede descartar fácilmente de manera permanente. Le garantizo que no hay una manera más fácil de alienar a los usuarios de sus complementos que haciendo esto.!
Sin embargo, hay casos de uso para notificaciones persistentes que no se pueden descartar, como las actualizaciones de la base de datos. Los complementos que utilizan tablas personalizadas pueden necesitar ejecutar rutinas de actualización de la base de datos de vez en cuando para que el complemento funcione correctamente. Por lo tanto, en este caso, es razonable agregar un aviso de administrador no desechable.
Una buena regla general es simplemente emplear el sentido común. ¿El aviso de administración que está a punto de agregar a su complemento lo molestaría como usuario? Si es así, es posible que desee replantearse la adición del aviso, o considerar si se mostraría mejor en una ubicación alternativa.
Conclusión
En este tutorial, hemos cubierto qué son los avisos de administración y los diversos tipos incorporados proporcionados por WordPress, incluido un aviso de administrador que se puede descartar. Como hemos visto, hay algunos inconvenientes en la implementación predeterminada de los avisos de administración, como no ser descartable y el hecho de que están representados en cada página de administración..
WordPress tiene una economía increíblemente activa. Hay temas, complementos, bibliotecas y muchos otros productos que lo ayudan a desarrollar su sitio y proyecto. La naturaleza de código abierto de la plataforma también lo convierte en una excelente opción desde donde puede mejorar sus habilidades de programación. En cualquier caso, puedes ver lo que tenemos disponible en Envato Market..
El resto de los tutoriales de esta serie se centrarán en cómo podemos extender los avisos de administración para que sean más prácticos cuando se utilicen en sus propios complementos y temas..
