👧🏾 🧙 👰🏿 Symfony2 में SonataAdminBundle के साथ एडिटिंग ट्री स्ट्रक्चर्स 🗂️ ➗ 😼

वृक्ष संरचनाओं का संपादन वेब विकास में एक काफी सामान्य कार्य है। यह उपयोगकर्ता के लिए बहुत सुविधाजनक है, क्योंकि यह उसे अपनी साइट पर कोई पदानुक्रम बनाने का अवसर देता है। स्वाभाविक रूप से, सिम्फनी 2 पर स्विच करने के बाद, पहले कार्यों में से एक इस तरह के पृष्ठों की एक श्रेणीबद्ध सूची बनाना और इसके लिए एक व्यवस्थापक पैनल लिखना था। और जब से मैं SonataAdminBundle को व्यवस्थापक पैनल के रूप में उपयोग करता हूं , कार्य पेड़ों को संपादित करने के लिए इसे कॉन्फ़िगर करना था।

ऐसा लगता था कि समस्या व्यापक थी, माँग में और मुझे एक तैयार समाधान "बॉक्स से बाहर" प्राप्त करने की उम्मीद थी। हालाँकि, ऐसा नहीं हुआ। इतना ही नहीं, सोनाटा के डेवलपर्स को इस विचार के बारे में कभी नहीं लगता था कि कोई व्यक्ति अपने बंडल के माध्यम से पेड़ों को "प्रशासित" करेगा।

चलो पेड़ से ही शुरू करते हैं। मेरे बचपन से "एक प्रोग्रामर के रूप में" मुझे सिखाया गया था कि पहिया को फिर से मजबूत न करें। और यद्यपि मैं कभी-कभी "लात" मारता था और पीछे हट जाता था, कि नई आविष्कार की गई साइकिल को आगे की सवारी करना आसान होगा, और बग़ल में नहीं: मैं हमेशा अपने हाथों पर चढ़ा और ... मुझे तैयार किए गए समाधानों का उपयोग करना था। पृष्ठों की वृक्ष संरचना के लिए, डॉक्ट्रिन एक्सटेंशन्स से नेस्टेड ट्री का उपयोग करने का निर्णय लिया गया।

डॉक्ट्रिन एक्सटेंशन ट्री का उपयोग करके ट्री मॉडल बनाना सीधा है और इसे मैनुअल में वर्णित किया गया है। मैं यह नोट करना चाहता हूं कि Symfony2 के अंदर डॉक्ट्रिन एक्सटेंशन के सुविधाजनक उपयोग के लिए, आपको StofDoctrineExtensionsBundle को कनेक्ट करना होगा, जिसकी स्थापना और कॉन्फ़िगरेशन, फिर से, मैनुअल में अच्छी तरह से वर्णित है। खैर, अगर अचानक किसी को इससे कोई समस्या है, तो मुझे टिप्पणियों में मदद करने में खुशी होगी।

इसलिए, मुझे ShtumiPravBundle: पेज मॉडल मिला, जिसका पूरा कोड मैं इस लेख में अनावश्यक नहीं दूंगा।

अब मैं नेस्टेड ट्री की बुरी विशेषताओं के बारे में कुछ शब्द कहना चाहता हूं, जिसके कारण मुझे एक दो बार सब कुछ बदलना पड़ा।

