Banner di notifica

:information_source: Riepilogo Il componente tematico Notification Banners offre un modo personalizzabile e flessibile per condividere messaggi sul tuo sito.
:eyeglasses: Anteprima Theme Creator
:hammer_and_wrench: Repository
GitHub - gormus/discourse-notification-banners: Helps admins create notification banners in various plugin outlets.
:question: Guida all’installazione Come installare un tema o un componente tematico
:open_book: Nuovo ai temi di Discourse? Guida per principianti all’uso dei temi di Discourse

Installa questo componente tematico

Il componente tematico Notification Banners offre un modo personalizzabile e flessibile per condividere messaggi sul tuo sito.

Ecco alcune caratteristiche principali:

  • Completamente personalizzabile: personalizza ogni banner per soddisfare le tue esigenze, inclusi contenuto, stile e comportamento.
  • Opzioni di visualizzazione flessibili: mostra i banner impilati o come carosello rotante per una facile navigazione.
  • Messaggistica mirata: mostra i banner solo a specifici gruppi di utenti, garantendo una comunicazione personalizzata.
  • Supporto temi: i banner si adattano automaticamente ai temi chiari o scuri, oppure puoi impostare colori personalizzati.
  • Supporto Markdown: utilizza Markdown per formattare facilmente i messaggi dei tuoi banner.
  • Carosello basato su Splide: la funzionalità carosello è alimentata dalla libreria JavaScript Splide, con impostazioni individuali per ogni banner.
  • Pianificazione: imposta date di inizio e fine specifiche per quando i banner dovrebbero apparire.
  • Facile ordine di visualizzazione: controlla l’ordine in cui vengono visualizzati i banner con impostazioni semplici.

Questo componente rende facile coinvolgere il tuo pubblico con notifiche visivamente accattivanti, personalizzate e ben organizzate.

Installazione

  1. Segui le istruzioni ufficiali per aggiungere questo componente tematico al tuo tema:
    Beginner's guide to using Discourse Themes

  2. Modifica l’impostazione theme authorized extensions per includere le estensioni di file css e js.

Funzionalità

Ogni banner di notifica può avere le seguenti funzionalità:

  • Titolo, facoltativo, visualizzato come intestazione H2 sopra il messaggio
  • Messaggio, messaggio di notifica semplice lungo 500 caratteri. È supportato Markdown.
  • Pubblico, seleziona i gruppi di utenti come pubblico per la notifica.
  • Categorie; seleziona le categorie su cui visualizzare il banner. Lascia vuoto per visualizzare su tutte le categorie.
  • Colore di sfondo, può essere impostato per differenziare il banner dagli altri.
  • Plugin outlet, imposta le notifiche sopra o sotto l’intestazione del sito, oppure utilizza l’outlet top-notices per visualizzarle insieme ai banner di topic nativi.
  • Visualizza in un carosello, quando selezionato, tutti i banner in ogni outlet vengono visualizzati in un carosello. Richiede un minimo di 2 banner selezionati per qualsiasi outlet.
  • Ignorabile, quando selezionato, gli utenti potranno ignorare il banner e questo verrà nascosto per loro.
  • Date di inizio e fine, quando definite, la visibilità del banner obbedisce a tali date. Puoi quindi impostare un banner in anticipo, ma diventerà visibile al pubblico selezionato solo alla data e ora impostate; o allo stesso modo puoi rimuovere automaticamente il banner dalla data dell’ultima visualizzazione.
  • Ordine di visualizzazione, definisci quale banner deve essere visualizzato in alto, quale in basso. Dalla v1.3.0, utilizzando i pulsanti nativi di riordino.

Il Carosello

La funzionalità di slideshow, o carosello, è fornita dalla libreria Splide; è concessa in licenza MIT.

Ogni carosello può essere configurato nella pagina del componente tematico utilizzando le opzioni Splide.

Colori dei Banner

Per impostazione predefinita, i banner utilizzeranno gli stessi colori del banner-topic:

.notification-banner {
    background: var(--tertiary-low);
    color: var(--primary);
}

Tuttavia, quando viene definito un colore di sfondo nelle impostazioni del banner, a seconda della sua luminosità, il nero o il bianco viene selezionato automaticamente come colore di primo piano.

Classi CSS Disponibili

.notification-banners--above-site-header,
.notification-banners--below-site-header,
.notification-banners--top-notices {

  .notification-banner {

    &__wrapper {
    }

    &__close {
    }

    &__header {
    }

    &__content {
    }
  }

  &.splide {
    .notification-banner {
    }
  }
}

.notification-banners--top-notices {
  .notification-banner {

    &__content {
    }
  }
}

La v1.3.0 introduce modifiche che potrebbero causare incompatibilità (per alcuni)

Non dimenticare di testare le modifiche e controllare le tue personalizzazioni prima di aggiornare i tuoi siti di produzione.

28 Mi Piace

Wow! Sembra fantastico e super flessibile.

