Years Since – Timeless Texts

Description

Keep date time related texts relevant. β€œI have worked for x years.” becomes outdated within a year. Years since keeps β€œx” current in your posts and allow your content to age well.

Usage

A year must be provided in your text by the attribute β€œy” such as [years-since y=2012].
As an option, Months by referencing β€œm” and day by using β€œd”. Months and day default to β€œ1” if not added in the shortcode.

For example, on an β€œAbout” page text, you might have something like:

We’ve worked remotely for [years-since y=2012], which has allowed the team to spend more time traveling and spending time with family.
Or, if you wanted to update a time span on a particular anniversary, you could do something like:
I’m [years-since y=1990 m=5 d=16] old.

More attributes

html
Add specific HTML tag to the calculation with the html attrribute e.g.

[years-since y=1990 html=span] will wrap the output in a span tag.

text
Add a text attribute with value false i.e.
[years-since y=1990 text=false] will remove the text years from the calculation.

It will output 23 instead of 23 years.

1.4.0

  • Fix: Breaking month and day output.
  • Add: Testing for WP 6.5.2
  • Add: Require PHP 8.2.0
  • Add: Require PHP 7.4
  • Add: Function arguments and Return Type hinting.
  • Add: A testing framework with pest with CI.
  • Fix: Deprecate Editor poylfill function for the block editor.

1.3.5

  • Fix: Breaking change HTML Default argument paragraph html attribute as β€œp” for the shortcode output.

1.3.4

  • Fix: Restore minus text format for the calculations.
  • Add: Translations file build + .pot.
  • Add: Default attributes for the shortcode.
  • New: HTML Default argument paragraph html attribute as β€œp” for the shortcode output.

1.3.3

  • Fix: Time calculations and messaging.
  • Test: WP 6.3.1.
  • Test: PHP 8.2.10.

1.3.2

  • Fix or to ||

1.3.1

  • Namespace the plugin to avoid PHP conflicts.
  • Fix the breaking html when [years-since-gb] is used.
  • Test WP version compatibility for 5.6.

1.3.0

  • Add functionality to allow for days, months, weeks instead of 0 years when time is less than a year.

1.2.0

  • Add Gutenberg support

1.1.0

  • Add Gutenberg note to readme.

1.0.1

  • Translate returned errors.
  • Shortcode parameter to suppress β€œyear” and β€œyears” text.

1.0.0

  • Initial creation.

Screenshots

  • Sample shortcodes added in the editor.
  • Preview of the shortcodes on the front end.

Installation

  • Navigate to your plugins admin page.
  • Search for β€œyears since” and download the plugin.
  • Install using the plugin admin interface.

FAQ

Does it work with the Block Editor/Gutenberg?

Yes.

Does it work with ClassicPress?

Yes. This will still work even if you revert to the Classic Editor seamlessly.

How can I contribute?

You can raise lots of issues here and also make some Pull Requests through github

Reviews

πŸ‚ πŸ”Ÿ 6, 2023
this is a unique plugin with only one job that maybe you would not need in every website, but it is very useful, and it does its job wellThanks for updating it!
πŸ‚ 9️⃣ 24, 2020
A well-thought-out solution, sleek and elegantly coded. I love the functionality that allows for days, months and weeks instead of 0 years when time passed is less than a year. Congratulations @laurencebahiirwa and a big thank you!
Read all 5 reviews

Contributors & Developers

“Years Since – Timeless Texts” is open source software. The following people have contributed to this plugin.

Contributors

“Years Since – Timeless Texts” has been translated into 5 locales. Thank you to the translators for their contributions.

Translate “Years Since – Timeless Texts” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.