ट्री संरचना को संग्रहीत करने के लिए, डॉक्ट्रिन एक्सटेंशन्स न केवल मूल क्षेत्र का उपयोग करता है, बल्कि रूट, लैफ्ट, आरजीटी, एलवीएल फ़ील्ड भी हैं, जो डेटाबेस में भी संग्रहीत हैं। खेतों का उद्देश्य स्पष्ट है: वे पेड़ में बच्चों के क्रम को निर्धारित करते हैं, और आपको पेड़ के तत्वों को "सही" क्रम में प्राप्त करने के लिए सरल SQL प्रश्न बनाने की अनुमति भी देते हैं। इन फ़ील्ड्स की गणना और डेटाबेस में स्वचालित रूप से संग्रहीत की जाती है। हालांकि, मैं अभी भी क्षेत्र की कमी और आरजीटी के मूल्यों की गणना करने के लिए एल्गोरिथ्म को समझ नहीं सका (हालांकि मैंने कठिन प्रयास नहीं किया था)। तो यहाँ है। क्या पेड़ के किसी भी तत्व में इन क्षेत्रों का एक मूल्य गलत हो जाना चाहिए - इससे पूरे पेड़ का टूटना होगा। एक टूटना जिसे ठीक करना लगभग असंभव है, उपरोक्त क्षेत्रों की गणना की जटिलता को देखते हुए, पेड़ के तत्वों की संख्या से गुणा किया जाता है।
डॉक्ट्रिन एक्सटेंशन्स ट्री में, मूल तत्वों को मानक तरीकों (मूवअप, मूवडाउन) के साथ बदलना असंभव है। जब आप ऐसा करने की कोशिश करते हैं, तो संबंधित संदेश के साथ एक "अपवाद" बाहर फेंक दिया जाएगा। व्यवहार, कहने का अधिकार, अजीब और अप्रत्याशित है, लेकिन आपको इसके साथ लगना होगा।
चरण 1 में, मैंने रूट, लैफ्ट, आरजीटी फ़ील्ड्स के बारे में बात की, जिसके मूल्यों में विफलता पूरे पेड़ के टूटने की ओर जाता है। अब आग में ईंधन डालें। विदेशी कुंजियों की उपस्थिति के कारण पेड़ के तत्वों को हटाने में विफलता की स्थिति में ऐसी स्थितियां होती हैं। मेरे मामले में, ये प्रत्येक लेख के लिए "खराब" अतिरिक्त तत्व थे। साइट को सामग्री से भरने के बाद इसकी सभी महिमा में समस्या का पता चला था, और पेड़ को बहाल करने के लिए बहुत अधिक नसों और श्रम की आवश्यकता थी।

व्यवस्थापक पैनल में पेड़ की संरचना का निष्कर्ष

जिन पहली समस्याओं को हल करने की आवश्यकता थी, उनमें से एक पेड़ के रूप में व्यवस्थापक पैनल में पृष्ठों का उत्पादन था, अर्थात, लेख शीर्षक से पहले बाईं ओर घोंसले के स्तर के अनुरूप रिक्त स्थान की संख्या जोड़ें। यही समस्या चुनिंदा ड्रॉपडाउन के साथ थी। समाधान बहुत सरल पाया गया - मॉडल में __toString और getLaveledTitle विधियाँ जोड़ें:

class Page { ... public function __toString() { $prefix = ""; for ($i=2; $i<= $this->lvl; $i++){ $prefix .= "& nbsp;& nbsp;& nbsp;& nbsp;"; } return $prefix . $this->title; } public function getLaveledTitle() { return (string)$this; } ... }

अब, सूची सेटिंग्स में, मक्खी पर उत्पन्न laveled_title फ़ील्ड का उपयोग करना संभव हो गया।

मैं सहमत हूं कि समाधान सबसे अच्छा नहीं है, लेकिन यहां कोई अन्य नहीं दिया गया है।

ऊपर लिखी समस्याओं के अनुच्छेद 2 को याद करें। इस समस्या को हल करने का सबसे आसान तरीका एक मूल तत्व बनाना है और या तो इसका उपयोग न करें या इसे मुख्य पृष्ठ के पाठ के रूप में उपयोग करें।
मैंने इसे "== रूट एलीमेंट ==" नाम देने का फैसला किया और इसे कहीं और इस्तेमाल नहीं किया। अर्थात्, व्यवस्थापक पैनल में इसके संपादन / विलोपन को प्रतिबंधित करना। अन्य सभी लेख या तो इस मूल तत्व के वंशज होने चाहिए, या वंशजों के वंशज होने चाहिए। मूल तत्व को डेटाबेस में हाथों से बनाया गया था, और इसे संपादन योग्य होने से रोकने के लिए, CreateQuery पद्धति को PageAdmin वर्ग में जोड़ा गया था।

