🧔🏼 ↔️ 🏭 SonataAdminBundle के साथ प्रशासनिक इंटरफ़ेस 👩🏿‍🎨 📔 👨🏼‍🤝‍👨🏻

सिम्फनी 2 की बुनियादी डिलीवरी सीआरयूडी इंटरफेस बनाने के लिए केवल न्यूनतम कार्यक्षमता प्रदान करती है । प्रशासनिक इंटरफ़ेस को लागू करने के लिए, कई बंडल विकसित किए गए हैं, विशेष रूप से, सोनाटाअमिनबंडल ।

यह किस लिए है?

SonataAdminBundle का उपयोग करके, आप जल्दी से ORM मॉडल के संपादन संस्थानों के लिए एक विन्यास योग्य इंटरफ़ेस बना सकते हैं ( MongoDb और PHPCr के साथ काम करने के लिए बंडल भी हाइलाइट किए गए हैं , लेकिन वे अभी भी विकास के प्रारंभिक चरण में हैं)। इस मामले में, इंटरफ़ेस के किसी भी हिस्से को अपने लिए संशोधित किया जा सकता है। अक्टूबर 2011 के अंत में, डिजाइन को ट्विटर बूस्ट्रैप फ्रेमवर्क में स्थानांतरित कर दिया गया था, इसलिए प्रशासनिक इंटरफ़ेस की उपस्थिति काफी आधुनिक है।

स्थापना और बुनियादी विन्यास

डिप्स फ़ाइल में, आपको SonataAdminBundle और अतिरिक्त बंडलों को स्थापित करने के लिए कोड जोड़ना होगा:

[SonataAdminBundle] git=http://github.com/sonata-project/SonataAdminBundle.git target=/bundles/Sonata/AdminBundle [SonataDoctrineORMAdminBundle] git=http://github.com/sonata-project/SonataDoctrineORMAdminBundle.git target=/bundles/Sonata/DoctrineORMAdminBundle [SonatajQueryBundle] git=http://github.com/sonata-project/SonatajQueryBundle.git target=/bundles/Sonata/jQueryBundle [KnpMenuBundle] git=https://github.com/KnpLabs/KnpMenuBundle.git target=/bundles/Knp/Bundle/MenuBundle [KnpMenu] git=https://github.com/KnpLabs/KnpMenu.git target=/knp/menu

और फिर चला

 php bin/vendors install

एप्लिकेशन / autoload.php फ़ाइल में, आपको ऐप / AppKernel.php फ़ाइल में नए नामस्थान जोड़ने की जरूरत है, स्थापित बंडलों का आरंभीकरण

 <?php // app/autoload.php $loader->registerNamespaces(array( // ... 'Sonata' => __DIR__.'/../vendor/bundles', 'Knp\Bundle' => __DIR__.'/../vendor/bundles', 'Knp\Menu' => __DIR__.'/../vendor/knp/menu/src', // ... )); // app/AppKernel.php public function registerBundles() { return array( // ... new Sonata\AdminBundle\SonataAdminBundle(), new Sonata\DoctrineORMAdminBundle\SonataDoctrineORMAdminBundle(), new Knp\Bundle\MenuBundle\KnpMenuBundle(), new Sonata\jQueryBundle\SonatajQueryBundle(), // ... ); }

एप्लिकेशन / कॉन्फिग / रूटिंग.आईएमएल फाइल में, आपको प्रशासनिक इंटरफ़ेस के लिए रूटिंग जोड़ना होगा:

 # app/config/routing.yml admin: resource: '@SonataAdminBundle/Resources/config/routing/sonata_admin.xml' prefix: /admin _sonata_admin: resource: . type: sonata_admin prefix: /admin

और स्थापित बंडल से वेब सीएसएस, जेएस, आदि निर्देशिका को लिखें

 php app/console assets:install web

प्रशासनिक इंटरफ़ेस में एक पासवर्ड जोड़ने के लिए, आप या तो मानक सिम्फनी 2 प्राधिकरण का उपयोग कर सकते हैं या अतिरिक्त FOSUserBlacklele का उपयोग कर सकते हैं

एप्लिकेशन / config / config.yml फ़ाइल में, आप शीर्षक और लोगो सेट कर सकते हैं, साथ ही साथ प्रशासनिक इंटरफ़ेस टेम्पलेट्स को ओवरराइड कर सकते हैं। सबसे पहले, प्रशासनिक इंटरफ़ेस का शीर्ष लेख जोड़ें:

 sonata_admin: title: .

