內容簡介
Day Spelled 是一款日期顯示外掛，透過短代碼將日期以完整拼寫格式呈現（含星期、月份全名），支援多語系自動轉換，可用於文章、頁面或小工具中，解決日期格式簡寫造成的歧義問題。
【主要功能】
• 以短代碼插入完整拼寫的日期（含星期與月份全名）
• 支援自訂指定日期或自動顯示當天日期
• 多語系自動對應，依據網站語系顯示對應語言
• 可用於文章、頁面及小工具等任何位置
• 輸入格式錯誤時自動顯示警告提示
外掛標籤
開發者團隊
原文外掛簡介
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 🙂
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.