Drupal 7 में सही आउटपुट फ़ील्ड

ComputerMinds लेख अनुवाद: Drupal 7 फ़ील्ड (सही तरीका) प्रतिपादन

संक्षिप्त उत्तर

Field_view_field () का उपयोग करें!

पूरा जवाब

Drupal 7 संस्थाओं (Entities) के साथ काम करने की क्षमता प्रदान करता है, और इसके साथ उन क्षेत्रों के साथ काम करने के लिए एक शक्तिशाली API जो संस्थाओं से जुड़ा हो सकता है। यदि आप सामग्री प्रकार पृष्ठ पर "फ़ील्ड प्रबंधन" और "डिस्प्ले कंट्रोल" टैब के माध्यम से फ़ील्ड का प्रबंधन करते हैं, तो ड्रुपल खेतों के साथ सही काम का ख्याल रखता है।

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

आपने कोड (या लिखा) देखा होगा जो कुछ इस तरह दिखता है:

//    $block['content'] = $node->field_name['und'][0]['safe_value']; 

Drupal 6 में नोड ऑब्जेक्ट खोदना काफी सामान्य था, और एक safe_value संभावित समस्याओं से बचने में मदद करता प्रतीत होगा। उसके बारे में इतना बुरा क्या है? आइए एक नजर डालते हैं।

1. सबसे पहले, ['und'] तत्व Drupal 7 में एक क्षेत्र के स्थानीयकरण का हिस्सा है; इसके अर्थ तक सीधी पहुंच किसी भी बहुभाषी वातावरण में समस्याओं को जन्म देगी।
   
2. क्षेत्र के मूल्य तक सीधी पहुंच प्राप्त करके, हम क्षेत्र के प्रतिपादन को गति देने और मूल मार्कअप का उपयोग करने की क्षमता खो देते हैं।
   
3. [0] [safe_value] स्पष्ट रूप से क्षेत्र के पहले मूल्य को संदर्भित करता है - यदि आप क्षेत्र के कई मूल्यों से प्रत्येक मूल्य का उपयोग करना चाहते हैं, तो आपको एक लूप का उपयोग करना होगा।
   
4. कुछ फ़ील्ड्स (उदाहरण के लिए, नोड रेफ़रेंस) में एक safe_value तत्व नहीं होता है, केवल मान - जिसे आसानी से संबंधित प्रीप्रॉफ़िंग के बिना प्रदर्शित किया जा सकता है। यह खतरनाक है, और न केवल इसलिए कि नोड संदर्भ में खतरनाक डेटा (समान एनआईडी) होता है, बल्कि इसलिए भी कि यह एक बुरी आदत है, विशेष रूप से नए डेवलपर्स के लिए। अन्य प्रकार के क्षेत्रों के मूल्य का उपयोग करना भी बहुत खतरनाक हो सकता है।
   

सौभाग्य से, वहाँ field_view_field () है !

 $output = field_view_field('node', $node, 'field_name'); 

यह फ़ंक्शन वर्तमान भाषा (फिक्स 1) में पूर्ण (फ़ील्ड 3) में फ़ील्ड के क्लियर किए गए मान (फिक्स 4) और रेंडरिंग के लिए तैयार एक सरणी के प्रारूप में वापस आ जाएगा, इसलिए आपको मार्कअप (फिक्स 2) के साथ सभी संबंधित डेटा मिलेंगे। जीत! यदि फ़ील्ड कोई फर्क नहीं पड़ता है, तो फ़ंक्शन वर्तमान भाषा के लिए उपलब्ध तर्क भाषा के आरक्षित वर्गों का उपयोग करेगा। आप स्वरूपण विकल्पों की एक सरणी भी पास कर सकते हैं या फ़ंक्शन के अतिरिक्त तर्क के रूप में दृश्य मोड सेट कर सकते हैं। यह एक बढ़िया विकल्प नहीं है?

अतिरिक्त टिप्स

मान लीजिए कि आप केवल मार्कअप के बिना एक मूल्य प्राप्त करना चाहते हैं। दो फील्ड एपीआई फ़ंक्शन हैं जो इस मामले में आपकी सहायता करेंगे। सबसे पहले, हमारे पास field_get_items () है जो तत्व के क्षेत्रों को सही भाषा में वापस करता है (फिर से, यदि आपको इसकी आवश्यकता है तो आप भाषा को निर्दिष्ट कर सकते हैं)। आप वहां खुदाई कर सकते हैं और कच्चा डेटा प्राप्त कर सकते हैं, संभवतः सर्वर साइड पर उपयोग के लिए या यदि आप कुछ विदेशी करना चाहते हैं, जैसे कि, उदाहरण के लिए, छवि क्षेत्र के लिए "alt" मानों का आउटपुट। यह मत भूलो कि आप कच्चे डेटा के साथ काम कर रहे हैं और आपको मूल्यों का उपयोग करने से पहले डेटा का उचित प्रीप्रोसेसिंग करने की आवश्यकता है , अन्यथा आप अपने प्रोजेक्ट में कमजोरियां पैदा करेंगे।

इसके अलावा, एक और सुविधाजनक फील्ड एपीआई फ़ंक्शन है, field_view_value () , यह तब मदद करेगा जब आप अंतर्निहित डेटा सफाई नियमों का उपयोग करके एक फ़ील्ड मान प्राप्त करना चाहते हैं। यह फ़ंक्शन स्वरूप फ़ील्ड का भी उपयोग करता है। यह एक एकल फ़ील्ड मान लेता है, जो फ़ील्ड_व्यू_वेल्यू () द्वारा लौटाए गए सरणी से लिया जाता है। यहाँ एक उदाहरण है:

 $node = node_load($nid); $field = field_get_items('node', $node, 'field_name'); $output = field_view_value('node', $node, 'field_name', $field[$delta]); 

जहां $ डेल्टा उस क्षेत्र का सूचकांक है जिसका मूल्य आप प्राप्त करना चाहते हैं। किसी एक क्षेत्र के लिए $ डेल्टा का मान 0. होगा। सब कुछ बहुत सरल है।

और, बस मज़े के लिए, यहां कुछ प्रारूपण विकल्पों का उपयोग करके नवीनतम उदाहरण दिया गया है जो ImageCache शैली को निर्दिष्ट करता है और नोड को संदर्भित करता है। यह उदाहरण field_view_value () और field_view_field () के समान काम करेगा।

 $node = node_load($nid); $image = field_get_items('node', $node, 'field_image'); $output = field_view_value('node', $node, 'field_image', $image[0], array( 'type' => 'image', 'settings' => array( 'image_style' => 'thumbnail', 'image_link' => 'content', ), )); 

यह चट्टान है!

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