English | العربية | বাংলা | Bosanski | Deutsch | Español | Français | हिन्दी | Italiano | 日本語 | 한국어 | मराठी | Português | Русский | Kiswahili | தமிழ் | తెలుగు | Türkçe | اردو | Tiếng Việt | 中文

• अनुवाद चेतावनी
• परिचय
  • उदाहरण
• स्थापना
• सेवाएं
• योगदान करना
  • $baseUrl
  • $baseParameterMapping
  • $additionalParameters
  • $defaultParameters
  • prepareAttributes()
• आपूर्ति दिशानिर्देश
  • समुदाय द्वारा समर्थन
  • बग्स और सुविधा प्राथमिकता
• लाइसेंस - MIT लाइसेंस

🔗अनुवाद चेतावनी

यह दस्तावेज़ स्वचालित रूप से अनुवादित किया गया है। यदि अनुवाद में कोई त्रुटि है, तो कृपया प्रोजेक्ट पर एक पुल अनुरोध खोलें और docs/{ISO 639-1 कोड}.md में अनुवादित फ़ाइल जोड़ें।

🔗परिचय

यह पैकेज आपके लारावेल एप्लिकेशन में शेयर लिंक जोड़ने की प्रक्रिया को सरल बनाता है। अगर आपको लगता है कि हम किसी सेवा को छोड़ रहे हैं, तो कृपया एक पुल अनुरोध खोलें!

एक शेयर लिंक एक सामाजिक मीडिया बेस URL को एक सेट किए गए पैरामीटर के साथ जोड़ने वाला एक URL होता है जो आपकी वेबसाइट या ऐप से सामग्री साझा करने के लिए होता है। पैरामीटर आमतौर पर सामग्री URL और पूर्व-निर्धारित संदेश शामिल करते हैं। इन लिंक्स का उपयोग करके उपयोगकर्ता आसानी से ट्विटर, फेसबुक, और टेलीग्राम जैसे प्लेटफ़ॉर्म पर पोस्ट साझा कर सकते हैं। लारावेल के ब्लेड कंपोनेंट सिस्टम के माध्यम से शेयर लिंक बनाने के लिए इस ओपन-सोर्स पैकेज का उपयोग करें।

🔗उदाहरण

<x-link-sharer service="twitter" text="मुझे शेयर करें!" url="https://www.defectivecode.com" hashtags="शानदार,लिंक" class="p-4">
    <!-- यहां आपके द्वारा शेयर बटन के दिखावट और अनुभव को नियंत्रित करने के लिए आपका HTML कोड होगा -->
    <span class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded">मुझे क्लिक करें!</span>
</x-link-sharer>

🔗स्थापना

1. पहले निम्नलिखित कमांड को चलाकर PHP पैकेज को स्थापित करें:

   composer require defectivecode/link-sharer

2. बस इतना ही! हमारा पैकेज स्वचालित रूप से Laravel के पैकेज खोज का उपयोग करके स्थापित हो जाएगा।

🔗सेवाएं

सेवा प्रदाताओं को कभी-कभी अपडेट करने के बिना अपने शेयर लिंक को अपडेट करते हैं। हम इन बदलावों के साथ अद्यतित रहने का हर प्रयास करते हैं। हालांकि, यदि आपको कोई कार्यरत सेवा मिलती है, तो कृपया एक मुद्दा खोलें या एक पुल अनुरोध सबमिट करें। नई सेवा जोड़ने के लिए, कृपया नीचे दिए गए योगदान खंड का संदर्भ लें।

कुछ सेवाएं अतिरिक्त पैरामीटर प्रदान करती हैं जो कॉम्पोनेंट को पास किए जा सकते हैं। इनका विवरण नीचे दी गई तालिका में दिया गया है।

