iservices.controlpanel 0.3.1

简介
============

``iservices.controlpanel``是一个plone控制面板，
为用户和集成商提供通用设置。这个控制面板背后的想法是
克隆管理员（而不是集成商或程序员）将有
能力：

* 定义在整个网站上使用的社交帐户，特别是在主题上。
程序员/集成商必须将其产品或主题与此控制
面板集成（希望是一个简单的步骤）并将此设置应用于
他们的逻辑。

* 允许更改 plone 用于
在 plonetheme.sunburs 上绘制其界面的全局背景和前景颜色（实际上只有两种颜色）。如果
用户需要的不止这些，制作一个完整的主题
产品可能会更好。

*更改克隆标志。站点管理员可以更改徽标。这
提供了一个简单的克隆主题部署，而无需
为了更改徽标而从头开始创建主题。

* 更改页脚和版权文字。站点管理员可以更改
页脚和版权页的文本，而无需程序员对
任何主题进行更改。

用法
=====

使用 buildout 安装
-----------------------

添加 ``iservices.controlpanel`` 到你的 ``eggs`` 小节::

鸡蛋 =
...
iservices.controlpanel

这个包依赖于一组其他包，希望所有包都应该
自动从 pypi 中提取。但是，您必须
根据以下模式调整 ``extends`` 小节::

extends =
http://dist.plone.org/release/<plone-version>/versions.cfg
...
http: //good-py.appspot.com/release/plone.app.z3cform/0.5.0-1?plone=<plone-version>
http://good-py.appspot.com/release/plone.app.registry /1.0b2?plone=<plone-version>

将 ``<plone-version>`` 替换为你正在使用的 Plone 版本，即 ``4.0.3``

如何在你的包和主题上使用它
—— --------------------------------------

当然，如果你使用这个包，你会想要访问它
管理的设置，对吧？这个包有一个小的 API，它封装了
样板代码，让你很容易使用它。

为了
访问控制面板的设置，您只需使用一个非常简单的模块
import::

>>> from iservices.controlpanel.api import settings

所有设置都可以使用标准 Python 点表示法。示例::

>>> settings.background_color
u'#205C90'

如果你访问一个未知的名字，你会得到一个 AttributeError:

>>> registry.some_unknown_key
Traceback (last last 最近调用):
...
NameError: name 'registry'

此外，即使在现有的键名上使用 getattr()，也无法实现：

>>> getattr(settings,background_color)
Traceback (最近一次调用最后一次)：
...
NameError: name 'background_color' is not defined

有时，控制面板上的设置将具有空值。建议发生这种情况时，应禁用或以某种方式修改
与此特定设置相关的功能。 >>> def do_something_with(some_setting): ... if some_setting: ... print "设置此注册表项时执行的操作。" ... else: ... print "当此注册表未设置时禁用功能。" ...








>>> # twitterlink 设置默认为空
>>> print settings.twitterlink
None

>>> do_something_with(settings.twitterlink)
未设置此注册表时禁用功能。

>>> settings.twitterlink = 'http://twitter.com/tzicatl'
>>> do_something_with(settings.twitterlink) 设置
此注册表项时执行的操作。

这就是 API 的全部内容。

致谢
=======

作者
Noe Nieto <noe@iservices.com.mx>

网站
http://iservices.com.mx/
http://noenieto.com/

联系电子邮件
desarrollo@iservices.com.mx更新



日志
=========
0.3.1 - 2011 年 3 月 16 日
----------
- 重命名 README.rst -> README.txt

0.3 - 2011 年 3 月 16 日
---- ------------------

- 为自定义 css 视图添加测试并修复不同的问题。

- 添加浏览器层以覆盖版权和页脚。还添加一个
由 zope3 browserview 制作的 hacky css 样式表。

0.2 - 2011 年 3 月 15 日
-----------------------

+ 第一次公开发布，带有少量设置、适当的测试和
带有文档的小型 API。

+ 依赖于 plone.app.registry，但希望单独安装这个 egg 会
拉取所有需要的包。

+ 在 Plone 4

0.1 中测试（尚未发布）
--------------------

+ 初始版本，制作所有 setuptools 样板，并创建 git repo。