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

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

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

# परिचय

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

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

• उदाहरण
• सेवाएं
  • $baseUrl
  • $baseParameterMapping
  • $additionalParameters
  • $defaultParameters
  • prepareAttributes()

🔗उदाहरण

<x-link-sharer service="twitter" text="मुझे साझा करें!" url="https://www.defectivecode.com" hashtags="awesome,links" 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 ब्लॉग पोस्ट का पाठ।
डायस्पोरा	✔️	✔️
डिगो	✔️	✔️	description पोस्ट में जोड़ने के लिए एक विवरण।
डौबान	✔️	✔️	comment पोस्ट में जोड़ने के लिए एक टिप्पणी।
एवरनोट	✔️	✔️
फेसबुक	❌	✔️
फ्लिपबोर्ड	✔️	✔️	quote पोस्ट में जोड़ने के लिए एक उद्धरण।
जीमेल	✔️	✔️	bcc बीसीसी करने के लिए ईमेल पतों की अल्पविराम से अलग की गई सूची। cc सीसी करने के लिए ईमेल पतों की अल्पविराम से अलग की गई सूची। su ईमेल का विषय। to भेजने के लिए ईमेल पतों की अल्पविराम से अलग की गई सूची।
हैकन्यूज	✔️	✔️
इंस्टापेपर	✔️	✔️	description पोस्ट का विवरण।
लाइनमी	❌️	✔️
लिंक्डइन	❌	✔️
लाइवजर्नल	✔️	✔️
मेनेमे	❌️	✔️
ओक्रू	❌️	✔️
आउटलुक	✔️	✔️
पिंटरेस्ट	✔️	✔️	media पोस्ट में दिखाने के लिए एक छवि URL।
प्लर्क	❌ ️	✔️
पॉकेट	✔️	✔️
क्यूजोन	✔️	✔️	summary पोस्ट का सारांश।
रेडिट	✔️	✔️
रेनरेन	✔️	✔️	description पोस्ट का विवरण। srcUrl पोस्ट का मूल URL।
स्काइप	✔️	✔️
टेलीग्राम	✔️	✔️
थ्रीमा	❌	✔️	id पोस्ट भेजने के लिए व्यक्ति का आईडी।
टम्बलर	✔️	✔️	caption पोस्ट में जोड़ने के लिए एक कैप्शन। tags पोस्ट पर लागू करने के लिए टैग की अल्पविराम से अलग की गई सूची।
ट्विटर	✔️	✔️	hastags ट्वीट पर लागू करने के लिए हैश टैग की अल्पविराम से अलग की गई सूची। via श्रेय देने के लिए ट्वीट करने वाला।
वाइबर	✔️	✔️
वीकोन्टाक्ट	✔️	✔️	description पोस्ट का विवरण। image पोस्ट में दिखाने के लिए एक छवि URL।
वीबो	✔️	✔️
व्हाट्सएप	✔️	✔️
जिंग	❌	✔️
याहूमेल	✔️	✔️

# योगदान
 
एक सेवा जोड़ना अपेक्षाकृत सरल है। `src/Services` फ़ोल्डर के भीतर एक नई सेवा क्लास बनाकर शुरू करें। क्लास का नाम उस सेवा के नाम पर रखें जिसे आप जोड़ रहे हैं। सिस्टम स्वचालित रूप से फैक्ट्री के माध्यम से सेवा को पंजीकृत करता है, इसलिए मैन्युअल पंजीकरण की आवश्यकता नहीं है।
 
नीचे दी गई Gmail सेवा एक अच्छा उदाहरण है।
 
```php
<?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 का मान ग्रहण करती है।

 
 
```markdown
# समर्थन दिशानिर्देश
 
हमारे ओपन सोर्स पैकेज को चुनने के लिए धन्यवाद! कृपया इन समर्थन दिशानिर्देशों को देखने के लिए एक क्षण निकालें। ये आपको हमारे प्रोजेक्ट का अधिकतम लाभ उठाने में मदद करेंगे।
 
