Blog Time

Description

This plugin adds a dynamic, functional clock to the the admin bar (at top of all admin pages) to show the server time for the blog. The clock automatically updates as time passes, as you would expect of a digital clock.

This plugin also supports a static mode which puts a timestamp string at the top of all admin pages instead of the dynamic clock. This static admin time widget is AJAX-ified so that if you click the timestamp, it updates in place (without a page reload) to show the new current server time.

Also provided is a “Blog Time” widget providing the same functionality as the admin widget, but for your sidebars. You may also utilize the plugin’s functionality directly within a theme template via use of the template tag c2c_blog_time().

NOTE: For the front-end widget, if the “Use dynamic clock?” configuration option is unchecked, this plugin generates a timestamp and NOT a clock. The time being displayed is the time of the page load, or if clicked, the time when the widget last retrieved the time. It won’t actively increment time on the display. By default the widget displays a dynamic clock that does increment time.

This is most useful to see the server/blog time to judge when a time sensitive post, comment, or action would be dated by the blog (i.e. such as monitoring for when to close comments on a contest post, or just accounting for the server being hosted in a different timezone). Or, when used statically as a timestamp and not a clock, it can indicate/preserve when the page was loaded.

Thanks to Moment.js for the JavaScript date handling library.

Links: Plugin Homepage | Plugin Directory Page | Author Homepage

Template Tags

The plugin provides one template tag for use in your theme templates, functions.php, or plugins.

Functions

  • <?php function c2c_blog_time( $time_format = '', $echo = true ) ?>
    Gets the formatted time for the site.

Arguments

  • $time_format (string)
    Optional. PHP-style time format string. See https://php.net/date for more info. Default is ” (which, unless otherwise modified, uses the default time forat: ‘g:i A’).

  • $echo (bool)
    Optional. Echo the template info? Default is true.

Examples

  • <?php // Output the site's current time.
    c2c_blog_time();
    ?>

  • <?php // Retrieve the value for use in code, so don't display/echo it.
    $site_date = c2c_blog_time( 'M d, Y', false );
    ?>

Filters

The plugin exposes four filters for hooking. Typically, customizations utilizing these hooks would be put into your active theme’s functions.php file, or used by another plugin.

c2c_blog_time (filter)

The ‘c2c_blog_time’ hook allows you to use an alternative approach to safely invoke c2c_blog_time() in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.

Arguments:

  • same as for c2c_blog_time()

Example:

Instead of:

<?php c2c_blog_time(); ?>

Do:

<?php echo apply_filters( 'c2c_blog_time', '' ); ?>

c2c_blog_time_format (filter)

The ‘c2c_blog_time_format’ hook allows you to customize the default format for the blog time. By default this is ‘g:i A’ (though this may be different if modified by localization).

Arguments:

  • $format (string): The default format for the blog time.

Example:

/**
 * Change the default blog time string
 *
 * @param string $format The default time format.
 * @return string
 */
function change_blog_time_format( $format ) {
    return 'b, g:i A';
}
add_filter( 'c2c_blog_time_format', 'change_blog_time_format' );

c2c_blog_time_toolbar_widget_for_user (filter)

The ‘c2c_blog_time_toolbar_widget_for_user’ hook allows you to control if the admin toolbar clock widget should be shown, on a per-user basis. By default the admin toolbar clock is shown to everyone who can see the admin toolbar.

Arguments:

  • $shown (boolean): Whether the admin toolbar clock widget should be shown. Default of true.

Example:

/**
 * Only show the admin toolbar clock for the 'boss' user.
 *
 * @param $show bool Status of whether the admin toolbar clock should be shown.
 * @return bool
 */
function restrict_blog_time_widget_appearance( $show ) {
    return 'boss' == get_current_user()->user_login;
}
add_filter( 'c2c_blog_time_toolbar_widget_for_user', 'restrict_blog_time_widget_appearance' );

c2c_blog_time_active_clock (filter)

The ‘c2c_blog_time_active_clock’ hook returns the boolean value indicating if the Javascript-powered dynamic clock introduced in v2.0 should be enabled or if instead the v1.x era behavior of a static timestamp that can be clicked to update the timestamp via AJAX should be enabled. By default the dynamic clock is enabled.

Arguments:

  • $allow (boolean): Boolean indicating if the admin widget should be a dynamic clock. Default is true.

