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

Oktubre 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!
Setyembre 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.