+
−# copyright 2003-2010 LOGILAB S.A. (Paris, FRANCE), all rights reserved.
+
−# contact http://www.logilab.fr/ -- mailto:contact@logilab.fr
+
−#
+
−# This file is part of CubicWeb.
+
−#
+
−# CubicWeb is free software: you can redistribute it and/or modify it under the
+
−# terms of the GNU Lesser General Public License as published by the Free
+
−# Software Foundation, either version 2.1 of the License, or (at your option)
+
−# any later version.
+
−#
+
−# CubicWeb is distributed in the hope that it will be useful, but WITHOUT
+
−# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+
−# FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
+
−# details.
+
−#
+
−# You should have received a copy of the GNU Lesser General Public License along
+
−# with CubicWeb.  If not, see <http://www.gnu.org/licenses/>.
+
−"""abstract box classes for CubicWeb web client
+
−
+
−"""
+
−__docformat__ = "restructuredtext en"
+
−_ = unicode
+
−
+
−from logilab.mtconverter import xml_escape
+
−
+
−from cubicweb import Unauthorized, role as get_role, target as get_target
+
−from cubicweb.schema import display_name
+
−from cubicweb.selectors import (no_cnx, one_line_rset,  primary_view,
+
−                                match_context_prop, partial_has_related_entities)
+
−from cubicweb.view import View, ReloadableMixIn
+
−
+
−from cubicweb.web import INTERNAL_FIELD_VALUE
+
−from cubicweb.web.htmlwidgets import (BoxLink, BoxWidget, SideBoxWidget,
+
−                                      RawBoxItem, BoxSeparator)
+
−from cubicweb.web.action import UnregisteredAction
+
−
+
−
+
−class BoxTemplate(View):
+
−    """base template for boxes, usually a (contextual) list of possible
+
−
+
−    actions. Various classes attributes may be used to control the box
+
−    rendering.
+
−
+
−    You may override on of the formatting callbacks is this is not necessary
+
−    for your custom box.
+
−
+
−    Classes inheriting from this class usually only have to override call
+
−    to fetch desired actions, and then to do something like  ::
+
−
+
−        box.render(self.w)
+
−    """
+
−    __registry__ = 'boxes'
+
−    __select__ = ~no_cnx() & match_context_prop()
+
−
+
−    categories_in_order = ()
+
−    cw_property_defs = {
+
−        _('visible'): dict(type='Boolean', default=True,
+
−                           help=_('display the box or not')),
+
−        _('order'):   dict(type='Int', default=99,
+
−                           help=_('display order of the box')),
+
−        # XXX 'incontext' boxes are handled by the default primary view
+
−        _('context'): dict(type='String', default='left',
+
−                           vocabulary=(_('left'), _('incontext'), _('right')),
+
−                           help=_('context where this box should be displayed')),
+
−        }
+
−    context = 'left'
+
−    htmlitemclass = 'boxItem'
+
−
+
−    def sort_actions(self, actions):
+
−        """return a list of (category, actions_sorted_by_title)"""
+
−        result = []
+
−        actions_by_cat = {}
+
−        for action in actions:
+
−            actions_by_cat.setdefault(action.category, []).append(
+
−                (action.title, action) )
+
−        for key, values in actions_by_cat.items():
+
−            actions_by_cat[key] = [act for title, act in sorted(values)]
+
−        for cat in self.categories_in_order:
+
−            if cat in actions_by_cat:
+
−                result.append( (cat, actions_by_cat[cat]) )
+
−        for item in sorted(actions_by_cat.items()):
+
−            result.append(item)
+
−        return result
+
−
+
−    def mk_action(self, title, path, escape=True, **kwargs):
+
−        """factory function to create dummy actions compatible with the
+
−        .format_actions method
+
−        """
+
−        if escape:
+
−            title = xml_escape(title)
+
−        return self.box_action(self._action(title, path, **kwargs))
+
−
+
−    def _action(self, title, path, **kwargs):
+
−        return UnregisteredAction(self._cw, self.cw_rset, title, path, **kwargs)
+
−
+
−    # formating callbacks
+
−
+
−    def boxitem_link_tooltip(self, action):
+
−        if action.__regid__:
+
−            return u'keyword: %s' % action.__regid__
+
−        return u''
+
−
+
−    def box_action(self, action):
+
−        cls = getattr(action, 'html_class', lambda: None)() or self.htmlitemclass
+
−        return BoxLink(action.url(), self._cw._(action.title),
+
−                       cls, self.boxitem_link_tooltip(action))
+
−
+
−
+
−class RQLBoxTemplate(BoxTemplate):
+
−    """abstract box for boxes displaying the content of a rql query not
+
−    related to the current result set.
+
−
+
−    It rely on etype, rtype (both optional, usable to control registration
+
−    according to application schema and display according to connected
+
−    user's rights) and rql attributes
+
−    """
+
−
+
−    rql  = None
+
−
+
−    def to_display_rql(self):
+
−        assert self.rql is not None, self.__regid__
+
−        return (self.rql,)
+
−
+
−    def call(self, **kwargs):
+
−        try:
+
−            rset = self._cw.execute(*self.to_display_rql())
+
−        except Unauthorized:
+
−            # can't access to something in the query, forget this box
+
−            return
+
−        if len(rset) == 0:
+
−            return
+
−        box = BoxWidget(self._cw._(self.title), self.__regid__)
+
−        for i, (teid, tname) in enumerate(rset):
+
−            entity = rset.get_entity(i, 0)
+
−            box.append(self.mk_action(tname, entity.absolute_url()))
+
−        box.render(w=self.w)
+
−
+
−
+
−class UserRQLBoxTemplate(RQLBoxTemplate):
+
−    """same as rql box template but the rql is build using the eid of the
+
−    request's user
+
−    """
+
−
+
−    def to_display_rql(self):
+
−        assert self.rql is not None, self.__regid__
+
−        return (self.rql, {'x': self._cw.user.eid}, 'x')
+
−
+
−
+
−class EntityBoxTemplate(BoxTemplate):
+
−    """base class for boxes related to a single entity"""
+
−    __select__ = BoxTemplate.__select__ & one_line_rset() & primary_view()
+
−    context = 'incontext'
+
−
+
−    def call(self, row=0, col=0, **kwargs):
+
−        """classes inheriting from EntityBoxTemplate should define cell_call"""
+
−        self.cell_call(row, col, **kwargs)
+
−
+
−
+
−class RelatedEntityBoxTemplate(EntityBoxTemplate):
+
−    __select__ = EntityBoxTemplate.__select__ & partial_has_related_entities()
+
−
+
−    def cell_call(self, row, col, **kwargs):
+
−        entity = self.cw_rset.get_entity(row, col)
+
−        limit = self._cw.property_value('navigation.related-limit') + 1
+
−        role = get_role(self)
+
−        self.w(u'<div class="sideBox">')
+
−        self.wview('sidebox', entity.related(self.rtype, role, limit=limit),
+
−                   title=display_name(self._cw, self.rtype, role))
+
−        self.w(u'</div>')
+
−
+
−
+
−class EditRelationBoxTemplate(ReloadableMixIn, EntityBoxTemplate):
+
−    """base class for boxes which let add or remove entities linked
+
−    by a given relation
+
−
+
−    subclasses should define at least id, rtype and target
+
−    class attributes.
+
−    """
+
−
+
−    def cell_call(self, row, col, view=None, **kwargs):
+
−        self._cw.add_js('cubicweb.ajax.js')
+
−        entity = self.cw_rset.get_entity(row, col)
+
−        box = SideBoxWidget(display_name(self._cw, self.rtype), self.__regid__)
+
−        related = self.related_boxitems(entity)
+
−        unrelated = self.unrelated_boxitems(entity)
+
−        box.extend(related)
+
−        if related and unrelated:
+
−            box.append(BoxSeparator())
+
−        box.extend(unrelated)
+
−        box.render(self.w)
+
−
+
−    def div_id(self):
+
−        return self.__regid__
+
−
+
−    def box_item(self, entity, etarget, rql, label):
+
−        """builds HTML link to edit relation between `entity` and `etarget`
+
−        """
+
−        role, target = get_role(self), get_target(self)
+
−        args = {role[0] : entity.eid, target[0] : etarget.eid}
+
−        url = self._cw.user_rql_callback((rql, args))
+
−        # for each target, provide a link to edit the relation
+
−        label = u'[<a href="%s">%s</a>] %s' % (xml_escape(url), label,
+
−                                               etarget.view('incontext'))
+
−        return RawBoxItem(label, liclass=u'invisible')
+
−
+
−    def related_boxitems(self, entity):
+
−        rql = 'DELETE S %s O WHERE S eid %%(s)s, O eid %%(o)s' % self.rtype
+
−        related = []
+
−        for etarget in self.related_entities(entity):
+
−            related.append(self.box_item(entity, etarget, rql, u'-'))
+
−        return related
+
−
+
−    def unrelated_boxitems(self, entity):
+
−        rql = 'SET S %s O WHERE S eid %%(s)s, O eid %%(o)s' % self.rtype
+
−        unrelated = []
+
−        for etarget in self.unrelated_entities(entity):
+
−            unrelated.append(self.box_item(entity, etarget, rql, u'+'))
+
−        return unrelated
+
−
+
−    def related_entities(self, entity):
+
−        return entity.related(self.rtype, get_role(self), entities=True)
+
−
+
−    def unrelated_entities(self, entity):
+
−        """returns the list of unrelated entities, using the entity's
+
−        appropriate vocabulary function
+
−        """
+
−        skip = set(e.eid for e in entity.related(self.rtype, get_role(self),
+
−                                                 entities=True))
+
−        skip.add(None)
+
−        skip.add(INTERNAL_FIELD_VALUE)
+
−        filteretype = getattr(self, 'etype', None)
+
−        entities = []
+
−        form = self._cw.vreg['forms'].select('edition', self._cw,
+
−                                             rset=self.cw_rset,
+
−                                             row=self.cw_row or 0)
+
−        field = form.field_by_name(self.rtype, get_role(self), entity.e_schema)
+
−        for _, eid in field.vocabulary(form):
+
−            if eid not in skip:
+
−                entity = self._cw.entity_from_eid(eid)
+
−                if filteretype is None or entity.__regid__ == filteretype:
+
−                    entities.append(entity)
+
−        return entities
+
−