Differences

This shows you the differences between two versions of the page.

--- plugin:yearbox [2011-12-04 14:18] – [Examples/Usage] 41.204.102.174
+++ plugin:yearbox [2024-03-22 12:27] (current) – Aleksandr
@@ Line 1: / Line 1: @@
 ====== yearbox Plugin ======
----- pluginnews -----
-headline:     By the same author
-style:        sameauthor
------
 ---- plugin ----
-description: Create simple year or recent month(s) calendars, with a new page link for each day
+description: [PHP 7.2 - 8.0] Create simple year or recent month(s) calendars, with a new page link for each day
-author     : Symon Bent
+author     : Michael Große (formerly: Symon Bent)
-email      : hendrybadao@gmail.com
+email      : mic.grosse+dokuwiki@googlemail.com
 type       : Syntax
-lastupdate : 2011-12-04
+lastupdate : 2021-03-19
-compatible : Anteater, Rincewind, Angua
+compatible : Hogfather
 depends    :
 conflicts  :
 similar    : wikicalendar
-tags       : calendar
+tags       : calendar, diary
+downloadurl: https://github.com/micgro42/yearbox/zipball/master
+bugtracker : https://github.com/micgro42/yearbox/issues
+sourcerepo : https://github.com/micgro42/yearbox
+donationurl: https://paypal.me/GrosseM
-downloadurl: https://github.com/MrBertie/yearbox/zipball/master
-bugtracker : https://github.com/MrBertie/yearbox/issues
-sourcerepo : https://github.com/MrBertie/yearbox
-donationurl: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=XUZQ9UDD5SNM2
 ----
+:!:  :!: **This Plugin needs at least PHP 7.2!** :!:  :!:
+(If you absolutely have to run a PHP version that is End of Life since long ago, you can install the last [[https://github.com/micgro42/yearbox/zipball/3d1075d384f31c6893bc0571f5998927f9ac3853|PHP 7.0 compatible version]].)
 ===== Installation =====
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
-As per [[https://github.com/MrBertie/yearbox/zipball/master|development version]] on GitHub:
+As per [[https://github.com/micgro42/yearbox/zipball/master|development version]] on GitHub:
-{{rss>https://github.com/MrBertie/yearbox/commits/master.atom 10 date}}
+{{rss>https://github.com/micgro42/yearbox/commits/master.atom date}}
 ===== Examples/Usage =====
@@ Line 63: / Line 63: @@
 ...will result in these calendars.
-{{http://pagequery.googlecode.com/files/sample%20of%20yearbox.png|Yearbox Example Screenshot}}
+{{ https://trello.com/1/cards/6368e98436ccad001ca1efa4/attachments/6368ea1fa25bdd0058b26d3c/download/sample-of-yearbox.png?recache |Yearbox Example Screenshot}}
-As you can perhaps infer from the link tool-tip, the namespace/page-name is automatically created as follows:
+The namespace/page-name is automatically created as follows:
   * <ns>
     * <year-month>
@@ Line 75: / Line 75: @@
 Parameters:
-^Syntax  ^Explanation  ^Default  |
+^Syntax((''[]'' = optional))  ^Explanation  ^Default  |
-|ns=<namespace>  |root namespace in which to create the linked calendar pages  |  current ns  |
+|''ns=<namespace>''      |root namespace in which to create the linked calendar pages  |  current ns  |
-|recent=<num>  |build calendar based on recent days, i.e. how many days should be visible before today (rounded up to whole months)---take precedence over other options! |  21 days  |
+|''recent=<num>''        |build calendar based on recent days, i.e. how many days should be visible before today (rounded up to whole months)---take precedence over other options! |  21 days  |
-|year=yyyy[,yyyy]  |build calendar for the given year, or range of years (inclusive)  |  current year  |
+|''year=yyyy[,yyyy]''    |build calendar for the given year, or range of years (inclusive)\\ :!: year must be ≥ 1902  |  current year  |
-|months=<csv>((csv = comma separated values))  |which months should be visible, 1=Jan, 2=Feb,..., e.g. months=6,7 (Jun,Jul)  |  all  |
+|''months=<csv>''((csv = comma separated values))  |which months should be visible, 1=Jan, 2=Feb,..., e.g. months=6,7 (Jun,Jul)  |  all  |
-|weekdays=<csv>  |which weekdays should have links, 1=Mon, 2=Tue,... e.g. weekdays=1,2,3,4,5 (Mon to Fri)((useful for school calendars, etc..))  |  all  |
+|''weekdays=<csv>''      |which weekdays should have links, 1=Mon, 2=Tue,... e.g. weekdays=1,2,3,4,5 (Mon to Fri)((useful for school calendars, etc..))  |  all  |
-|name=<name>  |prefix for new page name, e.g diary, journal, day  |  day  |
+|''name=<name>''         |prefix for new page name, e.g diary, journal, day  |  day  |
-|size=<num>  |font size to use; this controls the width/height of the calendar table((fontsize=<num> also works))  |  12px  |
+|''size=<num>''          |font size to use; this controls the width/height of the calendar table((fontsize=<num> also works))  |  12px  |
-|align=<direction>|align the year table left or right  |  centre  |
+|''align=<direction>''   |align the year table left or right  |  centre  |
-* [] = optional
-E.g.: %%{{yearbox>year=2010,2012;name=journal;size=12;ns=diary}}%%
+E.g.:
+  {{yearbox>year=2010,2012;name=journal;size=12;ns=diary}}
 ===== Configuration and Settings =====
-The month and day abbreviations can be changed in the language files.  Currently only English is available.
+The month and day abbreviations can be changed in the language files. A few languages are already available. Feel free to add your language on [[https://translate.dokuwiki.org/plugin/yearbox|yearbox translation page]].
 ===== Development =====
-Nothing yet.
+**Releases:**
+{{rss>https://github.com/micgro42/yearbox/releases.atom description author}}
 === Change Log ===
-  * 2011-04-09: [0.1]
+See [[https://github.com/micgro42/yearbox/blob/master/CHANGELOG.md|CHANGELOG.md]].
-    * Initial release
-  * 2011-05-02: [0.2]
-    * Bugfix release: incorrect dates for November/December (year was wrong); problems with URL Rewriting on
-  * 2011-05-08: [0.3]
-    * NEW: months and weekdays options, you can now make certain months and weekdays invisible (removes links in case of weekdays)
-    * FIX: bug with wikis where URL rewrite is on (? vs & at end of url)
-    * FIX: date logic problems: November and December were using wrong years!
-    * CSS: improved colour scheme and layout
-  * **2011-07-14: [0.4]**
-    * NEW: align option, left, right [centered is default]
-    * CHG: internal rewrite for future flexibility
 ===== FAQ =====
-Nothing here yet.
+:!: MAKE SURE YOU USE **%%~~NOCACHE~~%%** ON THE PAGE!
 ===== Discussion =====
 Please use the [[plugin:yearbox:discussion|discussion]] page.