BhD ddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z mZddlmZmZd Zd Zd ZGd d ZGddeZy)N)apps)ImproperlyConfigured) ModelForm) force_str)cached_property)gettextoverride)get_object_edit_urlget_object_preview_urlctjdjj}t |j dS)a Returns a list of (wizard.id, wizard) tuples (for all registered wizards) ordered by weight ``get_entries()`` is useful if it is required to have a list of all registered wizards. Typically, this is used to iterate over them all. Note that they will be returned in the order of their ``weight``: smallest numbers for weight are returned first.:: for wizard_id, wizard in get_entries(): # do something with a wizard... cmsc|jSNweight)es G/home/dcms/DCMS/lib/python3.12/site-packages/cms/wizards/wizard_base.pyzget_entries..s !(()key)rget_app_config cms_extensionwizardssortedvalues)rs r get_entriesrs5!!%(66>>G '.."(: ;;rcZtjdjj|S)z[ Returns a wizard object based on its :attr:`~.cms.wizards.wizard_base.Wizard.id`. r )rrrr) entry_keys r get_entryr!s&   u % 3 3 ; ;I FFrc#KtD]0}|j||s|j|jf2yw)z Yields a list of wizard entries that the current user can use based on their permission to add instances of the underlying model objects. )pageN)ruser_has_add_permissionidtitle)userr!entrys r entry_choicesr'(s? *  ( (D ( 988U[[) )*s !AAc eZdZdZdZ ddZy) WizardBasez Ncl||_||_||_||_||_||_|||_yy)u :param title: The title of the wizard. It will appear in a large font size on the wizard “menu” :param weight: Used for determining the order of the wizards on the creation form. :param form: The form to use for this wizard. This is mandatory, but can be sub-classed from :class:`django.forms.Form` or clas:`django.forms.ModelForm`. :param model: Required either here or in the form's Meta class. This is used to determine uniqueness of the wizards, so, only one wizard per model. :param template_name: The full-path to the template to use, if any. :param description: This is used on the start form. The description is optional, but if it is not supplied, the CMS will create one from the pattern: "Create a new «model.verbose_name» instance." :param edit_mode_on_success: Whether the user will get redirected to object edit url after a successful creation or not. This only works if the object is registered for toolbar enabled models. N)r$rformmodel descriptionedit_mode_on_success template_name)selfr$rr+r,r/r-r.s r__init__zWizardBase.__init__8sC&    &$8!  $!.D  %r)NNNT)__name__ __module__ __qualname____doc__r/r1rrr)r)2sMFJ8</rr)cheZdZdZdZdZedZdZdZ dZ dZ d Z d Z d Zd Zed Zy)Wizardz All wizard classes should inherit from ``cms.wizards.wizard_base.Wizard``. This class implements a number of methods that may be overridden as required. zcms/wizards/create.htmlNc8|jstdj|j|jj gj d}tj}|j||j|_|jS)z To construct a unique ID for each wizard, we start with the module and class name for uniqueness, we hash it because a wizard's ID is displayed in the form's markup, and we'd rather not expose code paths there. .zutf-8) _hash_cacherjoinr3 __class__r2encodehashlibsha1update hexdigest)r0 full_pathhashs rr#z Wizard.id^sv!$//4>>+B+BCDfWo <<>D KK "#~~/D rc |jS)z Simply returns the ``title`` property assigned during instantiation. Override this method if this needs to be determined programmatically. )r$r0kwargss r get_titlezWizard.get_titlens zzrc |jS)z Simply returns the ``weight`` property assigned during instantiation. Override this method if this needs to be determined programmatically. rrFs r get_weightzWizard.get_weightus {{rc |jr |jS|j}|r$|jj}t d|zSy)a Simply returns the ``description`` property assigned during instantiation or one derived from the model if description is not provided during instantiation. Override this method if this needs to be determined programmatically. zCreate a new %s instance.)r- get_model_meta verbose_name_)r0rGr, model_names rget_descriptionzWizard.get_description|sK   ## #  11J01J> >rc,t|jSr)rr$r0s r__str__zWizard.__str__s$$rc d|jd|jjd|jdt t|d }|S)N)r3r=r2r#hex)r0displays r__repr__zWizard.__repr__sJdoo&a(?(?'@TWWI[Y\]_`d]eYfXgghirc |j}|jj}|jj }|j |d|S)uS Returns boolean reflecting whether the given «user» has permission to add instances of this wizard's associated model. Can be overridden as required for more complex situations. :param user: The current user using the wizard. :return: True if the user should be able to use this wizard. z.add_)rMrN app_labelr2lowerhas_perm)r0r%rGr,r]rQs rr"zWizard.user_has_add_permissionsK KK)) ^^))+ }} {% |<==rc tjdj}|j|jvrF|j rt ||jddSt||jddSd|vr)t|d5|jcdddS|jS#1swY|jSxYw)a Once the wizard has completed, the user will be redirected to the URL of the new object that was created. By default, this is done by return the result of calling the ``get_absolute_url`` method on the object. If the object is registered for toolbar enabled models, the object edit url will be returned. This may be modified to return the preview url instead by setting the wizard property ``edit_mode_on_success`` to False. In some cases, the created content will not implement ``get_absolute_url`` or that redirecting the user is undesirable. In these cases, simply override this method. If ``get_success_url`` returns ``None``, the CMS will just redirect to the current page after the object is created. :param object obj: The created object :param dict kwargs: Arbitrary keyword arguments r languageN)ra) rrrr=toolbar_enabled_modelsr.r getr force_languageget_absolute_url)r0objrG extensions rget_success_urlzWizard.get_success_urls"''.<< ==I<< <((*3JPT9UVV)# :t8TU UV##VJ-?@2//122'') )2'') )s B;;Cc|jr |jSt|jtr$|jjj}|r|St d)NzFPlease set entry 'model' attribute or use ModelForm subclass as a form)r, issubclassr+rrNr)r0r,s rrMzWizard.get_modelsQ ::::  dii +IIOO))E "$BC Crc|j|j|j|j|j|j |j dS)N)r-r$rr#r+r,r/)rRrHrJr#r+r,r/rTs rwidget_attributeszWizard.widget_attributessL //1^^%oo'''IIZZ!//  r)r2r3r4r5r/r;propertyr#rHrJrRrUr[r"rhrMrrlr6rrr8r8Usb .MK      % >*:C    rr8)r? django.appsrdjango.core.exceptionsrdjango.forms.modelsrdjango.utils.encodingrdjango.utils.functionalrdjango.utils.translationrrPr rdcms.toolbar.utilsr r rrr'r)r8r6rrrusH7)+3M <"G* / /F} Z} r