Relative Date

Relative dates are where, instead of showing the exact date of a post, you can say it was posted "4 days ago". Tomorrow, this message would say "5 days ago". This plugin has been designed to be called from your theme (manually or automatically) to display these relative dates, as required. All relative dates are shown up to 2 depths and are not designed to be 100% accurate (due to rounding), but rather to give the reader an idea as to how old something is. Some examples... Something that is 1 year and 2 months and 3 weeks old will be output as "1 year, 2 months". Something that is 2 year and 0 months and 3 weeks old will be output as "2 years, 3 weeks". Key features include...

• Change your theme yourself or automatically convert the dates
• Set output depth and your own dividers
• Specify two dates if you wish so you can add your own time range
• And much, much more!

Technical specification...

• Licensed under GPLv2 (or later)
• Designed for both single and multi-site installations
• PHP7 compatible
• Fully internationalized, ready for translations. If you would like to add a translation to this plugin then please head to the Translating WordPress page
• WCAG 2.0 Compliant at AA level

Please visit the Github page for the latest code development, planned enhancements and known issues.

Relative Date can be found and installed via the Plugin menu within WordPress administration (Plugins -> Add New). Alternatively, it can be downloaded from WordPress.org and installed manually...

1. Upload the entire wp-relative-date folder to your wp-content/plugins/ directory.
2. Activate the plugin through the 'Plugins' menu in WordPress administration.

Voila! It's ready to go.

Learn more about my version numbering methodology 2.0.2

• Maintenance: Yoda conditions used throughout
• Maintenance: Lots of changes to the README
• Maintenance: Donation links are out. Github links are in
• Maintenance: Removed language folder and text domain

2.0.1

• Maintenance: The plugin now requires a minimum of WordPress 4.6
• Maintenance: Improvements to README for the new format directory and to clarify certain points
• Bug: Fixed a bug that meant some dates were not outputting correctly (thanks to @ajkessel for reporting that)

2.0

• Enhancement: Added a new option to automatically convert existing blog output to a relative date
• Enhancement: After WP 4.6 the plugin text domain doesn't need to be loaded. So I don't!
• Enhancement: Updated output to be WCAG 2.0 compliant at AA level
• Maintenance: Squeezed all the files into just one, after realizing it wouldn't be that big
• Maintenance: Apart from the core code that generates the relative date most of the existing code has been re-written
• Maintenance: Screenshots added and large swaths of the README re-written
• Maintenance: The time period text ("hour", "second", etc) - both singular and plural versions - was missing from the language files. Now added

1.2.2

• Maintenance: Added a text domain and domain path

1.2.1

• Maintenance: Updated support forum link

1.2

• Maintenance: Split code into separate files within an includes folder. Have a single root file that includes all the relevant code
• Maintenance: Re-written README
• Enhancement: Added new depth parameter
• Enhancement: Added internationalization

1.1.1

• Maintenance: Removed dashboard widget

1.1

• Bug: Now calculates current time properly - gets server time in GMT and applies GMT difference, as specified in user's WP options
• Enhancement: New parameter added that allows user to change the divider used in output
• Enhancement: User does not now need to pass any dates to the function - in this case the relative date for the current post/page will be returned
• Enhancement: Renamed functions that user does not specify to avoid clashes with other plugins
• Enhancement: Allow parameters to be specified in any order
• Enhancement: Added useful links to plugin page

1.0

• Initial release