Bh{ddlZddlmZmZddlmZddlmZddlmZm Z m Z ddl m Z ddl mZddlmZdd lmZdd lmZdd lmZdd lmZmZdd lmZddlmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%m&Z&ddl'm(Z(Gdde jRZ*y)N)datetime timedelta)GenericForeignKey) ContentType) connectionmodels transaction)title) force_str)lazy) gettext_lazy)invalidate_cms_page_cache)clear_placeholder_cache) EXPIRE_NOWMAX_EXPIRATION_TTL) LanguageError)PlaceholderManager)get_language_from_request permissions)RemovedInDjangoCMS51Warning)get_cms_setting get_site_id)get_language_objectcNeZdZdZej eddddZejedddZ eje ddej Z ejdd Zed d ZdZdZdZeZGd dZdZdZd8dZdZd8dZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'd Z(d!Z)d"Z*e+e)e*Z,d8d#Z-d8d$Z.d8d%Z/d&Z0d'Z1e+d(Z2d)Z3d8d*Z4d8d+Z5d,Z6d9d-Z7d.Z8d9d/Z9d8d0Z:d1Z;d2Zd8d5Z?d8d6Z@d7ZAy); PlaceholderzY ``Placeholders`` can be filled with plugins, which store or generate content. slotTF) max_lengthdb_indexeditablewidth)nullr )blankr" on_delete)r#r" content_type object_idceZdZdZgZdZy)Placeholder.Metacms)) use_structurezCan use Structure modeN)__name__ __module__ __qualname__ app_labeldefault_permissionsrK/home/dcms/DCMS/lib/python3.12/site-packages/cms/models/placeholdermodel.pyMetar(0s  D r1r3c|jSN)rselfs r2__str__zPlaceholder.__str__5s yyr1cd|jd|jjd|jd|jdt t |d }|S)N<.z id=z slot='z ' object at >)r, __class__r+pkrhexid)r7displays r2__repr__zPlaceholder.__repr__8sZ $.."9"9!:$twwiwtyykYefijlmqjrfsettu v r1NcB|j|jy)z(Deletes all plugins from the placeholderN) get_pluginsdeleter7languages r2clearzPlaceholder.clear>s "))+r1cddlm}ddlm}d}t |j |r)t |j jt}|d|j|t|j}t|}|S)Nr PageContentget_placeholder_confname)templatedefault) cms.modelsrKcms.utils.placeholderrM isinstancesourcer get_templatestrrr _)r7rKrMrOrNs r2 get_labelzPlaceholder.get_labelBse*> dkk; /:tDKK44c:#OTYY"MMr1c0ddlm}|j|S)Nr) plugin_pool)cms.plugin_poolr] get_extra_placeholder_menu_items)r7r]s r2get_extra_menu_itemsz Placeholder.get_extra_menu_itemsSs/;;DAAr1c.ddlm}|js |jS |jj |S#t $rPt|j}||d}|j|xs|j||jcYSwxYw)zl Returns ``True`` if user has permission to change all models attached to this placeholder. r)get_model_permission_codenamechange) cms.utils.permissionsrbr& is_superuserrT!has_placeholder_change_permissionAttributeErrortypehas_perm)r7userrbmodel change_perms r2has_change_permissionz!Placeholder.has_change_permissionXs H~~$$ $ Y;;@@F F Y%E7xHK==-X{DKK1X X Ys;ABBcXtj||dsy|j|syy)ze Returns ``True`` if user has permission to add ``plugin_type`` to this placeholder. addFT)rhas_plugin_permissionrm)r7rj plugin_types r2has_add_plugin_permissionz%Placeholder.has_add_plugin_permissionks-00{EJ))$/r1c||j|sy|D]%}tj||jdr%yy)zt Returns ``True`` if user has permission to add **all** plugins in ``plugins`` to this placeholder. FroT)rmrrprq)r7rjpluginsplugins r2has_add_plugins_permissionz&Placeholder.has_add_plugins_permissionvsD))$/ F44T6;M;MuU r1cltj||jdsy|j|syy)zc Returns ``True`` if user has permission to change ``plugin`` to this placeholder. rcFTrrprqrmr7rjrus r2has_change_plugin_permissionz(Placeholder.has_change_plugin_permission300v7I7I8T))$/r1cltj||jdsy|j|syy)zc Returns ``True`` if user has permission to delete ``plugin`` to this placeholder. rEFTrxrys r2has_delete_plugin_permissionz(Placeholder.has_delete_plugin_permissionr{r1ctj||jdsy|j|sy||k7r|j|syy)zk Returns ``True`` if user has permission to move ``plugin`` to the ``target_placeholder``. rcFTrx)r7rjrutarget_placeholders r2has_move_plugin_permissionz&Placeholder.has_move_plugin_permissionsL00v7I7I8T!77= % %d.H.H.Nr1cJ|j|sy|j||S)c Returns ``True`` if user has permission to delete all plugins in this placeholder F)rmhas_delete_plugins_permission)r7rj languagess r2has_clear_permissionz Placeholder.has_clear_permissions())$/11$ BBr1c|jj|jdjddj j }t j}|jD]}|||dryy) r) language__inPlaceholderPlugin)rqrqTflatrEF) cmsplugin_setfilterexclude values_listdistinctorder_byrrpiterator)r7rjr plugin_typeshas_permissionrqs r2rz)Placeholder.has_delete_plugins_permissions    % %9 % = W!4W 5 [T[ 2 XZ XZ %::'002 K!$ X> r1c|jytd|jjj DS)Nc3HK|]}|jtk(s|ywr5) related_modelr).0fs r2 z7Placeholder._get_source_remote_field..s`!T_A_A`s"")r&nextrT_meta get_fieldsr6s r2_get_source_remote_fieldz$Placeholder._get_source_remote_fields3 >> ! `t{{00;;=```r1cL|j}|y|j||S)NT)r run_checks)r7rj remote_fields r2 check_sourcezPlaceholder.check_sources,446  &&tT22r1c\|jr |jjjSyr5)rTrrkr6s r2_get_attached_modelzPlaceholder._get_attached_models" ;;;;$$** *r1c*t|ds[ddlm} |jj |j dj j|_|jS|jS#t$rd|_Y|jSwxYw)N_pagerrJ) placeholderspage) hasattrcms.models.contentmodelsrK admin_managerrselect_relatedfirstrrrg)r7rKs r2 page_getterzPlaceholder.page_getterstW% < "(66==4=P__`fgmmott zztzz" "! zz "sAA44BBc||_yr5)r)r7values r2 page_setterzPlaceholder.page_setters  r1c6t|j|S)zReturns a list of plugins attached to this placeholder. If language is given only plugins in the given language are returned.)listrDrFs r2get_plugins_listzPlaceholder.get_plugins_listsD$$X.//r1cr|r|jj|S|jjS)zReturns a queryset of plugins attached to this placeholder. If language is given only plugins in the given language are returned.rG)rrallrFs r2rDzPlaceholder.get_pluginss6 %%,,h,? ?!!%%''r1c@|j|jS)zBChecks if placeholder is empty (``False``) or populated (``True``))rDexistsrFs r2 has_pluginszPlaceholder.has_pluginss)0022r1cg}t|jjddD]} |jt ||S#t $rY-wxYw)z Returns language objects for every language for which the placeholder has plugins. This is not cached as it's meant to be used in the frontend editor. rGTr)setrDrappendrr)r7r lang_codes r2get_filled_languagesz Placeholder.get_filled_languagessk T--/;;JT;RS I   !4Y!?@  !  sA AAct|dgS)N_plugins_cache)getattrr6s r2get_cached_pluginszPlaceholder.get_cached_pluginsst-r22r1cVddl}ddlm}|jdtd|S)Nr)PlaceholderNoActionzBThe actions property is deprecated. Use placeholder admin instead.) stacklevel)warningsrRrwarnr)r7rrs r2actionszPlaceholder.actionss*= P ' #$$r1c t}jr tdstSfd}t |j }||D]\}}|j ||}|t|ttfr6t|tr ||z } n|} t#| j%dz} n t#|} t)| |}|dkstcS|S#t$rFtjd|jj|jt!|dzYwxYw#t&$rGtjd|jj|jt!|dzY2wxYw)u` Returns the number of seconds (from «response_timestamp») that this placeholder can be cached. This is derived from the plugins it contains. This method must return: ``EXPIRE_NOW <= int <= MAX_EXPIRATION_IN_SECONDS`` :type request: HTTPRequest :type response_timestamp: datetime :rtype: int PLUGIN_CACHEc3Ktdr(jD]}|j}||fyj|D]}|j yw)aA The placeholder will have a cache of all the concrete plugins it uses already, but just in case it doesn't, we have a code-path to generate them anew. This is made extra private as an inner function to avoid any other process stealing our yields. _all_plugins_cacheNrrget_plugin_class_instancerDget_plugin_instancelanginstanceru plugin_itemr7s r2inner_plugin_iteratorz?Placeholder.get_cache_expiration..inner_plugin_iterator(smt12 $ 7 7+H%??AF"F**+$(#3#3D#9rg?zjPlugin %(plugin_class)s (%(pk)d) returned unexpected value %(value)s for get_cache_expiration(), ignoring.r)rcache_placeholderrrrrget_cache_expirationrSrr TypeErrorrrr=r+r>r int total_seconds ValueErrormin) r7requestresponse_timestampmin_ttlrrGrruplugin_expirationdeltattls ` r2rz Placeholder.get_cache_expirations%%%_^-L  <"-Wdii@ 5h ?6 " Hf & ; ;GXt T !(+h -BC/:! 14F F$.E%--/#56/0C#w'G!|"!m6 "pU%!! (170@0@0I0I&.kk)23D)E !!," MM<-3,<,<,E,E"*++%./@%A  s& C1 D+A D('D(+A E;:E;ctdr t|s"|jr|jj}t ||t |y)N PAGE_CACHE)rrrsite_idrr)r7rGrs r2 clear_cachezPlaceholder.clear_cachets9 < ( % '499ii''Gh G0DEr1c|j|j|jdjdd}t |S)zn Returns a list of plugin ids matching the given language ordered by plugin position. parentpositionr>Tr)rDrrrr)r7rG parent_idplugin_tree_orders r2get_plugin_tree_orderz!Placeholder.get_plugin_tree_order}sP   X & - -Y - ? H H T ` `aelp ` q %&&r1c fd}jr tdsgSt}t|j}||D]\}}|s |j ||}|st |tr3|j|vsB|j|jb t|D]4}|j|vs|j|j6t%t'|S#t$rGtjd|jj|j t#|dzY wxYw)z1 Returns a list of VARY headers. c3Ktdr(jD]}|j}||fyj|D]}|j yw)z9See note in get_cache_expiration.inner_plugin_iterator().rNrrs r2rz.inner_plugin_iteratorskt12 $ 7 7+H%??AF"F**+$(#3#3D#9r sortedr) r7rr vary_listrGrruvary_on vary_on_items ` r2rzPlaceholder.get_vary_cache_ons6  <%%_^-LIE ,Wdii@ 5h ?  Hf..w$GG'3'==?)3MM'--/2(,W @ '--/y@%MM,*<*<*>?@ 6d9o&&! MM9-3,<,<,E,E"*++%.w%7  s+ D !DA EEcHddlm}||j||||}|S)Nr)copy_plugins_to_placeholder)rt placeholderrG root_plugin)cms.utils.pluginsrr)r7rrGrr new_pluginss r2 copy_pluginszPlaceholder.copy_pluginss.A1))(3*#  r1c6|j|jxsd}|j|z dk}|r8|j|j|j||jz dz|j |r|j |j|S)a .. versionadded:: 4.0 Adds a plugin to the placeholder. The plugin's position field must be set to the target position. Positions are enumerated from the start of the palceholder's plugin tree (1) to the last plugin (*n*, where *n* is the number of plugins in the placeholder). :param instance: Plugin to add. It's position parameter needs to be set. :type instance: :class:`cms.models.pluginmodel.CMSPlugin` instance .. note:: As of version 4 of django CMS the position counter does not re-start at 1 for the first child plugin. The ``position`` field and ``language`` field are unique for a placeholder. Example:: new_child = MyCoolPlugin() new_child.position = ( parent_plugin.position + 1 ) # add as first child: directly after parent parent_plugin.placeholder.add(new_child) rrstartoffset)get_last_plugin_positionrGr_shift_plugin_positionssave_recalculate_plugin_positions)r7r last_position needs_shifts r2 add_pluginzPlaceholder.add_plugins055h6G6GHMA  ((=8A=   ( (!!''$x'8'881< )      . .x/@/@ Ar1c|r|j||||S|j|j}|j|j}|j }|j |j |zf}||j kr|j |j|jtjd|j z|j |djtjd|j z n|j ||zj|jtjd|j z |j |j jtjd|j z|j|k7r|j||j|jy ) a .. versionadded:: 4.0 Moves a plugin within the placeholder (``target_placeholder=None``) or to another placeholder. :param plugin: Plugin to move :type plugin: :class:`cms.models.pluginmodel.CMSPlugin` instance :param int target_position: The plugin's new position :param target_placeholder: Placeholder to move plugin to (or ``None``) :type target_placeholder: :class:`cms.models.placeholdermodel.Placeholder` instance :param target_plugin: New parent plugin (or ``None``). The target plugin must be in the same placeholder or in the ``target_placeholder`` if one is given. :type target_plugin: :class:`cms.models.pluginmodel.CMSPlugin` instance The ``target_position`` is enumerated from the start of the palceholder's plugin tree (1) to the last plugin (*n*, where *n* is the number of plugins in the placeholder). )rutarget_positionr target_plugin position__gte)position__rangerrr) position__lterN) _move_plugin_to_placeholderrDrGget_last_plugin_get_descendants_countrrrupdaterFrr ) r7rurrr target_tree last_pluginsource_plugin_desc_countsource_plugin_ranges r2 move_pluginzPlaceholder.move_plugins& 33 /#5+ 4 &&v7 **6??; #)#@#@#B %BZ0Z[ V__ ,   o  > F FWj F k s s ((:.1E1EE t    -@-C  D K K*- 0D0DD L ""C[1["\dd$7efvxx 3k6J6JJfL   V__  = D D*- 0D0DD E  ==M ) MMM / **6??;r1c|j|j}|j|j}|j}|r|j}|j} dt |z} t || | z|jz dz} t | |z dz|j| z|z | zdz} |j |j|| n |j} |j |j|j| |j|||j||j|j|j|jy)Nrr)rr)r) rrGget_descendantsrlenmaxrrr ) r7rurrrsource_last_plugintarget_last_pluginplugin_descendants source_length target_lengthplugins_to_move_count source_offset target_offsets r2rz'Placeholder._move_plugin_to_placeholder=sl!11&//B/??P#335 .77M.77M$%,>(?$? !!!$99  // "  /!3-//ADYY\]] M  6 6%$ 7 /77M $$ OO//  %  ]8J K!!.@!A **6??;88Ir1ctj5|j|jj }|j }|j g|z}|jj|j|jt|z}||krC|j|j|j||j|jdddy#1swYyxYw)a .. versionadded:: 4.0 Removes a plugin and its descendants from the placeholder and database. :param instance: Plugin to add. It's position parameter needs to be set. :type instance: :class:`cms.models.pluginmodel.CMSPlugin` instance r)pk__inrN)r atomicrDrGcount_get_descendants_idsr>rrrErr!rr )r7rrt descendants to_deleter s r2 delete_pluginzPlaceholder.delete_pluginss   ! F&&0A0A&BHHJG"779K! 3I    % %Y % 7 > > @$--K0@@Mw&,,%%"++"- 2283D3DE F F Fs CC33C<c@|j|jSr5)rDlastrFs r2rzPlaceholder.get_last_plugins)..00r1c|dk(r|j||}n|j||}|r||jdzS|dk(r |xsddzS|xsdS)a .. versionadded:: 4.0 Helper to calculate plugin positions correctly. :param str language: language for which the position is to be calculated :param parent: Parent plugin or ``None`` (if position is on top level) :type parent: :class:`cms.models.pluginmodel.CMSPlugin` instance :param str insert_order: Either ``"first"`` (default) or ``"last"`` rrrr4r)get_first_plugin_positionrr)r7rGr insert_orderrs r2get_next_plugin_positionz$Placeholder.get_next_plugin_positionsn 7 "55hv5NH44Xf4MH h&??Q& & 6 !MQ& &}1r1c|j|}|r|j|}|jddjS)NrrTr)rDrrrr7rGrtrees r2r6z%Placeholder.get_first_plugin_positionsD) ;;f;-D 6<<>>r1c||j|}n!|j|k(r|j}ny|jddj S)NrTr)rDrr rr4r:s r2rz$Placeholder.get_last_plugin_positionsU >##H-D   4 '))+D 6;;==r1c||j|xsd}|j|j|jt j d|zy)Nrrrr)rrDrrrr)r7rGrrs r2rz#Placeholder._shift_plugin_positionssV >228<AF ")))>EEvxxXbOcflOlEmr1cddlm}m}m}|d}|d}|dvrcd}|j t j j|jj}|j||j|gy |dk(rcd}|j t j j|jj}|j||j|gy |dk(rcd}|j t j j|jj}|j||j|gy tt jd ) a@Closes gaps in the plugin tree by re-calculating the positions of all plugins. IMPORTANT: This method requires any gap to be large enough to be able to contain all missing plugin positions. Ensure to have shifted out plugins after the gaps far enough using the ``_shift_plugin_positions`` method.r) CMSPlugin_get_database_cursor_get_database_vendorwrite)sqlite postgresqlzUPDATE {0} SET position = subquery.new_pos FROM ( SELECT ID, ROW_NUMBER() OVER (ORDER BY position, id) AS new_pos FROM {0} WHERE placeholder_id=%s AND language=%s ) subquery WHERE {0}.id=subquery.idmysqlzUPDATE {0} SET position = (SELECT COUNT(*)+1 FROM (SELECT * FROM {0}) t WHERE placeholder_id={0}.placeholder_id AND language={0}.language AND {0}.position > t.position) WHERE placeholder_id=%s AND language=%soraclez is not supported by django-cmsN)cms.models.pluginmodelr?r@rAformatrops quote_namerdb_tableexecuter> RuntimeErrorvendor)r7rGr?r@rAcursor db_vendorsqls r2r z)Placeholder._recalculate_plugin_positionss3   &g.(1 0 0+ **Z^^66y7O7OPQC NN3( 3 4 ' !< **Z^^66y7O7OPQC NN3( 3 4 ( "< **Z^^66y7O7OPQC NN3( 3 4*"3"3!44STU Ur1r5)NN)Nr)Br+r,r-__doc__r CharFieldrWrPositiveSmallIntegerField default_width ForeignKeyrSET_NULLr%PositiveIntegerFieldr&rrTr is_static is_editablerobjectsr3r8rBrHrXr[r`rmrrrvrzr}rrrrrrrrpropertyrrrDrrrrrrrrrr rrr2rr8r6rrr r0r1r2rrs 6  AfI#u UD4F44QwZdUZ[M$6$$ // L ,++$TBI ~{ ;FIK "GEE  , N B Y&     C*a 3   K -D0 (3 3 % %]~F'/'b +ZKn 2Vr1r)+rrr"django.contrib.contenttypes.fieldsr"django.contrib.contenttypes.modelsr django.dbrrr django.template.defaultfiltersr django.utils.encodingr django.utils.functionalr django.utils.translationr rW cms.cachercms.cache.placeholderr cms.constantsrrcms.exceptionsrcms.models.managersr cms.utilsrrcms.utils.compat.warningsrcms.utils.confrrcms.utils.i18nrModelrr0r1r2rnsR(@:550+(6/98(2<A7.X V&,,X Vr1