This plugin helps answer the question what day and month this is, in natural language.
It is a plugin that enables you to have displayed anywhere in your site any date in a format that temporarily overrides just at the spot where you use it,the default format you have set through your dashboard. Specifically, the date displayed using this, will have the day and month fully spelled out.
It is an internationalised function that returns a date with its day and month named in the language determined by the locale that prevails when the shortcode is used, saving you the need to do an explicit translation.
To apply it, use the shortcode
[dayspell when='yyyy-mm-dd'] where
'when' is an
optional parameter that you can use to supply a date you wish spelled. If omitted, the value of 'when' defaults to the current date. If used, 'when' must be given a value in the format 'yyyy-mm-dd'.
The plugin will then give back a date with the day and month named.
The inspiration for this came partly from the film "If it's Tuesday, this must be Belgium", released by United Artists, starring Suzanne Pleshette and Ian McShane, among others.
Why would you want to make use of such a functionality?
By means of this plugin you can have the current date inserted within the body of a page, a post or a widget.
For another thing if, like me, you have set for the sake of expediency your Wordpress implementation to date your posts and pages in a brief form such as 10/12/2021, that might be lacking in character for use in a communication to your readers. It could at times also lead to ambiguity. (e.g. is the foregoing date December 10 or October 12?).
Then, as suggested above, using this plugin could be useful to emphasize the day and month when a particular set of circumstances would apply, in contrast to the date when you posted notification of that situation.
In particular, you could apply this plugin to advise your readers in an unmistakable manner about when a certain status holds, to report when a milestone was achieved, or to warn of a deadline that is about due.
To use this plugin
Insert where you want the spelled-out date to appear this shortcode:
[dayspell]
This will cause to be displayed the current date as for example:
Friday, January 8, 2021
If there is a particular date you want to publish on your site, supply its value with the
'when' parameter:
[dayspell when='yyyy-mm-dd']
Example:
If you were to write in a post:
This year Christmas occurs on [dayspell when='2021-12-25'].
It will result in the display at that place of the following:
This year Christmas occurs on Saturday, December 25, 2021.
Caution
If you do supply a date via the 'when' parameter, ensure that you always do so using the
format 'YYYY-MM-DD'. This means
NO SLASHES, NO COLONS, NO COMMAS! Anything used other than hyphens to delimit the year, month and day will result in the warning:
A valid date in yyyy-mm-dd format is required
You get this warning also in response to bad dates (e.g. 2021-02-30, 2021-13-25.)
More examples
- A restaurateur could prepare and publish ahead of time a menu of meals for a given day with;
"The
soupe du jour for [dayspell when='2021-01-16'] is minestrone".
This will cause to be published;
"The
soupe du jour for Saturday, January 16, 2021 is minestrone".
* An accountant might want to send his clients a reminder with:
"The final deadline to electronically file your individual tax return for the year 2020 if you got an extension is [dayspell when='2021-10-15']!"
which will result in:
"The final deadline to electronically file your individual tax return for the year 2020 if you got an extension is Friday, October 15, 2021!"
International use
As the plugin operates on a multi-lingual basis, it will automatically produce a day and month name using the language that applies in your particular context. This last is usually determined by the locale that is set by the language you select in the "general" tab of the settings menu in your administrator dashboard.
For example a blogger in France could in the last days of March write her readers a warning such as:
"Prenez garde aux farceurs le [dayspell when='2021-04-01']!"
This will then be seen by her readers as:
"Prenez garde aux farceurs le jeudi 1 avril 2020!"
Living Fossil can use your Support
Please show your approval by giving this plugin a star rating.
If you enjoyed this plugin and you believe that the added convenience to you is a fair trade-off against the typical cost of your next glass of beer or wine, then you passing on that to reward me with a donation would be much appreciated. It would also make up for all such glasses I missed when I relied on coffee alone to keep me alert over the many hours I toiled to learn PHP and how to build working plugins :-)
The quickest method for installing "Day Spelled" is to do so from within WordPress, using the Plugin/Add New feature.
Otherwise, if you would prefer to do things manually then follow these instructions:
- Download the "date-spelled" folder using our plugin URL listed above.
- Unzip this downloaded folder.
- Upload the un-zipped "date-spelled" folder to the ./wp-content/plugins/ directory.
- Activate the plugin through the "Plugins" menu in WordPress.
1.6
Current release,
Updated the readme.txt file to reflect compatibility up to WP version 5.6.2. and also to reflect the current 2021 year in the examples given in it. Moreover, language files were updated as and where appropriate for enabling translation of the help file examples
1.6
Current release,
Updated the readme.txt file to reflect compatibility up to WP version 5.3.2. and also to reflect the current 2020 year in the examples given. Language files updated as appropriate.
1.6
Current release,
Updated the readme.txt file to reflect compatibility up to WP version 5.0.2. and also to reflect the current 2019 year in the examples given. Language files updated as and where appropriate for enabling translation of these help file examples.
1.6
Current release,
Updated the readme.txt file to reflect compatibility up to WP version 4.9.4.
and edited language file to fix a typo in the french translation of help text.
1.6
Current release,
updated the readme.txt and help files to reflect the current 2018 year in the examples given. Language files also updated as and where appropriate for enabling translation of these help file examples.
1.6
Current release,
Updated the readme.txt file to reflect compatibility up to WP version 4.7.8.
Also edited same file to remove spurious line breaks.
1.6
Current release,
updated the readme.txt file to reflect compatibility up to WP version 4.7.1. and updated the readme.txt, help files to reflect the current year in the examples given. Language files also updated as appropriate for enabling translation of these help file's examples.
1.6
Updated the readme.txt file to reflect compatibility up to WP version 4.6.1 and also to correct the contributors name. Edited the plugin's main code to update the author name.
1.6
Current release
result of test for compatibility up to WP version 4.5.3
1.6
Current release
Updated the readme.txt file to result of test for compatibility up to WP version 4.5.3
1.6
Current release
Updated the readme.txt file to reflect compatibility up to WP version 4.3.1
1.6
Third public release
Update readme.txt and instructions to reflect 2106 dates.
1.5
Second public release
Added processes for applying minor tweaks to the output date's display format, according to the language being used.
Added functionality to create for this plugin a settings page in the dashboard and for populating its help tabs with user instructions.
Provided a french translation of the help instructions in the settings' tabs.
Applied various small cosmetic changes and corrected some typos.
1.0
First public release
0.5
Added french translation of error message and fixed bug in localization.php
0.0
Initial release