DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:yearbox

This is an old revision of the document!


yearbox Plugin

Compatible with DokuWiki

Greebo

plugin Create simple year or recent month(s) calendars, with a new page link for each day

Last updated on
2020-07-07
Provides
Syntax
Repository
Source

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Similar to monthcal, wikicalendar

Tagged with calendar

Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

As per development version on GitHub:

Examples/Usage

This plugin builds a HTML calendar for the given year, with a link to create a new page for each day of the year. Existing pages will have a tool-tip showing a preview of the page content. You can also use the recent= option to show only recent months, which is useful on the bottom of diary pages.

The purpose of the plugin is to easily create and manage diary, journal, and event pages. If you want to include a recent months calendar at the bottom of each of your diary pages then the include plugin is very helpful.

For example the following markup on your wiki page:

====== Yearbox test page ======

{{yearbox>recent=10;align=left}}

{{yearbox>recent=200;align=left}}

{{yearbox>year=2011,2013;months=5,6;weekdays=1,2,3,4,5}}

{{yearbox>recent=1;ns=diary;name=day;size=15}}

{{yearbox>recent=15;ns=journal;size=11}}

{{yearbox>recent=45;size=10}}

{{yearbox>year=2011;size=10;ns=events;name=jour}}

~~NOCACHE~~

…will result in these calendars.

Yearbox Example Screenshot

The namespace/page-name is automatically created as follows:

  • <ns>
    • <year-month>
      • <name>-<year>-<month>-<day>

Tip: The pagequery plugin can be quite useful if you want to display a list of recent entries, perhaps for use in a simple blog.

Syntax

Parameters:

Syntax1) Explanation Default
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
year=yyyy[,yyyy] build calendar for the given year, or range of years (inclusive) current year
months=<csv>2) 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)3) all
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 table4) 12px
align=<direction> align the year table left or right centre

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.

Development

Nothing yet.

Change Log

  • 2018-09-21:
    • New Maintainer!
    • The naming scheme can be changed globally in the configuration
  • 2011-07-14: [0.4]
    • NEW: align option, left, right [centered is default]
    • CHG: internal rewrite for future flexibility
  • 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-05-02: [0.2]
    • Bugfix release: incorrect dates for November/December (year was wrong); problems with URL Rewriting on
  • 2011-04-09: [0.1]
    • Initial release

FAQ

MAKE SURE YOU USE

~~NOCACHE~~

ON THE PAGE!

Discussion

Please use the discussion page.

1)
[] = optional
2)
csv = comma separated values
3)
useful for school calendars, etc..
4)
fontsize=<num> also works
plugin/yearbox.1594142801.txt.gz · Last modified: 2020-07-07 19:26 by grosse

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki