Beschrijving
A WordPress Customise Widget to add a global website banner, styled using a Bootstrap alert box.
The plugin assumes that you’re already using Bootstrap, so you need to load the Bootstrap javascript and CSS separately.
- Download Twitter Bootstrap
- Bootstrap CDN (directly link CSS and javascript files)
- Bootstrap Alerts in action
Once installed, you can add the alert to the correct location in your theme (for example, in header.php
with the global_bootstrap_banner()
function.
For example:
if (function_exists('global_bootstrap_banner')){
echo global_bootstrap_banner();
}
If you prefer, you can use a shortcode instead:
[global-bootstrap-banner]
Shortcode Options
The plugin works best when using the Customizer interface. However, if you wish you can use a shortcode and override most fields.
enabled
(defaulttrue
)- Whether to show the banner or not.
colour
(defaultalert-primary
)- Bootstrap class to use for styling the alert.
header_text
- Header – leave blank to skip the alert header.
body_text
- Main text for the alert. You can use HTML.
link_text
- Display text for a button at the bottom of the alert. Leave blank to skip.
link_url
- URL for button to link to.
link_class
(defaultbtn-primary
)- Bootstrap class to use for styling the button.
link_new_window
(defaultfalse
)- Whether to open the link in a new window or not.
link_btn_lg
(defaultfalse
)- Use the
btn-lg
class for the button (big button).
- Use the
link_btn_sm
(defaultfalse
)- Use the
btn-sm
class for the button (small button).
- Use the
link_btn_block
(defaultfalse
)- Use the
btn-block
class for the button (full width button).
- Use the
dismiss_btn
(defaulttrue
)- Whether to show a dismiss button in the corner of the alert.
dismiss_expiry
(default14
)- How many days the dismissal cookie should last for before it is shown again.
dismiss_id
- Random string to use for the dismissal cookie. Use a new one to force it to show for everyone.
alert_before
(default<div class="global-bootstrap-banner container">
)- HTML to use before the alert.
alert_after
(default</div>
)- HTML to use after the alert.
header_before
(default<h4 class="global-bootstrap-banner-heading alert-heading">
)- HTML to use before the heading.
header_after
(default</h4>
)- HTML to use after the heading.
link_before
(default<p class="global-bootstrap-banner-btn-p mb-0">
)- HTML to use before the button.
link_after
(default</p>
)- HTML to use after the button.
For example, a simple shortcode usage would be:
[global-bootstrap-banner body_text="This alert says something different"]
Note that the shortcode first takes the settings from the Customizer and then overwrites these.
So the above shortcode would show a header if it is set in the Customizer settings.
Credits
This plugin was written by @ewels.
Contributing
If you would like to contribute to this plugin, please go to the GitHub repository and make a personal fork of the development version. You can then make your changes and submit a pull request. I will happily review the code and then merge when we’re both happy.
Schermafbeeldingen
Installatie
The easy way
- Go to the Plugins Menu in WordPress
- Search for “Boostrap Banner”
- Click ‘Install’
- Activate the plugin
Manual Installation
- Download the plugin file from this page and unzip the contents
- Upload the
global-bootstrap-banner
folder to the/wp-content/plugins/
directory - Activate the
global-bootstrap-banner
plugin through the ‘Plugins’ menu in WordPress
Once Activated
- Make sure that your theme is loading Bootstrap CSS and Carousel javascript
- Add
echo global_bootstrap_banner();
to your theme or use the [global-bootstrap-banner] shortcode - Open the Customizer (Appearance > Customize, or Customize in the admin bar)
- Click “Banner Message” and add some content
Beoordelingen
Er zijn geen beoordelingen voor deze plugin.
Bijdragers & ontwikkelaars
“Global Bootstrap Banner” is open source software. De volgende personen hebben bijgedragen aan deze plugin.
BijdragersVertaal “Global Bootstrap Banner” naar jouw taal.
Interesse in de ontwikkeling?
Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.
Changelog
1.0
- Initial release.