From ebefd631a265bcca97adc8e52cf4d88b21581bab Mon Sep 17 00:00:00 2001
From: helmutm <helmutm@fd906abe-77d9-0310-91a1-e0d9ade77398>
Date: Sun, 16 Mar 2008 21:11:08 +0000
Subject: [PATCH] added view and actions for a pseudo-folder concept type

git-svn-id: svn://svn.cy55.de/Zope3/src/loops/trunk@2457 fd906abe-77d9-0310-91a1-e0d9ade77398
---
 browser/configure.zcml          |   9 ++++
 browser/folder.py               |  57 +++++++++++++++++++++++++
 helpers.txt                     |  71 ++++++++++++++++++++++++++++++--
 interfaces.py                   |   1 -
 locales/de/LC_MESSAGES/loops.mo | Bin 6341 -> 6632 bytes
 locales/de/LC_MESSAGES/loops.po |  15 +++++++
 6 files changed, 148 insertions(+), 5 deletions(-)
 create mode 100755 browser/folder.py

diff --git a/browser/configure.zcml b/browser/configure.zcml
index 4108841..7019d2f 100644
--- a/browser/configure.zcml
+++ b/browser/configure.zcml
@@ -221,6 +221,15 @@
       permission="zope.View"
       />
 
+  <zope:adapter
+      name="folder.html"
+      for="loops.interfaces.IConcept
+           zope.publisher.interfaces.browser.IBrowserRequest"
+      provides="zope.interface.Interface"
+      factory="loops.browser.folder.FolderView"
+      permission="zope.View"
+      />
+
   <!-- resource manager -->
 
   <addform
diff --git a/browser/folder.py b/browser/folder.py
new file mode 100755
index 0000000..d94661a
--- /dev/null
+++ b/browser/folder.py
@@ -0,0 +1,57 @@
+#
+#  Copyright (c) 2008 Helmut Merz helmutm@cy55.de
+#
+#  This program is free software; you can redistribute it and/or modify
+#  it under the terms of the GNU General Public License as published by
+#  the Free Software Foundation; either version 2 of the License, or
+#  (at your option) any later version.
+#
+#  This program 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 General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License
+#  along with this program; if not, write to the Free Software
+#  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+
+"""
+Elements for handling and presentation of pseudo folders.
+
+$Id$
+"""
+
+
+from cybertools.browser.action import actions
+from loops.browser.action import DialogAction
+from loops.browser.concept import ConceptView
+from loops.util import _
+
+
+actions.register('createFolder', 'portlet', DialogAction,
+        title=_(u'Create Folder...'),
+        description=_(u'Create a new folder.'),
+        viewName='create_concept.html',
+        dialogName='createFolder',
+        typeToken='.loops/concepts/folder',
+        fixedType=True,
+        innerForm='inner_concept_form.html',
+)
+
+actions.register('editFolder', 'portlet', DialogAction,
+        title=_(u'Edit Folder...'),
+        description=_(u'Modify folder.'),
+        viewName='edit_concept.html',
+        dialogName='editFolder',
+)
+
+
+class FolderView(ConceptView):
+
+    def getActions(self, category='concept', page=None):
+        if category == 'portlet':
+            return actions.get(category, ['createFolder', 'editFolder'],
+                               view=self, page=page)
+        return []
+
diff --git a/helpers.txt b/helpers.txt
index 76efbe2..a238383 100755
--- a/helpers.txt
+++ b/helpers.txt
@@ -280,6 +280,13 @@ i.e. the 'topic' concept, via an adapter:
   >>> ITopic.providedBy(cc1Adapter)
   True
 
+There is a shortcut to getting the typeInterface adapter for an object.
+
+  >>> from loops.common import adapted
+  >>> cc1Adapter = adapted(cc1)
+  >>> ITopic.providedBy(cc1Adapter)
+  True
+
 
 Simple access to type information with BaseView
 -----------------------------------------------
@@ -299,8 +306,8 @@ context object's type:
   <Topic object ...>
 
 