अनुवादक सेवा को सक्षम करने के लिए, आपको एप्लिकेशन / config / config.yml को संशोधित करना होगा:

  framework: translator: { fallback: %locale% }

स्थापना के बाद, जब पता http: // लोकलहोस्ट / एडमिन / डैशबोर्ड पर पहुंचता है (हम मानते हैं कि सिम्फनी 2 http: // localhost ) नाम वाली साइट पर स्थापित है, एक खाली प्रशासनिक इंटरफ़ेस प्रदर्शित किया जाता है जिसके लिए इकाई प्रशासन सेवाएं अभी तक पंजीकृत नहीं हैं।

नोट: अनुवादक और IE

रूसी स्वीकार-भाषा को निर्धारित करने के लिए अनुवादक घटक के लिए, आपको IE सेटिंग्स के इंटरनेट विकल्प / सामान्य / भाषा अनुभाग में रु-रु कोड के साथ रूसी भाषा को जोड़ने की आवश्यकता है।

उदाहरण का उपयोग करें

एक उदाहरण के रूप में, हम समाचारों को संपादित करने के लिए एक प्रशासनिक इंटरफ़ेस बनाएंगे, जिसका सार लेख में वर्णित है सिम्बोनी 2 पर एक सीआरयूडी एप्लिकेशन बनाना । प्रयुक्त संस्थाओं के स्रोत गिथूब पर देखे जा सकते हैं।

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

कक्षाएं {इकाई का नाम} व्यवस्थापक

