#############################################################################
#
# Copyright (c) 2001, 2002 Zope Foundation and Contributors.
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL). A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#
##############################################################################
"""ZCML directives for defining browser resources
"""
from zope.configuration.fields import GlobalObject, GlobalInterface
from zope.configuration.fields import Path, MessageID
from zope.interface import Interface
from zope.schema import TextLine, Int
from zope.security.zcml import Permission
[docs]class IResourceDirective(IBasicResourceInformation):
"""
Defines a browser resource.
.. seealso:: `.FileResourceFactory`
"""
name = TextLine(
title=u"The name of the resource",
description=u"""
This is the name used in resource urls. Resource urls are of
the form ``<site>/@@/resourcename``, where ``<site>`` is the url of
"site", a folder with a site manager.
We make resource urls site-relative (as opposed to
content-relative) so as not to defeat caches.""",
required=True
)
factory = GlobalObject(
title=u"Resource Factory",
description=u"The factory used to create the resource. The factory "
u"should only expect to get the request passed when "
u"called.",
required=False
)
file = Path(
title=u"File",
description=u"The file containing the resource data. The resource "
u"type that will be created depends on file extension. "
u"The named IResourceFactoryFactory utilities are "
u"registered per extension. If no factory is registered "
u"for given file extension, the default FileResource "
u"factory will be used.",
required=False
)
image = Path(
title=u"Image",
description=u"""
If the image attribute is used, then an image resource, rather
than a file resource will be created.
This attribute is deprecated in favor of pluggable resource types,
registered per extension. Use the "file" attribute instead.
""",
required=False
)
template = Path(
title=u"Template",
description=u"""
If the template attribute is used, then a page template resource,
rather than a file resource will be created.
This attribute is deprecated in favor of pluggable resource types,
registered per extension. Use the "file" attribute instead. To
use page template resources, you need to install zope.ptresource
package.
""",
required=False
)
[docs]class II18nResourceDirective(IBasicResourceInformation):
"""
Defines an i18n'd resource.
"""
name = TextLine(
title=u"The name of the resource",
description=u"""
This is the name used in resource urls. Resource urls are of
the form ``<site>/@@/resourcename``, where ``<site>`` is the url of
"site", a folder with a site manager.
We make resource urls site-relative (as opposed to
content-relative) so as not to defeat caches.""",
required=True
)
defaultLanguage = TextLine(
title=u"Default language",
description=u"Defines the default language",
required=False
)
[docs]class II18nResourceTranslationSubdirective(IBasicResourceInformation):
"""
Subdirective to `II18nResourceDirective`.
"""
language = TextLine(
title=u"Language",
description=u"Language of this translation of the resource",
required=True
)
file = Path(
title=u"File",
description=u"The file containing the resource data.",
required=False
)
image = Path(
title=u"Image",
description=u"""
If the image attribute is used, then an image resource, rather
than a file resource will be created.
This attribute is deprecated, as images are now simply files.
Use the "file" attribute instead.
""",
required=False
)
[docs]class IResourceDirectoryDirective(IBasicResourceInformation):
"""
Defines a directory containing browser resources.
.. seealso:: `.DirectoryResource`
"""
name = TextLine(
title=u"The name of the resource",
description=u"""
This is the name used in resource urls. Resource urls are of
the form ``<site>/@@/resourcename``, where ``<site>`` is the url of
"site", a folder with a site manager.
We make resource urls site-relative (as opposed to
content-relative) so as not to defeat caches.""",
required=True
)
directory = Path(
title=u"Directory",
description=u"The directory containing the resource data.",
required=True
)
[docs]class IIconDirective(Interface):
"""
Define an icon for an interface.
"""
name = TextLine(
title=u"The name of the icon.",
description=u"The name shows up in URLs/paths. For example 'foo'.",
required=True
)
for_ = GlobalInterface(
title=u"The interface this icon is for.",
description=u"""
The icon will be for all objects that implement this
interface.""",
required=True
)
file = Path(
title=u"File",
description=u"The file containing the icon.",
required=False
)
resource = TextLine(
title=u"Resource",
description=u"A resource containing the icon.",
required=False
)
title = MessageID(
title=u"Title",
description=u"Descriptive title",
required=False
)
layer = GlobalInterface(
title=u"The layer the icon should be found in",
description=u"""
For information on layers, see the documentation for the skin
directive. Defaults to "default".""",
required=False
)
width = Int(
title=u"The width of the icon.",
description=u"""
The width will be used for the <img width="..." />
attribute. Defaults to 16.""",
required=False,
default=16
)
height = Int(
title=u"The height of the icon.",
description=u"""
The height will be used for the <img height="..." />
attribute. Defaults to 16.""",
required=False,
default=16
)