Hai considerato la possibilità di limitarlo a una o più categorie?

9 Mi Piace

Grazie!

In realtà, avevo considerato di includere quello che avevo fatto in precedenza con il mio tema-component Filtered Topic Lists; vedi la sezione “Mostra su”.

Ero preoccupato che potesse complicare le cose, ecco perché non ho incluso quell’opzione. Invece, ho scelto di utilizzare i gruppi di utenti come pubblico per i banner.

Ma sarei felice di includerlo se ci fosse la necessità.

5 Mi Piace

Molto bello @gormus, grazie per aver condiviso questo componente con la community. :discourse: :clap:

3 Mi Piace

Grazie @Lilly è un piacere : )

3 Mi Piace

quando faccio clic sul pulsante X per chiudere questo banner popup, c’è un modo per farlo riapparire? Ho selezionato in background del banner repeat: repeat; repeat-x; repeat-y ma non funziona?

2 Mi Piace

Fantastico! Lo proverò nel mondo reale e vedrò se è effettivamente necessario o meno prima di infastidirti al riguardo.

4 Mi Piace

Attualmente no. Non ho considerato che un utente potesse voler ripristinare una notifica ignorata.
Pensi che dovrebbe esserci un’opzione per questo?

Potresti chiarire cosa intendi?

2 Mi Piace

Capisco cosa intendi, grazie!

3 Mi Piace

Sarei interessato anche a questa funzionalità (disponibile per categorie specifiche). Grazie per la considerazione.

4 Mi Piace

Ora le categorie sono supportate come pubblico di destinazione. È possibile selezionare una o più categorie per banner.

Fammi sapere cosa ne pensi : )

5 Mi Piace

Attualmente la mia pagina discourse è in esecuzione ver 3.4.0.beta3-dev e presenta un errore che non visualizza la pagina durante l’installazione del banner. Puoi ricontrollare e fornire aggiornamenti anticipati per la community. Grazie per la condivisione.

2 Mi Piace

Ciao @hoangphuctran93,

Grazie per aver segnalato il problema, sono riuscito a confermarlo tramite un’installazione pulita di Notification Banners su un Discourse 3.4.0.beta3-dev (d3f09f8f61)

Ho appena rilasciato una correzione, aggiorna l’istanza sul tuo sito, aggiorna la pagina con un refresh forzato se necessario.

2 Mi Piace

Grazie, hanno funzionato bene, non vedo l’ora di ricevere nuove idee e aggiornamenti. Ho alcuni suggerimenti come segue:

  1. Espandi la casella di input
  2. Consenti la selezione rapida di immagini oltre alla progettazione con HTML.
  3. Aggiungi un campo dati per nominare il banner invece di usarlo con il titolo, questo aiuta a categorizzare e gestire quando vengono applicati più banner.

Questo è il risultato dell’applicazione sulla nostra pagina discourse.

1 Mi Piace

Ho problemi con questa parte: il link non funziona. Come posso autorizzare quelle estensioni sul mio sito?

Grazie!

Devi sostituire meta.discourse.org con l’URL del tuo forum. Non puoi accedere all’area di amministrazione qui.
https://meta.discourse.org/admin/site_settings/category/files?filter=theme%20authorized%20extensions

In alternativa, puoi navigare nelle impostazioni del tuo sito e cercare theme authorized extensions

5 Mi Piace

Ah sì, grazie :slight_smile:

Un’altra domanda: quando dici pianificazione, c’è un modo per far apparire il banner alla stessa ora ogni settimana? Abbiamo orari di ricevimento settimanali ricorrenti durante i quali vorrei che questo banner venisse visualizzato, in modo che chiunque sul sito possa vedere che gli orari di ricevimento sono attualmente in corso e unirsi se lo desidera.

1 Mi Piace

È possibile abilitare un banner che inizi a essere visualizzato in una data e ora definite e venga rimosso in un’altra.

Quindi è possibile avere solo una pianificazione per la data e l’ora di inizio e fine.

Ciò che stai chiedendo richiede una funzionalità di pianificazione più elaborata che Notification Banners non fornisce.

Tuttavia, potresti comunque ottenere ciò di cui hai bisogno creando copie dello stesso banner utilizzando date di inizio e fine diverse.

Ti consiglio vivamente di testare questo scenario prima di andare in produzione.

E ricorda, indipendentemente dal fuso orario in cui ti trovi, i valori di data e ora devono essere inseriti in UTC e devono corrispondere al formato visualizzato nelle descrizioni dei campi.

4 Mi Piace

Grazie per il tuo contributo!

Speravo in una soluzione più automatizzata, dato che abbiamo 3 diverse sessioni di orario d’ufficio a settimana, ogni settimana, quindi sarebbe un bel po’ di lavoro manuale creare banner duplicati per tutte queste sessioni.

Ho esaminato anche il plugin Automations come altra opzione, ma anche l’automazione dei banner consente solo azioni “puntuali” e non azioni “ricorrenti”.

2 Mi Piace