Description
Specify a time to show (and start) the count down, and an end time to count down to.
Ideal for displaying a message such as “For same day dispatch, order within 1h 37m”.
Screenshots
Installation
This section describes how to install the plugin and get it working.
- Upload the plugin files to the
/wp-content/plugins/dispatch-countdown
directory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress
- Use the WooCommerce->Settings->Product Settings->Dispatch Countdown screen to configure the plugin
FAQ
- How do I move the countdown?
-
The countdown must be called at a point where
global $product
is available, so
make sure to call this plugin after WooCommerce has loaded. To move the
countdown, you can remove the action and then add it back wherever you want:/** * Move dispatch countdown */ function your_theme_move_dispatch_countdown() { // Check the class exists if ( ! class_exists( 'Dispatch_Countdown' ) ) { return; } // Get the current instance $dispatch_countdown = Dispatch_Countdown::get_public_instance(); // Remove the action remove_action( 'woocommerce_before_single_product', array( $dispatch_countdown, 'display_countdown' ) ); // Add the action back where you like add_action( 'your_theme_before_main_container', array( $dispatch_countdown, 'display_countdown' ) ); } add_action( 'init', 'your_theme_move_dispatch_countdown' );
Replacing
your_theme_before_main_container
with whichever hook you wish - How do I change the HTML output?
-
There are a few filters available to override certain parts of the output. The
main filter isdispatch_countdown_content
and can be used as follows:/** * Change countdown HTML output * * NOTE: You must include an element with the id of dispatch-countdown__time`
* as javascript uses this to update the countdown.
*/
function your_theme_dispatch_countdown_content ( $html, $wording, $product, $countdown ) {
// Add the wording
$countdown_html = esc_html( $wording );
// Add the element for js to update – be sure to include the product ID as shown
$countdown_html .= ‘ ‘;
// Add the countdown text
$countdown_html .= esc_html( $countdown );
// Close the countdown element
$countdown_html .= ”;return $countdown_html;
}
add_filter( ‘dispatch_countdown_content’, ‘your_theme_dispatch_countdown_content’, 10, 4 );`
Reviews
Contributors & Developers
“Dispatch Countdown” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Dispatch Countdown” 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.7
- Update docs
- Add POT file for translations
- Adds filters to main output
1.0.6
- Allow dispatch countdown hook to be overridden
- Update documentation with how to move
1.0.5
- Remove some dist files
1.0.4
- No changes – deployment tests only
1.0.3
- No changes – deployment tests only
1.0.2
- Added icons
- Added screenshots
1.0.1
- Updated readme.txt to adhere to WordPress standards
1.0.0
- Initial release.