=== Current Year Shortcode === Contributors: runthingsdev Tags: shortcode, year, copyright, date, dynamic-content Tested up to: 6.9 Requires at least: 6.0 Requires PHP: 7.4 Stable tag: 2.1.1 License: GPLv3 or later License URI: http://www.gnu.org/licenses/gpl-3.0.html Adds a shortcode to display the current year or a year range, perfect for copyright statements. == Description == This is a plugin which adds a simple shortcode to display the current year or a dynamic year range, particularly useful for copyright statements at the bottom of your website. Its most basic usage is `[year]`, which will display the current year. If you provide a starting year with the 'from' parameter, it will expand into a date range when the 'from' year is before the current year. If `[year]` is used by another plugin, then it uses the fallback `[runthings_year]` which can be customised with the `runthings_current_year_shortcode_tag` filter. You can see the active shortcode tag in it entry in the installed plugins page. = Features = * Display current year with `[year]` * Create a dynamic year range with `[year from="2020"]` * Abbreviated year format with `[year from="2020" mode="short"]`, which shows "2020-26" (if the current year is 2026) * Automatic fallback shortcode `[runthings_year]` if another plugin already uses the 'year' shortcode * Filter (`runthings_current_year_shortcode_tag`) to set your own shortcode = Usage Examples = Assuming the current year is 2026: * `[year]` displays "2026" * `[year from="2026"]` displays "2026" (since it's the current year) * `[year from="1983"]` displays "1983-2026" * `[year from="2020" mode="short"]` displays "2020-26" (shortened current year) * `[year from="1995" mode="short"]` displays "1995-2026" (not shortened because centuries differ) == Installation == 1. Upload the plugin files to the `/wp-content/plugins/runthings-current-year-shortcode` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the 'Plugins' screen in WordPress. 3. Use the `[year]` shortcode in your posts, pages, or widgets. == Frequently Asked Questions == = What if another plugin already uses the [year] shortcode? = If another plugin already uses the `[year]` shortcode, this plugin will automatically use `[runthings_year]` instead to avoid conflicts. = How can I check which shortcode is active? = On the Plugins admin page, you'll see the active shortcode listed in the plugin's row. = Can I use this in my footer? = Yes! This shortcode works perfectly in footer widgets, custom footer code, or anywhere else shortcodes are supported in your theme. = What's the 'mode=short' parameter for? = When using a date range with years in the same century (e.g., 2020-2026), the 'short' mode will abbreviate the end year to just the last digits (2020-26), creating a cleaner look for your copyright statements. == Screenshots == 1. Using the shortcode in a footer widget 2. Plugin info showing the active shortcode 3. Help tab with usage examples == Changelog == = 2.1.1 - 17th December 2025 = * Update year examples to 2026 * Bump tested up to 6.9 = 2.1.0 - 26th March 2025 = * Move scripts and styles into external files = 2.0.0 - 15th March 2025 = * Update year examples to 2025 * Added fallback shortcode runthings_year if year is taken * Added `runthings_current_year_shortcode_tag` filter to customise the shortcode * Added contextual help tab to plugins page * Added usage examples link to plugins page * Added active shortcode info to plugins page * Prepare for WordPress.org repository = 1.3.0 - 5th January 2024 = * Update year examples to 2024 = 1.2.0 - 29th May 2023 = * Update year examples to 2023 = 1.1.0 - 19th February 2022 = * Added license * Updated plugin meta * Added readme file * Initial public release = 1.0.0 - 25th August 2021 = * Internal release == Upgrade Notice == = 2.1.1 = Bump tested up to 6.9. Update year examples to 2026. = 2.1.0 = This update moves scripts and styles into externally included files. = 2.0.0 = This update adds PHP type declarations for better code quality and updates year examples. Requires PHP 7.4 or higher. == Filters == #### runthings_current_year_shortcode_tag This filter allows customization of the shortcode tag used by the plugin. For detailed documentation and examples, see the [full documentation on GitHub](https://github.com/runthings-dev/runthings-current-year-shortcode#filters). ##### Parameters: 1. **`$tag`** (`string`): The shortcode tag to be registered. Defaults to 'year' or 'runthings_year' if conflicted. == Additional Notes == Built by Matthew Harris of runthings.dev, copyright 2021-2026. Visit [runthings.dev](https://runthings.dev/) for more WordPress plugins and resources. Contribute or report issues at [GitHub repository](https://github.com/runthings-dev/runthings-current-year-shortcode). == License == This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, see [http://www.gnu.org/licenses/gpl-3.0.html](http://www.gnu.org/licenses/gpl-3.0.html). Icon - Calendar by Qadeer Hussain, from Noun Project, https://thenounproject.com/browse/icons/term/calendar/ (CC BY 3.0) Icon - legal by hanis tusiyani, from Noun Project, https://thenounproject.com/browse/icons/term/legal/ (CC BY 3.0)