Example:

// Disable the dynamic clock and use the static timestamp (whcih can be clicked to update the time via AJAX) instead.
add_filter( 'c2c_blog_time_active_clock', '__return_false' );

Screenshots

  • A screenshot of the blog time being displayed in the admin toolbar.
  • A screenshot of the 'Blog Time' widget.

Installation

  1. Unzip blog-time.zip inside the /wp-content/plugins/ directory for your site (or install via the built-in WordPress plugin installer)
  2. Activate the plugin through the ‘Plugins’ admin menu in WordPress
  3. Optionally use the ‘Blog Time’ widget or the template tag c2c_blog_time() in a theme template file to display the blog’s time at the time of the page’s rendering.

FAQ

How do I customize the format of the time string?

The widget and template tag allow you specify a time format directly. The default value for the time format, and the one used by the display of the blog time in the static admin widget, can be overridden by adding a filter to ‘c2c_blog_time_format’ and returning the desired time format. See https://php.net/date for more information regarding the time format.

Why is the time not changing in the sidebar widget?

The widget’s “Use dynamic clock?” configuration setting may not be checked (which it is by default).

The time matches my computer’s time; how do I know this thing is working?

Your machine may well be synced with the server’s clock. One test you can perform is to change the blog’s time zone (under Settings -> General). The blog’s time will then be set to a different hour, which should then be reflected by the widget.

How do I go back to having the legacy static timestamp as opposed to the dynamic clock?

See the Filters section for the c2c_blog_time_active_clock filter, which includes an example line of code you’ll need to add to your theme.

How can I show the blog’s date instead of the time?

You could do something like this:

/* Insert the following code in the active theme's functions.php or, even better,
in a site-specific plugin. */

// Disable dynamic clock since a clock is not being displayed.
add_filter( 'c2c_blog_time_active_clock', '__return_false' );
// Change the datetime format string used by the plugin.
add_filter( 'c2c_blog_time_format', 'my_blog_time_format' );

/**
 * Returns a custom datetime format string for default use
 * by the Blog Time plugin.
 *
 * See https://php.net/date for more information regarding the time format.
 *
 * @param string $format Original format string (ignored)
 * @return string New format string
 */
function my_blog_time_format( $format ) {
    return 'M d, Y';
}

Reviews

Also not sure why people don't like this. Useful.

