This plugin enables you to insert a multi-lingual date with the day and
month spelled out, anywhere in a site where a shortcode can be used.
|Author:||Living Fossil a.k.a. George Gombay (profile at wordpress.org)|
|WordPress version required:||3.0|
|WordPress version tested:||5.3.3|
|Added to WordPress repository:||22-11-2015|
|Total downloads:||1 075|
Click to start download
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/2020, 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:
This will cause to be displayed the current date as for example:
Friday, January 10, 2020
If there is a particular date you want to publish on your site, supply its value with the ‘when’ parameter:
If you were to write in a post:
This year Christmas occurs on [dayspell when=’2020-12-25′].
It will result in the display at that place of the following:
This year Christmas occurs on Friday, December 25, 2020.
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. 2020-02-30, 2020-13-25.)
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='2020-01-18'] is minestrone".
This will cause to be published;
"The *soupe du jour* for Saturday, January 18, 2020 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 2019 if you got an extension is [dayspell when='2020-10-15']!"
which will result in:
"The final deadline to electronically file your individual tax return for the year 2019 if you got an extension is Thursday, October 15, 2020!"
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='2020-04-01']!"
This will then be seen by her readers as:
"Prenez garde aux farceurs le mercredi 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
Can I use with this plugin dates that are in the past?
Absolutely. However if you are still running WordPress on a 32-bit machine, you might not be able to go back further in time than 13 December 1901. In such an environment you will also be prevented from referring to dates lying in the future after 19 January 2038.
How can I reach you?
Should you wish to give us your feedback or would like to either extend this plugin, or its later versions, then please forward your comments and suggestions to:
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.
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.
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.
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.
Updated the readme.txt file to reflect compatibility up to WP version 4.7.8.
Also edited same file to remove spurious line breaks.
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.
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.
result of test for compatibility up to WP version 4.5.3
Updated the readme.txt file to result of test for compatibility up to WP version 4.5.3
Updated the readme.txt file to reflect compatibility up to WP version 4.3.1
Third public release
Update readme.txt and instructions to reflect 2106 dates.
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.
First public release
Added french translation of error message and fixed bug in localization.php