Description
EMC2 Alert Boxes uses jQuery and HTML5 animations to provide a great-looking, simple and functional alerting system. Alert boxes can be placed using the [emc2alert]
shortcode or by calling the $().emc2alert()
jQuery function!
Check the demo at http://alert.emc2innovation.com !
Easy to use! Insert a shortcode on any page using a quick-create TinyMCE icon, or create alerts on the fly using jQuery:
Shortcode: [emc2alert]This is some text![/emc2alert]
-or-
jQuery: $('body').emc2alert({ text:"This is some text!" });
Advanced Usage
Shortcode
[emc2alert type=”success” style=”normal” width=”300px” position=”top” wpbar=”auto” visible=”visible” closebtn=”1″ title=”Introducing…” animate=”true”]A great way to alert your visitors![/emc2alert]
Defaults:
- type: “info” – “success”, “warning”, “error” also available
- style: NULL – “normal” displays as block at shortcode location, or “fixed” for top or bottom of page
- width: NULL – accepts position with units, ie “300px”, “100%” or “5em”
- position: “top” – If style=”fixed”, position can be set to top or “bottom” of page
- wpbar: “auto” – Auto-detects WP Admin Bar. Can be set to TRUE or FALSE as well to set compensation.
- visible: TRUE – Set to FALSE to hide
- closebtn: FALSE – Set to TRUE to add a close button to the box
- title: “Alert Title” – Box title
- animate: FALSE – Set to TRUE to enable slideUp() and slideDown() jQuery animations on open and close!
jQuery
$('body').emc2alert({ // Prepends Alert Box to 'body' element
title: "Your Title", // or $('myTitleDiv').html()
text: "Your Message", // or $('myMsgDiv').html()
type: "info", // 'info', 'warning', 'error', 'success' - determines bg colors
style: "normal", // 'normal', 'fixed' - in page or fixed to top or bottom
visible: true, // true, false - hides if necessary
position: "top", // 'top', 'bottom' - positions box on page
width: null, // '100%', '960px' - specify units
closebtn: false, // true, false - displays close button in corner
wpbar: false, // true, false, 'auto' - adds top margin to avoid admin bar, with auto-detect
animate: false // true, false - adds open/close animation
});
BIG thanks to Red Team Design’s work!
To Do list:
- Add animate argument to TinyMCE shortcode generator
- Add custom class field to shortcode
- Add a settings page
- Make plugin child-theme compatible
- Add !important styles to CSS
Known bugs:
- None yet! Please post at http://alert.emc2innovation.com if you find one.
Configuration
EMC2 Alert Boxes will work straight out of the box. Everything is configured from the shortcode or jQuery call! Post in the forums if you want to see a feature added.
If you are editing with the TinyMCE WYSIWYG interface, you will notice an orange triangle icon appear. This is a quick-build shortcode generator in case you forget exactly
Screenshots
Installation
Installation is straighforward:
- Upload the
/emc2-alert-boxes/
folder to your/wp-content/plugins/
directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Add shortcode to page or call function with jQuery
FAQ-e
- Why do you take forever to respond?
-
I work to eat. If you want a faster response, consider donating or hiring me for a job!
- Are you available for help?
-
I might be able to help you – it totally depends on my schedule and workload. Send me an email! hello@emc2innovation.com. You could also post here on the forums.
If you want to jump the gun, make me a temporary user (with that email up there) and I will be more inclined to give you a hand. In return for my help, all I ask for is a rating! 🙂
Reviews
There are no reviews for this plugin.
Contributors & Developers
“EMC2 Alert Boxes” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “EMC2 Alert Boxes” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0
- Helloooooo World.
1.1
- Added register_activation hook
1.2
- Goofed on an SVN update
1.3
- Fixed a remote call to make plugin standards-compliant