{"id":22687,"date":"2013-04-01T15:01:20","date_gmt":"2013-04-01T15:01:20","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/relative-date-template-tag\/"},"modified":"2013-09-18T22:54:06","modified_gmt":"2013-09-18T22:54:06","slug":"relative-date-template-tag","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/relative-date-template-tag\/","author":10072957,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.6","stable_tag":"1.0.6","tested":"3.5.2","requires":"3.5.0","requires_php":"","requires_plugins":"","header_name":"Relative Date Template Tag by InternetAlche.Me","header_author":"Eric Allen","header_description":"","assets_banners_color":"","last_updated":"2013-09-18 22:54:06","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/ericrallen\/wp-relative-date-template-tag","header_author_uri":"http:\/\/internetalche.me\/","rating":0,"author_block_rating":0,"active_installs":10,"downloads":1388,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.0.3","1.0.4","1.0.5","1.0.6","trunk"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[4708,1426,3623],"plugin_category":[40],"plugin_contributors":[95378],"plugin_business_model":[],"class_list":["post-22687","plugin","type-plugin","status-closed","hentry","plugin_tags-dates","plugin_tags-relative-date","plugin_tags-template-tag","plugin_category-calendar-and-events","plugin_contributors-ericrallen","plugin_committers-ericrallen"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/relative-date-template-tag.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

Adds the_relative_date()<\/code> and get_the_relative_date()<\/code> template tags to your arsenal of template tags.<\/p>\n\n

These template tags will return the relative time passed since the post was published, like \"12 hours ago\" or \"3 weeks ago.\"<\/p>\n\n

Tag to Print Relative Time:<\/p>\n\n

<?php the_relative_date(); ?>\n<\/code><\/pre>\n\n
Tag to Retrieve Relative Time:<\/p>\n\n
<?php get_the_relative_date(); ?>\n<\/code><\/pre>\n\n
Options<\/h3>\n\n
When calling either template tag you can pass a few optional parameters via an array to customize the value that is returned.<\/p>\n\n
Example:<\/p>\n\n
<?php \/\/print relative date as \"X periods ago\"\n\/\/where periods is the largest time period that can be calculated for the current post where X >= 1\nthe_relative_date(); ?>\n<\/code><\/pre>\n\n
Example:<\/p>\n\n
<?php \/\/retrieve relative date as \"X periods ago\"\n\/\/where periods is the largest time period that can be calculated for the current post where X >= 1\nget_the_relative_date(); ?>\n<\/code><\/pre>\n\n
Example:<\/p>\n\n
<?php \/\/relative date args\n$params = array(\n    'period' => 'minutes'\n);\n\n\/\/get relative date as \"X minutes ago\"\nget_the_relative_date($params);\n<\/code><\/pre>\n\n
Example:<\/p>\n\n
$params = array(\n    'period' => 'days',\n    'suffix' => 'before now',\n    'id' => 22\n);\n\n\/\/prints relative date for post with ID 22 as \"X days before now\"\nthe_relative_date($params);<h3>Relative Time<\/h3>\n<\/code><\/pre>\n\n
The template tags will return the time relative to the timezone set in Wordpress' General Settings and will return the largest time period that it can, unless the $period parameter is set. If the $period parameter is set, but the post wasn't posted at least 1 $period ago, the template tag will return the largest time period that it can calculate for the post.<\/p>\n\n
Acceptable 'period'<\/code> values (the returned string will be de-pluralized if needed):<\/p>\n\n