ECHO_content/ECHO_Nav.py - diff

Return to ECHO_Nav.py CVS log

Up to [Repository] / ECHO_content

Diff for /ECHO_content/ECHO_Nav.py between versions 1.47 and 1.74

version 1.47, 2004/09/27 14:39:59	version 1.74, 2006/03/02 19:59:03
Line 1	Line 1
# Objekte zur Erzeugung von Navigationselementen	# Objekte zur Erzeugung von Navigationselement
	from AccessControl import ClassSecurityInfo
from Globals import DTMLFile	from Globals import DTMLFile
from OFS.Image import Image,cookId	from OFS.Image import Image,cookId
from OFS.Folder import Folder	from OFS.Folder import Folder
Line 12 from Products.PageTemplates.ZopePageTemp	Line 12 from Products.PageTemplates.ZopePageTemp
import os.path	import os.path
from Globals import package_home	from Globals import package_home
import urllib	import urllib
from ECHO_helpers import displayTypes,checkOnlyOneInGroup	from ECHO_helpers import *
from ECHO_collection import content_html	from ECHO_collection import content_html
	from types import *


from Globals import DTMLFile	from Globals import DTMLFile
Line 27 import re	Line 27 import re
import string	import string
from Products.PageTemplates.ZopePageTemplate import ZopePageTemplate	from Products.PageTemplates.ZopePageTemplate import ZopePageTemplate
import os.path	import os.path
from Globals import package_home
import urllib	import urllib
from ECHO_helpers import displayTypes,checkOnlyOneInGroup	from ECHO_helpers import displayTypes,checkOnlyOneInGroup
from ECHO_collection import content_html	from ECHO_collection import content_html
	import zLOG

	try:
	from Products.ZSQLExtend.ZSQLExtend import ZSQLExtendFolder
	except:
	zLOG.LOG('ECHO_Nav',zLOG.INFO,'ZSQLSimpleSearch not supported')



Line 51 class ECHO_ZCatalogElement(SimpleItem):	Line 56 class ECHO_ZCatalogElement(SimpleItem):
self.weight=weight	self.weight=weight
self.content=contentType	self.content=contentType


manage_options= SimpleItem.manage_options+(	manage_options= SimpleItem.manage_options+(
{'label':'Main Config','action':'changeECHO_ZCatalogElementForm'},	{'label':'Main Config','action':'changeECHO_ZCatalogElementForm'},
)	)
Line 75 class ECHO_ZCatalogElement(SimpleItem):	Line 81 class ECHO_ZCatalogElement(SimpleItem):
def changeECHO_ZCatalogElementForm(self):	def changeECHO_ZCatalogElementForm(self):
"""change"""	"""change"""

pt=PageTemplateFile('Products/ECHO_content/zpt/changeECHO_ZCatalogElement.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','changeECHO_ZCatalogElement.zpt')).__of__(self)
return pt()	return pt()

def changeECHO_ZCatalogElement(self,title,field,catalogId,baseUrl,weight,contentType,RESPONSE=None):	def changeECHO_ZCatalogElement(self,title,field,catalogId,baseUrl,weight,contentType,RESPONSE=None):
Line 90 class ECHO_ZCatalogElement(SimpleItem):	Line 96 class ECHO_ZCatalogElement(SimpleItem):
if RESPONSE is not None:	if RESPONSE is not None:
RESPONSE.redirect('manage_main')	RESPONSE.redirect('manage_main')
def getKeywordList(self):	def getKeywordList(self):
	try:
return getattr(self,self.catalogId).uniqueValuesFor(self.field)	return getattr(self,self.catalogId).uniqueValuesFor(self.field)
	except:
	#return getattr(self,self.catalogId).query(self.field)

	list= [x for x in getattr(getattr(self,self.catalogId),self.field).words()]
	list.sort()
	return list

def getNavList(self):	def getNavList(self):
"""ausgabe der treffer list für navigation"""	"""ausgabe der treffer list fuer navigation"""

records=self.getKeywordList()	records=self.getKeywordList()

	records=[x.encode('utf-8') for x in records]
	records.sort()