-Concepts as queries
--------------------
+Concepts as Queries
+===================
 
 We first have to set up the query type, i.e. a type concept associated
 with the IQueryConcept interface. The query type concept itself has already
@@ -348,8 +355,8 @@ view/multi-adapter with this name:
   <class 'SimpleView'>
 
 
-Controlling presentation using view properties
-----------------------------------------------
+Controlling Presentation Using View Properties
+==============================================
 
   >>> from zope.annotation.interfaces import IAttributeAnnotatable, IAnnotations
   >>> from zope.annotation.attribute import AttributeAnnotations
@@ -405,3 +412,59 @@ browser).
   >>> controller = Controller(view, request)
   >>> controller.skinName.value
   'SuperSkin'
+
+
+Folders
+=======
+
+  We may provide a concept type called a folder - there is no special
+  functionality about it but it may be used for building a pseudo hierarchy
+  using nested folders. This may make it easier for users to map the
+  structures of their documents in the filesystem to the loops concept
+  map.
+
+  >>> from loops.setup import addAndConfigureObject
+  >>> tFolder = addAndConfigureObject(concepts, Concept, 'folder',
+  ...                   title=u'Folder', conceptType=typeObject)
+
+Usually we want to create folders only in objects of a certain type,
+e.g. in a domain. So we activate the folder creation action by providing
+the domain type with a corresponding option.
+
+  >>> tDomain = concepts['domain']
+  >>> taDomain = adapted(tDomain)
+  >>> taDomain.options = ['action.portlet:createFolder']
+
+Importing the FolderView will register this action.
+
+  >>> from loops.browser.folder import FolderView
+
+If we now create a domain and set up a view on it it will provide the
+folder creation action.
+
+  >>> general = addAndConfigureObject(concepts, Concept, 'general',
+  ...                   title=u'General', conceptType=tDomain)
+
+  >>> from loops.browser.concept import ConceptView
+  >>> view = ConceptView(general, TestRequest())
+  >>> sorted(a.name for a in view.getActions('portlet'))
+  ['createFolder']
+
+Let's now create a folder.
+
+  >>> f01 = addAndConfigureObject(concepts, Concept, 'f01',
+  ...                   title=u'Test Folder', conceptType=tFolder)
+
+A folder should be associated with a FolderView that provides two actions
+for editing the folder and for creating a new subfolder.
+
+  >>> view = FolderView(f01, TestRequest())
+  >>> sorted(a.name for a in view.getActions('portlet'))
+  ['createFolder', 'editFolder']
+
+
+Fin de partie
+=============
+
+  >>> placefulTearDown()
+
diff --git a/interfaces.py b/interfaces.py
index 14ba8fd..266f454 100644
--- a/interfaces.py
+++ b/interfaces.py
@@ -28,7 +28,6 @@ from zope import schema
 from zope.app.container.constraints import contains, containers
 from zope.app.container.interfaces import IContainer, IOrderedContainer
 from zope.app.file.interfaces import IImage as IBaseAsset
-from zope.app.folder.interfaces import IFolder
 from zope.component.interfaces import IObjectEvent
 from zope.size.interfaces import ISized
 
