diff options
| author | Casey Duncan <casey.duncan@gmail.com> | 2011-01-18 23:05:54 -0700 |
|---|---|---|
| committer | Casey Duncan <casey.duncan@gmail.com> | 2011-01-18 23:05:54 -0700 |
| commit | b0240d3d5a39a504d5a5155a23a6d6a431b457ef (patch) | |
| tree | b0c3b4f5dd8a0ec1c01912bfeff769d1329a9c97 /docs/zcml/default_permission.rst | |
| parent | 278b302270823336d770761aaac22d854e348ea6 (diff) | |
| parent | 48bccbe4ff7351d823a471005effea1afc06bb4f (diff) | |
| download | pyramid-b0240d3d5a39a504d5a5155a23a6d6a431b457ef.tar.gz pyramid-b0240d3d5a39a504d5a5155a23a6d6a431b457ef.tar.bz2 pyramid-b0240d3d5a39a504d5a5155a23a6d6a431b457ef.zip | |
Merge https://github.com/Pylons/pyramid
Diffstat (limited to 'docs/zcml/default_permission.rst')
| -rw-r--r-- | docs/zcml/default_permission.rst | 57 |
1 files changed, 0 insertions, 57 deletions
diff --git a/docs/zcml/default_permission.rst b/docs/zcml/default_permission.rst deleted file mode 100644 index 54e720ea6..000000000 --- a/docs/zcml/default_permission.rst +++ /dev/null @@ -1,57 +0,0 @@ -.. _default_permission_directive: - -``default_permission`` -------------------------------- - -Set the default permission to be used by all :term:`view -configuration` registrations. - -This directive accepts a single attribute ,``name``, which should be -used as the default permission string. An example of a permission -string: ``view``. Adding a default permission makes it unnecessary to -protect each view configuration with an explicit permission, unless -your application policy requires some exception for a particular view. - -If a default permission is *not* set, views represented by view -configuration registrations which do not explicitly declare a -permission will be executable by entirely anonymous users (any -authorization policy is ignored). - -There can be only one default permission active at a time within an -application, thus the ``default_permission`` directive can only be -used once in any particular set of ZCML. - -Attributes -~~~~~~~~~~ - -``name`` - Must be a string representing a :term:`permission`, - e.g. ``view``. - - -Example -~~~~~~~ - -.. code-block:: xml - :linenos: - - <default_permission - name="view" - /> - -Alternatives -~~~~~~~~~~~~ - -Using the ``default_permission`` argument to the -:class:`pyramid.config.Configurator` constructor can be used -to achieve the same purpose. - -Using the -:meth:`pyramid.config.Configurator.set_default_permission` -method can be used to achieve the same purpose when using imperative -configuration. - -See Also -~~~~~~~~ - -See also :ref:`setting_a_default_permission`. |