सेवा	पाठ समर्थित	URL समर्थित	टिप्पणियाँ
ब्लॉगर	✔️	✔️	t ब्लॉग पोस्ट का पाठ।
डायस्पोरा	✔️	✔️
डायगो	✔️	✔️	विवरण पोस्ट में जोड़ने के लिए एक विवरण।
दोबान	✔️	✔️	टिप्पणी पोस्ट में जोड़ने के लिए एक टिप्पणी।
एवरनोट	✔️	✔️
फेसबुक	❌	✔️
फ्लिपबोर्ड	✔️	✔️	उद्धरण पोस्ट में जोड़ने के लिए एक उद्धरण।
जीमेल	✔️	✔️	bcc बीसीसी करने के लिए एक कॉमा से अलग ईमेल पत्रों की सूची। cc सीसी करने के लिए एक कॉमा से अलग ईमेल पत्रों की सूची। su ईमेल का विषय। to भेजने के लिए एक कॉमा से अलग ईमेल पत्रों की सूची।
हैकन्यूज	✔️	✔️
इंस्टापेपर	✔️	✔️	विवरण पोस्ट का विवरण।
लाइनमी	❌️	✔️
लिंक्डइन	❌	✔️
लाइवजर्नल	✔️	✔️
मेनेमे	❌️	✔️
ओकरू	❌️	✔️
आउटलुक	✔️	✔️
पिन्ट्रेस्ट	✔️	✔️	मीडिया पोस्ट पर दिखाने के लिए एक छवि URL।
प्लर्क	❌ ️	✔️
पॉकेट	✔️	✔️
क्यूज़ोन	✔️	✔️	सारांश पोस्ट का सारांश।
रेडिट	✔️	✔️
रेनरेन	✔️	✔️	विवरण पोस्ट का विवरण। srcUrl पोस्ट का मूल URL।
स्काइप	✔️	✔️
टेलीग्राम	✔️	✔️
थ्रीमा	❌	✔️	id पोस्ट भेजने के लिए व्यक्ति का आईडी।
टंब्लर	✔️	✔️	कैप्शन पोस्ट में जोड़ने के लिए एक कैप्शन। टैग पोस्ट पर लागू करने के लिए टैगों की एक कॉमा अलग सूची।
ट्विटर	✔️	✔️	हैशटैग ट्वीट पर लागू करने के लिए हैशटैगों की एक कॉमा अलग सूची। विया क्रेडिट देने के लिए ट्वीटर।
वाइबर	✔️	✔️
वीकॉन्टेक	✔️	✔️	विवरण पोस्ट का विवरण। छवि पोस्ट पर दिखाने के लिए एक छवि URL।
वेबो	✔️	✔️
व्हाट्सएप	✔️	✔️
ज़िंग	❌	✔️
याहूमेल	✔️	✔️

🔗योगदान करना

सेवा जोड़ना एकदम सरल है। src/Services फ़ोल्डर में एक नई सेवा कक्षा बनाकर शुरू करें। अपनी सेवा के नाम के बाद कक्षा का नाम दें। सिस्टम सेवा को स्वचालित रूप से फैक्टरी के माध्यम से पंजीकृत करता है, इसलिए मैनुअल पंजीकरण की आवश्यकता नहीं है।

नीचे दिए गए Gmail सेवा एक अच्छा उदाहरण के रूप में प्रदान की गई है।

<?php
 
namespace DefectiveCode\LinkSharer\Services;
 
use DefectiveCode\LinkSharer\Traits\AppendsLinks;
 
class Gmail extends Service
{
    use AppendsLinks;
 
    protected string $baseUrl = 'https://mail.google.com/mail/u/0';
 
    protected array $baseParameterMapping = [
        'text' => 'body',
    ];
 
    protected array $additionalParameters = [
        'bcc',
        'cc',
        'su',
        'to',
    ];
 
    protected array $defaultParameters = [
        'view' => 'cm',
    ];
}

कृपया ध्यान दें कि केवल baseUrl अनिवार्य है। baseParameterMapping, additionalParameters और defaultParameters वैकल्पिक हैं लेकिन यह कार्यक्षमता को बढ़ा सकते हैं।

🔗$baseUrl

किसी सेवा का URL HTTPS के साथ शुरू होने की आवश्यकता नहीं होती है। उदाहरण के लिए, Viber viber://forward का उपयोग करता है।

baseUrl प्रॉपर्टी सेवा का प्राथमिक URL निर्दिष्ट करती है। यह URL शेयर लिंक उत्पन्न करते समय मूल्यांकन पैरामीटरों के साथ आधारभूत होता है। उदाहरण के रूप में Gmail का उपयोग करते हुए, इसका बेस URL https://mail.google.com/mail/u/0 है।

🔗$baseParameterMapping

इस पैकेज ने दो प्राथमिक गुणों को पहचाना है: text और url, उनकी व्यापकता के कारण। इन गुणों को केवल तभी परिभाषित करें जब सेवा विचार में एक अलग नामकरण पद्धति का उपयोग करती है। उदाहरण के लिए, Gmail text की जगह body का उपयोग करता है, इसलिए यह विशेष नक्शा बनाने की आवश्यकता होती है। Gmail का उपयोग करते हुए, ब्लेड कंपोनेंट में किसी भी text गुण को शेयर लिंक में body प्रश्न पैरामीटर में परिवर्तित किया जाता है।

🔗$additionalParameters

कुछ सेवाएं विशेष प्रश्न पैरामीटर स्वीकार करती हैं। Gmail को संदर्भ के रूप में लेते हुए, इसे bcc, cc, su और to का समर्थन करता है। इन्हें additionalParameters एरे में परिभाषित करें। जब उपयोगकर्ता ब्लेड कंपोनेंट में इन गुणों को शामिल करते हैं, तो वे शेयर लिंक में जोड़े जाते हैं। सुनिश्चित करें कि ये पैरामीटर भी समर्थित सेवाओं टेबल में सूचीबद्ध हैं, संक्षेप में विवरणों के साथ।

🔗$defaultParameters

कुछ सेवाएं शेयर लिंक के कार्य के लिए निश्चित प्रश्न पैरामीटरों की आवश्यकता होती है। उदाहरण के रूप में, Gmail view=cm की शामिली की आवश्यकता होती है। ऐसे अनिवार्य गुणों को defaultParameters एरे में घोषित किया जाता है। वे हमेशा शेयर लिंक में जोड़े जाते हैं और छोड़े नहीं जा सकते हैं।

