Formatted Banner

clarkwinkelmann

Formatted Banner

This extension adds a customizable banner to Flarum homepage or all pages.

The "Content" field accepts Flarum formatter compatible syntax.
The "HTML" field accepts any valid HTML, but script tags will not be executed.

"Content" and "HTML" can be used at the same time.
"HTML" will be added below "Content" if both are used.

Allow dismissing banner works the same way as Flarum Welcome Hero.
Local Storage is used to save the dismissal.
The banner appears again if the browser cached data is cleared.

Replace Welcome Hero with banner places the Banner in place of Flarum's built-in Welcome Hero.
Visually this is very similar to the default option, but it means the banner only appears on the discussion list.

Hide Welcome Hero only has an effect if the banner is not already replacing the Welcome Hero.
This can also be achieved natively by removing all values from Flarum Welcome Hero settings.

If Replace Welcome Hero with banner or Hide Welcome Hero are enabled, the extension conflicts with the terms update banner of FoF Terms and probably other extensions that do something similar.

Installation

composer require clarkwinkelmann/flarum-ext-formatted-banner

Support

This extension is under minimal maintenance.

It was developed for a client and released as open-source for the benefit of the community.
I might publish simple bugfixes or compatibility updates for free.

You can contact me to sponsor additional features or updates.

Support is offered on a "best effort" basis through the Flarum community thread.

Sponsors: Dater.com

Links

kytos

Thanks for the mod, it works great.
How can I set it to only Tags view?

Thanks again.

clarkwinkelmann

kytos I don't think you can do that with my current implementation. It's either on all pages, or just the pages that have the Flarum native hero banner.

I can add a way to specify a whitelist of pages that should have the banner as a sponsored feature, it's probably around 30min of work

kytos

Thanks.

Looking forward to this feature.

LoneDev

Forum reports this after extension is enabled: An error occurred while trying to load this page..
Admin page reports 500.

clarkwinkelmann

LoneDev please retrieve the error from the log file https://docs.flarum.org/troubleshoot

LoneDev

clarkwinkelmann I use ianm-log-viewer to get logs, but it doesn't contain any information about the error.
Strange.

meihuak

a great extension, is there a simple?

clarkwinkelmann

LoneDev it could be a general PHP or webserver error, also try looking in the global server logs. You can also enable debug in config.php before trying again to hopefully see an error message right on the page.

meihuak I don't have any demo, sorry. It can be used for so many purposes it would be difficult to provide a demo that's meaningful to most users. The point of the extension is to insert stuff that cannot be inserted using the built in Flarum banner message.