यहां मैं PageAdmin वर्ग का पूरा कोड दूंगा, और नीचे मैं बताऊंगा कि क्या तरीके और क्या उपयोग किए गए थे।

 <? namespace Shtumi\PravBundle\Admin; use Sonata\AdminBundle\Admin\Admin; use Sonata\AdminBundle\Form\FormMapper; use Sonata\AdminBundle\Datagrid\ListMapper; use Sonata\DoctrineORMAdminBundle\Datagrid\ProxyQuery; class PageAdmin extends Admin{ protected $maxPerPage = 2500; protected $maxPageLinks = 2500; protected $datagridValues = array( '_sort_order' => 'ASC', '_sort_by' => 'p.root, p.lft' ); public function createQuery($context = 'list') { $em = $this->modelManager->getEntityManager('Shtumi\PravBundle\Entity\Page'); $queryBuilder = $em ->createQueryBuilder('p') ->select('p') ->from('ShtumiPravBundle:Page', 'p') ->where('p.parent IS NOT NULL'); $query = new ProxyQuery($queryBuilder); return $query; } protected function configureListFields(ListMapper $listMapper) { $listMapper ->add('up', 'text', array('template' => 'ShtumiPravBundle:admin:field_tree_up.html.twig', 'label'=>' ')) ->add('down', 'text', array('template' => 'ShtumiPravBundle:admin:field_tree_down.html.twig', 'label'=>' ')) ->add('id', null, array('sortable'=>false)) ->addIdentifier('laveled_title', null, array('sortable'=>false, 'label'=>' ')) ->add('_action', 'actions', array( 'actions' => array( 'edit' => array(), 'delete' => array() ), 'label'=> '' )) ; } protected function configureFormFields(FormMapper $form) { $subject = $this->getSubject(); $id = $subject->getId(); $form ->with('') ->add('parent', null, array('label' => '' , 'required'=>true , 'query_builder' => function($er) use ($id) { $qb = $er->createQueryBuilder('p'); if ($id){ $qb ->where('p.id <> :id') ->setParameter('id', $id); } $qb ->orderBy('p.root, p.lft', 'ASC'); return $qb; } )) ->add('title', null, array('label' => '')) ->add('text', null, array('label' => ' ')) ->end() ; } public function preRemove($object) { $em = $this->modelManager->getEntityManager($object); $repo = $em->getRepository("ShtumiPravBundle:Page"); $subtree = $repo->childrenHierarchy($object); foreach ($subtree AS $el){ $menus = $em->getRepository('ShtumiPravBundle:AdditionalMenu') ->findBy(array('page'=> $el['id'])); foreach ($menus AS $m){ $em->remove($m); } $services = $em->getRepository('ShtumiPravBundle:Service') ->findBy(array('page'=> $el['id'])); foreach ($services AS $s){ $em->remove($s); } $em->flush(); } $repo->verify(); $repo->recover(); $em->flush(); } public function postPersist($object) { $em = $this->modelManager->getEntityManager($object); $repo = $em->getRepository("ShtumiPravBundle:Page"); $repo->verify(); $repo->recover(); $em->flush(); } public function postUpdate($object) { $em = $this->modelManager->getEntityManager($object); $repo = $em->getRepository("ShtumiPravBundle:Page"); $repo->verify(); $repo->recover(); $em->flush(); } }

नेस्टेड ट्री में एक पेड़ बनाने में एक ख़ासियत है। बाएं से दाएं पूरे क्रम में पूरे पेड़ के चारों ओर जाने के लिए, आपको इसके तत्वों को पहले रूट फ़ील्ड से और फिर लैफ्ट फ़ील्ड द्वारा सॉर्ट करना होगा। इसके लिए $ datagridValues प्रॉपर्टी को जोड़ा गया है।

एक पेड़ को संपादित करते समय, ज्यादातर मामलों में पेजिंग की आवश्यकता नहीं होती है। इसलिए, मैंने मानक 30 से 2500 तक एक पृष्ठ से तत्वों की संख्या में वृद्धि की।

तत्वों को जोड़ना / संपादित करना

यहां मुख्य समस्या लेख को संपादित करने के रूप में माता-पिता की पदानुक्रमित ड्रॉप-डाउन सूची का आउटपुट थी। इकाई पैरेंट फ़ील्ड में क्लोजर के साथ क्वेरी_बिल्डर जोड़कर इस समस्या को हल किया गया था। चूंकि हमारे पास डेटाबेस में एक मूल तत्व "== रूट तत्व ==" है, इसलिए मूल क्षेत्र आवश्यक होना चाहिए।