Works just fine. My only complaint is that the widget header does not appear, and there is no space between it and the next widget (I semi-resolved this by putting a paragraph tag in the “text after” field, but it didn’t quite work. Otherwise, 5 stars for me.

Works Just fine … I like it

I’m surprised that this hasn’t had good reviews. It works just fine, adds a little clock right by your admin name in title bar so you can always see your blog time.

Between having to deal with all the “timing” stuff we need to in WordPress, this little addon is quite nice to have.

Thank you.

Botched Plugin

Though the concept for the plugin was nice and perfect for what I was looking for, unfortunately it didn’t work. Time displayed was not accurate and I also felt that it somehow affected the load time for my site. Badly optimized, I has say.

Read all 6 reviews

Contributors & Developers

“Blog Time” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Blog Time” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

3.5 (2017-01-21)

  • New: Add ability for dynamic clock to honor custom time format.
    • Package Moment.js (v2.17.1), a datatime library for JS.
    • Add map_php_time_format_to_momentjs() to remap PHP time format tokens to Moment.js time format tokens.
    • Simplify blog-time.js to defer time handling to Moment.js.
    • Make time format and UTC offset available for JS usage.
    • Output time format when customized (such as via widget or template tag) in markup for use by JS.
    • Remove documentation indicating dynamic clock does not honor custom time format.
  • New: Add clock dashicon before adminbar time widget.
  • Change: Determine the dynamic clock update time interval based on time format string to reduce update frequency when possible.
  • Change: Move CSS into enqueued file.
    • CSS is now in file css/blog-time.css.
    • Remove add_css().
  • Change: Extract time format related code out of display_time() and into new get_time_format().
  • Chnage: Add context to handlers for time format and display.
    • Add $context arg to get_format_time() and display_time().
    • Add $context arg to ‘c2c_blog_time_format’ filter.
    • Add ‘context’ as configuration parameter for add_widget().
    • Set context everywhere context can be set.
  • Change: Update widget framework to 012, bumping c2c_BlogTimeWidget to 007.
  • Bugfix: Add ‘.ab-item’ class to time link so it gets proper styles in adminbar when JS is disabled.
  • Change: Prevent dynamic adminbar clock from getting hover styling as if it were a link.
  • Change: Ensure linked timestamp in static widget does not abide by a:visited styling.
  • Change: Widget: Move register_c2c_BlogTimeWidget() to ‘c2c_BlogTimeWidget::register_widget()`.
  • Change: Sanitize the translated string used in an attribute.
  • Change: Enable more error output for unit tests.
  • Change: Default WP_TESTS_DIR to /tmp/wordpress-tests-lib rather than erroring out if not defined via environment variable.
  • Change: Note compatibility through WP 4.7+.
  • Change: Remove support for WordPress older than 4.6 (should still work for earlier versions though).
  • Change: Add ‘Template Tags’ section to FAQ.
  • Change: Minor inline documentation improvements and reformatting.
  • Change: Update copyright date (2017).
  • Change: Update both screenshots.

3.4 (2016-01-15)

  • Bugfix: Properly output markup around widget.
  • Change: Update widget framework to 011:
    • Change class name to c2c_BlogTime_Widget_011 to be plugin-specific.
    • Set textdomain using a string instead of a variable.
    • Remove load_textdomain() and textdomain class variable.
    • Formatting improvements to inline docs.
  • Change: Add support for language packs:
    • Set textdomain using a string instead of a variable.
    • Don’t load textdomain from file.
    • Remove .pot file and /lang subdirectory.
  • Change: Explicitly declare methods in unit tests as public or protected.
  • Change: Minor improvements to inline docs and test docs.
  • Add: Create empty index.php to prevent files from being listed if web server has enabled directory listings.
  • Change: Note compatibility through WP 4.4+.
  • Change: Update copyright date (2016).

3.3.2 (2015-08-22)

  • Change: Discontinue use of PHP4-style constructor invocation of WP_Widget to prevent PHP notices in PHP7.
  • Use DIRECTORY_SEPARATOR in path for include files instead of hard-coded /.
  • Change: Update widget framework to version 010.
  • Change: Minor widget file header reformatting.
  • Change: Update widget to version 005.
  • Change: Note compatibility through WP 4.3+.
  • New: Add unit tests for widget class versions.
  • New: Add c2c_BlogTimeWidget::version() to get version of the widget class.

3.3.1 (2015-03-12)

  • Revert back to using dirname(__FILE__); DIR is only PHP 5.3+

3.3 (2015-02-16)

  • Add unit tests
  • Explicitly declare all class methods static
  • Output dynamic clock time components more efficiently
  • Use DIR instead of dirname(__FILE__)
  • Various inline code documentation improvements (spacing, punctuation)
  • Use phpDoc formatting for example code in readme
  • Note compatibility through WP 4.1+
  • Update copyright date (2015)
  • Regenerate .pot

3.2 (2014-10-15)

  • Update widget to use C2C_Widget base class (v008)
  • Remove appending of random number to plugin JS version when enqueuing
  • Add check to prevent execution of code if file is directly accessed
  • Minor plugin header reformatting
  • Minor code reformatting (spacing, bracing)
  • Change documentation links to wp.org to be https
  • Note compatibility through WP 4.0+
  • Update copyright date (2014)
  • Add assets directory to plugin repository checkout
  • Add banner image
  • Add plugin icon
  • Move screenshots into repo’s assets directory
  • Update screenshots
  • Update donate link
  • Regenerate .pot
  • Update some out-of-date documentation

3.1 (not publicly released)

  • Slight dynamic clock reimplementation that should fix DST off-by-one-hour bug
  • Add filter ‘c2c_blog_time_format’
  • Deprecate support for ‘blog_time_format’ filter (use ‘c2c_blog_time_format’ instead)
  • Use string instead of variable to specify translation textdomain
  • Re-license as GPLv2 or later (from X11)
  • Add ‘License’ and ‘License URI’ header tags to readme.txt and plugin file
  • Remove ending PHP close tag
  • Note compatibility through WP 3.4+

3.0

  • Move admin widget into admin toolbar
  • Discontinue inclusion of jqClock jQuery plugin and instead use custom developed code
  • Fix bug with incorrect hour being shown for dynamic clock
  • Change JavaScript to detect if ‘c2c-blog-time-dynamic’ class is present on span to determine if clock should be dynamic
  • Add support for dynamic clock in sidebar widget
  • Support multiple occurrences of widget (admin and/or sidebar) on single page
  • Update widget to use C2C_Widget base class (v005)
  • Clear link title attribute when using dynamic clock since instructions for clicking to update don’t apply
  • Enqueue JavaScript (which has been moved into new js/blog-time.js)
  • Enqueue JavaScript on front-end also if admin toolbar or widget are being shown
  • Add filter ‘c2c_blog_time_toolbar_widget_for_user’ for per-user control of admin toolbar widget (default is true)
  • Remove support for ‘c2c_blog_time_js_insert_action’ filter
  • Remove support for ‘c2c_blog_time_target’ filter
  • Add version() to return plugin version
  • Add admin_bar_menu(), is_wp_login(), show_in_toolbar_for_user()
  • Remove load_textdomain(), add_js()
  • Remove support for deprecated blog_time()
  • Code reformatting (function reorganization)
  • Note compatibility through WP 3.3+
  • Drop support for versions of WP older than 3.3
  • Create ‘lang’ subdirectory and move .pot file into it
  • Regenerate .pot
  • Change description
  • Add ‘Domain Path’ directive to top of main plugin file
  • Add link to plugin directory page to readme.txt
  • Update screenshots (now based on WP 3.3)
  • Update copyright date (2012)

2.0.1

  • Fix bug relating to showing time in incorrect timezone

2.0

  • Integrate jqClock to provide dynamic clock in admin section
  • Add filter ‘c2c_blog_time_js_insert_action’ to allow overriding default JS insertion method used to insert admin widget onto page
  • Add filter ‘c2c_blog_time_target’ to allow overriding target relative to which the JS insertion of the admin widget is performed
  • Add filter ‘c2c_blog_time_active_clock’ to allow disabling dynamic Javascript clock and use v1.x era static timestamp (that can be click to update time)
  • Display admin blog time widget even if JS is disabled
  • Create add_js() and use it to output JS (code moved from add_widget())
  • Hook add_widget() to ‘in_admin_header’ action
  • Add additional CSS rules to maintain appearance in latest WP
  • Remove unused JS variable wpcontenturl
  • Note compatibility through WP 3.2+
  • Drop support for versions of WP older than 3.1
  • Tiny code formatting change (spacing)
  • Documentation updates to reflect recent changes
  • Add Credits section to readme.txt
  • Fix plugin homepage and author links in description in readme.txt

1.2

  • Fix UI compatibility issue introduced by WP 3.1
  • Use class variable to store ID for the admin widget (and change it from previous value)
  • Switch from object instantiation to direct class invocation
  • Explicitly declare all functions public and class variables private
  • Move template tag functions and class initialization call within primary if(class_exists())
  • Output CSS in a single line
  • Rename widget class from ‘BlogTimeWidget’ to ‘c2c_BlogTimeWidget’
  • Note compatibility through WP 3.1+
  • Update copyright date (2011)

1.1

  • Rename blog_time() template tag to c2c_blog_time()
  • Deprecate blog_time() template tag, but retain it for backwards compatibility
  • Add hook ‘c2c_blog_time’ (filter) to respond to the function of the same name so that users can use the apply_filters() notation for invoking template tag
  • Move most of the code in constructor into init()
  • Invoke add_widget() against ‘admin_print_footer_scripts’ hook rather than ‘admin_footer’
  • Fix PHP warnings/notices in widget code
  • Full support for localization
  • Rename class from ‘BlogTime’ to ‘c2c_BlogTime’
  • Note compatibility with WP 2.9+, 3.0+
  • Drop support for versions of WP older than 2.8
  • Assign object instance to global variable, $c2c_blog_time as global, to allow for external manipulation
  • Remove docs from top of plugin file (all that and more are in readme.txt)
  • Minor code reformatting (spacing)
  • Add PHPDoc documentation
  • Add package info
  • Remove trailing whitespace in header docs
  • Update copyright date
  • Add Changelog, Filters, and Upgrade Notice sections to readme.txt
  • Add .pot file

1.0

  • Initial release