## समुदाय संचालित समर्थन
 
हमारा ओपन-सोर्स प्रोजेक्ट हमारे अद्भुत समुदाय द्वारा संचालित है। यदि आपके पास प्रश्न हैं या सहायता की आवश्यकता है, तो StackOverflow और अन्य ऑनलाइन संसाधन आपके लिए सबसे अच्छे विकल्प हैं।
 
## बग्स और फीचर प्राथमिकता
 
ओपन-सोर्स प्रोजेक्ट को प्रबंधित करने की वास्तविकता का मतलब है कि हम हर रिपोर्ट किए गए बग या फीचर अनुरोध को तुरंत संबोधित नहीं कर सकते। हम मुद्दों को निम्नलिखित क्रम में प्राथमिकता देते हैं:
 
### 1. हमारे भुगतान किए गए उत्पादों को प्रभावित करने वाले बग्स
 
बग्स जो हमारे भुगतान किए गए उत्पादों को प्रभावित करते हैं, हमेशा हमारी शीर्ष प्राथमिकता होंगे। कुछ मामलों में, हम केवल उन बग्स को संबोधित कर सकते हैं जो हमें सीधे प्रभावित करते हैं।
 
### 2. समुदाय पुल अनुरोध
 
यदि आपने किसी बग की पहचान की है और आपके पास उसका समाधान है, तो कृपया एक पुल अनुरोध सबमिट करें। हमारे उत्पादों को प्रभावित करने वाले मुद्दों के बाद, हम इन समुदाय संचालित सुधारों को अगली उच्च प्राथमिकता देते हैं। एक बार समीक्षा और स्वीकृत होने के बाद, हम आपके समाधान को मर्ज करेंगे और आपके योगदान का श्रेय देंगे।
 
### 3. वित्तीय समर्थन
 
उल्लिखित श्रेणियों के बाहर के मुद्दों के लिए, आप उनके समाधान के लिए वित्तीय योगदान कर सकते हैं। प्रत्येक खुले मुद्दे को एक ऑर्डर फॉर्म से जोड़ा गया है जहां आप वित्तीय योगदान कर सकते हैं। हम इन मुद्दों को प्रदान की गई वित्तीय राशि के आधार पर प्राथमिकता देते हैं।
 
### समुदाय योगदान
 
ओपन सोर्स तब फलता-फूलता है जब उसका समुदाय सक्रिय होता है। भले ही आप बग्स को ठीक नहीं कर रहे हों, कोड सुधार, दस्तावेज़ अपडेट, ट्यूटोरियल, या समुदाय चैनलों में दूसरों की सहायता करके योगदान करने पर विचार करें। हम सभी को, एक समुदाय के रूप में, ओपन-सोर्स कार्य का समर्थन करने के लिए प्रोत्साहित करते हैं।
 
_पुनः दोहराने के लिए, DefectiveCode हमारे भुगतान किए गए उत्पादों, समुदाय पुल अनुरोधों, और मुद्दों के लिए प्राप्त वित्तीय समर्थन के आधार पर बग्स को प्राथमिकता देगा।_

# लाइसेंस - एमआईटी लाइसेंस

कॉपीराइट © Defective Code, LLC. सर्वाधिकार सुरक्षित

इस सॉफ़्टवेयर और संबंधित प्रलेखन फ़ाइलों (सॉफ़्टवेयर) की एक प्रति प्राप्त करने वाले किसी भी व्यक्ति को नि:शुल्क अनुमति दी जाती है, जिसमें बिना किसी प्रतिबंध के सॉफ़्टवेयर का उपयोग, प्रतिलिपि, संशोधन, विलय, प्रकाशन, वितरण, उप-लाइसेंस और/या सॉफ़्टवेयर की प्रतियां बेचने के अधिकार शामिल हैं, और जिन व्यक्तियों को सॉफ़्टवेयर प्रदान किया गया है, उन्हें ऐसा करने की अनुमति दी जाती है, निम्नलिखित शर्तों के अधीन:

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

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