पोस्टपर्सिस्ट और पोस्टपेड तरीकों के लिए के रूप में, उन्हें यह सुनिश्चित करने के लिए रिपॉजिटरी के सत्यापन और पुनर्प्राप्त करने के तरीकों को कॉल करने के लिए जोड़ा गया था ताकि यह सुनिश्चित हो सके कि इन कार्यों के बाद पेड़ की संरचना को नुकसान नहीं होगा।

अपने पड़ोसियों के सापेक्ष आइटम सॉर्ट करें

यह भी बटन बनाने के लिए आवश्यक था जिसके साथ उपयोगकर्ता अपने पड़ोसियों के सापेक्ष लेख को ऊपर / नीचे स्थानांतरित कर सकता था। SonataAdminBundle आपको रिकॉर्ड की सूची के क्षेत्रों में अपने टेम्प्लेट का उपयोग करने की अनुमति देता है। इसलिए, आपको क्रमशः और ऊपर और नीचे बटन के लिए दो टेम्पलेट बनाने की आवश्यकता है:

ShtumiPravBundle: व्यवस्थापक: field_tree_up.html.twig

 {% extends 'SonataAdminBundle:CRUD:base_list_field.html.twig' %} {% block field %} {% spaceless %} {% if object.parent.children[0].id != object.id %} <a href="{{ path('page_tree_up', {'page_id': object.id}) }}"> <img src="{{ asset('bundles/shtumiprav/images/admin/arrow_up.png') }}" alt="{% trans %}{% endtrans %}" /> </a> {% endif %} {% endspaceless %} {% endblock %}

ShtumiPravBundle: व्यवस्थापक: field_tree_down.html.twig

 {% extends 'SonataAdminBundle:CRUD:base_list_field.html.twig' %} {% block field %} {% spaceless %} {% if object.parent.children[object.parent.children|length - 1].id != object.id %} <a href="{{ path('page_tree_down', {'page_id': object.id}) }}"> <img src="{{ asset('bundles/shtumiprav/images/admin/arrow_down.png') }}" alt="{% trans %}{% endtrans %}" /> </a> {% endif %} {% endspaceless %} {% endblock %}

ये टेम्पलेट PageAdmin वर्ग के configListFields विधि से जुड़े हुए हैं।

दो रास्तों को राउटिंग में जोड़ा जाना चाहिए। फाइल को क्रमशः ऊपर और नीचे बटन के लिए जोड़ा जाना चाहिए:

 page_tree_up: pattern: /admin/page_tree_up/{page_id} defaults: { _controller: ShtumiPravBundle:PageTreeSort:up } page_tree_down: pattern: /admin/page_tree_down/{page_id} defaults: { _controller: ShtumiPravBundle:PageTreeSort:down }

ठीक है, निश्चित रूप से, आपको एक PageTreeSortController नियंत्रक बनाने की आवश्यकता है जो लेख के आंदोलन का प्रदर्शन करेगा:

 <?php namespace Shtumi\PravBundle\Controller; use Symfony\Bundle\FrameworkBundle\Controller\Controller; use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template; use JMS\SecurityExtraBundle\Annotation\Secure; class PageTreeSortController extends Controller { /** * @Secure(roles="ROLE_SUPER_ADMIN") */ public function upAction($page_id) { $em = $this->getDoctrine()->getEntityManager(); $repo = $em->getRepository('ShtumiPravBundle:Page'); $page = $repo->findOneById($page_id); if ($page->getParent()){ $repo->moveUp($page); } return $this->redirect($this->getRequest()->headers->get('referer')); } /** * @Secure(roles="ROLE_SUPER_ADMIN") */ public function downAction($page_id) { $em = $this->getDoctrine()->getEntityManager(); $repo = $em->getRepository('ShtumiPravBundle:Page'); $page = $repo->findOneById($page_id); if ($page->getParent()){ $repo->moveDown($page); } return $this->redirect($this->getRequest()->headers->get('referer')); } }

