.. -*- coding: utf-8 -*- .. _vue_plone: ============== La vue "plone" ============== Cette vue fournit nombre d'informations particulièrement utiles dans la construction de vos templates. À noter que dans vos templates utilisant la macro de gabarit de page par défaut, cette vue est accessible par l'objet ``plone_view``. .. code-block:: xml ...
Cette URL est http://foo
... Détails dans :class:`Products.CMFPlone.browser.interfaces.IPlone` .. note:: Vous noterez à la lecture des méthodes proposées que nombre d'entre elles sont reprises de :ref:`vue_plone_context_state`, :ref:`vue_plone_portal_state` ou :ref:`vue_plone_layout`. Celles-ci sont des raccourcis facilitant la compatibilité ascendante avec les versions antérieures de Plone. Pour programmer un composant qu'il est inutile de rendre compatible avec ces anciennes version, on préfèrera l'utilisations des méthodes équivalentes de :ref:`vue_plone_context_state`, :ref:`vue_plone_portal_state` ou :ref:`vue_plone_layout`. .. list-table:: plone :widths: 20 60 :header-rows: 1 * - Attribut - Méthode - Description * - ``getCurrentUrl()`` - URL courante incluant la query string (paramètres CGI) * - ``visibleIdsEnabled()`` - ``True`` si la modification des id des éléments de contenus sont permis au niveau du portail comme au niveau de l'utilisateur. * - ``uniqueItemIndex(pos=0)`` - Retourne un itérateur utilisable pour énumérer des éléments dans une template avec la méthode :meth:`next()`. Exemple : ``tal:define="foo plone_view/uniqueItemIndex; un foo/next; deux foo/next"`` * - ``toLocalizedTime(time, long_format=None, time_only=None)`` - Convertit un objet :class:`DateTime` ou une date sous forme de `chaîne normalisée ISO 8601 `_ en une date et heure localisées sous forme de chaîne de caractères. * - ``normalizeString(text)`` - Transforme un texte quelconque éventuellement unicode en une chaîne ASCII compatible avec les identifiants Zope. * - ``isDefaultPageInFolder()`` - Equivalent à la méthode :meth:`is_default_page()` de :ref:`vue_plone_context_state`. * - ``isStructuralFolder()`` - Equivalent à la méthode :meth:`is_structural_folder()` de :ref:`vue_plone_context_state`. * - ``hide_columns(self, column_left, column_right)`` - Equivalent de la méthode :meth:`hide_columns(self, column_left, column_right)` de :ref:`vue_plone_layout`. * - ``navigationRootPath`` - Equivalent de la méthode :meth:`navigation_root_path()` de :ref:`vue_plone_portal_state`. * - ``navigationRootUrl()`` - Equivalent de la méthode :meth:`navigation_root_url()` de :ref:`vue_plone_portal_state`. * - ``getParentObject()`` - Equivalent de la méthode :meth:`parent()` de :ref:`vue_plone_context_state`. * - ``getCurrentFolder()`` - Equivalent de la méthode :meth:`folder()` de :ref:`vue_plone_context_state`. * - ``getCurrentFolderUrl()`` - L'URL du dossier retourné par :meth:`getCurrentFolder()` ci-dessus. * - ``getCurrentObjectUrl()`` - Equivalent de la méthode :meth:`canonical_object_url()` de :ref:`vue_plone_context_state`. * - ``isFolderOrFolderDefaultPage()`` - Equivalent de la méthode :meth:`is_default_page()` de :ref:`vue_plone_context_state`. * - ``isPortalOrPortalDefaultPage()`` - Equivalent de la méthode :meth:`is_portal_root()` de :ref:`vue_plone_context_state`. * - ``getViewTemplateId()`` - Equivalent de la méthode :meth:`view_template_id()` de :ref:`vue_plone_context_state`. * - ``showEditableBorder()`` - Détermine si le cadre d'édition (contenant les onglets "Contenu", "Modifier", ...) doit être affiché. * - ``displayContentsTab()`` - Détermine si les onglets d'édition doivent être affichés. * - ``getIcon(item)`` - Equivalent de la méthode :meth:`getIcon(item)` de :ref:`vue_plone_layout`. * - ``cropText(text, length, ellipsis)`` - Tronque un texte brut jusqu'à ``length`` caractères tout en omettant l'éventuel mot coupé. * - ``have_portlets(manager_name, view=None)`` - Equivalent de la méthode :meth:`have_portlets(manager_name, view=None)` de :ref:`vue_plone_layout`. * - ``mark_view(view)`` - Equivalent de la méthode :meth:`mark_view(view)` de :ref:`vue_plone_layout`. * - ``site_encoding()`` - L'encodage du texte de ce site. Typiquement ``utf-8``. * - ``bodyClass(template, view)`` - Equivalent de la méthode :meth:`bodyClass(template, view)` de :ref:`vue_plone_layout`.