Day Spelled

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
Plugin version:1.6
Added to WordPress repository:22-11-2015
Last updated:04-03-2020
Rating, %:100
Rated by:1
Plugin URI:http://wordaster.com/day-spelled.html
Total downloads:1 075
Active installs:60+
plugin download
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:

[dayspell]

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:

[dayspell when=’yyyy-mm-dd’]

Example:

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.

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. 2020-02-30, 2020-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='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!"
    

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


FAQ
ChangeLog