diff --git a/locales/de/LC_MESSAGES/loops.mo b/locales/de/LC_MESSAGES/loops.mo
index 529e1f04865d7a01d8c135ca7b91c881eef1a256..f9293a5d3240bf6925e3826346b33161f2a9a961 100644
GIT binary patch
delta 2516
zcmYk+TWnNC9LMqLZK3qC(r#~vuoVg|Eo-s06uDHYl$-6gRuHPSblX#?t=nX+7;iaI
z(fC3z)YTBRsX{P{*2GGApeCk7Q_vUVgGLBEKw^!3Km!kz7r(#V*|?Mb_cJp+XXZb1
z=A7@>&DOYA^U|Y+GC(XPhSQ8u$4?%9DE>@iTCo%>F@g(l6qn;^ybFK8Z2T1&!rZ_t
zoVES8uz+^TB4Y}%2<dW7fQsg-M=v&DI|gwfo<vRf1?J;7n1?f{i7%rjo<of@Z~Ha7
zu3wD0t_*!xhefy>i<#f_P|<*|*nb>DUHB>9gHyN|f5&v3LozpiBY)-&Kbm*}St#LL
z%*7(qeXCFj)Z6}@sQLC`0rQ&yDmnNX>cV5F3C2(pevX>pE3Cyy`~SaC_uWQKoJK?U
zWutbi5S73(Yc(pdMpWW$=xTyaDvV)5ScXHWM53sHPNOCm$7(!h`)5&)>?UTQMyF~#
zsAug%-M0ocPYuQ%HS%W~a@l`n(n9NQ>_FXc7<HkG{F%4-S%Xp3)_sQ>@E6p?zuERx
z)QYd;TD*-KcLiDMx(3vv-DcYzUiM!rKR|~Dd=`~?1l9jGa-K{SmDm{Sy3eo*$5C&=
zWz<gHK~0p#_Q_0CzZW%L5o(;3Sf4_YE|o{<=p*focm{RBA6SVuaS1ME*(}DaNBzGE
zwG%;pbjm}h*Xl580Y_11;iUCTWGZtGyKn~esN8byR)%$`t=WQlB<;4{g?bdjsOw%v
zy*_WC68iwj(M+Nen86afW}Qcko6pZmEJxkfjC^lgbBGGpm^V=qoj_$ahT5`m)Wqj)
z{{_?lKciMUhnhH*231pnN+5vxpzW~z4l41NPzyYc8G8Rmsc7O;xEar&w)jufmj8qL
zqNOm4wlo9ve=qX5O)(Z@IqLeYsKi@QXQ0#e_n;nW1o<<g{A4q~IZH(YPGbxHh)QS)
z>GGINDQX95ZF>`Hg+Ww8{nqDD_q~cr<Opiq5o8VKL)2mZ8npx8qN@omQrU!8Py?5+
z98Fk*8gQd+H=?fJg|*m;6?h!A(kWbr)3$vJmB_!S9n55Ky^cAkovSEe|Mjdl(4m!V
zM@`&@b+{k(34X`+kE14<v`*RnY1ARSgj(4Z<n1!Mh-HM5-9xM(R6@l4#AZGJL{TDo
zMI2%Wp~KTmlo8400UBCGUs7ie_4T&>1g<8O_*2Bagg#zuZtUBk1hp&A5Zg3=BcTJM
zqUZH!tY*y9xRzisv7#+g*%!w=j$MSFsY*MsfjFcFrJSfDv}0Qdl>nigY9bC0ZU;Zf
z<-w$ep4slC_I=bliC){c+^P?lUcJ494%&V~uV|vQ*h(tuoV5}4M62Ha?Nm4)<{;rG
zN{Jw$gI7%?ias8RqVL5{;vu4+(AiOWl6aVSjA$UX5Q$PrMQ2Lq>;J-%bfWd?O_Wts
zDu@B1hR})bCR7S1K3eEa^)w9)_BxS~j~Bh}>5Er=S?^}Xdjo;M$R}AH>9H&3vySF8
z5B2u<z37i$IB_KVpvM!8^oF_rT3$3i><>H7J7Isk%ikRybVdgA&-!dT<a9?uPXDkI
d*0_G(3yFK*^Sz&Iueoq4Og7<(s)7?~{{i0d;&=c6

delta 2278
zcmYk-drX#99Ki7t5{ZB!x1c~WB}+jukr33Z2rwvLN)s_MOdVUWY_T=7?X{IHYmLd9
zk@W}JO&hDV(Hz!VTdl3At;^QBZLH<iTG$`8tgV*o`+YgJ&iFl_^IYEZJGbZI$5rpI
zOimSK9to5^L^;thD}+P%Ko$qebF)K8;4xf=zv2bBAUlLgybSZP1#@vL(nQ#WIoKDk
z4`MOr4`K<9Ab-j58b@<Y;5>W>Z^2KHTw&3inS|9?$ax(WU>llvJDRv3ZD(J+egJ*`
zFc#rUcp<)trT94(kUvbv8|Scs8zppmKGtC-wjg~8?Z{u)!oftnXb1anF5ZLw?f}}c
zVYH(!pd&wtdH8X>{|#o7KTK0G(OIm+KfQq~7?wX+gC=T4uP4wY=tdLnj1D3{4UeGh
z4I_VHghLg+h<0oe{r$I?wBgfKYVl0GQ9)Lhq6*K))o4eWI5?7x=<jx*iTcnP89--Z
z5belAcrgy4&yS(cy@5XWRvz=el*%L*oT{^EgR{A7;ym=c5FKeL*5FdK;V$&KL3EAp
zkLN?kSi%wX_s^ppKOV2YjjVQ<oXh;%voGR<Q&`RUX>@nzGYw8vEt;qyx;|cSMiX_Q
z?QFw_^H>sW=KNXay9vKT@0T-*Wmtt5VP}#Gxk5ksz<zWl9!7WX2>QB=p(A(~-2-1m
zzem^f4DP_ckx2|aG-Ai^LTBb)bV(kK=TD+bk$i=U55A7R9usKKK1CBxV;N@98!bm0
ztjERJj(#`xB7flt4mNxY?Z^pqhEAe+-iy~iLh>ZT*Hj$YZ)n0fv~Hq>Xv0lt!Y&SW
zZ~z_2L3BwD<2oF{^irZTI)#3Senw~Pmw5j#WOYI&NlShIi>TPc8nnSiw1ExiT5Uo*
zwjX_N7)>;aH{l6%#D5@@70#g}ozIUvFGB}Zjdr9Zn!qgbhi)n+>_r>ii?k8;p}TYl
z9q}`0gD>M+JcTy=JDM<`>9HfF=y@gj{1U9gM!W*=MhAKnlPjr=#tWaJ9r+TSx*yQj
z>?d@}viNSgrX}b|7Nd!lV?EZRU(kVg{c$u=Dta_tA4T?QIPUyAvQu2(tw|SqXxUDz
zC-xAx5|<P7BV0vXO<YenORa=uGvTYoHVO-gT|^b(Tk-$m3|np^YFz(nD%X02vVqu1
z+(}rr5?zF&zLHo(+(7gY&YT->8)0#ZEsaD*x;ArgW|kAq=)dKTSV_44Hxq8GRq^7D
z=yWqF{}tZ^%QeJmVv8pf*Sj)Z3*l1SO}I1`H}CC)OVUobS$m1=2+Im0*}=h0Vp&6M
zO4s<mjtzvL=Oyu)9~$?ApH$06qK$A9T3l<_)jeTZFhly^xz%o>lkmI2TWE1&W{Mvj
z_d+w_u4hw+7UB}ZO<7B<9k0lqmyueRb6@JioP(*J+|8+p+{eZ{^LA&YJ}5kt>MwdV
V)mB`VYAx<bjTJvNo+x>G)<62nws-&l

diff --git a/locales/de/LC_MESSAGES/loops.po b/locales/de/LC_MESSAGES/loops.po
index 932cf8b..2e1a03e 100644
--- a/locales/de/LC_MESSAGES/loops.po
+++ b/locales/de/LC_MESSAGES/loops.po
@@ -17,6 +17,9 @@ msgstr "Begriff"
 msgid "Resource"
 msgstr "Ressource"
 
+msgid "Folder"
+msgstr "Ordner"
+
 msgid "Log out"
 msgstr "Abmelden"
 
@@ -32,6 +35,18 @@ msgstr "Ressource anlegen..."
 msgid "Create a new resource object."
 msgstr "Eine neue Ressource erzeugen"
 
+msgid "Create Folder..."
+msgstr "Ordner anlegen..."
+
+msgid "Create a new folder."
+msgstr "Einen neuen Ordner anlegen"
+
+msgid "Edit Folder..."
+msgstr "Ordner bearbeiten..."
+
+msgid "Modify folder."
+msgstr "Ordner ändern"
+
 msgid "Edit Blog Post..."
 msgstr "Eintrag bearbeiten..."