समाचार, समाचार लिंक और समाचार श्रेणियों को संपादित करने के लिए, आपको टेस्ट / न्यूज़बंडल / व्यवस्थापक निर्देशिका में 3 कक्षाएं बनाने की आवश्यकता है: NewsAdmin, NewsLinkAdmin और NewsCategoryAdmin:

 <?php namespace Test\NewsBundle\Admin; use Sonata\AdminBundle\Admin\Admin; use Sonata\AdminBundle\Form\FormMapper; use Sonata\AdminBundle\Datagrid\DatagridMapper; use Sonata\AdminBundle\Datagrid\ListMapper; use Sonata\AdminBundle\Show\ShowMapper; use Knp\Menu\ItemInterface as MenuItemInterface; class NewsAdmin extends Admin { /** *    * * @param \Sonata\AdminBundle\Show\ShowMapper $showMapper * @return void */ protected function configureShowField(ShowMapper $showMapper) { $showMapper ->add('id', null, array('label' => '')) ->add('title', null, array('label' => '')) ->add('announce', null, array('label' => '')) ->add('text', null, array('label' => '')) ->add('pubDate', null, array('label' => ' ')) ->add('newsLinks', null, array('label' => '  ')) ->add('newsCategory', null, array('label' => '')); } /** *     * @param \Sonata\AdminBundle\Form\FormMapper $formMapper * @return void */ protected function configureFormFields(FormMapper $formMapper) { $formMapper ->add('title', null, array('label' => '')) ->add('announce', null, array('label' => '')) ->add('text', null, array('label' => '')) ->add('pubDate', null, array('label' => ' ')) //by_reference            //  Symfony Form Framework,  setter  News::setNewsLinks ->add('newsLinks', 'sonata_type_collection', array('label' => '', 'by_reference' => false), array( 'edit' => 'inline', //  NewsLink   pos,      //  sortable        'sortable' => 'pos', 'inline' => 'table', )) ->add('newsCategory', null, array('label' => '')) ->setHelps(array( 'title' => '  ', 'pubDate' => '    ' )); } /** *    * * @param \Sonata\AdminBundle\Datagrid\ListMapper $listMapper * @return void */ protected function configureListFields(ListMapper $listMapper) { $listMapper ->addIdentifier('id') ->addIdentifier('title', null, array('label' => '')) ->add('pubDate', null, array('label' => ' ')) ->add('newsCategory', null, array('label' => '')); } /** * ,        * * @param \Sonata\AdminBundle\Datagrid\DatagridMapper $datagridMapper * @return void */ protected function configureDatagridFilters(DatagridMapper $datagridMapper) { $datagridMapper ->add('title', null, array('label' => '')); } /** *         * * @param \Knp\Menu\ItemInterface $menu * @param $action * @param null|\Sonata\AdminBundle\Admin\Admin $childAdmin * * @return void */ protected function configureSideMenu(MenuItemInterface $menu, $action, Admin $childAdmin = null) { $menu->addChild( $action == 'edit' ? ' ' : ' ', array('uri' => $this->generateUrl( $action == 'edit' ? 'show' : 'edit', array('id' => $this->getRequest()->get('id')))) ); } }

समाचार लिंक के लिए व्यवस्थापकीय वर्ग में केवल कॉन्फ़िगफ़ॉर्मफ़िल्ड विधि होती है, जैसे समाचार लिंक को समाचार के साथ संपादित किया जाता है:

 <?php namespace Test\NewsBundle\Admin; use Sonata\AdminBundle\Admin\Admin; use Sonata\AdminBundle\Form\FormMapper; class NewsLinkAdmin extends Admin { /** * @param \Sonata\AdminBundle\Form\FormMapper $formMapper * @return void */ protected function configureFormFields(FormMapper $formMapper) { $formMapper ->add('url', null, array('label' => 'URL', 'required' => true)) ->add('text', null, array('label' => '')); } }

NewsCategoryAdmin NewsAdmin के समान बनाया गया है। प्रशासनिक कक्षाओं के लिए स्रोत कोड गिथब पर देखा जा सकता है।

प्रशासनिक सेवाओं का पंजीकरण

प्रशासनिक वर्ग को एक सेवा के रूप में पंजीकृत होने की आवश्यकता होती है, जिसके लिए उसे टेस्ट / न्यूज़बंडल / रिसोर्स / कॉन्फिगरेशन / सर्विसेज.xml में पंजीकृत होना आवश्यक है। प्रशासनिक इंटरफ़ेस की सेवाओं के लिए, टैग "sonata.admin" इंगित किया गया है, जो उन्हें अन्य सेवाओं से अलग करने की अनुमति देता है। मेनू आइटम के समूह का नाम (विशेषता "समूह") और मेनू आइटम का नाम (विशेषता "लेबल") भी संकेत दिया गया है - यह डेटा प्रशासनिक इंटरफ़ेस के मेनू का निर्माण करने के लिए उपयोग किया जाता है। हमारे मामले में, मुख्य मेनू में समाचार लिंक संपादित करने के लिए मेनू आइटम को दिखाने की आवश्यकता नहीं है, क्योंकि वे समाचार संपादन पृष्ठ पर दर्ज किए जाते हैं। इसलिए, सेवा c id = "test.news.admin.newsLink" के लिए हम विशेषता show_in_dashboard = "false" सेट करते हैं।

उपर्युक्त उदाहरण में, सेवाएं मानक सोनाटा एडमीनबंडल: सीआरयूडी नियंत्रक का उपयोग करती हैं, लेकिन यदि आवश्यक हो तो आप अपने स्वयं के नियंत्रक बना सकते हैं।

 <?xml version="1.0" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd"> <services> <service id="test.news.admin.news" class="Test\NewsBundle\Admin\NewsAdmin"> <tag name="sonata.admin" manager_type="orm" group="" label=""/> <argument/> <argument>Test\NewsBundle\Entity\News</argument> <argument>SonataAdminBundle:CRUD</argument> </service> <service id="test.news.admin.newsLink" class="Test\NewsBundle\Admin\NewsLinkAdmin"> <tag name="sonata.admin" manager_type="orm" show_in_dashboard="false" /> <argument/> <argument>Test\NewsBundle\Entity\NewsLink</argument> <argument>SonataAdminBundle:CRUD</argument> </service> <service id="test.news.admin.newsCategory" class="Test\NewsBundle\Admin\NewsCategoryAdmin"> <tag name="sonata.admin" manager_type="orm" group="" label=" "/> <argument/> <argument>Test\NewsBundle\Entity\NewsCategory</argument> <argument>SonataAdminBundle:CRUD</argument> </service> </services> </container>

क्या हुआ?

रिबूट करने के बाद, प्रशासनिक इंटरफ़ेस इस तरह दिखता है:

जब आप "समाचार / सूची" लिंक पर क्लिक करते हैं, तो प्रविष्टियों को फ़िल्टर करने की क्षमता वाले समाचारों की एक सूची प्रदर्शित की जाती है:

समाचार संपादन पृष्ठ इस तरह दिखता है:

संलग्न संस्थाओं की स्थिति बदलना

पृष्ठ को पुनः लोड किए बिना समाचार से जुड़े लिंक जोड़े जाते हैं। एक समाचार क्षेत्र "NewsLink" इकाई में जोड़ा गया है, जिसके द्वारा समाचारों के लिंक का अनुरोध करने पर छंटनी की जाती है। फ़ील्ड प्रकार sonata_type_collection के लिए 'सॉर्टेबल' => 'पॉस' विकल्प को निर्दिष्ट करते हुए, तालिका पंक्तियों को खींचकर और ड्रॉप करके इंटरफ़ेस के लिए समाचार के क्रम को बदलने की क्षमता को जोड़ा जाता है:

हालाँकि, डेटाबेस में परिलक्षित लिंक की स्थिति को बदलने के लिए, आपको NewsAdmin वर्ग को जोड़ना होगा (यह सुनिश्चित नहीं है कि समाधान सही है, लेकिन कम से कम यह काम करता है):

 #src/Test/NewsBundle/Admin/NewsAdmin.php class NewsAdmin { .. /** *      * @param $news   * @return void */ public function preUpdate($news) { //     $emptyObj = $this->getNewInstance(); // ,     onfigureFormFields  NewsAdmin, //     //      -    ,  //  NewsLink  ,    html- //(        NewsLink) //     NewsLink   -  ,   Doctrine $this->getForm()->setData($emptyObj)->bindRequest($this->getRequest()); $newLinkPos = array(); //  NewsLink foreach ($emptyObj->getNewsLinks() as $link) $newLinkPos[] = $link->getUrl(); $newLinkPos = array_flip($newLinkPos); //     foreach ($news->getNewsLinks() as $pos => $link) $link->setPos($newLinkPos[$link->getUrl()]); } .. }

नेविगेशन

SonataAdminBundle की बुनियादी डिलीवरी में मानक बटन नामों, हेडर आदि का रूसी स्थानीयकरण है। स्थानीयकरण पूर्ण होने के लिए, प्रशासनिक इंटरफ़ेस के बनाए गए अनुभागों के लिए, आपको शीर्षक अनुवाद बनाने की आवश्यकता होती है जो स्वचालित रूप से इकाई नामों के आधार पर बनाए जाते हैं, उदाहरण के लिए, समाचार सूची, समाचार बनाएँ। ऐसा करने के लिए, Test / NewsBundle / Resources / अनुवाद निर्देशिका में एक संदेश.ru.xliff फ़ाइल बनाएं (आप यहां अनुवाद सेवा के बारे में पढ़ सकते हैं)

चेतावनी! नीचे दिए गए उदाहरण में ई / टैग के साथ </ खट्टा में, अंग्रेजी सी को रूसी सी द्वारा प्रतिस्थापित किया जाता है, अन्यथा कोड स्वरूपण मक्खियों

 <?xml version="1.0"?> <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2"> <file source-language="ru" datatype="plaintext" original="" > <body> <trans-unit id="News List"> <source>News List</soure> <target> </target> </trans-unit> <trans-unit id="News Create"> <source>News Create</soure> <target> </target> </trans-unit> <trans-unit id="News Edit"> <source>News Edit</soure> <target> </target> </trans-unit> <trans-unit id="News Category List"> <source>News Category List< soure> <target>  </target> </trans-unit> <trans-unit id="News Category Create"> <source>News Category Create</soure> <target>  </target> </trans-unit> <trans-unit id="News Category Edit"> <source>News Category Edit</soure> <target>  </target> </trans-unit> </body> </file> </xliff>

निष्कर्ष

परिणाम एक कार्यात्मक, एक्स्टेंसिबल रिकॉर्ड संपादन इंटरफ़ेस है। SonataAdmin द्वारा उपयोग किए जाने वाले सभी टेम्प्लेट और कंट्रोलर को एप्लिकेशन कॉन्फ़िगरेशन में ओवरराइड किया जा सकता है। SonataAdmin- आधारित डेवलपर्स ने कई वेब फ़ंक्शन विकसित करने के लिए कई बंडलों को उपयोगी बनाया है जो कई बुनियादी कार्यों को लागू करते हैं: SonataUserBundle (उपयोगकर्ता प्रबंधन), SonataNewsBundle (ब्लॉग), SonataMediaBundle (मीडिया प्रबंधन) और SonataPageBundle (CMS प्रोटोटाइप)। बड़ी समस्या खराब प्रलेखन, विशेष रूप से सोनाटापेजबंडल, हालांकि पहली नज़र में एक दिलचस्प उत्पाद है।

अद्यतन 2012-07-20: सिम्फनी 2.1 के नवाचारों को ध्यान में रखते हुए लेख का वर्तमान संस्करण यहां है

SonataAdminBundle के साथ प्रशासनिक इंटरफ़ेस