if not records:	if not records:
return []	return []
else:	else:
ret=[]	ret=[]
for record in records:	for record in records:

#print "RC",record	#print "RC",record
#if record:	#if record:
# ret.append((record,self.baseUrl+urllib.quote(record)))	# ret.append((record,self.baseUrl+urllib.quote(record)))
Line 116 class ECHO_ZCatalogElement(SimpleItem):	Line 131 class ECHO_ZCatalogElement(SimpleItem):

def manage_addECHO_ZCatalogElementForm(self):	def manage_addECHO_ZCatalogElementForm(self):
"""Form for adding"""	"""Form for adding"""
pt=PageTemplateFile('Products/ECHO_content/zpt/AddECHO_ZCatalogElement.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','AddECHO_ZCatalogElement.zpt')).__of__(self)
return pt()	return pt()

def manage_addECHO_ZCatalogElement(self,id,title,field,baseUrl,weight,contentType,RESPONSE=None):	def manage_addECHO_ZCatalogElement(self,id,title,field,catalogId,baseUrl,weight,contentType,RESPONSE=None):
"""Add an ECHO_ZCatalogelement"""	"""Add an ECHO_ZCatalogelement"""
self._setObject(id,ECHO_ZCatalogElement(id,title,field,baseUrl,weight,contentType))
	self._setObject(id,ECHO_ZCatalogElement(id,title,field,catalogId,baseUrl,weight,contentType))

if RESPONSE is not None:	if RESPONSE is not None:
RESPONSE.redirect('manage_main')	RESPONSE.redirect('manage_main')
Line 140 class ECHO_contentType(Image):	Line 156 class ECHO_contentType(Image):

def changeECHO_contentTypeForm(self):	def changeECHO_contentTypeForm(self):
"""Change the description text"""	"""Change the description text"""
pt=PageTemplateFile('Products/ECHO_content/zpt/changeECHO_contentType.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','changeECHO_contentType.zpt')).__of__(self)
return pt()	return pt()

def changeECHO_contentType(self,description,RESPONSE=None):	def changeECHO_contentType(self,description,RESPONSE=None):
Line 238 class ECHO_sqlElement(SimpleItem):	Line 254 class ECHO_sqlElement(SimpleItem):
def changeECHO_sqlElementForm(self):	def changeECHO_sqlElementForm(self):
"""change"""	"""change"""

pt=PageTemplateFile('Products/ECHO_content/zpt/changeECHO_sqlElement.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','changeECHO_sqlElement.zpt')).__of__(self)
return pt()	return pt()

def changeECHO_sqlElement(self,title,query,field,searchField,baseUrl,weight,contentType,RESPONSE=None):	def changeECHO_sqlElement(self,title,query,field,searchField,baseUrl,weight,contentType,RESPONSE=None):
Line 254 class ECHO_sqlElement(SimpleItem):	Line 270 class ECHO_sqlElement(SimpleItem):
if RESPONSE is not None:	if RESPONSE is not None:
RESPONSE.redirect('manage_main')	RESPONSE.redirect('manage_main')

def searchQuery(self,query=None,obj=None):	try:
#presently a hack, tests if search is of the search method, if not look at the next level.	searchQuery=ZSQLExtendFolder.ZSQLSimpleSearch
#	except:
#return self.ZSQLsimpleSearch(var=self.query)	zLOG.LOG('ECHO_Nav',zLOG.INFO,'ZSQLSimpleSearch not supported')
if not query:
query=self.query

if self.search.meta_type=="Z SQL Method":
return self.search(var=self.query)
else:
if self.aq_parent.aq_parent.search.meta_type=="Z SQL Method":
return self.aq_parent.aq_parent.search(var=self.query)
else:
return []




def getNavList(self):	def getNavList(self):
"""ausgabe der treffer list für navigation"""	"""ausgabe der treffer list fuer navigation"""

records=self.searchQuery()	#naechste schritte sind trial and error, warum geht mal das eine mal das andere 2.3 / 2.4 ??

	try:
	try:
	records=self.ZSQLSimpleSearch(query=self.query)
	except:
	records=self.searchQuery(self.aq_parent,query=self.query) #python 2.4 version (??)
	except:
	records=self.searchQuery()#python 2.3 version(??)


