一个可重复使用的Django应用程序,允许您输入雇员的工资数据,以便授权人员可以查看、打印和导出其工资单(PDF)。
django-payslip的Python项目详细描述
一个可重用的django应用程序,允许您输入员工的工资数据 以便授权人员可以查看、打印和导出工资单(pdf)。
安装
要使用此应用程序,您需要安装以下先决条件:
pip install Django pip install django-libs pip install python-dateutil pip install WeasyPrint
如果要安装pypi的最新稳定版本:
$ pip install django-payslip
如果您有冒险精神并希望安装来自github的最新提交:
$ pip install -e git://github.com/bitmazk/django-payslip.git#egg=payslip
将payslip添加到INSTALLED_APPS:
INSTALLED_APPS = ( ..., 'payslip', )
将此应用程序连接到您的urls.py:
urlpatterns = patterns('', ... url(r'^payslip/', include('payslip.urls')), )
功能和用法
您可以:
- Define companies
- Assign employees (a user model is created automatically)
- Define payment types
- Create payments
- Create custom extra fields for COMPANIES, EMPLOYEES and PAYMENTS
- Create global attributes for those custom fields (dropdown fields)
- Generate custom payslips
- Print those payslips or export them as styled PDF documents
你的工资单已经有一个打印模板了,应该包括 主要使用工资单。如果需要,可以使用 自己的风格。在这里找到它payslip/templates/payslip/payslip.html。
您也可以创建自己的css,但一定要涵盖打印样式。找到它 这里是static/payslip/css/payslip.css。
在模板中添加所需的基本公司信息后,您可以 可以添加付款和员工,并开始工资削减。:)玩得开心。
设置
工资单货币
默认值:“欧元”
您首选的货币缩写。
贡献
如果您想参与此项目,请执行以下步骤:
# Fork this repository # Clone your fork $ mkvirtualenv -p python2.7 payslip $ pip install -r requirements.txt $ ./payslip/tests/runtests.sh # You should get no failing tests $ git co -b feature_branch master # Implement your feature and tests # Describe your change in the CHANGELOG.txt $ git add . && git commit $ git push origin feature_branch # Send us a pull request for your feature branch
无论何时运行测试,都会在 tests/coverage/index.html。添加新功能时,请确保 你把保险范围保持在100%。
如果您正在进行需要在浏览器中测试的更改(即 css或js文件),您可能希望设置django项目,请按照 上面的安装说明,然后运行python setup.py develop。这个 只需在项目的virtualenv中放置一个到克隆叉的鸡蛋链接。
路线图
- 添加员工和经理仪表板
查看github上的问题跟踪器,了解下一步的里程碑和特性。