添加用于大型项目的通用联系人应用程序
giant-contact的Python项目详细描述
巨大的接触
一个可重用的包,可用于任何需要通用Contact
应用程序的项目。在
这将包括基本格式和功能,如通过管理员和电子邮件创建模型。在
安装
要使用包管理器安装,请运行:
$ poetry add giant-contact
然后应该将"contact"
添加到base.py
中的INSTALLED_APPS
和{
在base.py
中还应该有DEFAULT_FROM_EMAIL
和DEFAULT_TO_EMAIL
。这由电子邮件发送方法使用。在
配置
此应用程序公开以下设置:
- 在
在DEFAULT_FROM_EMAIL
是电子邮件中的From
地址。在 - 在
在DEFAULT_TO_EMAIL
是默认收件人。这通常是客户的地址。在 - 在
在CONTACT_ABSOLUTE_URL
允许用户设置get_absolute_url
方法中使用的不同URL - 在
在CONTACT_SUCCESS_URL
允许用户设置不同的成功URL - 在
在CONTACT_EMAIL_TEMPLATE_HTML
是电子邮件的HTML表示形式的路径。在 - 在
在CONTACT_EMAIL_TEMPLATE_TXT
是电子邮件文本表示的路径。在 - 在
在CONTACT_ADMIN_LIST_DISPLAY
是管理索引的字段列表。这一定是个列表 - 在
在CONTACT_ADMIN_FIELDSETS
允许用户定义管理字段集。这必须是两个元组的列表 - 在
在CONTACT_ADMIN_READONLY_FIELDS
允许用户在管理中配置只读字段。这一定是个列表 - 在
在CONTACT_FORM_FIELDS
允许用户自定义联系人表单上显示的字段。这一定是个列表 - 在
在CONTACT_FORM_FIELD_PLACEHOLDERS
允许用户自定义字段占位符文本。这必须是包含字段名的dict - 在
在CONTACT_FORM_REQUIRED_FIELDS
允许用户自定义联系人表单上需要的字段。这一定是个列表 - 在
在CONTACT_FORM_LABELS
允许用户自定义联系人表单上的字段标签。这必须是字段名及其相应标签的dict - 在
在CONTACT_FORM_WIDGETS
允许用户自定义联系人窗体上的字段控件。这必须是字段名及其对应的小部件的dict
网址
将以下内容添加到core.urls
以获得常规功能:
如果要自定义URL以包含不同的路径和/或模板,首先必须在core.urls
中导入contact.views
,然后可以添加以下内容:
path("contact-us/", contact.views.EnquiryFormView.as_view({"template_name": "custom_template_name.html}), name=contact-us)
path("contact-us/success/", contact.views..SuccessView.as_view(), name=contact-success)
上下文处理器
如果您希望与上下文处理程序一起使用联系人表单,则需要将contact.context_processors.enquiry_form
添加到TEMPLATES
上下文处理器列表中。这将允许您访问模板中的表单。在
准备释放
为了为TestPyPi和PyPi的新版本准备包,您需要做一件关键的事情。您需要更新pyproject.toml
中的版本号。
这样就可以在不发生版本号冲突的情况下发布包。版本编号还必须遵循语义版本规则,可以在此处找到https://semver.org/。在
出版
出版一个包含诗歌的包是非常容易的。检查版本号是否已更新(与以前的版本不同)后,只需运行两个命令。在
$ `poetry build`
将为您打包项目,以便于发布。在
$ `poetry publish`
将包发布到PyPi。您需要输入在公司密码管理器中找到的帐户的用户名和密码
- 项目
标签: