=== Years Since - Timeless Texts ===
Contributors: laurencebahiirwa
Tags: date, update, updater, time, span, year, automated, references
Donate link: https://paypal.me/laurencebahiirwa
Requires at least: 4.9.0
Tested up to: 6.3.1
Requires PHP: 7.4
Stable tag: 1.4.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

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. 

== 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**.

== Screenshots ==
3. Sample shortcodes added in the editor.
4. 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.

== Frequently Asked Questions ==

= 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](https://github.com/bahiirwa/years-since/) here and also make some [Pull Requests through github](https://github.com/bahiirwa/years-since/)

== Upgrade Notice ==

== 1.4.1 ==
- Fix: Add proper escaping for the shortcode input.

== 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.