ftw.calendar 3.1.2

介绍

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

特性

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

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

• 国际化：目前 ftw.calendar 可在德语、英语和捷克语中使用。欢迎添加更多翻译。

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

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

使用

• 将 ftw.calendar 添加到您的 buildout 配置中

[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

configure.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)

configure.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

• Pypi: http://pypi.python.org/pypi/ftw.calendar

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

版权

本软件包由4teamwork拥有版权。

ftw.calendar遵从GNU通用公共许可证，版本2。

变更日志