if not records:	if not records:
Line 293 class ECHO_sqlElement(SimpleItem):	Line 304 class ECHO_sqlElement(SimpleItem):

def manage_addECHO_sqlElementForm(self):	def manage_addECHO_sqlElementForm(self):
"""Form for adding"""	"""Form for adding"""
pt=PageTemplateFile('Products/ECHO_content/zpt/AddECHO_sqlElement.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','AddECHO_sqlElement.zpt')).__of__(self)
return pt()	return pt()

def manage_addECHO_sqlElement(self,id,title,query,field,searchField,baseUrl,weight,contentType,RESPONSE=None):	def manage_addECHO_sqlElement(self,id,title,query,field,searchField,baseUrl,weight,contentType,RESPONSE=None):
Line 304 def manage_addECHO_sqlElement(self,id,ti	Line 315 def manage_addECHO_sqlElement(self,id,ti
RESPONSE.redirect('manage_main')	RESPONSE.redirect('manage_main')


class ECHO_pageTemplate(ZopePageTemplate):	class ECHO_pageTemplate(ZopePageTemplate,ECHO_basis):
"""pageTemplate Objekt"""	"""pageTemplate Objekt"""
meta_type="ECHO_pageTemplate"	meta_type="ECHO_pageTemplate"
	security=ClassSecurityInfo()


_default_content_fn = os.path.join(package_home(globals()),	_default_content_fn = os.path.join(package_home(globals()),
'html/ECHO_pageTemplateDefault.html')	'html/ECHO_pageTemplateDefault.html')

manage_options=ZopePageTemplate.manage_options+(	manage_options=ZopePageTemplate.manage_options+ECHO_basis.manage_options+(
{'label':'Main Config','action':'changeECHO_pageTemplateMainForm'},	{'label':'Main Config','action':'changeECHO_pageTemplateMainForm'},
	{'label':'Graphic Coords','action':'ECHO_graphicEntry'},
)	)

	security.declarePublic('content_html')

	def addChanges(self):
	"""do nothing leere methode, notwendig, da bei veerbung
	von dieser klasse nur ueberschrieben werden kann,
	falls methode per url aufgerufen werden soll"""

	return True

def content_html(self):	def content_html(self):
"""content_html"""	"""content_html"""
return content_html(self,'pageTemplate')	return content_html(self,'pageTemplate')

def changeECHO_pageTemplateMainForm(self):	def changeECHO_pageTemplateMainForm(self):
"""change"""	"""change"""
pt=PageTemplateFile('Products/ECHO_content/zpt/ChangeECHO_pageTemplateMain.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','ChangeECHO_pageTemplateMain.zpt')).__of__(self)
return pt()	return pt()

def changeECHO_pageTemplateMain(self,weight,contentType,label,description,RESPONSE=None,isAlwaysClickable=None,suffix=None,prefix=None):	def changeECHO_pageTemplateMain(self,weight,contentType,label,description,RESPONSE=None,isAlwaysClickable=None,suffix=None,prefix=None):
Line 337 class ECHO_pageTemplate(ZopePageTemplate	Line 360 class ECHO_pageTemplate(ZopePageTemplate
if RESPONSE is not None:	if RESPONSE is not None:
RESPONSE.redirect('manage_main')	RESPONSE.redirect('manage_main')

def getLabel(self):
if hasattr(self,'label'):
return self.label.encode('utf-8')

else:
return 0

def getWeight(self):	def getWeight(self):
"""get weight"""	"""get weight"""
if hasattr(self,'weight'):	if hasattr(self,'weight'):
Line 370 class ECHO_pageTemplate(ZopePageTemplate	Line 386 class ECHO_pageTemplate(ZopePageTemplate

def manage_addECHO_pageTemplateForm(self):	def manage_addECHO_pageTemplateForm(self):
"""Form for adding"""	"""Form for adding"""
pt=PageTemplateFile('Products/ECHO_content/zpt/AddECHO_pageTemplate.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','AddECHO_pageTemplate.zpt')).__of__(self)
return pt()	return pt()

from urllib import quote	from urllib import quote
Line 420 def manage_addECHO_pageTemplate(self, id	Line 436 def manage_addECHO_pageTemplate(self, id
class ECHO_navigation(Folder):	class ECHO_navigation(Folder):
"""Navigations Element"""	"""Navigations Element"""
meta_type="ECHO_Navigation"	meta_type="ECHO_Navigation"
	management_page_charset="utf-8"

	def getUsername(self):
	"""get name of user"""
	username=str(self.REQUEST['AUTHENTICATED_USER'])
	if username=='Anonymous User':
	return None
	else:
	return username

	def searchExternalCollection(self,url,simpleSearch):
	"""search external collection via xmlrpc"""
	server=xmlrpclib.Server(url)

	results=server.getSubcolsXMLRpc(simpleSearch)

	return results

	def getXMLRpcConnection(self,url):
	"""getxmlrpc"""
	if not hasattr(self,"_v_server"):
	self._v_server=[]

	server=xmlrpclib.Server(url)
	self._v_server.append(server)

	return len(self._v_server)-1

	def getXMLRpcMethod(self,nr,method,compressed=None):
	"""getmethod"""

	ret= eval('self._v_server[%i].%s'%(nr,method))
	if compressed:
	ret=decodeRPC(ret)
	return ret

	def getNavInfo(self):
	"""root informationen"""
	if hasattr(self,'logo_image'):
	if hasattr(self.logo_image,'tag'):
	imageTag=self.logo_image.tag()
	else:
	imageTag=''
	return (self.title,imageTag)

	def linkBar(self,parent):
	"""linkbarer balken"""
	str=""


	while not(parent.meta_type == "ECHO_root"):
	fragment="""<a href="%s">%s</a>"""%(parent.absolute_url(),parent.label)
	str=fragment+"/"+str
	parent=parent.aq_parent

	return str

	def decode(self,str):
	"""decoder"""
	if not str:
	return ""
	if type(str) is StringType:
	try:
	return str.decode('utf-8')
	except:
	return str.decode('latin-1')
	else:

	return str

def ECHOFormatListStr(self,list,search="\n",replace="<br>"):	def ECHOFormatListStr(self,list,search="\n",replace="<br>"):
"""formatiert liste im str"""	"""formatiert liste im str"""
Line 430 class ECHO_navigation(Folder):	Line 515 class ECHO_navigation(Folder):

def ECHO_cacheManageForm(self):	def ECHO_cacheManageForm(self):
"""change form"""	"""change form"""
pt=PageTemplateFile('Products/ECHO_content/zpt/ECHO_cacheManageForm').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','ECHO_cacheManageForm')).__of__(self)
pt.content_type="text/html"	pt.content_type="text/html"
return pt()	return pt()

Line 461 class ECHO_navigation(Folder):	Line 546 class ECHO_navigation(Folder):
if not obj:	if not obj:
obj = self	obj = self

entries=obj.ZopeFind(obj,obj_metatypes=['ECHO_collection'],search_sub=1)	entries=obj.ZopeFind(obj,obj_metatypes=['ECHO_collection','VLP_resource'],search_sub=1)

for entry in entries:	for entry in entries:
#print entry[0]
entry[1].ZCacheable_setManagerId(managerName)	entry[1].ZCacheable_setManagerId(managerName)


return "changed all CM in: "+self.title	return "changed all CM in: "+self.title

displayedMetaTypes=displayTypes

	displayableMetaTypes=displayTypes

def getImageViewers(self):	def getImageViewers(self):
"""images"""	"""images"""
Line 486 class ECHO_navigation(Folder):	Line 572 class ECHO_navigation(Folder):
self.id=id	self.id=id
self.title=title	self.title=title
self.pathToHierarchy=pathToHierarchy	self.pathToHierarchy=pathToHierarchy
	self.displayedMetaTypes=displayTypes

manage_options = Folder.manage_options+(	manage_options = Folder.manage_options+(
{'label':'Main Config','action':'ECHO_navigationConfigForm'},	{'label':'Main Config','action':'ECHO_navigationConfigForm'},
{'label':'Cache','action':'ECHO_cacheManageForm'},	{'label':'Cache','action':'ECHO_cacheManageForm'},

)	)
	displayedMetaTypes=displayTypes

def ECHO_navigationConfigForm(self):	def ECHO_navigationConfigForm(self):
"""configForm"""	"""configForm"""
pt=PageTemplateFile('Products/ECHO_content/zpt/ChangeECHO_navigation.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','ChangeECHO_navigation.zpt')).__of__(self)
return pt()	return pt()

def ECHO_navigationConfig(self,title,pathToHierarchy,RESPONSE=None):	def ECHO_navigationConfig(self,title,pathToHierarchy,displayedMetaTypes=displayTypes,RESPONSE=None):
"""config"""	"""config"""
self.title=title	self.title=title
self.pathToHierarchy=pathToHierarchy	self.pathToHierarchy=pathToHierarchy
	self.displayedMetaTypes=toList(displayedMetaTypes)[0:]


if RESPONSE is not None:	if RESPONSE is not None:
RESPONSE.redirect('manage_main')	RESPONSE.redirect('manage_main')
Line 561 class ECHO_navigation(Folder):	Line 651 class ECHO_navigation(Folder):

def barFromHash(self,hash,start=None,sortField=None,location=None):	def barFromHash(self,hash,start=None,sortField=None,location=None):
"""Erzeuge Navigations Element"""	"""Erzeuge Navigations Element"""
#print "hash",hash
listNav=[]	listNav=[]
if not start:	if not start:
temp=hash	temp=hash
Line 610 class ECHO_navigation(Folder):	Line 700 class ECHO_navigation(Folder):
# add label falls existiert und nicht leer	# add label falls existiert und nicht leer
if hasattr(temp[x][1],'label'):	if hasattr(temp[x][1],'label'):

if not temp[x][1].label=='':	if not temp[x][1].getLabel()=='':
try:
label=temp[x][1].getLabel()	label=temp[x][1].getLabel()
except:
label=temp[x][1].label
else:	else:
label=temp[x][1].title.encode('utf-8')	try:
	label=temp[x][1].getTitle()
	except:
	zLOG.LOG("ECHO_Nav",zLOG.ERROR,"%s has neither getLabel nor getTile implemented"%temp[x][1].getId())
	label=""
else:	else:
label=temp[x][1].title.encode('utf-8')	label=temp[x][1].getTitle()


if location:	if location:

loc=getattr(temp[x][1],'location','top')	loc=getattr(temp[x][1],'location','top')
if (loc==location):	if (loc==location):
listNav.append((label,createPath(self.absolute_url(),temp[x][1].absolute_url()),temp[x][1],getattr(temp[x][1],'prefix',''),getattr(temp[x][1],'suffix','')))

	listNav.append((label,createPath(self,self.absolute_url(),temp[x][1].absolute_url(relative=1))+getattr(temp[x][1],'queryString',''),temp[x][1],getattr(temp[x][1],'prefix',''),getattr(temp[x][1],'suffix','')))
else:	else:
listNav.append((label,createPath(self.absolute_url(),temp[x][1].absolute_url()),temp[x][1],getattr(temp[x][1],'prefix',''),getattr(temp[x][1],'suffix','')))

	listNav.append((label,createPath(self,self.absolute_url(),temp[x][1].absolute_url(relative=1))+getattr(temp[x][1],'queryString',''),temp[x][1],getattr(temp[x][1],'prefix',''),getattr(temp[x][1],'suffix','')))
	#print self.REQUEST
return listNav	return listNav

def tempSorted(self,hash,field="weight"):	def tempSorted(self,hash,field="weight"):
Line 635 class ECHO_navigation(Folder):	Line 731 class ECHO_navigation(Folder):
for x in hash.keys():	for x in hash.keys():
#print hash[x][1]	#print hash[x][1]
if hasattr(hash[x][1],field):	if hasattr(hash[x][1],field):
	try:
	weight=int(getattr(hash[x][1],field))
	except:
weight=getattr(hash[x][1],field)	weight=getattr(hash[x][1],field)
#print weight	#print weight
else:	else:
Line 654 class ECHO_navigation(Folder):	Line 753 class ECHO_navigation(Folder):

testStr=re.sub("/index_html",'',self.REQUEST.get('URL',''))	testStr=re.sub("/index_html",'',self.REQUEST.get('URL',''))

	if len(item)<2:
	return 0
#falls exakte Übereinstimmung dann immer 1	#falls exakte Übereinstimmung dann immer 1
if (testStr==item[1]) and (self.REQUEST.get('QUERY_STRING','')==''):	if (testStr==item[1]) and (self.REQUEST.get('QUERY_STRING','')==''):

Line 689 class ECHO_navigation(Folder):	Line 790 class ECHO_navigation(Folder):
return 0	return 0


	def getPathStyle(self, item, style=""):
	"""returns a string with the given style + 'sel' if the path is already selected."""

	if self.isSelectedPath(item):
	return style + 'sel'
	else:
	return style


def buttonsFromHash(self,hash,start=None,orientation="horizontal"):	def buttonsFromHash(self,hash,start=None,orientation="horizontal"):
Line 718 class ECHO_navigation(Folder):	Line 826 class ECHO_navigation(Folder):

description=temp[x][1].title	description=temp[x][1].title

url=createPath(self.absolute_url(),temp[key][1].absolute_url())
	url=createPath(self,self.absolute_url(),temp[key][1].absolute_url(relative=1))

if (self.REQUEST['URL']==url) \| (self.REQUEST['URL']==url+"/index_html"):	if (self.REQUEST['URL']==url) \| (self.REQUEST['URL']==url+"/index_html"):
html=html+startTag+"[%s]" % description+endTag	html=html+startTag+"[%s]" % description+endTag
Line 770 class ECHO_navigation(Folder):	Line 879 class ECHO_navigation(Folder):
return nr+1	return nr+1

def secondNavElements(self):	def secondNavElements(self):
"""Zweite Ordnung"""	"""Zweite Ordnung Navigationselemente"""

hash=self.createNavHash(2,checkOnly="no")	hash=self.createNavHash(2,checkOnly="no")

actual_url=self.REQUEST['URL']	actual_url=self.REQUEST['URL']

ult_temp=re.sub(self.absolute_url(),"",actual_url)	ult_temp=re.sub(self.absolute_url(),"",actual_url)
Line 849 class ECHO_navigation(Folder):	Line 959 class ECHO_navigation(Folder):

def manage_addECHO_navigationForm(self):	def manage_addECHO_navigationForm(self):
"""Form for adding"""	"""Form for adding"""
pt=PageTemplateFile('Products/ECHO_content/zpt/AddECHO_navigation.zpt').__of__(self)	pt=PageTemplateFile(os.path.join(package_home(globals()),'zpt','AddECHO_navigation.zpt')).__of__(self)
return pt()	return pt()

def manage_addECHO_navigation(self,id,title,pathToHierarchy,RESPONSE=None):	def manage_addECHO_navigation(self,id,title,pathToHierarchy,RESPONSE=None):
Line 864 def manage_addECHO_navigation(self,id,ti	Line 974 def manage_addECHO_navigation(self,id,ti



def createPath(url1,url2):	def createPath(self,url1,url2):
	#bugfix in absolute_url, ploetzlich erschein in absolute_url der physikalische pfad.

	if self.REQUEST.has_key('VirtualRootPhysicalPath'):
	vp="/".join(self.REQUEST['VirtualRootPhysicalPath'])
	if vp[0]=="/":
	vp=vp[1:]

	url2=url2.replace(vp+"/",'')
	else:
temp1=url1.split("/")	temp1=url1.split("/")
temp2=url2.split("/")	temp2=url2.split("/")
for test in temp1:	for test in temp1:
if temp2[0]==test:	if temp2[0]==test:
del temp2[0]	del temp2[0]

#print "CP:"+url1+"::"+url2+"::"+url1+"/"+string.join(temp2,"/")	url2= string.join(temp2,"/")
return url1+"/"+string.join(temp2,"/")
	return url1+"/"+url2

def sortWeight(x,y):	def sortWeight(x,y):
#print x[1],y[1]	#print x[1],y[1]

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>

Removed from v.1.47
changed lines
	Added in v.1.74