WordPress.org

Plugin Directory

Test out the new Plugin Directory and let us know what you think.

Blog Time

Display the time according to your blog via an admin toolbar widget, a sidebar widget, and/or a template tag.

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' );

Requires: 4.6 or higher
Compatible up to: 4.7.2
Last Updated: 3 weeks ago
Active Installs: 700+

Ratings

2.8 out of 5 stars

Support

1 of 1 support threads in the last two months have been marked resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,4,4
0,1,0
100,2,2
100,1,1
0,1,0
100,1,1
100,1,1
100,1,1