.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ===================================== EXT: Render week preview for calendar ===================================== :Author: Thomas Kowtsch :Created: 2009-06-17T12:52:49 :Changed by: Thomas Kowtsch :Changed: 2009-06-17T15:28:30.380000000 :Classification: cal_weekpreview :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: forAdmins, forDevelopers, forBeginners, forIntermediates :Author: Thomas Kowtsch :Email: typo3@thomas-kowsch.de :Info 4: :Language: en |img-1| |img-2| EXT: Render week preview for calendar - cal\_weekpreview .. _EXT-Render-week-preview-for-calendar: EXT: Render week preview for calendar ===================================== Extension Key: cal\_weekpreview Language: en Keywords: forAdmins, forDevelopers, forBeginners, forIntermediates Copyright 2000-2008, Thomas Kowtsch, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: Render week preview for calendar 1 <#1.EXT:%20Render%20week%20preview%20for%20calendar|outline>`_ **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ `Screenshots 3 <#1.1.2.Screenshots|outline>`_ **`User/Administration manual 4 <#1.2.User/Administration%20manual|outline>`_** `Installation 4 <#1.2.1.Installation|outline>`_ `FAQ 4 <#1.2.2.FAQ|outline>`_ **`Configuration 5 <#1.3.Configuration|outline>`_** `Reference 5 <#1.3.1.Reference|outline>`_ **`Known problems 6 <#1.4.Known%20problems|outline>`_** **`To-Do list 7 <#1.5.To-Do%20list|outline>`_** **`ChangeLog 8 <#1.6.ChangeLog|outline>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The extension's purpose is to provide Typo3 installations using calendar base extension (cal) with a new month-style view that allows to preview the events of the next weeks. This view is as comprehensive and clear as the default month view and and acts as mid-term overview like a list view. It fits especially the need for public calendars that offer more events a list view can handle because of removing the barrier of the end of a month. .. _Screenshots: Screenshots ^^^^^^^^^^^ - |img-3| - Even across the end of the month, events are shown in the calendar grid – without the special “off month”-CSS-styling - - Activation of the week-preview and the number of weeks is done by changing template constants: |img-4| .. _User-Administration-manual: User/Administration manual -------------------------- .. _Installation: Installation ^^^^^^^^^^^^ .. _Step-1-Install-the-extension: Step 1: Install the extension """"""""""""""""""""""""""""" The extension can be installed through the typical TYPO3 installation process using the Extension Manager. It requires to to have the calendar base extension (extension key: cal) installed in version 1.2 or above. *At the time of creating the extension and writing this manual, this requires to install a development snapshot release (available under `http://svn.webempoweredchurch.org/snapshots/show/calendar)! `_* .. _Step-2-Add-static-TypoScript-template: Step 2: Add static TypoScript template """""""""""""""""""""""""""""""""""""" |img-5| Open your page template (or create a new extension template), and add the “week preview template” to the “Include static (from extensions):” list. The default configuration is to activate the new week preview with a timeframe of 6 weeks. If this fits your needs, you do not need to touch the configuration. .. _Step-3-Adjust-the-number-of-weeks-shown: Step 3: Adjust the number of weeks shown """""""""""""""""""""""""""""""""""""""" Please refer to the chapter “configuration” to get an overview about the ways you can tweak the extensions behaviour. Instead of writing error-prone text to the “constants” field it might be better to use the “Constants Editor” instead: |img-6| .. _Step-4-Adjust-your-calendar-s-template-for-month-views: Step 4: Adjust your calendar's template for month views """"""""""""""""""""""""""""""""""""""""""""""""""""""" Since the extension provides a configurable preview to the next weeks, it does not make much sense to have the small “previous month” and “next month” calendars (the extension does not touch these at all). So, you may want to simply remove them from your template. .. _FAQ: FAQ ^^^ F: While trying to install the extension, the Extension Manager complains about a wrong version of cal... A: Most likely, cal's version 1.2 is not available in the TER yet. At the time of writing this manual, it was still in development, requiring to manually install a development snapshot. F: I installed the extension and changed the number of weeks to 10, but the view doesn't change. A: Please make sure that you installed the static template properly. If no valid configuration is found, the extension falls back to the standard month view. F: I'm pretty sure I did everything as described, but the view simply shows a heading with the week day names. A: Please ensure that you provided a “number of weeks” greater than zero. Negative values, a “0” or alphanumeric values will result in showing no weeks at all. .. _Configuration: Configuration ------------- The extension is configured trough constants in the page template. Please see the table below for valid variables and values. .. _Reference: Reference ^^^^^^^^^ Available constants for plugin.tx\_calweekpreview: .. ### BEGIN~OF~TABLE ### .. _enable: enable """""" .. container:: table-row Property enable Data type boolean Description Toggles week preview on or off. If set to 0 (false), the default month view from calendar base will be used to render. Default 1 .. _numOfWeeks: numOfWeeks """""""""" .. container:: table-row Property numOfWeeks Data type integer Description Defines the number of weeks to be shown. In order to make any sense, the value should be greater than zero (0); otherwise the view will produce only a table with some names of weekdays. Default 6 .. ###### END~OF~TABLE ###### .. _generated: ((generated)) """"""""""""" .. _Example: Example ~~~~~~~ To enable the week preview for the next half year your configuration should look like this: :: plugin.tx_calweekpreview { enable = 1 numOfWeeks = 26 } .. _Known-problems: Known problems -------------- - The code to render the grid is a copy from the original calendar base month view. In order to remain fully compatible with any changes there, a redesign of both cal and cal\_weekpreview is required. Volunteers are welcome to provide a generic “grid view” that can be feeded with some basic configuration and a list of events by a classic month view, the week preview or any other future view. - The small calendars (last/next month) are not adjusted based on the week preview output. It doesn't seem to make much sense to me to show them at all, but keep in mind that users might get confused if you show them an eight-week-preview *and* a “next month”-calendar... .. _To-Do-list: To-Do list ---------- See the “Known Problems” section – it might be useful to work on these items. .. _ChangeLog: ChangeLog --------- Any relevant changes will be added to the changelog file in the extensions directory. 8 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 234 .. :id: graphics1 .. :name: graphics1 .. :width: 455 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 78 .. :id: graphics2 .. :name: graphics2 .. :width: 239 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 61 .. :id: graphics3 .. :name: graphics3 .. :width: 266 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 110 .. :id: graphics4 .. :name: graphics4 .. :width: 268