🔗prepareAttributes()

शेयर लिंक उत्पन्न करने से पहले गुणों को संशोधित करने के लिए, अपनी सेवा में एक prepareAttributes विधि प्रस्तुत करें। इस विधि को generateLink विधि को गुणों को पास करने से पहले सक्रिय किया जाता है, जिससे कस्टम गुण संशोधन किए जा सकते हैं। नीचे दिए गए उदाहरण में AppendsLinks गुण का उपयोग करके एक प्रदर्शन दिया गया है।

<?php
 
namespace DefectiveCode\LinkSharer\Traits;
 
trait AppendsLinks
{
    protected function prepareAttributes(): void
    {
        if (isset($this->attributes['text']) && isset($this->attributes['url'])) {
            $this->attributes['text'] = $this->attributes['text'] . "\n" . $this->attributes['url'];
            return;
        }
 
        if (isset($this->attributes['url'])) {
            $this->attributes['text'] = $this->attributes['url'];
        }
    }
}

सेवा में पारित गुणों को $attributes एरे के माध्यम से पहुंचा जा सकता है। इस उदाहरण में:

• यदि text और url गुण दोनों मौजूद हैं, तो url को text गुण में जोड़ा जाता है।
• केवल url गुण ही उपलब्ध होने की स्थिति में, text गुण का मान url का हो जाता है।

🔗आपूर्ति दिशानिर्देश

हमारे ओपन सोर्स पैकेज का चयन करने के लिए धन्यवाद! कृपया इन समर्थन दिशानिर्देशों की जांच करें। ये आपको हमारे परियोजना से सबसे अधिक लाभ उठाने में मदद करेंगे।

🔗समुदाय द्वारा समर्थन

हमारे ओपन सोर्स परियोजना को हमारे शानदार समुदाय द्वारा प्रेरित किया जाता है। यदि आपके पास सवाल हैं या सहायता की आवश्यकता है, तो स्टैकओवरफ्लो और अन्य ऑनलाइन संसाधन आपके सर्वोत्तम विकल्प हैं।

🔗बग्स और सुविधा प्राथमिकता

ओपन सोर्स परियोजना का प्रबंधन करने की वास्तविकता यह है कि हम हर रिपोर्ट की गई बग या सुविधा अनुरोध को तुरंत संबोधित नहीं कर सकते हैं। हम निम्नलिखित क्रम में मुद्दों को प्राथमिकता देते हैं:

1. हमारे भुगतान किए गए उत्पादों पर प्रभाव डालने वाले बग्स

हमारे भुगतान किए गए उत्पादों पर प्रभाव डालने वाले बग्स हमेशा हमारी प्राथमिकता रहेंगे। कुछ मामलों में, हम केवल हमें प्रभावित करने वाले बग्स को ही संबोधित करेंगे।

2. समुदाय पुल अनुरोध

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

3. वित्तीय समर्थन

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

समुदाय के योगदान

ओपन सोर्स उन्नत होता है जब उसका समुदाय सक्रिय होता है। यदि आप बग्स को ठीक नहीं कर रहे हैं, तो कोड सुधार, दस्तावेज़ अपडेट, ट्यूटोरियल या समुदाय में दूसरों की सहायता करके योगदान करने का विचार करें। हम सभी को, एक समुदाय के रूप में, ओपन सोर्स कार्य का समर्थन करने की ऊर्जा से प्रेरित करते हैं।

फिर से कहने के लिए, DefectiveCode बग्स को हमारे भुगतान किए गए उत्पादों पर कैसे प्रभावित करते हैं, समुदाय पुल अनुरोधों पर और मुद्दों के लिए प्राप्त वित्तीय समर्थन पर आधारित प्राथमिकता देगा।

🔗लाइसेंस - MIT लाइसेंस

कॉपीराइट © डिफेक्टिव कोड, एलएलसी। सभी अधिकार सुरक्षित हैं।

इस सॉफ़्टवेयर और संबद्ध संदर्भ फ़ाइलों (यहाँ तक कि "सॉफ़्टवेयर") की प्रतिलिपि प्राप्त करने वाले किसी भी व्यक्ति को निःशुल्क रूप से अनुमति प्रदान की जाती है, सॉफ़्टवेयर के बिना किसी भी प्रतिबंध के साथ सॉफ़्टवेयर का उपयोग करने, प्रतिलिपि करने, संशोधित करने, मर्ज करने, प्रकाशित करने, वितरित करने, सबलाइसेंस करने और/या सॉफ़्टवेयर की प्रतिलिपि बेचने के अधिकारों को निःशुल्क रूप से प्रदान करने के लिए, और सॉफ़्टवेयर के लिए उपयुक्त शर्तों के अधीन उपयोग करने के लिए उपयुक्त व्यक्तियों को अनुमति प्रदान करने के लिए।

उपरोक्त कॉपीराइट नोटिस और इस अनुमति नोटिस को सभी प्रतिलिपियों या महत्वपूर्ण भागों में शामिल किया जाना चाहिए।

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