{"id":29790,"date":"2014-05-30T05:09:44","date_gmt":"2014-05-30T05:09:44","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/localize-time\/"},"modified":"2014-05-30T05:17:31","modified_gmt":"2014-05-30T05:17:31","slug":"localize-time","status":"publish","type":"plugin","link":"https:\/\/bal.wordpress.org\/plugins\/localize-time\/","author":9321132,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"1.0.0","tested":"3.9.40","requires":"3.0.1","requires_php":"","requires_plugins":"","header_name":"Localize Time","header_author":"JB Christy <JBChristy614@gmail.com>","header_description":"","assets_banners_color":"","last_updated":"2014-05-30 05:17:31","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/JBChristy\/localize-time","header_author_uri":"","rating":3.3,"author_block_rating":0,"active_installs":40,"downloads":2965,"num_ratings":3,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.0.0":"<p>Initial version of plugin<\/p>"},"ratings":{"1":1,"2":0,"3":0,"4":1,"5":1},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1539087","resolution":"2","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1539087","resolution":"1","location":"plugin"}},"screenshots":{"1":"Examples of entering the shortcode.","2":"What the shortcode displays in the US Pacific timezone."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[22803,1356,9698],"plugin_category":[],"plugin_contributors":[88880],"plugin_business_model":[],"class_list":["post-29790","plugin","type-plugin","status-publish","hentry","plugin_tags-local-time","plugin_tags-time","plugin_tags-timezone","plugin_contributors-jbchristy","plugin_committers-jbchristy"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/localize-time.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/localize-time\/trunk\/screenshot-1.png?rev=1539087","caption":"Examples of entering the shortcode."},{"src":"https:\/\/ps.w.org\/localize-time\/trunk\/screenshot-2.png?rev=1539087","caption":"What the shortcode displays in the US Pacific timezone."}],"raw_content":"<!--section=description-->\n<p>This WordPress plugin adds the <strong><code>[localize_time]<\/code><\/strong> shortcode. The shortcode allows an author\nto enter a date and time in any timezone. The shortcode displays the original time with\ntimezone, followed by the same time in the user's timezone, formatted correctly for the\nuser's locale. This is useful for announcing live events, e.g. a live online streaming\nevent, to widely dispersed audiences.<\/p>\n\n<p>The date and time to be displayed are entered as the shortcode's content, i.e. between the\n<strong><code>[localize_time]<\/code><\/strong> and <strong><code>[\/localize_time]<\/code><\/strong> tags. The time can be specified in almost\nany format that's recognizable as a date and time.<\/p>\n\n<p>The shortcode takes the following options:<\/p>\n\n<ul>\n<li><strong><code>tz<\/code><\/strong> - the timezone the shortcode's content is in. If this option is omitted, it defaults\nto the site's timezone. Timezones are specified in any format recognized by\n<a href=\"http:\/\/www.php.net\/manual\/en\/timezones.php\">PHP's DateTimeZone<\/a>.<\/li>\n<li><strong><code>fmt<\/code><\/strong> - a format string specifying how the original time should be displayed. If omitted,\nit defaults to the site's date format followed by the site's time format followed by the\ntimezone. To output the original time exactly as entered (with the timezone), specify\n<strong><code>fmt=\"orig\"<\/code><\/strong>. Or you can enter a format string using the same codes that are used on\nWordPress's General Settings tab. See\n<a href=\"http:\/\/codex.wordpress.org\/Formatting_Date_and_Time\">full documentation on date \/ time format strings here<\/a>.<\/li>\n<li><strong><code>before_local<\/code><\/strong> - the string to precede the local time. Defaults to ' ('<\/li>\n<li><strong><code>after_local<\/code><\/strong>  - the string to follow  the local time. Defaults to ')'<\/li>\n<\/ul>\n\n<h3>Examples<\/h3>\n\n<p>Below are examples of using the shortcode. For these examples, the site's timezone is set to America\/New_York (EST-5EDT) and the user is in the America\/Los_Angeles (PST-8PDT) timezone.<\/p>\n\n<ul>\n<li><p>Local time is in a different year and month from original time:<br \/>\n  [localize_time]1\/1\/2014 1:00 am[\/localize_time]<br \/>\noutputs:<br \/>\nJanuary 1, 2014 1:00 am EST (12\/31\/2013, 10:00:00 PM PST)<\/p><\/li>\n<li><p>Specify a time in timezone different from the site's:<br \/>\n  [localize_time tz=\"Europe\/Paris\" ]July 14, 2014 19:00[\/localize_time]<br \/>\noutputs:<br \/>\nJuly 14, 2014 7:00 pm CEST (7\/14\/2014, 10:00:00 AM PDT)<\/p><\/li>\n<li><p>Specify a format for the original time:<br \/>\n  [localize_time fmt=\"m\/d\/Y g:i A T\"]June 14, 2014 6:30 AM[\/localize_time]<br \/>\noutputs:<br \/>\n06\/14\/2014 6:30 AM EDT (6\/14\/2014, 3:30:00 AM PDT)<\/p><\/li>\n<li><p>Specify a time in the same timezone as the user:<br \/>\n  [localize_time tz=\"PST\"]3pm Nov. 1, 2014[\/localize_time]<br \/>\noutputs:<br \/>\nNovember 1, 2014 3:00 pm PDT<\/p><\/li>\n<\/ul>\n\n<p>Note that the display of the local time varies by timezone and browser.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>localize-time<\/code> directory to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>Can I change the way the local time is formatted?<\/dt>\n<dd><p>No. The local time is displayed by the user's browser in a format appropriate for her locale.\nYou can not change the format.<\/p><\/dd>\n<dt>What if the user is in the same timezone as the original time?<\/dt>\n<dd><p>If the user is in the same timezone as the original time, she will see only the original time;\nthe local time will not be displayed, as it would be repetitious. See the last example above.<\/p><\/dd>\n<dt>Can I style the times?<\/dt>\n<dd><p>Yes. In your theme's CSS target <code>.localize_time_orig<\/code> to style the original times\nand <code>.localize_time_local<\/code> to style the local times.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Provides a [localize_time] shortcode, which displays times in the user&#039;s local timezone.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/29790","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=29790"}],"author":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jbchristy"}],"wp:attachment":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=29790"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=29790"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=29790"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=29790"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=29790"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=29790"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}