ftw.calendar 3.1.2

介绍

ftw.calendar是基于 fullcalendar ( http://arshaw.com/fullcalendar ) 的日历视图。

特征

• 通用：ftw.calendar 不关心事件对象，它只需要一个集合，其中生成的大脑有一个 start 和一个 end 属性。如果日历视图位于集合以外的其他内容类型上，它将显示此上下文下的所有事件（在 portal_calendar 中定义的类型）。

• 轻量级：唯一的要求（当然除了 plone）是 simplejson。或者，如果要启用事件大小调整和拖放功能，可以安装 jquery.ui，但不是必需的。

• 国际化：目前 ftw.calendar 提供德语、英语和捷克语版本。随意添加更多翻译。

• 集成：ftw.calendar 关心您的日历设置。一周的第一天得到尊重并相应地显示。

• 灵活：日历源实现为适配器。覆盖它以修改标题或添加 css 类。

用法

• 将ftw.calendar添加到您的构建配置中：

[instance]
eggs +=
    ftw.calendar

• 安装通用导入配置文件。

使用ftwcalendar_view作为任何集合的新默认视图。新 plone 站点中的默认事件集合应该可以正常工作，但您可能应该删除日期标准，因为 fullcalendar 需要能够根据所选月份设置它们。

日历来源

为了便于定制，我建议从默认日历源实现扩展并覆盖三个定义的函数之一。

这是来自ftw.meeting的示例：

from ftw.calendar.browser.calendarupdateview import CalendarJSONSource

class MeetingCalendarJSONSource(CalendarJSONSource):

    def generate_source_dict_from_brain(self, brain):
        output = super(MeetingCalendarJSONSource,
                       self).generate_source_dict_from_brain(brain)

        if brain.Type == 'Meeting' and \
           self.memberid in brain.getAttendeesOrUsers:

            output['className'] += ' attendee'

        return output

配置.zcml：

<configure zcml:condition="installed ftw.calendar">
    <adapter
        for="* ftw.meeting.interfaces.IMeetingLayer"
        name="ftw_calendar_source"
        provides="ftw.calendar.browser.interfaces.IFtwCalendarJSONSourceProvider"
        factory=".calendarsource.MeetingCalendarJSONSource"
        />
</configure>

日历事件创建者

可以通过单击日历小部件上的日期/时间来创建日历条目。由于ftw.calendar不知道在特定项目中使用哪种事件类型，它必须由产品使用ftw.calendar定义。没有默认实现！除非您在产品中实现它，否则它不会起作用。

这是使用适配器完成的。这是来自ftw.contentpage的示例：

from ftw.calendar.browser.interfaces import IFtwCalendarEventCreator
from plone import api
from zope.interface import implements


class CalendarEventPageCreator(object):
    implements(IFtwCalendarEventCreator)

    def __init__(self, context, request):
        self.context = context
        self.request = request

    def getEventType(self):
        return "EventPage"

    def createEvent(self, title, start_date):
        return api.content.create(container=self.context,
                                  type="EventPage",
                                  title=title,
                                  startDate=start_date,
                                  endDate=start_date)

配置.zcml

<adapter
   for="* *"
   provides="ftw.calendar.browser.interfaces.IFtwCalendarEventCreator"
   factory=".adapters.CalendarEventPageCreator"
   />

故障排除

安装并尝试日历视图后，通常会出现 javascript 错误。通常这些是由于 javascript 缓存造成的，可以通过在 js_registry 中启用 javascript 调试来轻松解决。

学分

非常感谢 Adam Shaw 的 jq.fullcalendar。

链接

• Github：https ://github.com/4teamwork/ftw.calendar

• 问题：https ://github.com/4teamwork/ftw.calendar/issues

• 皮皮： http ://pypi.python.org/pypi/ftw.calendar

• 持续集成：https ://jenkins.4teamwork.ch/search?q=ftw.calendar

版权

这个包是4teamwork的版权。

ftw.calendar根据 GNU 通用公共许可证第 2 版获得许可。

变更日志