केवल एक व्यवस्थापक ही इस नियंत्रक तक पहुँच सकता है; इसलिए, रोल पर रोक ROLE_SUPER_ADMIN आवश्यक है।

आइटम हटाएं

पेड़ के तत्वों को हटाने की मुख्य सूक्ष्मता यह है कि आपको यह ध्यान रखने की आवश्यकता है कि विदेशी कुंजी के कारण कोई संघर्ष नहीं है और पेड़ में कोई विफलताएं नहीं हैं। मैंने पहले से ही नेस्टेड पेड़ समस्याओं के पैरा 3 में इस बारे में बात की थी।

मैंने विशेष रूप से यह दिखाने के लिए कि पेज हटाने के लिए पेजरमिन वर्ग से प्रीमेव विधि को हटाना शुरू नहीं किया है, आपको किसी अन्य मॉडल से संबंधित सभी प्रविष्टियों को हटाने और देखभाल करने की आवश्यकता है। मेरे मामले में, ये एडिशनल मीनू और सर्विस मॉडल थे।

मैं यह भी ध्यान देना चाहूंगा कि कैस्केड डिलीट मॉडल में इंस्टॉलेशन इस मामले में काम नहीं करता है। तथ्य यह है कि डॉक्ट्रिन एक्सटेंशन्स ट्री वंशज को हटाने के लिए अपने स्वयं के तरीकों का उपयोग करता है, जो कैस्केडिंग पर ध्यान नहीं देते हैं। सच है, सुनिश्चित करने के लिए, मैंने अभी भी कैस्केडिंग विलोपन स्थापित किया है:

 class Page { ... /** * @ORM\OneToMany(targetEntity="Service", mappedBy="page", cascade={"all"}, orphanRemoval=true) * @ORM\OrderBy({"position"="ASC"}) */ protected $services; ... }

नेस्टेड ट्री स्वचालित रूप से वंशज को हटा देता है। कॉन्फ़िगर करने के लिए कुछ भी नहीं था।

निष्कर्ष

ऐसा लगता है कि मेरे द्वारा बताए गए समाधान में कुछ भी जटिल नहीं है, हालांकि, नेस्ट ट्री के कभी-कभी पूरी तरह से पारदर्शी व्यवहार नहीं होने के कारण, सोनाटास्मिनबंडल में प्रवेश बनाने की सुविधाओं से जटिल, मुझे कुछ समय के लिए इस समाधान के साथ टिंकर करना पड़ा। मुझे उम्मीद है कि यह समान कार्य को लागू करते समय, प्रिय पाठक को बचाने में मदद करेगा।

इस समाधान से क्या गायब है। पहली बात जो दिमाग में आती है वह सबप्रिसेस को छिपाती है। यही है, प्रत्येक तत्व के बगल में "प्लसस", आपको इसके वंश को प्रदर्शित करने की अनुमति देता है। ऐसा समाधान बहुत बड़े पेड़ों के लिए प्रासंगिक होगा। सुधार का दूसरा विचार पहले से निम्नानुसार है - मैं चाहूंगा कि व्यवस्थापक इस अभिभावक तत्व को प्लस चिन्ह पर क्लिक करके याद रखें और एक नया लेख बनाते समय, यह स्वचालित रूप से "मूल" फ़ील्ड में इसका चयन करेगा।

दोनों समस्याओं का हल मुश्किल नहीं है। "प्लस साइन" के लिए एक और टेम्पलेट बनाना आवश्यक है और फिर नियंत्रक में सत्र को सहेजें जो तत्वों को प्रदर्शित किया जाना चाहिए और जिसे छिपाया जाना चाहिए। खैर, createQuery विधि में, इस सत्र से डेटा प्रोसेस करें।

Symfony2 में SonataAdminBundle के साथ एडिटिंग ट्री स्ट्रक्चर्स

व्यवस्थापक पैनल में पेड़ की संरचना का निष्कर्ष

तत्वों को जोड़ना / संपादित करना

अपने पड़ोसियों के सापेक्ष आइटम सॉर्ट करें

आइटम हटाएं

निष्कर्ष

More articles: