Day Spelled

Description

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/2019, 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 11, 2019

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=’2019-12-25′].

It will result in the display at that place of the following:

This year Christmas occurs on Wednesday, December 25, 2019.

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. 2019-02-30, 2019-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='2019-01-19'] is minestrone".
    

    This will cause to be published;

     "The *soupe du jour* for Saturday, January 19, 2019 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 2018 is [dayspell when='2019-10-15']!" 
    

    which will result in:

       "The final deadline to electronically file your individual tax return for the year 2018 is Tuesday, October 15, 2019!"
    

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='2019-04-01']!"

This will then be seen by her readers as:

      "Prenez garde aux farceurs le lundi 1 avril 2019!"

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 🙂

License

This file is part of day-spelled.

‘Day Spelled’ 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.

‘Day Spelled’ 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.

A copy of the license is included in the root of the plugin’s directory.
The file is named LICENSE.

You should have received a copy of the GNU General Public License. If you did not, see http://www.gnu.org/licenses/.

How to uninstall Day Spelled

To uninstall ‘Day Spelled’, you merely need to de-activate it from the plugins’ list of your administrator dashboard.

Installation

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:

  1. Download the “date-spelled” folder using our plugin URL listed above.
  2. Unzip this downloaded folder.
  3. Upload the un-zipped “date-spelled” folder to the ./wp-content/plugins/ directory.
  4. Activate the plugin through the “Plugins” menu in WordPress.

FAQ

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:
webmasterwordaster@gmail.com

Reviews

Read all 1 review

Contributors & Developers

“Day Spelled” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Day Spelled” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

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