Title: Blog Time Author: Scott Reilly Published: 7 сар 6, 2009 Last modified: 7 сар 29, 2021 --- Search plugins ![](https://ps.w.org/blog-time/assets/banner-772x250.png?rev=1008415) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/blog-time/assets/icon-128x128.png?rev=1008415) # Blog Time By [Scott Reilly](https://profiles.wordpress.org/coffee2code/) [Download](https://downloads.wordpress.org/plugin/blog-time.4.0.1.zip) * [Details](https://mn.wordpress.org/plugins/blog-time/#description) * [Reviews](https://mn.wordpress.org/plugins/blog-time/#reviews) * [Installation](https://mn.wordpress.org/plugins/blog-time/#installation) * [Development](https://mn.wordpress.org/plugins/blog-time/#developers) [Support](https://wordpress.org/support/plugin/blog-time/) ## Description This plugin adds a dynamic, functional clock to 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 can be clicked to update the time 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](https://momentjs.com/) for the JavaScript date handling library. Links: [Plugin Homepage](https://coffee2code.com/wp-plugins/blog-time/) | [Plugin Directory Page](https://wordpress.org/plugins/blog-time/) | [GitHub](https://github.com/coffee2code/blog-time/) | [Author Homepage](https://coffee2code.com) ### Template Tags The plugin provides one template tag for use in your theme templates, functions. php, or plugins. #### Functions * `` Returns and/or displays the formatted time for the site. #### Arguments * `$time_format` (string) Optional. PHP-style time format string. See https:// www.php.net/manual/en/datetime.format.php 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 * ` * ` ### 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()` жишээ: 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. жишээ: ``` /** * 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. жишээ: ``` /** * 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. жишээ: ``` // 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 * [[ * The blog time being displayed in the admin toolbar. * [[ * The “Blog Time” widget. * [[ * The “Blog Time Format” setting found on Settings -> General. ## Installation 1. Install via the built-in WordPress plugin installer or download and unzip `blog- time.zip` inside the plugins directory for your site (typically `wp-content/plugins/`) 2. Activate the plugin through the ‘Plugins’ admin menu in WordPress 3. Optional: Customize the time format used for displaying the time via the “Blog Time Format” setting found in Settings -> General. 4. Optional: 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? Under the site’s general admin settings — at Settings -> General — you’ll find a“ Blog Time Format” setting that accepts any valid PHP time format token. See https:// www.php.net/manual/en/datetime.format.php for more information regarding valid time format tokens. The widget and template tag also allow you to 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 hooking the `c2c_blog_time_format` filter and returning the desired time format. This takes precedence over the setting’s value. ### 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). Or JavaScript could be disabled in the browser. ### How do I know if this thing is working if the time matches my computer’s time? 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. Remember to change the time zone back to its proper value! ### Can the clock be enabled/disabled on a per-user basis? Yes, but only programmatically at the moment. Check out the docs for the `'c2c_blog_time_toolbar_widget_for_user'` filter for more information and a code example. ### 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? Via Settings -> General, you can set the “Blog Time Format” value to something like` M d, Y`, which results in a time format like “Jun 21, 2021”. See https://www.php. net/manual/en/datetime.format.php for other month, day, and year time format tokens. ### Does this plugin include unit tests? Yes. ## Reviews ![](https://secure.gravatar.com/avatar/81fccbb24d959bdab5667acebe9de2c6d3551ce67fe0ef51e0f768bc043ea9bd? s=60&d=retro&r=g) ### 󠀁[Simple. Does what it says in the tin](https://wordpress.org/support/topic/simple-does-what-it-says-in-the-tin/)󠁿 [afrikane](https://profiles.wordpress.org/afrikane/) 7 сар 30, 2021 Responsive support too. ![](https://secure.gravatar.com/avatar/a500597acdf8f128e55d33edd9591451b101540687073006f1eb150b08ec629a? s=60&d=retro&r=g) ### 󠀁[Works as expected](https://wordpress.org/support/topic/works-as-expected-419/)󠁿 [MrBrian](https://profiles.wordpress.org/mrbrian/) 12 сар 3, 2018 We process time sensitive orders with employees logging in throughout the world, and this was exactly what I was looking for! Displays the current time in the admin bar, and even updates the time without reloading the page. Not sure why several negative reviews.. works 100% for me. ![](https://secure.gravatar.com/avatar/436e751596e8f130707553509cf5696b9ef1739dec391bdbbb549515af1b72d0? s=60&d=retro&r=g) ### 󠀁[does not work as expected](https://wordpress.org/support/topic/does-not-work-as-expected-5/)󠁿 [](https://profiles.wordpress.org/millstreettown/) 11 сар 25, 2017 For us it did not work as anticipated (in the admin bar) It loaded the server time correctly, but a few seconds later it started using the local client time instead. This defeated the purpose of the clock, so i blocked the c2c_blog_time_active_clock filter, and while not dynamic, allows the time to be updated when clicked. Also, adding the seconds has helped. It is a useful tool, and is worth keeping, but only in its modified form. ![](https://secure.gravatar.com/avatar/4134712294ae013b803a8c9349754f252902975438bd5d004bb2e6d862abafb8? s=60&d=retro&r=g) ### 󠀁[Perfect](https://wordpress.org/support/topic/perfect-4495/)󠁿 [timwoolfson](https://profiles.wordpress.org/timwoolfson/) 10 сар 31, 2017 Works just great. ![](https://secure.gravatar.com/avatar/18fd75eb9c9bae775492e80249a9b505607c1fef305d65d96324ee0111b66689? s=60&d=retro&r=g) ### 󠀁[Also not sure why people don't like this. Useful.](https://wordpress.org/support/topic/also-not-sure-why-people-dont-like-this-useful/)󠁿 [zanzaboonda](https://profiles.wordpress.org/zanzaboonda/) 9 сар 3, 2016 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. ![](https://secure.gravatar.com/avatar/04864f46e924f350df9a987d929579eb54d48c99962b39aa32e8c36d32aabd3a? s=60&d=retro&r=g) ### 󠀁[Works Just fine … I like it](https://wordpress.org/support/topic/works-just-fine-i-like-it/)󠁿 [seamstobesew](https://profiles.wordpress.org/seamstobesew/) 9 сар 3, 2016 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. [ Read all 8 reviews ](https://wordpress.org/support/plugin/blog-time/reviews/) ## Contributors & Developers “Blog Time” is open source software. The following people have contributed to this plugin. Contributors * [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/) “Blog Time” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/blog-time/contributors) for their contributions. [Translate “Blog Time” into your language.](https://translate.wordpress.org/projects/wp-plugins/blog-time) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/blog-time/), check out the [SVN repository](https://plugins.svn.wordpress.org/blog-time/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/blog-time/) by [RSS](https://plugins.trac.wordpress.org/log/blog-time/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 4.0.1 (2021-07-29) * Fix: Ensure inline script is only output once per pageload to prevent issue when blog time appears on page multiple times, which resulted in all acting as if static * New: Add `reset()` to restore memoized class variables to default values * Change: Note compatibility through WP 5.8+ #### 4.0 (2021-06-19) Highlights: This recommended release introduces a setting for configuring the blog time format, adds support for the ‘T’ timezone format token, updates the bundled Moment.js library, improves documentation, restructures unit test files, notes compatibility through 5.7+, and incorporates numerous behind-the-scenes tweaks. Details: * New: Add setting for configuring time format - New: Add “Blog Time Format” setting to the “General Settings” page. - New: Add link to setting from plugin’s action links - New: Show default time format when setting is blank - New: Show inline notice below setting when time format is filtered, and indicate that it takes precedence over setting - New: Add `initialize_setting()`, `allowed_options()`, `display_option()`, ` plugin_action_links()`, and `is_wp_55_or_later()` - New: Add new screenshot * Change: Use default time format if parameter or filter attempts to configure an empty string or non-string value * Fix: Add support for the ‘T’ timezone format character to the dynamic clock ( support for which was removed from Moment.js awhile ago) * Change: Update bundled Moment.js to v2.29.1 - 2.29.1: https://gist.github.com/marwahaha/cc478ba01a1292ab4bd4e861d164d99b - 2.29.0: https://gist.github.com/marwahaha/b0111718641a6461800066549957ec14 - 2.28.0: https://gist.github.com/marwahaha/028fd6c2b2470b2804857cfd63c0e94f - 2.27.0: https://gist.github.com/marwahaha/5100c9c2f42019067b1f6cefc333daa7 * Removed: Dropped support for long-deprecated `'blog_time_format'` filter. Use`' c2c_blog_time_format'` instead. * Change: Switch to use of `wp_add_inline_script()` instead of `wp_localize_script()` * Change: Add optional `$exit` arg to `report_time()` to allow not exiting after outputting the time * Change: Improve some inline documentation * Change: Improve documentation and formatting in readme.txt * Change: Note compatibility through WP 5.7+ * Change: Update URLs to PHP documentation for datetime formatting * Change: Update copyright date (2021) * Unit tests: - Change: Restructure unit test directories and files into `tests/` top-level directory * Change: Move `bin/` into `tests/` * Change: Move `tests/bootstrap.php` into `tests/phpunit/` * Change: In bootstrap, store path to plugin file constant so its value can be used within that file and in test file * Change: Move `tests/*.php` into `tests/phpunit/tests/` * Change: Remove ‘test-‘ prefix from unit test files * Change: Rename `phpunit.xml` to `phpunit.xml.dist` per best practices - New: Add tests for `enqueue_js()`, `report_time()`, `admin_bar_menu()` * New: Add a few more possible TODO items #### 3.6.2 (2020-06-11) * Change: Update Moment.js to v2.26.0 - 2.26.0: https://gist.github.com/marwahaha/0725c40740560854a849b096ea7b7590 - 2.25.3: https://github.com/moment/moment/blob/develop/CHANGELOG.md#2253 - 2.25.2: https://github.com/moment/moment/blob/develop/CHANGELOG.md#2252 - 2.25.1: https://github.com/moment/moment/blob/develop/CHANGELOG.md#2251 - 2.25.0: https://gist.github.com/ichernev/6148e64df2427e455b10ce6a18de1a65 * Change: Remove `is_wp_login()` since it is no longer necessary * Change: Remove redundant check in `enqueue_js()` that is already performed in` show_in_toolbar_for_user()` * New: Add TODO.md and move existing TODO list from top of main plugin file into it * Change: Note compatibility through WP 5.4+ * Change: Update links to coffee2code.com to be HTTPS * Change: Add an FAQ and tweak docs in readme.txt * Unit tests: - New: Add tests for `display_time()` - Change: Add more tests for `get_time_format()` - Change: Use HTTPS for link to WP SVN repository in bin script for configuring unit tests (and delete commented-out code) - Change: Remove unnecessary unregistering of hooks in `tearDown()` _Full changelog is available in [CHANGELOG.md](https://github.com/coffee2code/blog-time/blob/master/CHANGELOG.md)._ ## Meta * Version **4.0.1** * Last updated **5 жил ago** * Active installations **600+** * WordPress version ** 4.6 or higher ** * Tested up to **5.8.13** * Languages * [English (US)](https://wordpress.org/plugins/blog-time/) ба [Russian](https://ru.wordpress.org/plugins/blog-time/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/blog-time) * Tags * [blog](https://mn.wordpress.org/plugins/tags/blog/)[clock](https://mn.wordpress.org/plugins/tags/clock/) [datetime](https://mn.wordpress.org/plugins/tags/datetime/)[server](https://mn.wordpress.org/plugins/tags/server/) [time](https://mn.wordpress.org/plugins/tags/time/) * [Advanced View](https://mn.wordpress.org/plugins/blog-time/advanced/) ## Ratings 3.6 out of 5 stars. * [ 4 5-star reviews ](https://wordpress.org/support/plugin/blog-time/reviews/?filter=5) * [ 1 4-star review ](https://wordpress.org/support/plugin/blog-time/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/blog-time/reviews/?filter=3) * [ 2 2-star reviews ](https://wordpress.org/support/plugin/blog-time/reviews/?filter=2) * [ 1 1-star review ](https://wordpress.org/support/plugin/blog-time/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/blog-time/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/blog-time/reviews/) ## Contributors * [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/blog-time/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6ARCFJ9TX3522)