About 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....

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 | GitHub | Author Homepage

Template Tags

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

Functions

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

c2c_blog_time(); ?>
$site_date = c2c_blog_time( 'M d, Y', false ); ?>

Hooks

The plugin exposes four filters for hooking. Code using these filters should ideally be put into a mu-plugin or site-specific plugin (which is beyond the scope of this readme to explain). Less ideally, you could put them in your active theme’s functions.php file.

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:

Do:

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

Performance

Memory Usage

Average memory usage is 35.85 KB
This is less than 99% plugins

Page Speed

Average page loading time is
increased by 0.03 s
This is faster than 99% plugins

Speed Test Benchmark

Before plugin activation
After plugin activation

Benchmark

Change

Average Change

- 0.03s

/(front page)

+ 0.13s

/wp-admin/edit-comments.php

- 0.02s

/wp-admin/edit-tags.php?taxonomy=category

+ 0.1s

/wp-admin/edit.php

- 0.02s

/wp-admin/index.php

- 0.06s

/wp-admin/media-new.php

- 0.08s

/wp-admin/options-discussion.php

- 0.01s

/wp-admin/options-writing.php

+ 0.01s

/wp-admin/post-new.php

+ 0.12s

/wp-admin/post-new.php?post_type=page

- 0.12s

/wp-admin/upload.php

- 0.39s

Memory Usage Benchmark

Before plugin activation
After plugin activation

Benchmark

Change

Average Change

+ 35.85KB

/ (front page)

+ 4.03KB

/wp-admin/edit-comments.php

+ 3.55KB

/wp-admin/edit-tags.php?taxonomy=category

+ 3.89KB

/wp-admin/edit.php

+ 11.88KB

/wp-admin/index.php

+ 3.78KB

/wp-admin/media-new.php

+ 3.73KB

/wp-admin/options-discussion.php

+ 3.85KB

/wp-admin/options-writing.php

+ 1.78KB

/wp-admin/post-new.php

+ 4.86KB

/wp-admin/post-new.php?post_type=page

+ 4.31KB

/wp-admin/upload.php

+ 3.63KB

User Rating of Blog Time from WP Hive Users

Overall Quality

Measures the overall quality

Ease of Use

How easy it is to use?

Quality of Support

Satisfied or not?

Value for Money

Is it good bang for the buck?

Features

Is it feature riched?

Rate Now

Stats

Download Statistics

Plugin Version Usage

Database Tables

The plugin has added 0 additional options to your WordPress.

WP-Options

The plugin has added 1 additional options to your WordPress website.

widget_blog-time

Blog Time

Version : 4.0.1

Want to write review?

The plugin ran into some errors

20K

800

13 years

0.0%

1

8

00

00

About Blog Time

Description

Template Tags

Functions

Arguments

Examples

Hooks

Performance

Memory Usage

Page Speed

Speed Test Benchmark

Pages

Benchmark

Change

Memory Usage Benchmark

Pages

Benchmark

Change

User Rating of Blog Time from WP Hive Users

Overall Quality

Ease of Use

Quality of Support

Value for Money

Features

Stats

Download Statistics

Plugin Version Usage

More

Database Tables

WP-Options

Errors

Frequently Updated

Show Off Your Plugin

PHP 7.4.8

WP 5.8

Love using this plugin?

Ratings & Reviews

Like what you see?

Social Reviews and Recommendations Widgets Review Write a Review

Are you an author of this plugin?

Stina Gunnarsdottir

Overall

Easy of Use

Features

Quality of Support

Value for Money

Changelog

Are you an author
of this plugin?