django-pendulum 0.1.6-pre4

特性

• 可配置性：Pendulum可以配置在多个Django驱动的网站上运行。周期长度可以配置为月度或固定长度周期。

• 项目：您可以有无限数量的项目，以便对在特定任务上花费的小时进行分类。每个项目可以通过Django管理员根据需要激活/停用。

• 活动：活动允许您进一步对每个项目中特定任务上完成的工作进行分类。

需求

django-pendulum需要一个现代版本的Django框架。通过现代我仅仅是指具有newforms-admin功能的版本。如果您运行的是Django 1.0或更高版本，那就没问题。

django-pendulum还依赖于django.contrib.admin，django.contrib.auth，django.contrib.contenttypes，和django.contrib.sites框架。

安装

使用以下方法之一下载 django-pendulum

pip install -U django-pendulum

easy_install django-pendulum

hg clone http://bitbucket.org/codekoala/django-pendulum
git clone http://github.com/codekoala/django-pendulum.git
hg clone http://django-pendulum.googlecode.com/hg django-pendulum

验证安装

确保您已成功安装 Pendulum 的最简单方法是执行以下命令之一：

python -c "import pendulum; print pendulum.get_version()"

如果显示您尝试安装的 Pendulum 版本，您就可以继续操作了。如果您看到其他内容，您可能需要检查您的 PYTHONPATH 环境变量。

配置

首先，您必须将此项目添加到 settings.py 中的 INSTALLED_APPS 列表。

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    ...
    'pendulum',
    ...
)

运行 manage.py syncdb。这将为您创建一些数据库表，这些表对于操作是必需的。

接下来，您应该在主 urls.py 文件中添加一个条目。例如

from django.conf.urls.defaults import *

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    (r'^admin/(.*)', admin.site.root),
    (r'^pendulum/', include('pendulum.urls')),
)

接下来，您需要配置 Pendulum 以用于活动的 Django 网站。您可以通过进入 Django 管理员界面并点击“添加”链接旁边的“Pendulum 配置”链接来完成此操作。

配置的第一步是选择此特定配置将应用于哪个网站。如果您只有一个网站，这个决定很简单 :)

接下来，您必须选择您希望使用的“会计期间”类型。如果您想要一个月的期间，请确保选中“是否为月度”复选框。然后输入期间开始的月份中的那一天。每个月的第一天开始的期间将从每个月的第一天的午夜开始，到每个月的最后一天的晚上11:59:59结束。从每个月的16号开始的期间将从每个月的16号的午夜开始，到下个月的15号的晚上11:59:59结束。选择像月底31号这样的开始日期并不明智，无论您处于什么情况。

或者，您可以选择固定长度的会计期间。安装日期不一定是实际的安装日期。此字段用作创建期间的参考点。例如，如果您有为期两周的会计期间，从星期天开始，结束于两周后的星期六，您可以从任何月份的任何年份中选择任何星期天。然后输入14作为期间长度。期间将自动构建，从每个星期天的午夜开始，到未来某个星期六的晚上11:59:59结束。

如果您未为特定网站配置 Pendulum，那么当您尝试通过前端访问 Pendulum 时，可能会收到 HTTP 500 错误。

日期字段

我在添加或更新条目时对使日期/时间字段更友好持谨慎态度。我不想让任何人局限于我的特定做法。我个人更喜欢jQuery来做这类事情，但我确实意识到jQuery让很多人感到厌恶。因此，应用程序的早期版本没有提供任何使这些字段更容易使用和理解的功能。

然而，这似乎是尝试过这个应用程序的人中最常见的抱怨——缺乏用户友好的日期选择器。因此，我添加了一些基于jQuery的实用工具，使选择日期更加容易和直观。

默认情况下，应用程序将期望在您的媒体目录中名为 pendulum 的目录中找到适当的文件。您应该做的只是复制或创建Pendulum应用程序目录中的 media 文件夹的符号链接。如果您复制 media 文件夹，请将其重命名为 pendulum。如果您创建Pendulum的 media 文件夹的符号链接，请确保链接名为 pendulum。此目录应包含使日期选择器正常工作的所有必要文件。

在您的 add_update_entry.html 模板中（如果您覆盖了默认的模板），请确保您有一个代码块，如下所示：

{% block extra-head %}
{{ form.media }}
<script type="text/javascript">
$(document).ready(function () {
    $('input.vDateField').datepicker({
            dateFormat: $.datepicker.W3C,
            showOn: 'both',
            buttonImage: '{{ MEDIA_URL }}pendulum/img/calendar.png',
            buttonImageOnly: true
        });
});
</script>
{% endblock %}

这只是jQuery将日期选择器附加到相应字段的方式。

PENDULUM_DATE_MEDIA = {
    'js': (settings.MEDIA_URL + 'pendulum/js/jquery.js',
            settings.MEDIA_URL + 'pendulum/js/jquery.ui.js'),
    'css': {
        'all': (settings.MEDIA_URL + 'pendulum/css/jquery-ui.css',)
    }
}